mcpField
A
arch-nuxt

arch-nuxt

github.com/hairyfDevelopment26100 installsUpdated 2w ago
Repository

About arch-nuxt

A skill set for building Nuxt 4 projects from a Vitesse-style starter. It documents the Vite-based stack, app structure, state, server APIs, and PWA setup.

Key features

  1. 01Nuxt 4 starter architecture
  2. 02File-based routing and layouts
  3. 03Pinia and composable patterns
  4. 04Server API setup
  5. 05PWA and UnoCSS configuration
  6. 06Data fetching and color mode

Use cases

  1. 01Starting a Nuxt 4 app with the described stack
  2. 02Implementing server API endpoints
  3. 03Configuring PWA features and styling

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hairyf/skills --skill arch-nuxt

After installing, type/arch-nuxtin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

GENERATION.md
references/
best-practices-page-meta.md
best-practices-routing.md
core-app-structure.md
core-constants.md
core-eslint.md
core-nuxt-config.md
core-overview.md
core-scripts.md
features-client-only.md
features-color-mode.md
features-components.md
features-composables.md
features-data-fetching.md
features-layouts.md
features-pinia-state.md
features-pwa.md
features-server-api.md
features-unocss.md

Details

From the project README

arch-nuxt is the Vitesse-style starter for Nuxt 4: SSR, file-based routing, auto-imports, and an opinionated stack (Vite, UnoCSS, Pinia, VueUse, ColorMode, VitePWA). It provides a minimal, production-ready setup: app/ structure, layouts, composables, Pinia store with HMR, server API, PWA config, and UnoCSS. Prefer Vite-powered Nuxt; do not consider webpack or other bundlers.

The skill is based on vitesse-nuxt (arch-nuxt source), generated at 2026-01-30.

Recommended practices:

  • Prefer Vite-powered Nuxt; skip webpack and other bundlers
  • Use Pinia for global/client state; use useState for SSR-shared state when appropriate
  • Keep PWA config in app/config/pwa.ts and spread it in nuxt.config.ts

Core References

TopicDescriptionReference
OverviewProject purpose, structure, stack, when to usecore-overview
Nuxt configdefineNuxtConfig, modules, app head, nitro, experimentalcore-nuxt-config
App structureapp/, app.vue, NuxtLayout, NuxtPagecore-app-structure
Scriptsbuild, dev, generate, preview, typecheck, dev:pwacore-scripts
Constantsapp/constants, appName, appDescriptioncore-constants
ESLint@antfu/eslint-config, Nuxt appendcore-eslint

Features

TopicDescriptionReference
LayoutsLayout system, definePageMeta layoutfeatures-layouts
ComposablesuseCount, useState, auto-importfeatures-composables
Pinia stateuseUserStore, defineStore, HMRfeatures-pinia-state
Server APIdefineEventHandler, server/apifeatures-server-api
PWAVitePWA config, manifest, workbox, dev PWAfeatures-pwa
UnoCSSuno.config.ts, shortcuts, presets, iconsfeatures-unocss
ColorModeuseColorMode, DarkToggle, theme-color metafeatures-color-mode
ComponentsAuto-import, Counter, Footer, NuxtLinkfeatures-components
Client-onlyClientOnly, Suspense, useOnline, fallbackfeatures-client-only
Data fetchinguseFetch, useTimeAgo, async component datafeatures-data-fetching

Best Practices

TopicDescriptionReference
RoutingFile-based routing, dynamic/catch-all routesbest-practices-routing
Page metadefinePageMeta, layout selectionbest-practices-page-meta

Comments

Markdown supported