• Stars
    star
    401
  • Rank 107,625 (Top 3 %)
  • Language
    TypeScript
  • License
    MIT License
  • Created about 4 years ago
  • Updated 6 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Opinionated Vite + Vue 3 + TypeScript + Tailwind CSS starter template w/ tests and CI.

Vite + Vue 3 + 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 and documentation of how to do things but minimal cruft to delete to get you going.

Please check out the homepage for full docs. A detailed changelog is available. This repository is also mirrored on GitLab.

Features

  • Vue 3
  • Pinia store (fully typed Vuex store is available up to template version 1.13)
  • Routing using vue-router 4
  • TypeScript 5
  • Automatic package and component imports w/ unplugin-auto-import and unplugin-vue-components
  • Tailwind CSS 3 w/ following plugins and configuration preinstalled:
    • @tailwindcss/aspect-ratio
    • @tailwindcss/typography
    • @tailwindcss/forms
  • PostCSS 8 w/ postcss-nesting plugin and cssnano for minimizing production CSS
  • Eslint
  • Prettier
  • Alias @ to <project_root>/src
  • Predefined and fully typed 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)
  • Vitest unit + component tests
  • GitHub workflows
    • Renovatebot for keeping up with dependencies
    • Automated unit + component tests
    • Automated e2e tests
    • Coverage reporting in PR comments (example)
  • GitLab CI config available up to versions 2.x

Elsewhere

Contributing

Contributions are welcome! Please follow the code of conduct when interacting with others.