CleanFrame
삼성 The Frame용 개인 홈 화면, 포크와 맞춤을 위한 시작점
아직 감지된 업데이트가 없습니다. GitHub 릴리스가 나오면 여기에 보입니다.
개인 계정의 공개 저장소 소유자는 GitHub로 로그인해 운영자를 확인하고 소개를 직접 관리할 수 있습니다. 관리자 승인은 필요하지 않습니다.
로그인한 뒤 확인 파일을 만들어 이 저장소의 기본 브랜치에 30분 안에 커밋해 주세요. 다른 브랜치나 포크의 파일은 인정하지 않습니다. 파일을 올린 뒤 아래에서 확인하면 관리자 승인 없이 관리할 수 있습니다. 자격을 유지하려면 파일을 남겨 두세요.
로그인이 필요하면 로그인 화면으로 이동합니다. 로그인 후 이곳으로 돌아와 원하는 확인 버튼을 다시 눌러 주세요.
프로젝트 폴더에서 /nomorevibe verify를 실행하면 소유권을 확인하고 소개를 직접 관리할 수 있습니다.
1분 만에 확인하기함께한 사람과 언제, 어디서, 무엇을 했는지 남기고 그 기록을 대한민국 지도와 타임라인으로 돌아보는 서비스
저장소 README에서 가져옴
README 전체를 불러오는 중입니다. 아래는 저장된 발췌입니다.
함께한 사람과 장소를 중심으로 우리의 하루를 기록합니다. 뭐했지는 홈 화면에 설치해 앱처럼 사용하는 관계 기반 라이프로그 PWA(Progressive Web App)입니다. 연인이나 친구와 언제, 어디서, 무엇을 했는지 기록하고 대한민국 지도와 타임라인으로 돌아봅니다. 여행뿐 아니라 퇴근 후 산책, 단골 카페에서의 대화, 기념일처럼 함께한 일상도 모아 볼 수 있습니다. 뭐했지는 브라우저에서 바로 사용할 수 있고 홈 화면에 설치하면 주소창 없이 독립된 앱 화면으로 실행됩니다. • iPhone: Safari에서 서비스를 열고 공유 메뉴의 ‘홈 화면에 추가’를 선택합니다. Apple 설치 안내 • Android·데스크톱: 지원 브라우저의 ‘앱 설치’ 또는 ‘홈 화면에 추가’ 메뉴를 사용합니다. 브라우저별 설치 안내 • 기록 알림: 지원 환경에서 알림 권한을 허용하고 설정의 ‘기록 알림’을 켜면 새 기록의 웹 푸시를 받을 수 있습니다. 현재 기록 조회와 저장에는 인터넷 연결이 필요합니다.README 전문 보기 ↗
함께한 사람과 장소를 중심으로 우리의 하루를 기록해요.
뭐했지는 홈 화면에 설치해 앱처럼 쓰는 관계 기반 라이프로그 PWA(Progressive Web App)예요. 연인이나 친구와 언제, 어디서, 무엇을 했는지 기록하고 대한민국 지도와 타임라인으로 돌아봐요. 여행뿐 아니라 퇴근 후 산책, 단골 카페에서의 대화, 기념일처럼 함께한 일상도 모아 볼 수 있어요.
가입 없이 체험 데모에서 샘플 데이터로 모든 기능을 직접 써 볼 수 있어요.
뭐했지는 브라우저에서 바로 쓸 수 있고, 홈 화면에 설치하면 주소창 없이 독립된 앱 화면으로 실행돼요.
기록을 보고 저장하려면 인터넷 연결이 필요해요.
모두 체험 데모에서 찍은 화면이고, 등장하는 사람과 기록은 가상 데이터예요. 데모의 경로는 길찾기 대신 직선으로 이어요.
다녀온 곳이 빛나는 지도와 타임라인, 달력에서 함께한 날들을 다시 찾아봐요.
집에서 그날 다녀온 곳까지, 그리고 방문한 장소 사이를 차례로 이어 그려요.
날짜와 날씨, 방문한 지역과 장소, 카테고리·제목·메모를 차례로 남겨요.
지도에서 바로 기록을 열어 보고 구성원 이름으로 댓글을 주고받아요.
| 영역 | 사용 기술 |
|---|---|
| 웹 | Next.js App Router, React, TypeScript |
| 스타일·UI | Tailwind CSS, shadcn/ui, Base UI, Phosphor Icons |
| 서버 상태 | TanStack Query |
| 인증·데이터 | Supabase Auth, PostgreSQL, RLS |
| 장소·지역 검색 | Kakao Local API |
| 경로·주소 | Kakao Mobility 길찾기 API, 카카오 우편번호 서비스 |
| 인터랙션 | Motion, use-funnel |
| PWA | Web App Manifest, Service Worker, Web Push |
| 도구 | pnpm, Biome, Node.js 내장 테스트 러너 |
프로젝트의 패키지 관리자는 [email protected]이에요.
이 pnpm 버전을 지원하는 Node.js 환경과 Supabase 프로젝트, 카카오 REST API 키가 필요해요.
pnpm install
루트에 .env.local을 만들고 연결할 프로젝트의 값을 넣어요.
NEXT_PUBLIC_SUPABASE_URL=https://YOUR_PROJECT.supabase.co
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=YOUR_PUBLISHABLE_KEY
KAKAO_REST_API_KEY=YOUR_KAKAO_REST_API_KEY
웹 푸시를 쓰려면 다음 값도 설정해요.
NEXT_PUBLIC_VAPID_PUBLIC_KEY=YOUR_VAPID_PUBLIC_KEY
VAPID_PRIVATE_KEY=YOUR_VAPID_PRIVATE_KEY
VAPID_SUBJECT=mailto:YOUR_EMAIL
새 Supabase 프로젝트의 스키마 준비와 마이그레이션 절차는 DB 마이그레이션 안내를 참고해요.
이메일 인증을 쓴다면 http://localhost:3000/auth/confirm을 Supabase의 허용 리디렉션 URL에 등록해요.
pnpm dev
http://localhost:3000에서 회원가입해요. 이메일 인증이 켜져 있다면 인증 메일의 링크로 가입을 마친 뒤 구성원을 등록하면 기록을 시작할 수 있어요.
로그인 없이 화면을 살펴보려면 http://localhost:3000/demo를 열어요. 데모는 실제 앱 컴포넌트를 샘플 데이터로 실행하고, 데모에서 바꾼 내용은 실제 서비스에 저장되지 않아요.
app/ Next.js 라우팅과 route handler 진입점
src/app/ 전역 스타일, provider, route handler 구현
src/pages/ 페이지 단위 화면 조합
src/widgets/ 지도, 기록 폼 등 화면 블록
src/features/ 회원가입, 기록 생성, 장소 선택 등 사용자 행동
src/entities/ 기록, 장소, 지역, 구성원 등 도메인
src/shared/ 공용 UI, API 클라이언트, 유틸
demo/ 실제 앱 컴포넌트와 샘플 데이터를 연결하는 체험 데모
docs/ 개발 문서, 기획과 백로그, README 스크린샷
supabase/ 데이터베이스 마이그레이션
public/ PWA 아이콘, 서비스 워커 등 정적 파일
Feature-Sliced Design의 레이어별 의존 방향을 따르고, 상세 규칙은 코드 컨벤션에 정리되어 있어요.