CleanFrame
A personal home screen for Samsung The Frame. A starting point to fork and adapt.
둘만의 순간과 방문한 지역을 지도 위에 기록하는 커플 라이프로그
Translation pending
LifestyleTypeScript · JavaScriptGitHub @j-yesungOnlineOwner unconfirmed
Have you tried it? One tap is enough. No sign-in needed.
No updates detected yet. GitHub releases will appear here.
Owners of public repositories under a personal GitHub account can sign in to verify ownership and manage the introduction themselves. No administrator approval is needed.
Sign in, generate a verification file, and commit it to this repository’s default branch within 30 minutes. Files on other branches or forks do not count. Then check the file below to manage the project without administrator approval. Keep the file to retain your access.
If needed, you will go to sign-in. After signing in, return here and press your chosen verification button again.
Run /nomorevibe verify in your project folder to verify ownership and manage the introduction yourself.
Verify in one minuteAsk about other verification options
함께한 사람과 언제, 어디서, 무엇을 했는지 남기고 그 기록을 대한민국 지도와 타임라인으로 돌아보는 서비스
Translation pending
Taken from the repository README
Loading the full README. The saved excerpt is shown below.
함께한 사람과 장소를 중심으로 우리의 하루를 기록합니다. 뭐했지는 홈 화면에 설치해 앱처럼 사용하는 관계 기반 라이프로그 PWA(Progressive Web App)입니다. 연인이나 친구와 언제, 어디서, 무엇을 했는지 기록하고 대한민국 지도와 타임라인으로 돌아봅니다. 여행뿐 아니라 퇴근 후 산책, 단골 카페에서의 대화, 기념일처럼 함께한 일상도 모아 볼 수 있습니다. 뭐했지는 브라우저에서 바로 사용할 수 있고 홈 화면에 설치하면 주소창 없이 독립된 앱 화면으로 실행됩니다. • iPhone: Safari에서 서비스를 열고 공유 메뉴의 ‘홈 화면에 추가’를 선택합니다. Apple 설치 안내 • Android·데스크톱: 지원 브라우저의 ‘앱 설치’ 또는 ‘홈 화면에 추가’ 메뉴를 사용합니다. 브라우저별 설치 안내 • 기록 알림: 지원 환경에서 알림 권한을 허용하고 설정의 ‘기록 알림’을 켜면 새 기록의 웹 푸시를 받을 수 있습니다. 현재 기록 조회와 저장에는 인터넷 연결이 필요합니다.Read the full 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의 레이어별 의존 방향을 따르고, 상세 규칙은 코드 컨벤션에 정리되어 있어요.