mcpField
A
arch-nuxt-lite

arch-nuxt-lite

github.com/hairyfDevelopment2698 installsUpdated 2w ago
Repository

About arch-nuxt-lite

arch-nuxt-lite is a lightweight Vite and Vue 3 starter for client-only single-page apps. This skill documents its structure and practices, including file-based routing, auto-imports, styling, and testing.

Key features

  1. 01File-based routing with unplugin-vue-router
  2. 02Auto-imported components and composables
  3. 03UnoCSS styling and icons
  4. 04VueUse composables
  5. 05Vitest component testing
  6. 06SPA deployment guidance for Netlify

Use cases

  1. 01Starting a simple client-only Vue app
  2. 02Adding typed file-based routes
  3. 03Writing component tests with Vitest

Install

Copy the command and run it in a terminal.

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

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

Bundled files

References and scripts installed along with SKILL.md.

GENERATION.md
assets/
ci.yml
references/
best-practices-routing.md
core-app-structure.md
core-ci.md
core-eslint.md
core-overview.md
core-scripts.md
core-vite-config.md
features-components.md
features-composables.md
features-deploy.md
features-routing.md
features-testing.md
features-unocss.md

Details

From the project README

arch-nuxt-lite (Vitesse Lite) is the lightweight Vite + Vue 3 SPA starter: file-based routing via unplugin-vue-router, components and composables auto-import, UnoCSS, VueUse, and Vitest. No SSR, i18n, layouts, SSG, PWA, or Markdown. Prefer it for simple client-only apps; use arch-nuxt or Nuxt for SSR.

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

Recommended practices:

  • Prefer Vite + unplugin-vue-router for file-based routing; keep routes in src/pages
  • Use ~/ alias for src/ in imports
  • Use VueUse (useDark, useToggle, useCounter, etc.) and composables in src/composables; all auto-imported

Core References

TopicDescriptionReference
OverviewProject purpose, structure, stack, when to usecore-overview
App structureEntry, RouterView, path alias, App.vuecore-app-structure
Vite configdefineConfig, plugins, alias, Vitestcore-vite-config
Scriptsbuild, dev, lint, typecheck, preview, testcore-scripts
CIGitHub Actions — build, test, lint, typecheck matrixcore-ci
ESLint@antfu/eslint-config, unocss, formatters, pnpmcore-eslint

Features

TopicDescriptionReference
Routingunplugin-vue-router, file-based routes, useRoute/useRouter, typed paramsfeatures-routing
Componentsunplugin-vue-components, auto-import, UnoCSS iconsfeatures-components
Composablesunplugin-auto-import, composables dir, dark mode (useDark, useToggle)features-composables
UnoCSSuno.config.ts, shortcuts, presets, icons, web fontsfeatures-unocss
TestingVitest, jsdom, component tests with @vue/test-utilsfeatures-testing
DeployNetlify, netlify.toml, SPA redirectfeatures-deploy

Best Practices

TopicDescriptionReference
RoutingFile-based routing patterns, dynamic/catch-all routesbest-practices-routing

Comments

Markdown supported