cretueusebiu / laravel-vue-spa
A Laravel-Vue SPA starter project template.
Installs: 18 746
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3 042
Watchers: 144
Forks: 961
Open Issues: 15
Type:project
Requires
- php: ^7.3|^8.0
- fideloper/proxy: ^4.4
- fruitcake/laravel-cors: ^2.0
- guzzlehttp/guzzle: ^7.0.1
- laravel/framework: ^8.54
- laravel/socialite: ^5.2
- laravel/tinker: ^2.6
- laravel/ui: ^3.3
- tymon/jwt-auth: dev-develop
Requires (Dev)
- doctrine/dbal: ^2.13
- facade/ignition: ^2.5
- fakerphp/faker: ^1.9.1
- laravel/dusk: ^6.17
- mockery/mockery: ^1.4.2
- nunomaduro/collision: ^5.0
- phpunit/phpunit: ^9.3.3
README
A Laravel-Vue SPA starter kit.
Features
- Laravel 8
- Vue + VueRouter + Vuex + VueI18n + ESlint
- Pages with dynamic import and custom layouts
- Login, register, email verification and password reset
- Authentication with JWT
- Socialite integration
- Bootstrap 5 + Font Awesome 5
Installation
composer create-project --prefer-dist cretueusebiu/laravel-vue-spa
- Edit
.env
and set your database connection details - (When installed via git clone or download, run
php artisan key:generate
andphp artisan jwt:secret
) php artisan migrate
npm install
Usage
Development
npm run dev
Production
npm run build
Socialite
This project comes with GitHub as an example for Laravel Socialite.
To enable the provider create a new GitHub application and use https://example.com/api/oauth/github/callback
as the Authorization callback URL.
Edit .env
and set GITHUB_CLIENT_ID
and GITHUB_CLIENT_SECRET
with the keys form your GitHub application.
For other providers you may need to set the appropriate keys in config/services.php
and redirect url in OAuthController.php
.
Email Verification
To enable email verification make sure that your App\User
model implements the Illuminate\Contracts\Auth\MustVerifyEmail
contract.
Testing
# Run unit and feature tests vendor/bin/phpunit # Run Dusk browser tests php artisan dusk
Changelog
Please see CHANGELOG for more information what has changed recently.