ローカル開発とリポジトリ構成

コマンドはリポジトリのルートで実行します。

起動

Node.js 24系(>=24.0.0 <25)を使用します。CIも24系で実行します。開発依存にもNode.js 24.22.2を含めており、依存関係のインストール後は npm run 内でこのバージョンを使用します。

npm ci
npm run dev

ローカルURLは http://127.0.0.1:4321/ です。

npm run check
npm run build
npm run preview

dist/ に出力したファイル一式を静的ホスティングで配信できます。ビルド時・閲覧時にWordPressへ接続しません。

ディレクトリ構成

.
├── src/
│   ├── components/           # ロゴ、テーマ切替、GA、お知らせ一覧
│   ├── content/pages/        # 固定ページの本文HTML
│   ├── data/
│   │   ├── pages.json        # 固定ページのURL・タイトル・本文ファイルの対応
│   │   ├── pages.ts          # メタデータと本文HTMLを結合するローダー
│   │   ├── news.json         # お知らせの記事データ
│   │   ├── navigation.ts     # 会社情報・商品情報・採用情報のナビゲーション
│   │   └── assets.json       # 移行元画像URLと配信パスの対応
│   ├── layouts/Layout.astro # 共通head・ヘッダー・フッター
│   ├── pages/               # 公開URLに対応するAstroページ・静的データ生成
│   └── styles/              # 共通・ページ別のCSS
├── public/
│   ├── assets/original/     # 元画像
│   ├── assets/webp/         # 最適化スクリプトで生成する配信用画像
│   └── hp_pdf/              # 製品PDF
├── backend/contact-form/    # お問い合わせ送信API(サイトとは別に配置)
├── infra/contact-form/      # SAM定義・自前版の構築設定例
├── scripts/                 # 画像最適化・表示検証・移行の補助スクリプト
├── source-archive/          # 移行元のHTML断片・RSS
├── original-home.html      # 移行元トップページのHTML
├── astro.config.mjs        # 本番URL・静的出力・Tailwindの設定
├── tsconfig.json           # Astroのstrict設定を継承するTypeScript設定
├── package.json            # 依存関係・実行コマンド・Node.js要件
├── package-lock.json       # インストールする依存バージョンの固定
├── .gitlab-ci.yml          # GitLab CIの自動検証と本番デプロイ
├── docs/                   # 開発・運用・デザインのドキュメント
├── dist/                   # 本番用ビルドの出力(Git管理対象外)
├── dist-preview/           # 確認環境用ビルドの出力(Git管理対象外)
└── qa-artifacts/           # 検証結果・スクリーンショット(Git管理対象外)

固定ページは現在26件(トップページを含む)、お知らせは12件です。固定ページの本文は src/content/pages/、URLなどのメタデータは src/data/pages.json で分けて管理し、src/data/pages.ts で結合します。

ページ生成の対応

公開URL 実装・データ
/ src/pages/index.astro。ご挨拶は home.html、お知らせは news.json から取得
会社情報・商品情報・採用情報などの固定ページ src/pages/[...path].astro が pages.ts から生成(トップページを除く)
/news/・/updates/・/careers/ 各ディレクトリの index.astro と共通の NewsListing.astro
/news/<slug>/ src/pages/news/[slug].astro が news.json から生成
/<slug>/ src/pages/[legacy].astro が生成する旧記事URLの互換ページ
/search/ src/pages/search/index.astro
/search-index.json src/pages/search-index.json.ts が固定ページ・お知らせの検索データを生成
/sitemap.xml src/pages/sitemap.xml.ts が公開URL一覧を生成
/404.html src/pages/404.astro

.ts の検索データ・サイトマップもビルド時に静的ファイルとして出力します。公開サーバーでNode.jsを常駐させる必要はありません。public/ のファイルは、ディレクトリ構成を保って出力先へコピーされます。

本番・確認用ビルドの違い

npm run build の本番成果物は、通常ページのインデックス登録を禁止しません。404ページは noindex を維持します。npm run dev は noindex, nofollow を出力します。外部確認環境などでインデックス登録を防ぎたい場合は npm run build:preview を使い、dist-preview/ の成果物を配置してください。通常の npm run preview は本番成果物 dist/ のローカル確認なので、本番と同じrobots設定です。

sitemap.xml のURLとGoogleアナリティクスの計測対象オリジンには、astro.config.mjs の site(https://www.tectas.co.jp)を使用します。本番URLを変更する場合は、この設定を更新して再ビルドしてください。

次の作業