151 lines
5.3 KiB
Markdown
151 lines
5.3 KiB
Markdown
<p align='center'>
|
||
<img src='https://repository-images.githubusercontent.com/286295150/b1b1be80-354a-11eb-87c0-5dc96cae2bd9' alt='Vitess - Opinionated Vite Starter Template' width='600'/>
|
||
</p>
|
||
|
||
<p align='center'>
|
||
<em>Mocking up web app with <b>⚡️Vitesse</b></em>
|
||
</p>
|
||
|
||
<br>
|
||
|
||
<p align='center'>
|
||
<a href="https://vitesse.netlify.app/">Live Demo</a>
|
||
</p>
|
||
|
||
<br>
|
||
|
||
## Features
|
||
|
||
- ⚡️ [Vue3](https://github.com/vuejs/vue-next), [Vite](https://github.com/vitejs/vite), [pnpm](https://pnpm.js.org/), [ESBuild](https://github.com/evanw/esbuild) - born with fastness
|
||
|
||
- 🗂 [File based routing](./src/pages)
|
||
|
||
- 📦 [Components auto importing](./src/components)
|
||
|
||
- 📲 [PWA](https://github.com/antfu/vite-plugin-pwa)
|
||
|
||
- 🎨 [TailwindCSS **v2.0**](https://blog.tailwindcss.com/tailwindcss-v2) with dark mode out-of-box
|
||
|
||
- 😃 [Use icons from any icon sets, with no compromise](./src/components)
|
||
|
||
- 🌍 [i18n ready](./locales)
|
||
|
||
- 🗒 [Markdown Support](https://github.com/antfu/vite-plugin-md)
|
||
|
||
- 🔥 Use the [new `<script setup>` style](https://github.com/vuejs/rfcs/pull/227)
|
||
|
||
- 🖨 Server-side generation (SSG) via [vite-ssg](https://github.com/antfu/vite-ssg)
|
||
|
||
- 🦾 TypeScript, of course
|
||
|
||
- ☁️ Deploy on Netlify, zero-config
|
||
|
||
<br>
|
||
|
||
## Pre-packed
|
||
|
||
### UI Frameworks
|
||
|
||
- [Tailwind CSS](https://tailwindcss.com/) - with built-in dark mode!
|
||
- [Tailwind Typography](https://github.com/tailwindlabs/tailwindcss-typography) - Typography for Tailwind
|
||
|
||
### Icons
|
||
|
||
- [Iconify](https://iconify.design) - use icons from any icon sets [🔍Icônes](https://icones.netlify.app/)
|
||
- [PurgeIcons](https://github.com/antfu/purge-icons) - bundles only the icons that you use
|
||
|
||
### Plugins
|
||
|
||
- [Vue Router](https://github.com/vuejs/vue-router)
|
||
- [vite-plugin-voie](https://github.com/vamplate/vite-plugin-voie) - file system based routing
|
||
- [vite-plugin-components](https://github.com/antfu/vite-plugin-components) - components auto import
|
||
- [vite-plugin-pwa](https://github.com/antfu/vite-plugin-pwa) - PWA
|
||
- [vite-plugin-md](https://github.com/antfu/vite-plugin-md) - Markdown as components / components in Markdown
|
||
- [markdown-it-shiki](https://github.com/antfu/markdown-it-shiki) - [Shiki](https://github.com/shikijs/shiki) for syntax highlighting
|
||
- [vue-i18n](https://github.com/intlify/vue-i18n-next) - internationalization
|
||
- [VueUse](https://github.com/antfu/vueuse) - collection of useful composition APIs
|
||
|
||
### Coding Style
|
||
|
||
- Use Composition API with [`<script setup>` SFC](https://github.com/vuejs/rfcs/pull/227)
|
||
- [ESLint](https://eslint.org/) with [@antfu/eslint-config-vue](https://github.com/antfu/eslint-config), single quotes, no semi.
|
||
|
||
### Dev tools
|
||
|
||
- [TypeScript](https://www.typescriptlang.org/)
|
||
- [Vue TypeScript Plugin](https://github.com/znck/vue-developer-experience/tree/master/packages/typescript-plugin-vue) - better type support for Vue
|
||
- [pnpm](https://pnpm.js.org/) - fast, disk space efficient package manager
|
||
- [vite-ssg](https://github.com/antfu/vite-ssg) - Server-side generation
|
||
- [Netlify](https://www.netlify.com/) - deploy
|
||
- [VS Code Extensions](./.vscode/extensions.json)
|
||
- [Iconify IntelliSense](https://marketplace.visualstudio.com/items?itemName=antfu.iconify)
|
||
- [i18n Ally](https://marketplace.visualstudio.com/items?itemName=antfu.i18n-ally)
|
||
- [Tailwind CSS IntelliSense](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)
|
||
- [Vetur](https://marketplace.visualstudio.com/items?itemName=octref.vetur)
|
||
- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-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 are also welcome!
|
||
|
||
- [vitesse-lite](https://github.com/kn0wn/vitesse-lite) by [@kn0wn](https://github.com/kn0wn)
|
||
|
||
## Try it now!
|
||
|
||
### Github Template
|
||
|
||
[Create a repo from this template on Github](https://github.com/antfu/vitesse/generate).
|
||
|
||
### Clone to local
|
||
|
||
If you prefer to do it manually with the cleaner git history
|
||
|
||
```bash
|
||
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
|
||
|
||
- [ ] Rename `name` field in `package.json`
|
||
- [ ] Change the author name in `LICENSE`
|
||
- [ ] Change the title in `index.html`
|
||
- [ ] Change the favicon in `public`
|
||
- [ ] Remove the `.github` folder which contains the funding info
|
||
- [ ] Clean up the READMEs and remove routes
|
||
|
||
And, enjoy :)
|
||
|
||
## Usage
|
||
|
||
### Development
|
||
|
||
Just run and visit http://localhost:3333
|
||
|
||
```bash
|
||
pnpm dev
|
||
```
|
||
|
||
### Build
|
||
|
||
To build the App, run
|
||
|
||
```bash
|
||
pnpm build
|
||
```
|
||
|
||
And you will see the generated file in `dist` that ready to be served.
|
||
|
||
### Deploy on Netlify
|
||
|
||
Go to [Netlify](https://app.netlify.com/start) and select your clone, `OK` along the way, and your App will be live in a minute.
|
||
|
||
## Why
|
||
|
||
I have created several Vite apps recently. Setting the configs up is kinda the bottleneck for me to make the ideas simply come true within a very short time.
|
||
|
||
So I made this starter template for myself to create apps more easily, along with some good practices that I have learned from making those apps. It's strongly opinionated, but feel free to tweak it or even maintains your own forks. [(see community maintained variation forks)](#variations)
|