ドキュメント
Web サーフェス
Web アプリは公開マーケティングページ、多言語ドキュメントシェル、認証済みダッシュボードを 1 つの Astro プロジェクトで扱います。
ルートマップ
| ルート | 用途 |
|---|---|
/, /pricing | マーケティング用ランディングページ |
/docs/* | クイックスタート、SDK、CLI、概念、Web リファレンスを表示するドキュメントシェル |
/blog/*, /compare/*, /guides/* | SEO と教育向けコンテンツ |
/ko/*, /jp/* | 韓国語と日本語のローカライズ入口 |
/app, /app/workflows, /app/oauth-callback | 認証済みダッシュボードシェルとワークフロービルダー入口 |
スタックとランタイム
| 要素 | 現在の選択 |
|---|---|
| サイトフレームワーク | Astro 6 |
| インタラクティブ UI | React 19 |
| スタイリング | Tailwind CSS 4 とローカル UI primitives |
| ローカライズ | en, ko, jp を使う Astro i18n |
| デプロイ先 | npm run build が生成する dist/ を使う Cloudflare Pages |
ローカル開発
bashcd web
npm install
npm run dev
npm run build
npm run preview- パッケージ要件は
node >=22.12.0です。 PUBLIC_API_URLがsrc/lib/api.tsとsrc/lib/auth-api.tsで使う API origin を決めます。- ダッシュボード認証はバックエンドが設定する httpOnly Cookie と CSRF 保護用の
schift_csrfCookie を使います。
デプロイメモ
このプロジェクトは静的 Astro サイトとしてビルドされます。wrangler.toml は Cloudflare Pages が生成された dist/ を使うように設定されており、sitemap は /app を公開インデックス対象から外しています。