ランディング (Astro)
apps/landing は静的な Astro サイトであり、@workspace/ui (shadcn / Tailwind v4) を再利用してブランドに一貫性を持たせ、クライアント JS をほぼゼロに抑えています。
使用するタイミング
apps/landing以下のあらゆる変更 (セクション、コンポーネント、スタイリング、動的データの追加など)
使用しないタイミング
- Next.js アプリやモバイル — ランタイムが異なるため
ゼロJSモデル
- Astro はデフォルトで React コンポーネントをビルド時に静的 HTML にレンダリングします。shadcn コンポーネント (
<Button>,<Card>,<Badge>) を表示目的で使用する場合、クライアント JS は一切出荷されません。 client:*ディレクティブ (client:load,client:visible) を追加した場合のみ JS が出荷されます。真にインタラクティブな部分にのみ使用し、そのインタラクティブなグループは単一の.tsxアイランドにまとめてください。React コンテキストは個別の Astro アイランド間で共有されません。- ボタンとしてスタイルされたリンクには、ハイドレートされたボタンではなく
<a class={buttonVariants(...)}>を推奨します。
Tailwind v4 + 共有トークン (重要な修正)
- Tailwind v4 は
@tailwindcss/viteを介してastro.config.mjsで設定されています (古い@astrojs/tailwind統合は非推奨です)。 src/styles/global.cssは共有テーマをインポートし、Astro コンテンツソースを追加します:共有の@import "@workspace/ui/globals.css"; @source "./**/*.{astro,ts,tsx}";globals.cssは.ts/.tsxのみをスキャンするため、@sourceを追加しないと.astroマークアップに記述されたユーティリティクラスが生成されません (警告なく適用されません)。- CSSコメントの落とし穴:
**/グロブを含む CSS コメント (例:apps/**/*の説明) は、コメントを早期に閉じてしまい (*/)、次のルールを壊します。コメント内にグロブを入れないでください。
動的データ (必要な場合)
- ランディングには React プロバイダーも WorkOS 認証もありません。フォームや動的な呼び出しが必要な場合は、
convex/browserのConvexHttpClientを使用した Astro サーバーエンドポイントで一回限りのミューテーション/クエリを実行してください (ConvexReactClient/ConvexProviderWithAuthは使用しません)。
注意点
@workspace/ui/globals.css全体をインポートすると、余分なテーマ変数やアニメーションが取り込まれますが、問題ありません (Tailwind が未使用のユーティリティをツリーシェイクします)。next-themesはここにはないため、ランディングはライトモードのみです。小さなインライン.darkトグルスクリプトを追加する場合は別です。next/fontは使用できません。正確なフォントを揃えるには@fontsource/*または<link>を使用してください。
確認
pnpm --filter landing build→ 静的dist/;client:*のないページのindex.htmlには<script>タグがありません。.astroでのみ使用されているクラス (例:bg-primary) がビルド済み CSS に含まれていること (@source修正が機能していること)。pnpm --filter landing typecheck(astro check) がパスすること。