arch-nuxt について
Vitesse スタイルのスターターを使った Nuxt 4 開発を支援するスキル集です。Vite ベースの構成、アプリ構造、状態管理、サーバー API、PWA 設定を解説します。
主な機能
- 01Nuxt 4 スターターの構成
- 02ファイルベースのルーティングとレイアウト
- 03Pinia とコンポーザブルのパターン
- 04サーバー API の設定
- 05PWA と UnoCSS の設定
- 06データ取得とカラーモード
活用シーン
- 01記載されたスタックで Nuxt 4 アプリを開始
- 02サーバー API エンドポイントの実装
- 03PWA 機能とスタイルの設定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hairyf/ skills --skill arch-nuxtインストール後、Claude Code で/arch-nuxtを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
GENERATION.mdreferences/best-practices-page-meta.mdbest-practices-routing.mdcore-app-structure.mdcore-constants.mdcore-eslint.mdcore-nuxt-config.mdcore-overview.mdcore-scripts.mdfeatures-client-only.mdfeatures-color-mode.mdfeatures-components.mdfeatures-composables.mdfeatures-data-fetching.mdfeatures-layouts.mdfeatures-pinia-state.mdfeatures-pwa.mdfeatures-server-api.mdfeatures-unocss.md詳細
arch-nuxt は Nuxt 4 向けの Vitesse スタイルのスターターです。SSR、ファイルベースのルーティング、自動インポート、そして独自のスタック(Vite、UnoCSS、Pinia、VueUse、ColorMode、VitePWA)を備えています。最小限で本番環境に対応したセットアップを提供します。app/ 構成、レイアウト、コンポーザブル、HMR 対応の Pinia ストア、サーバー API、PWA 設定、UnoCSS が含まれます。Vite を利用する Nuxt を優先し、webpack やその他のバンドラーは対象外としてください。
このスキルは vitesse-nuxt(arch-nuxt のソース)を基にしており、2026-01-30 に生成されました。
推奨プラクティス:
- Vite を利用する Nuxt を優先し、webpack やその他のバンドラーは使用しないでください
- グローバル/クライアントの状態には Pinia を使用し、適切な場合は SSR で共有する状態に
useStateを使用してください - PWA 設定は
app/config/pwa.tsに置き、nuxt.config.tsでスプレッドしてください
コアリファレンス
| トピック | 説明 | リファレンス |
|---|---|---|
| 概要 | プロジェクトの目的、構成、スタック、使用する場面 | core-overview |
| Nuxt 設定 | defineNuxtConfig、モジュール、アプリの head、nitro、experimental | core-nuxt-config |
| アプリ構成 | app/、app.vue、NuxtLayout、NuxtPage | core-app-structure |
| スクリプト | build、dev、generate、preview、typecheck、dev:pwa | core-scripts |
| 定数 | app/constants、appName、appDescription | core-constants |
| ESLint | @antfu/eslint-config、Nuxt append | core-eslint |
機能
| トピック | 説明 | リファレンス |
|---|---|---|
| レイアウト | レイアウトシステム、definePageMeta layout | features-layouts |
| コンポーザブル | useCount、useState、自動インポート | features-composables |
| Pinia の状態管理 | useUserStore、defineStore、HMR | features-pinia-state |
| サーバー API | defineEventHandler、server/api | features-server-api |
| PWA | VitePWA 設定、マニフェスト、workbox、開発用 PWA | features-pwa |
| UnoCSS | uno.config.ts、ショートカット、プリセット、アイコン | features-unocss |
| ColorMode | useColorMode、DarkToggle、theme-color メタ | features-color-mode |
| コンポーネント | 自動インポート、Counter、Footer、NuxtLink | features-components |
| クライアントのみ | ClientOnly、Suspense、useOnline、フォールバック | features-client-only |
| データ取得 | useFetch、useTimeAgo、非同期コンポーネントのデータ | features-data-fetching |
ベストプラクティス
| トピック | 説明 | リファレンス |
|---|---|---|
| ルーティング | ファイルベースのルーティング、動的ルート/キャッチオールルート | best-practices-routing |
| ページメタ | definePageMeta、レイアウトの選択 | best-practices-page-meta |
コメント
Markdown 対応