s4wave/spacewaveをREADMEから読み解く：構成、導入条件、運用上の境界

ブラウザ内で完結するSpace

s4wave/spacewave の README はプロジェクトを「self-host directly in the web browser, no servers required. local-first」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「README」には次の説明があります。Open it in your browser: no account, no server, working offline in one click.。これは範囲の説明であり、本番検証の結果ではありません。

利用者側の設計では、同期対象のデータと一時的なUI状態を区別します。Spaceはファイル、ノート、アプリ、レイアウト、デバイス、ワークフローを共有状態として扱いますが、READMEは個別アプリの競合解決規則や保持期間を説明していません。複数端末で同じノートを編集し、片方をオフラインにした後で再接続する試験を行えば、期待する同期結果を確認できます。クラウドを選ぶ場合は100GBで月8ドルの管理ストレージとrelayが追加されると説明されていますが、課金アカウントを使わずにアプリを動かせることも明記されています。ブラウザ版の開始はspacewave.appを開くだけで、ソースからはbun install後にstart:desktop、start:web、start:web:wasmを使います。保存データのバックアップ、招待者のアクセス停止、ネットワーク断からの復帰は、採用条件に含めて実際の端末で確認します。

Spaceの共有状態とマルチプレイヤー

README の「README」にある内容から、用途が合うかを先に判断できます。Multiplayer: Invite people into a Space and work in it together, live。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。Spaces: One shared place for your files, notes, apps, devices, and workflows。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。

Spacewave Stackを自作アプリに使う場合は、Bldrのビルド結果だけでなく、ブラウザとデスクトップで同じ状態を読めるかを確認します。READMEが挙げるSQL、K/V、GraphDBの違いは保存モデルの選択肢であり、個別アプリのデータ移行を自動化する記述ではありません。保存先を変えたときの接続設定も確認します。複数端末で状態を比較します。

BifrostとHydraの保存・同期

動作の説明は「README」など複数の箇所に分かれています。確認できる情報は次の通りです。As your work grows, the workspace becomes a Space: shared encrypted state for files, notes, apps, layouts, devices, and workflows. Spaces are multiplayer: invite people into one and work in it together, live.。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。

導入前に、オフラインで編集したノートを再接続後に復元できるか、招待した利用者の変更が各端末へ届くか、保存先を変えても同じデータを開けるかを個別に確認します。READMEはこの試験結果や保持期間を示していないため、採用判断は自分のSpaceのデータ型とネットワーク条件に結び付けて行います。

GoとWebAssemblyを動かす構成

初回導入は README の入口から始めます。確認できるコマンドは次の通りです。

# Install dependencies bun install

# Start the desktop app bun run start:desktop

# Start the web app with GoScript browser Go plugins bun run start:web

# Start the web app with standard Go/WASM browser Go plugins bun run start:web:wasm

実行可能なコマンドがない場合は手順を作らず、「Why Spacewave?」で依存関係、待受ポート、初回設定を確認します。

bunで起動する開発手順

日常運用は公式文書の範囲に限ります。「README」にはYou choose where your data lives and how it moves. Store it on your machines, in your browser, on your own server, or in a cloud you pick, and sync over any network your devices can reach.とあります。設定、環境変数、権限、データ保存先は明記されたものだけを扱います。未記載の既定値は隔離環境で確認し、戻せる設定を保存してください。 同じ資料にはPeer-to-Peer Sync: Sync directly between your devices and keep working offlineともあります。

暗号化と保存先の選択

制約も確認が必要です。現在の資料からは、s4wave/spacewave の互換表、性能基準、サービス保証、長期サポートを確認できません。README の記載は「Make it your own with the same machinery the app is made of: a Go, TypeScript, React, and WebAssembly stack where every app is local-first, multiplayer, and encrypted by default.」です。不明点は採用記録の検証項目として残し、断定に変えないでください。

自分で運用する場合の判断軸

ライセンスはメタデータと LICENSE に基づき、SPDX は Apache-2.0 です。再配布や改変の条件を確認する情報であり、安全審査の代わりではありません。認証情報、公開範囲、ログ、依存ライブラリの扱いは別途確認が必要です。

Spacewaveの説明で重要なのは、サーバーを持たないことと、保存先を固定しないことが同じ意味ではない点です。ブラウザのIndexedDB、端末上のストレージ、利用者が用意したバックエンド、選択したクラウドを使い分けられます。WebRTC、WebSocket、LAN、relayのどれで接続できるかはネットワーク環境に左右され、オフラインで編集できても別端末への同期が直ちに完了するとはREADMEに書かれていません。Bifrostは通信、Hydraはデータ構造と同期、Bldrはビルド、GoScriptはGoコードのブラウザ向け変換を担当します。開発者はprotoファイルを変更した後にbun run genを実行し、bun run test、bun run test:go、bun run lint、bun run typecheckを分けて確認できます。暗号化が標準と説明されていても、鍵の回復、共有相手の失効、選択した保存先のバックアップ手順までは別途確認が必要です。

編集部の結論

s4wave/spacewaveは、READMEに書かれた構成と作業手順が自分の環境に合う人に向きます。公式説明だけでは性能、障害時の復旧、運用負担までは判断できないため、masterブランチのREADMEにある具体的なコマンドと設定を小さな検証環境で確認してください。特にこのプロジェクト固有の入力、保存先、権限、外部サービスとの境界を記録し、合わない条件を先に除外するのが妥当です。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes