arch-nuxt-lite

arch-nuxt-lite（Vitesse Lite）是轻量级 Vite + Vue 3 SPA 起步模板：通过 unplugin-vue-router 实现基于文件的路由，组件与组合式函数自动导入，UnoCSS、VueUse 和 Vitest。无 SSR、i18n、布局、SSG、PWA 或 Markdown。适用于简单的纯客户端应用；如需 SSR，请使用 arch-nuxt 或 Nuxt。

该技能基于 vitesse-lite（arch-nuxt-lite 源码），生成于 2026-01-30。

推荐实践：

• 优先使用 Vite + unplugin-vue-router 实现基于文件的路由；将路由放在 src/pages 中
• 在导入中使用 ~/ 别名指向 src/
• 使用 VueUse（useDark、useToggle、useCounter 等）以及 src/composables 中的组合式函数；全部自动导入

核心参考

主题	描述	参考
概览	项目用途、结构、技术栈、适用场景	core-overview
应用结构	入口、RouterView、路径别名、App.vue	core-app-structure
Vite 配置	defineConfig、插件、别名、Vitest	core-vite-config
脚本	build、dev、lint、typecheck、preview、test	core-scripts
CI	GitHub Actions — build、test、lint、typecheck 矩阵	core-ci
ESLint	@antfu/eslint-config、unocss、formatters、pnpm	core-eslint

特性

主题	描述	参考
路由	unplugin-vue-router、基于文件的路由、useRoute/useRouter、类型化参数	features-routing
组件	unplugin-vue-components、自动导入、UnoCSS 图标	features-components
组合式函数	unplugin-auto-import、composables 目录、深色模式（useDark、useToggle）	features-composables
UnoCSS	uno.config.ts、快捷方式、预设、图标、Web 字体	features-unocss
测试	Vitest、jsdom、使用 @vue/test-utils 的组件测试	features-testing
部署	Netlify、netlify.toml、SPA 重定向	features-deploy

最佳实践

主题	描述	参考
路由	基于文件的路由模式、动态/全捕获路由	best-practices-routing