ウェブサイトビルダー
ワークフロー
1. プロジェクトの評価
プロジェクトの種類を特定し、スタックを選択します:
| シグナル | スタック | デプロイ先 |
|---|---|---|
| マーケティングサイト、ポートフォリオ、シンプルなページ | Vanilla HTML/CSS/JS または Astro | Netlify |
| 認証、API、データベースを伴う動的アプリ | Next.js + Tailwind | Vercel |
| Shopifyストアページ(商品、コレクション、ホームページ) | Liquid + JSON テンプレート | Shopify API |
| コンテンツ重視のブログ/ドキュメント | Astro + MDX | Netlify |
詳細なスタック選定基準については、references/stack_guide.md を参照してください。
2. デザインシステムの確立
コンポーネントを作成する前に、デザイントークンを定義します:
色: プライマリ、セカンダリ、アクセント、ニュートラル(50-900)、成功、エラー
タイポグラフィ: 見出しフォント、本文フォント、スケール(xs から 4xl)
スペーシング: 4px ベースユニット(4, 8, 12, 16, 24, 32, 48, 64)
角丸: sm (4px), md (8px), lg (12px), full
シャドウ: sm, md, lg
ブランドアセット(ロゴ、色、フォント)をすべてのコンポーネントで一貫して適用します。パレット構築パターンについては、references/design_tokens.md を参照してください。ウェルネス/ Eコマースデザインのインスピレーション(Serene Herbs、Magic Mind スタイル)については、references/design_inspiration.md を参照してください。
3. コンポーネントの構築
静的サイト: セクションごとに、モバイルファーストで構築します。各セクションは自己完結型で、独自のスタイルを持ちます。
React/Next.js アプリ: コンポーネントファーストのアーキテクチャ。原子 → 分子 → 有機体 → ページの順に構築します。
Shopify テーマ: テーマカスタマイザーで編集可能な {% schema %} ブロックを備えたLiquidセクションとして構築します。Shopify特有のパターン、落とし穴、デプロイについては、references/shopify_2_0.md を参照してください。
4. デプロイ
Netlify(静的サイト):
npx netlify-cli deploy --prod --dir=./dist
Shopify(Liquidセクション + JSONテンプレート): バンドルスクリプトを使用してAdmin API経由でプッシュします:
scripts/deploy_shopify_section.py—.liquidセクションファイルをプッシュscripts/deploy_shopify_template.py— JSONテンプレートをプッシュし、商品を割り当て
Vercel(Next.js):
npx vercel --prod
デプロイの詳細と安全なパターンについては、references/deployment.md を参照してください。
Shopifyクイックリファレンス
Shopifyは最もエラーが発生しやすいスタックです。主な落とし穴:
- ブロックタイプ — テーマの実際のブロックタイプ名を使用します(例:
title、@app/titleではありません) - リッチテキストフィールド — HTMLタグに
style属性は使用不可。セマンティックHTMLのみ - カラースキーム —
scheme-1からscheme-5の名前で指定します(background-1ではありません) - image-with-text — コンテンツにはブロック(見出し、テキスト、ボタン)を使用し、セクションレベルの設定は使用しません
- template_suffix の安全性 — サフィックスを変更するとすべてのテーマに影響します。常にライブテーマにフォールバックテンプレートを先にプッシュしてください
- レート制限 — API呼び出しの間に
time.sleep(0.5)を追加します
Shopifyの完全なリファレンスと例については、references/shopify_2_0.md を参照してください。