antfu-collective /vitesse

🏕 Opinionated Vite + Vue Starter Template

★ 9,435⑂ 953👁 88⑃ 238● 234▤ 0
TypeScriptMITCreated 2020-08-09vitesse.netlify.app/
+0
日增长
9,435
stars
953
forks
88
watchers
238
prs
234
issues
0
releases

README

快速地Vitesse 创建 Web 应用






在线 Demo




 Note: 本模板创建于 Vue 3 和 Vite 的早期过渡时期。目前,如果您正在寻求更好的 Vue 开发体验和更持续的维护,我们建议您使用 Nuxt 3 来代替(它也可以根据需要使用 SPA 或 SSG)。本模板仍会作为参考缓慢地维护下去,但将不会有太多的更新。




English | 简体中文




 特性

- ⚡️ Vue 3, Vite, pnpm, Rolldown - 就是快!

- 🗂 基于文件的路由

- 📦 组件自动化加载

- 🍍 使用 Pinia 的状态管理

- 📑 布局系统

- 📲 PWA

- 🎨 UnoCSS - 高性能且极具灵活性的即时原子化 CSS 引擎

- 😃 各种图标集为你所用

- 🌍 I18n 国际化开箱即用

- 🗒 Markdown 支持

- 🔥 使用 新的  语法

- 📥 API 自动加载 - 直接使用 Composition API 无需引入

- 🖨 使用 vite-ssg 进行服务端生成 (SSG)

- 🦔 使用 beasties 的生成关键 CSS

- 🦾 TypeScript, 当然

- ⚙️ 结合 GitHub Actions,使用 Vitest 进行单元测试, Cypress 进行 E2E 测试

- ☁️ 零配置部署 Netlify



 预配置

 UI 框架

- UnoCSS - 高性能且极具灵活性的即时原子化 CSS 引擎

 Icons

- Iconify - 使用任意的图标集,浏览:🔍Icônes
- UnoCSS 的纯 CSS 图标方案

 插件

- Vue Router
  - unplugin-vue-router - 以文件系统为基础的路由
  - vite-plugin-vue-layouts - 页面布局系统
- Pinia - 直接的, 类型安全的, 使用 Composition API 的轻便灵活的 Vue 状态管理
- unplugin-vue-components - 自动加载组件
- unplugin-auto-import - 直接使用 Composition API 等,无需导入
- vite-plugin-pwa - PWA
- unplugin-vue-markdown - Markdown 作为组件,也可以让组件在 Markdown 中使用
  - markdown-it-prism - Prism 的语法高亮
  - prism-theme-vars - 利用 CSS 变量自定义 Prism.js 的主题
- Vue I18n - 国际化
  - unplugin-vue-i18n - Vue I18n 的 Vite 插件
- VueUse - 实用的 Composition API 工具合集
- vite-ssg-sitemap - 站点地图生成器
- @vueuse/head - 响应式地操作文档头信息
- vite-plugin-vue-devtools - 旨在增强Vue开发者体验的Vite插件

 编码风格

- 使用 Composition API 地  SFC 语法
- ESLint 配置为 @antfu/eslint-config, 单引号, 无分号.

 开发工具

- TypeScript
- Vitest - 基于 Vite 的单元测试框架
- Cypress - E2E 测试
- pnpm - 快, 节省磁盘空间的包管理器
- vite-ssg - 服务端生成
  - beasties - 关键 CSS 生成器
- Netlify - 零配置的部署
- VS Code 扩展
  - Vite - 自动启动 Vite 服务器
  - Volar - Vue 3  IDE 支持
  - Iconify IntelliSense - 图标内联显示和自动补全
  - i18n Ally - 多合一的 I18n 支持
  - ESLint

 衍生项目

由于这个模板的业务场景非常的局限,下面提供了一个精心策划的列表,列出了社区维护的具有不同偏好和功能集的衍生项目。也可以看看他们。当然也欢迎你 PR 提供自己的项目!

 官方

- vitesse-lite - Vitesse 的轻量版本
- vitesse-nuxt3 - Vitesse 的 Nuxt 3 版本
- vitesse-nuxt-bridge - Vitesse 的 Nuxt2 桥接版本
- vitesse-webext - 开箱即用的浏览器扩展 vite 模板

 社区

查看英文版

 现在可以试试!

 Vitesse 需要 Node.js 22.22.2+、24.15.0+ 或 26+

 GitHub 模板

使用这个模板创建仓库.

 克隆到本地

如果您更喜欢使用更干净的 git 历史记录手动执行此操作

bash
npx degit antfu-collective/vitesse my-vitesse-app
cd my-vitesse-app
pnpm i  如果你没装过 pnpm, 可以先运行: npm install -g pnpm


 清单

使用此模板时,请尝试按照清单正确更新您自己的信息

- [ ] 在 LICENSE 中改变作者名
- [ ] 在 App.vue 中改变标题
- [ ] 在 vite.config.ts 更改主机名
- [ ] 在 public 目录下改变favicon
- [ ] 移除 .github 文件夹中包含资助的信息
- [ ] 整理 README 并删除路由

紧接着, 享受吧 :)

 使用

 开发

只需要执行以下命令就可以在 http://localhost:3333 中看到

bash
pnpm dev


 构建

构建该应用只需要执行以下命令

bash
pnpm build


然后你会看到用于发布的 dist 文件夹被生成。

 部署到 Netlify

前往 Netlify 并选择你的仓库, 一路 OK 下去,稍等一下后,你的应用将被创建.

Top issues

Discussions

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON