Cyenoch / vitesse-tauri

Mocking up desktop app with Vitesse^(speed) and Tauri^(lightest)

Note: This template is created during the early transition of Vue 3 and Vite. At this moment, if you are seeking for better Vue developer experience and more consistent maintenance, instead (it also works perfectly with SPA or SSG as needed). This template still serves as a reference, but expect slower updates.

English | 简体中文

Features

• ⚡️ Tauri, Vue 3, Vite, pnpm, esbuild - born with fastness

• 🗂 File based routing

• 📦 Components auto importing

• 🍍 State Management via Pinia

• 📑 Layout system

• 🎨 UnoCSS - the instant on-demand atomic CSS engine

• 😃 Use icons from any icon sets with classes

• 🌍 I18n ready

• 🔎 Component Preview

• 🔥 Use the new <script setup> syntax

• 📥 APIs auto importing - use Composition API and others directly

• 🖨 Static-site generation (SSG) via vite-ssg

• 🦔 Critical CSS via critters

• 🔤 Webfont self-hosting

• 🦾 TypeScript, of course

• ⚙️ Unit Testing with Vitest

Pre-packed

Platform

• Tauri - Build an optimized, secure, and frontend-independent application for multi-platform deployment.

UI Frameworks

• UnoCSS - The instant on-demand atomic CSS engine.

Icons

• Iconify - use icons from any icon sets 🔍Icônes
• Pure CSS Icons via UnoCSS

Plugins

• Vue Router
  • unplugin-vue-router - file system based routing
  • vite-plugin-vue-layouts - layouts for pages
• Pinia - Intuitive, type safe, light and flexible Store for Vue using the composition api
• unplugin-vue-components - components auto import
• unplugin-auto-import - Directly use Vue Composition API and others without importing
• unplugin-vue-macros - Explore and extend more macros and syntax sugar to Vue.
• unplugin-vue-markdown - Markdown as components / components in Markdown
  • markdown-it-shikiji - Shiki for syntax highlighting
• Vue I18n - Internationalization
  • unplugin-vue-i18n - unplugin for Vue I18n
• VueUse - collection of useful composition APIs
• vite-ssg-sitemap - Sitemap generator
• vite-plugin-webfont-dl - Zero-config webfont (Google Fonts) downloader and injector to improve website's performance.
• vite-plugin-vue-devtools - Designed to enhance the Vue developer experience.

Coding Style

• Use Composition API with <script setup> SFC syntax
• ESLint with @antfu/eslint-config, single quotes, no semi.

Dev tools

• TypeScript
• Vitest - Unit testing powered by Vite
• WebdriverIO - Next-gen browser and mobile automation test framework for Node.js.
• pnpm - fast, disk space efficient package manager
• vite-ssg - Static-site generation
  • critters - Critical CSS
• VS Code Extensions
  • Vite - Fire up Vite server automatically
  • Volar - Vue 3 <script setup> IDE support
  • Iconify IntelliSense - Icon inline display and autocomplete
  • i18n Ally - All in one i18n support
  • ESLint

Variations

As this template is strongly opinionated, the following provides a curated list for community-maintained variations with different preferences and feature sets. Check them out as well. PR to add yours is also welcome!

Official

• vitesse-lite - Lightweight version of Vitesse
• vitesse-nuxt3 - Vitesse for Nuxt 3
• vitesse-nuxt-bridge - Vitesse for Nuxt 2 with Bridge
• vitesse-webext - WebExtension Vite starter template

Community

• vitesse-ssr-template by @frandiox - Vitesse with SSR
• vitailse by @zynth17 - Like Vitesse but with TailwindCSS
• vitesse-modernized-chrome-ext by @xiaoluoboding - ⚡️ Modernized Chrome Extension Manifest V3 Vite Starter Template
• vitesse-stackter-clean-architect by @shamscorner - A modular clean architecture pattern in vitesse template
• vitesse-enterprise by @FranciscoKloganB - Consistent coding styles regardless of team-size.
• vitecamp by @nekobc1998923 - Like Vitesse but without SSG/SSR/File based routing, includes Element Plus
• vitesse-h5 by @YunYouJun - Vitesse for Mobile
• bat by @olgam4 - Vitesse for SolidJS
• vitesse-solid by @xbmlz - Vitesse for SolidJS, build with SolidStart, includes UnoCSS and HopeUI.

Try it now!

Vitesse requires Node >=14.18

GitHub Template

Create a repo from this template on GitHub.

Clone to local

If you prefer to do it manually with the cleaner git history

npx degit antfu/vitesse my-vitesse-app
cd my-vitesse-app
pnpm i # If you don't have pnpm installed, run: npm install -g pnpm

Checklist

When you use this template, try follow the checklist to update your info properly

Tauri related:

• Rust development environment is a must

• Change the name in Cargo.toml
• Change the config in tauri.conf.json (follow: Tauri Configuration)
• Change the icons under the src-tauri/icons folder

Web related:

• Change the author name in LICENSE
• Change the title in App.vue
• Change the hostname in vite.config.ts
• Change the favicon under the public folder
• Remove the .github folder which contains the funding info
• Clean up the READMEs and remove routes

And, enjoy :)

Usage

Development

Just run:

pnpm tauri dev

Build

To build the App, run

pnpm tauri build

And you will see the generated file in dist that ready to be served. and the executable file under here