slava-arapov/starter-laravel-vue-frontend

Laravel/Vue 2 Starter (Frontend)

This template is designed for a quick start of a new Laravel/Vue project.

The starter is decoupled into two parts:

• Backend Laravel API
• Frontend Vue.js SPA (you are here)

Features and Dependencies

• Vue 3 (Options API), Vue Router 4, Vuex 4, ESLint, Vite
• Vue Components with TypeScript declarations and vue-tsc installed
• Unit tests (Vitest)
• Vuetify 3 Beta
• VeeValidate 4
• Material Design Icons — SVG custom import
• User Authentication and Authorization using Laravel Sanctum
• Login, Register, Email Verification and Password Reset using Laravel Fortify
• Administration Dashboard
• Users CRUD
• Basic current User Update and avatar upload
• Auth, Guest, Admin Middleware
• Pagination
• Dark/Light/System Theme Switch

System Requirements

• Node.js >= 16.0

Project Setup

1. Clone the repository

   git clone https://github.com/slava-arapov/starter-laravel-vue-frontend.git
   cd starter-laravel-vue-frontend

2. Copy your .env file for local development or production

   cp .env.local.example .env.local
   cp .env.production.local.example .env.production.local

3. Edit your .env file. Make sure your API URL added

   VITE_APP_API_URL=http://localhost # for local development, Laravel Sail default
   VITE_APP_API_URL=https://api.yourappname.com # for production build

4. Install dependencies

   npm install

Compiles and hot-reloads for development

npm run dev

Compiles and minifies for production

npm run build

Runs tests

npm run test

Runs tests with coverage enabled

npm run coverage

Lints and fixes files

npm run lint

Runs vue-tsc type-checking tool

npm run tsc

Customize configuration

See Configuration Reference.

Credits

This starter is designed using the instructions at https://laravelvuespa.com. I highly recommend to check out this resource and to support @garethredfern.

License

This starter is open-sourced software licensed under the MIT license.