Laravel-Vue-SPA — Vue Starter Template

This is a Laravel + Vue single-page application (SPA) scaffold project, positioned as a starter for quickly building a front-end/back-end separated application with basic user functionality. The front end uses Vue and integrates VueRouter, Vuex, and VueI18n; pages use dynamic imports and custom layouts. Authentication uses JWT and covers login, registration, email verification, and password reset flows. The project includes GitHub as an example integration for Laravel Socialite. The styling layer uses Bootstrap 4 and Font Awesome 5.

The installation process requires first cloning the repository, configuring the database connection in .env, and then running php artisan key:generate, php artisan jwt:secret, php artisan migrate, and npm install in sequence. During development, you can use npm run watch to build and watch, or npm run hot to start hot reloading; for production builds, use npm run production.

Enabling email verification requires making the App\User model implement the Illuminate\Contracts\Auth\MustVerifyEmail contract. Enabling GitHub login requires creating a new GitHub application, setting https://example.com/api/oauth/github/callback as the authorization callback URL, and filling in GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET in .env; integrating other providers requires configuring the corresponding keys in config/services.php and setting the redirect URL in OAuthController.php.

The project is MIT licensed, allowing free use, modification, commercial use, and distribution of this version of the code; when distributing, the copyright notice and the full MIT license notice must be retained. Third-party assets such as demo images, fonts, and icons must be checked separately under their respective licenses; external services such as domains, hosting, and databases may incur additional charges.