エンジニアガイド 概要

構成

Asteroid は 2 プロジェクト構成のモノレポです。

• asteroid-core: Cloudflare Workers（Hono + Prisma D1）で提供する API。
• asteroid-terminal: Vite（TanStack Router）+ React の Web アプリと Tauri デスクトップ。

Core

• API・DB（D1）を提供

Airport

• Web/Tauri クライアント

共通ルール（抜粋）

• Node/pnpm は Volta で固定（Node 22.19.0 / pnpm 10.16.1）。
• フォーマッタ/リンタは Biome。pnpm fix で整形、pnpm type-check で型チェック。
• 機密はコミットしない。Core は Wrangler のシークレット、App は .env で管理。
• PR は小さく、目的/影響範囲/動作確認（dev/build）を記載。

バージョン固定

• Volta により Node/pnpm を固定

コード品質

• Biome/TS チェック

セキュリティ

• シークレットは VCS へコミットしない

次のステップ

開発を始めるには「セットアップ」を参照してください。