Freero

Freero

チームでブレインストーミング、計画、図解、ワークショップを一緒に進めるための、オリジナルのリアルタイム共同作業ホワイトボードです。無限に広がるキャンバスを備えています。

内容

• キャンバス — 無限のパン／ズーム、ドットグリッド、ミニマップ、スナップと整列ガイド、複数選択、サイズ変更／回転、グループ化、ロック、元に戻す／やり直し、ボード間のコピー／貼り付け、ドラッグ＆ドロップによるインポート。
• コンテンツ — 付箋、21種類の図形、リッチテキスト、コネクター（直線／直角／曲線、接続、ラベル付き）、ペン＋蛍光ペン＋消しゴム、画像、絵文字とスタンプ、フレーム、タスクカード、マインドマップ、タグ、PDF、ボード上で再生できる動画と音声、その他あらゆるファイル用のファイルカード。
• 共同作業 — ライブ同期、カーソルと選択範囲、アバター、共同作業者をフォロー、「全員を自分のところに呼ぶ」、絵文字リアクション、コメントスレッド、オーナー／編集者／コメント投稿者／閲覧者のロール、招待またはリンクで共有。
• ファシリテーション — 投票セッション、共有タイマー、フレームを使ったプレゼンテーションモード。
• テンプレートとエクスポート — 18カテゴリにわたる180種類のオリジナルテンプレート、PNG／JPG／SVGへのエクスポート、フレームのPDF化、画像としてコピー。
• ダッシュボード — ボードのグリッド／リスト表示、検索、フィルター、お気に入り、ライブサムネイル、複製、共有。

実行

Node 22+ が必要です。

npm install
npm run dev          # server on :4000 + web on :5173

http://localhost:5173 を開き、シード済みのデモアカウント [email protected] / freero123（開発専用）でログインするか、アカウントを登録してください。 http://localhost:5173/board/local は、サーバーが不要なオフラインのサンドボックスボードです。

本番環境：

npm run build && npm start     # serves the built web app and the marketing site (apps/site) on :4000
docker compose up --build -d   # or the full stack: proxy, 2 app replicas, Postgres, Redis, MinIO, Mailpit on :8080

実環境へのデプロイ：docs/deployment.md · すべての設定： docs/configuration.md · バックアップ、監視、インシデント： docs/operations.md。

設定：PORT（デフォルトは4000）、FREERO_DATA_DIR（デフォルトは./data — 組み込みのPGlite データベースはdata/pgにあり、アップロードもここに保存されます）、DATABASE_URL（代わりに実際のPostgresを使用する場合）、DATABASE_POOL_MAX （デフォルトは10）。Postgresへの移行前に作成したボードがある場合は、開発サーバーを停止して npm run db:import-sqlite を一度実行してください。

開発

コマンド	内容
npm run check	アーキテクチャ境界＋型チェック＋単体テスト
npm run verify	実セッションでのエンドツーエンドチェック：実際のサーバー、実際のYjs WebSocketクライアント、ロール、永続化
npm run new:feature <name> -- …	機能フォルダーを生成します（ARCHITECTURE.mdを参照）
node scripts/ui-shot.mjs --url … --out …	ヘッドレスChromiumで実際のUIを操作し、スクリーンショットを撮影します

FreeroはDuneメソッドに従っています： 機能は予約済みのファイル名によって検出される独立したフォルダーに分離され、各状態には単一の書き込み元があり、禁止された依存関係があると、サポートされているパスを示すエラーとともにnpm run checkが失敗します。コードを変更する前にARCHITECTURE.mdをお読みください。

技術スタック：React 18 + TypeScript + Vite、WebSocket経由のYjs（CRDT）、Express + ws、PostgreSQL （pg、開発／テストではPGlite）、UI検証用のPlaywright。

ライセンス

MIT。依存関係には、許容的なライセンス（MIT、Apache-2.0、MPL-2.0）のものだけを採用しています。GPL、AGPL、およびソース公開型プロジェクトは、プロトコルレベルでのみ統合し、ベンダーとして同梱することはありません。