本家 Boostnote はサービス終了済みです（後継は BoostNote-App）。 本リポジトリは BoxPistols による Boostnote Legacy のフォークで、ライセンス（GPL-3.0）を継承しつつ、 リアルタイム共同編集・local-first・拡張性を備えたモダンなノートアプリへ段階的に作り替えています。 ベンチマーク: Obsidian / HackMD。
| パス | 内容 | ランタイム |
|---|---|---|
browser/, lib/ |
The Boosters 本体（フル機能。React 16 + Redux + Vite 6、.cson ファイル保存）。Electron 28 へ近代化し electron-builder で OS App 配布 |
Node 22 |
app/ |
モダンアプリ土台（Vite + React 19 + TypeScript + CodeMirror 6）。3ペインUXを再現し、実 .cson の読込・新規作成・編集の書き戻し保存（オートセーブ）・タグ編集・フォルダ移動・ゴミ箱（移動/復元/完全削除）・全文検索・一覧ソート（更新/作成/タイトル）・KaTeX 数式プレビュー・コードのシンタックスハイライト・Markdown エクスポート・仮想化リスト・フォルダピッカーに対応。Electron 42。The Boosters Next として配布 |
Node 22 |
poc/collab-core/ |
共同編集コアの実証（Yjs + CodeMirror 6 + self-host Hocuspocus + .cson スナップショット、device-pairing 認証） |
Node 22 |
docs/ |
モダナイゼーション設計判断書（スタック選定・脅威モデル・As-Built アーキテクチャ） | — |
.claude/skills/boostnote-modernize |
アーキテクチャ判断・作業方針をまとめた Claude Code スキル | — |
| キー | 動作 |
|---|---|
| ⌘/Ctrl + N | 新規ノート |
| ⌘/Ctrl + F | 検索にフォーカス |
| ⌘/Ctrl + B | 太字（選択をトグル） |
| ⌘/Ctrl + I | 斜体（選択をトグル） |
| ⌘/Ctrl + K | リンク化 |
Apple Silicon について: 本体（
browser/+lib/）も Electron 28 へ近代化済みで arm64 ネイティブです（旧 Electron 4 時代の「arm64 ビルドが存在しない」制約は解消）。The Boosters/The Boosters Nextいずれもネイティブ arm64 dmg を配布します。Rosetta は不要です。
# The Boosters 本体（Node 22 / pnpm / Vite 6 / Electron 28・arm64 ネイティブ）
pnpm install # Volta が Node 22 を自動選択。postinstall で Electron 28(arm64) 取得
pnpm run compile && pnpm start # Vite で renderer をビルドして Electron 起動
pnpm test # AVA + Jest
pnpm run lint # ESLint
pnpm run dist # 配布ビルド（compile + electron-builder + ad-hoc 署名）
# モダンアプリ（Node 22）
cd app
npm install
npm run dev # ブラウザ（サンプルデータ）
npm test # .cson データ層テスト
npm run build # 型チェック付き本番ビルド
BOOSTNOTE_STORAGE="/path/to/storage" npm run electron # 実 .cson を読むデスクトップ起動
# 共同編集コア（Node 22）
cd poc/collab-core && npm install && npm test📦 Releases ページ から最新版を入手します。 v0.16.4 以降を使用してください（v0.16.2 / v0.16.3 のインストーラは起動しない致命バグがあります）。
- Releases から dmg をダウンロード
- Apple Silicon（M1〜）:
The-Boosters-<ver>-arm64.dmg（ネイティブ arm64、Rosetta 不要） - Intel:
The-Boosters-<ver>-x64.dmg
- Apple Silicon（M1〜）:
- dmg を開き、The Boosters.app を
Applicationsへドラッグ - 初回のみ: アプリを右クリック（Control+クリック）→「開く」→「開く」
- Apple Developer 署名がない ad-hoc 署名ビルドのため、「開発元を確認できません」の警告が出ます。この右クリック起動で以後は普通に開けます
- 2 回目以降は Dock / Launchpad から通常起動
それでも「壊れているため開けません」と出る場合（旧バージョン等）はターミナルで
xattr -cr "/Applications/The Boosters.app"を実行してから開いてください。
- Releases から
The-Boosters-Setup-<ver>.exeをダウンロード - 実行すると SmartScreen の警告が出るので 「詳細情報」→「実行」
- インストーラの指示に従う（インストール先は変更可能）
- スタートメニュー / デスクトップから起動
- UI は日本語で起動します（設定 > インターフェース で変更可）
- ノート保存先はデフォルトで
~/Boostnote（設定 > ストレージ で追加・変更可） - 自動更新チェック（v0.16.4 以降）: 新しいリリースが出ると起動時に通知され、ダウンロードページを開けます。設定 > The Boosters について > Enable Auto Update で ON/OFF
- 全リリースはパッケージ後に 実行時依存の解決チェック（
scripts/check-packaged-requires.mjs）を通過 - Windows は CI 実機で起動検証: win-smoke がリリース済み exe をサイレントインストール → 実起動 → メイン UI 到達を機械判定
- macOS は Apple Silicon 実機でインストール〜起動を検証
Vite + React 19 + CodeMirror 6 の次世代土台（機能は限定）。タグ app-v* の push で release.yml がビルドし、The-Boosters-Next-* として配布されます。
タグ v* の push で release-legacy.yml が macOS / Windows をビルドして Releases に公開します（ローカルからは pnpm run dist + gh release create でも可）:
git tag v0.16.5 && git push origin v0.16.5恒久課題: Apple Developer ID + 公証（$99/年）を導入すれば mac の右クリック手順も不要になります。証明書を GitHub Secrets に登録 → afterPack フックを置き換える設計です。
ノートは <ストレージ>/notes/<key>.cson の個別ファイルとしてローカルに保存されます。追加実装なしで複数端末同期ができます:
- ストレージフォルダを OneDrive / iCloud Drive / Dropbox の同期フォルダ内に置く。
- 各端末でアプリを起動し、サイドバーの「＋ ストレージを追加」（または空状態の「📂 ストレージフォルダを開く」）から同じフォルダを指定する。
.cson が source of truth なのでオフラインでも完全動作します。同じノートを別端末で同時に編集した場合のみクラウド側で重複ファイルが生じ、手動解消が必要です（whole-file 同期の制約）。自動・ロスレスなリアルタイム共同編集は poc/collab-core/（Yjs CRDT）を配線するアップグレードパスとして用意しています。詳細は As-Built アーキテクチャ を参照。
- シェル: Electron を最新サポート版（v42）へ。
- UI: React 19 + Redux Toolkit。現行 UI/UX を踏襲しつつ進化。
- エディタ: CodeMirror 6（source markdown + ライブプレビュー）。
- 同期: Yjs（CRDT）で local-first ＋ リアルタイム共同編集。
.csonは派生スナップショットとして温存。 - 同期サーバ: self-host Hocuspocus（平文は自分の VPS、フラットコスト）。共有は自分の複数端末（device-pairing）。
- 優先順位: まず高速・安定の土台。詳細は
docs/を参照。
GPL v3（BoostIO からの継承）。