README

A Laravel, Vue & Tailwind SPA starter project template.

Please note

This project is based on an older version of cretueusebiu/laravel-vue-spa. All credits should go to Cretu Eusebiu, this version only contains some changes for the use of Tailwind and to fit our own needs.

Features

Laravel 8
Vue + VueRouter + Vuex + VueI18n (disabled for now) + ESlint
Pages with dynamic import and custom layouts
Login, register, email verification and password reset
Authentication with JWT
Socialite integration (disabled for now)
Tailwind + Font Awesome 5
Basic Tailwind design for some pages

To Do - v1.0.0

~~Upgrade to Laravel 8~~
~~Fix npm hot reloading~~
~~Redesign auth pages~~
~~Redesign dashboard pages~~
~~Remove redundant components~~
Sidebar icons & sidebar toggle
Create VueI18n components and implement them
Create Socialite components for GitHub
Fix all tests
Add more components
Create a changelog and track changes

Installation

composer create-project --prefer-dist skrypt-nl/laravel-vue-tailwind-spa
Edit .env and set your database & email connection details
(When installed via git clone or download, run php artisan key:generate and php artisan jwt:secret)
php artisan migrate
npm install

Usage

Development

# Build and watch
npm run watch

# Serve with hot reloading
npm run hot

Production

npm run production

Socialite

Socialite has been integrated, but hasn't been added by default on the login & sign up pages.

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

Currently, the tests are not working properly as these were created for the original project. We will do our best to get them up and running as soon as possible again.

# Run unit and feature tests
vendor/bin/phpunit

# Run Dusk browser tests
php artisan dusk

Changelog

Coming soon

~~Please see CHANGELOG for more information what has changed recently.~~

skrypt-nl / laravel-vue-tailwind-spa

Maintainers

Details