🍽️ 한끼 (HANKKI)
흩어진 레시피를, 한곳에. — 그리고 예쁘게 꾸며서 자랑까지.
인스타·유튜브·블로그·사진에 흩어진 레시피를 모으고 정리하는 나만의 레시피 아카이브.
한끼는 레시피를 찾는 앱이 아니라 모으는 앱입니다. "인스타에 저장은 해놨는데 못 찾겠다" — 이 문제를 해결합니다.
설치형 웹앱(PWA)이라 휴대폰 홈 화면에 설치하면 독립 앱처럼 전체화면으로 실행되고, 오프라인에서도 동작합니다.
📦 앱 소스는 hankki/ 폴더에 있습니다. · 🐻🐧 마스코트 = 꼬르곰·펭펭 · 현재 버전 v8.69
✨ 주요 기능
모으기
- 가져오기(Import) — Instagram · YouTube · 링크 · 사진(OCR 자동 인식) · 직접 작성
- Inbox — 가져온 레시피는 바로 저장 안 되고 임시 보관 → 나중에 제목·태그·폴더로 정리
- 검색 — 음식명 · 재료 · 태그로 찾기 · 즐겨찾기 · 자주 해먹는 요리("만들었어요!" 누를수록 자동 수집)
꾸미기 (레꾸) — 한끼의 시그니처
- 레시피 꾸미기(레꾸) — 레시피 표지를 꼬르곰·펭펭 스티커·프레임·배경·손글씨·반짝임 효과로 꾸미기 (다꾸 감성). 꾸미던 중 앱이 꺼져도 자동저장 복구.
- 레꾸자랑 — 내가 꾸민 표지나 랜덤 카드를 카톡·인스타로 공유(바이럴 진입점).
살림
- 장보기 · 냉장고 — 장보기 체크리스트("샀어요" → 냉장고 자동 입고), 유통기한 관리, 냉장고 파먹기(있는 재료로 요리 추천), 레시피에서 재료 한 번에 담기
- 주부의 장바구니 — 18년차 주부가 엄선한 건강 식재료 큐레이션 · 쇼핑몰 바로가기
- 요리모드 — 큰 글씨 · 화면 안 꺼짐 · 단계별 타이머
- 요리 기록(다이어리) — 만든 요리 아카이브 · 요리 달력
모든 데이터는 기기의 localStorage에 저장됩니다. (V2에서 클라우드 백업·AI 자동 정리·가족 공유 예정)
🐻🐧 캐릭터
꼬르곰(곰)과 펭펭(펭귄) — 요리하는 단짝 콤비. 앱 곳곳의 안내·빈 화면·공유 카드·꾸미기 스티커의 주인공입니다. (유니코드 이모지 대신 우리 캐릭터·라인 아이콘만 사용)
🎨 디자인 시스템
- 팔레트 — 웜 뉴트럴 뮤트 톤(곰펭 캐릭터와 조화). 배경
#FDFBF7 · 포인트 딥 브라운 #6B4F3A · 크림/샌드 계열 보조. 라이트·다크 대응.
- 폰트 — 본문 Pretendard, 꾸미기 손글씨 = Gaegu · Gowun Dodum · Jua · Nanum Pen Script 등
- 무드 — 미니멀 · 따뜻함 · 사진 중심 · 여백 많은 UI · 얇은 선 아이콘 · 아주 옅은 카드 그림자
🛠️ 기술 스택
- React 18 + Vite · PWA(
vite-plugin-pwa, 오프라인·공유받기 share_target)
- tesseract.js — 사진 레시피 OCR · html-to-image — 공유 카드 생성
- GitHub Pages 배포 (GitHub Actions) — 배포 전 스모크 테스트 자동 실행(저장 등 핵심 흐름 런타임 크래시 시 배포 차단)
📁 저장소 구조
hankki/ ← 앱 소스 (React PWA)
src/ ← 화면·컴포넌트·스티커 자산
docs/ ← 기획·복기·로드맵 문서
docs/stickers/ ← 스티커·이모지 마스터 라이브러리(README = 단일 진실원)
.claude/commands/ ← 작업 명령어(/안녕·/잘자·/점검·/청소 등)
_archive/ ← 구버전·타프로젝트 잔재 보관(삭제 대신 격리)
© 2026 한끼(HANKKI) · 제작 중 · 무단 복제·배포 금지
