Vite Typescript + Tailwind Starter
Simple, opinionated, fully typed, and production-ready project template for Vite.
This template is practical and batteries included but not overly complex or bloated. Also explicit configuration over magic; it should be easy to understand how everything works, strip out anything you don’t need, and fast to modify things to your needs.
Includes plenty of examples of how to do things but minimal cruft to delete to get you going.
Features
Vue 3
Fully typed Vuex 4 store
Routing using vue-router 4
TypeScript 4.3
Tailwind CSS 2.2 w/ JIT compiler + following plugins preinstalled
@tailwindcss/aspect-ratio
@tailwindcss/line-clamp
@tailwindcss/typography
@tailwindcss/forms
firefox-variant
PostCSS 8 w/ postcss-nesting plugin
Eslint
Prettier
Alias @ to <project_root>/src
Manually configured global components in main.ts
Predefined global variables:
VITE_APP_VERSION is read from package.json version at build time
VITE_APP_BUILD_EPOCH is populated as new Date().getTime() at build time
Using newest script setup syntax w/ Ref sugar (see the official Script Setup documentation and Ref Sugar RFC discussion)
Cypress.io e2e tests (configured similarly to vue-cli)
GitHub workflows
Dependabot
Automated e2e tests
GitLab CI
Notes
In order to take full advance of the new script setup sugar and full TypeScript support in Vue SFC templates (like in the screenshot above), you should disable Vetur and use Volar instead. (This is totally optional but recommended as it results much better DX!) See official IDE Support documentation.
If you need more than one parameter in the typed Vuex actions, use payload object instead of multiple parameters. For example:[Action.updateItem](
{ commit }: AugmentedActionContext,
payload: {
id: string
obj: Partial<MyItem>
}
): Promise<void>
Project setup and usage
Install dependencies:
yarn
Run development server:
yarn dev
Open Cypress test runner:
yarn test
Run Cypress tests in headless mode:
yarn test:ci
Build and preview built site locally:
yarn preview
Build:
yarn build