가족 쇼핑·일정·예산을 한 곳에서 관리하는 자체 호스팅 앱
중간맛 분석
가족 구성원 간 쇼핑, 일정, 예산, 식사 계획을 실시간으로 공유하고 동기화하는 자체 호스팅 앱입니다. React + TypeScript(프론트엔드)와 Node.js + PostgreSQL(백엔드) 스택으로 빌드되며, Compose 또는 Windows 설치 프로그램으로 자신의 서버에 배포합니다. 쇼핑 리스트는 가게 아일별 모드를 지원하고, 예산은 카테고리별 한도와 차트 기능을 제공하며, 일정은 iCal 내보내기와 자동 상기 알림을 지원합니다. Mealie, Grocy, Home Assistant, Nextcloud 같은 자체 호스팅 앱과 연동되며, PWA로 오프라인 브라우징도 가능합니다. 서버 설치와 보안(HTTPS, Tailscale) 설정을 위한 자세한 가이드 문서를 제공합니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 가족 구성원이 주간 식사를 함께 계획하고 필요한 재료를 쇼핑 리스트에 추가하여 공동 구매
- 부모가 가정 예산을 설정하고 추적하면서 자녀는 읽기 전용으로 지출 내역 확인
- 가족의 업무·학교·진료 일정을 공유 캘린더에 입력하여 전체 일정 충돌 확인
핵심 기능
대안 대비 차별점
완전 오픈소스(AGPL-3.0)이며 자신의 서버에 설치 가능하고, Mealie·Grocy·Home Assistant 같은 자체 호스팅 앱과 원활하게 연동됩니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Docker
- Docker Compose
바로 차려먹기Node.js (npm)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/NexaFlowFrance/OpenFamily.git && cd OpenFamily && npm install && npm run dev
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
Docker 사용 (권장)
- .env 파일을 .env.example에서 복사하여 설정을 준비합니다.
cp .env.example .env
- Docker Compose로 스택을 빌드하고 실행합니다.
docker-compose up -d --build
- 앱에 접근합니다.
- 프론트엔드: http://localhost:3000
- 백엔드 API: http://localhost:3001
- 스택이 제대로 동작하는지 검증합니다.
npm run smoke:api
수동 설치 (대안)
- 모든 npm 의존성을 설치합니다.
npm run install:all
- PostgreSQL 데이터베이스를 생성합니다.
psql -U postgres -c "CREATE DATABASE openfamily;"
- .env 파일을 .env.example에서 복사합니다.
cp .env.example .env
- 개발 서버를 실행합니다.
npm run dev
- 프론트엔드: http://localhost:5173
- 백엔드 API: http://localhost:3001
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try NexaFlowFrance/OpenFamily
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2025년 생성
「셀프호스팅·홈서버」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/NexaFlowFrance/OpenFamily)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기