NexaFlowFrance/OpenFamily

自分のサーバーで運用する買い物リスト・カレンダー・予算管理の家族向けアプリです。

完成アプリ条件つき · AGPL-3.0セルフホスト・自宅サーバーTypeScript難易度
2000 保存
54フォーク4Issue

中辛 の解説

OpenFamily はセルフホスト型で、ショッピングリスト・カレンダー・家計管理・食事計画など家族の日常業務を一元管理するアプリです。ショッピング時の通路別表示、カレンダーの iCal export、予算のカテゴリー別上限アラートなど、各機能が実用的に実装されています。React 19、Node.js 20、PostgreSQL 16 で構築されており、WebSocket によるリアルタイム同期と PWA 対応によるオフラインモードをサポートしています。セットアップは Windows インストーラ(設定不要)、Docker Compose(推奨)、手動インストール から選択でき、Mealie・Home Assistant・Nextcloud などセルフホスト製品との連携も可能です。ライブデモで機能を試すことができます。

こんなリポジトリです

こんなときに便利です

  • 買い物時に家族で共有したショッピングリストを店舗内の通路順で確認しながら購入する
  • 家族各メンバーの仕事時間・学校時間表を週単位で一元管理し、スケジュールを把握する
  • 月次支出をカテゴリー別に追跡し、設定した上限を超えた際にアラートで通知される

主な機能

ショッピングリスト・カレンダー・予算管理・タスク・食事計画を一元管理できる複合プラットフォームWebSocket によるリアルタイム同期とオフラインモード対応Mealie・Grocy・Home Assistant・Nextcloud などセルフホスト製品との統合

ほかとの違い

オープンソースのセルフホスト型で、Mealie・Home Assistant などセルフホスト製品との統合が可能です。

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

準備するもの

  • Docker & Docker Compose
  • Node.js 20 + PostgreSQL 16(手動インストール時)

すぐに始める

Docker(推奨)

  1. リポジトリをクローンして環境変数をコピーします
git clone https://github.com/NexaFlowFrance/OpenFamily.git
cd OpenFamily
cp .env.example .env
  1. 必要に応じて .env ファイルを編集します

  2. Docker で起動します

docker-compose up -d --build
  1. Web ブラウザで http://localhost:3000 にアクセスします

  2. 動作確認(オプション)

npm run smoke:api

手動インストール(Docker 不使用)

  1. リポジトリをクローンして環境変数をコピーします
git clone https://github.com/NexaFlowFrance/OpenFamily.git
cd OpenFamily
cp .env.example .env
  1. 依存関係をインストールします
npm run install:all
  1. PostgreSQL でデータベースを作成します
psql -U postgres -c "CREATE DATABASE openfamily;"
  1. 開発サーバーを起動します
npm run dev
  1. Web ブラウザで http://localhost:5173 にアクセスします

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try NexaFlowFrance/OpenFamily

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

スター推移 · 7日

2007日間の増加数を計算するための比較データが不足しています

確認日時

使いやすさ · まねしやすいか

サンプル評点 14/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2025 年に作成

「セルフホスト・自宅サーバー」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/NexaFlowFrance/OpenFamily.svg)](https://www.gitbap.com/r/NexaFlowFrance/OpenFamily)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る