Vue Boilerplate with Vite, Tailwind CSS, Pinia, and Axios
Menghour Say
Posted on February 10, 2024
Iād like to share the most recent Vuejs boilerplate with you here. When you clone this repository, the boilerplate of Vue v3, Typescript, Vite, Vue Router, Pinia, Axios, Tailwind CSS, and Vue i18n for buildings efficient, faster, maintainable, and scalable for enterprise applications.
š Table of Contents
- ā What's Included?
- šļø Core Dependencies
- šļø Project Structure
- š Getting Started
- š” Scripts
- š License
ā What's Included?
- [x] Authentication: Provides a secure login system for users.
- [x] Authorization: Implements role-based access control to manage user permissions.
- [x] Multiple Language: Supports localization and enables users to switch between different languages.
- [x] Theme (Light/Dark/System): Offers a choice of light, dark, or system-based theme for a personalized user experience.
- [x] Form Validation: Includes form validation functionality to ensure data integrity and improve user experience.
- [x] Error Handling: Handles and displays error messages in a user-friendly manner.
- [x] API Integration: Integrates with external APIs to fetch data and provide dynamic content.
- [ ] Responsive Design: Ensures the application is optimized for various screen sizes and devices.
- [ ] Testing: Includes a test suite with unit tests and integration tests for reliable code quality.
- [ ] Documentation: Provides comprehensive documentation to guide developers and users.
šļø Core Dependencies
Library | Version | Description |
---|---|---|
Vue | A progressive JavaScript framework for building user interfaces. | |
Vite | Next-generation frontend build tooling for fast and efficient development. | |
Typescript | A superset of JavaScript that enhances the development experience with static typing. | |
Vue Router | Official router for Vue.js, used for managing application routes. | |
Vue i18n | Internationalization plugin for Vue.js applications, enabling multi-language support. | |
Vue Query | A data-fetching and state management library for Vue.js, with powerful data-fetching capabilities. | |
Pinia | An intuitive store for Vue.js applications, providing centralized state management. | |
Axios | Promise-based HTTP client for making API requests. | |
Tailwind CSS | A highly customizable CSS framework for rapid web development. |
šļø Project Structure
āāā public/
ā āāā assets
ā ā āāā fonts
| | āāā images
ā āāā favicon.ico
āāā src
ā āāā assets
ā ā āāā images
ā ā āāā styles
ā āāā components
ā ā āāā PrivateOutlet
ā ā āāā ui
ā ā āāā ...
ā āāā constants
ā āāā hooks
ā āāā http
ā ā āāā axios
ā ā āāā index.ts
ā āāā layouts
ā ā āāā MainLayout.ts
ā ā āāā ...
ā āāā locales
ā ā āāā en
ā ā āāā km
ā āāā modules
ā ā āāā authentication
ā ā āāā current-user
ā ā āāā dashboard
ā ā āāā ...
ā āāā router
ā ā āāā privateRoutes.ts
ā ā āāā publicRoutes.ts
ā ā āāā ...
ā āāā services
ā āāā types
ā āāā utils
ā ā āāā common
ā ā āāā crypto
ā ā āāā ...
ā āāā App.ts
ā āāā main.ts
āāā types
āāā package.json
āāā ...
.
š Getting Started
Prerequisites
-
Node Js version
v20.10.0
. The current Long Term Support (LTS) release is an ideal starting point. - Visual Studio Code. Visual Studio Code is the free and open-sourced code editor. It is one of the top most editor used especially for JavaScript application development.
Recommended Plugin for VSCode
- TypeScript Vue Plugin (Volar)
- Vue Language Features (Volar)
- Tailwind CSS IntelliSense
- Prettier - Code formatter
- Prettier ESLint
- Auto Rename Tag
- Code Spell Checker
- ESLint
- Git Graph
- GitLens ā Git supercharged
Installation
-
Clone this repository to your computer:
https://github.com/saymenghour/vue3-enterprise-boilerplate.git cd vue3-enterprise-boilerplate code .
-
Run command below to ignore git case-sensitive filename
git config --global core.ignorecase false
-
From the project's root directory, install the required packages (dependencies):
pnpm install
-
Create environment files:
cp .env.example .env
Set up the environment variables.
-
To run the app on your local machine:
pnpm dev
-
Build for production
pnpm build
Happy Coding :)
š” Scripts
The following scripts are available:
Script | Action |
---|---|
pnpm install |
Installs the project dependencies. |
pnpm dev |
Runs the application in development mode. |
pnpm build |
Builds the production-ready optimized bundle. |
pnpm preview |
Starts the preview server using Vite. |
pnpm lint |
Runs ESLint to lint the project files and fix any issues. |
pnpm format |
Formats the source code using Prettier. |
š License
This project is licensed under the MIT License.
Posted on February 10, 2024
Join Our Newsletter. No Spam, Only the good stuff.
Sign up to receive the latest update from our blog.