geoffselby/laravel-jwt-boilerplate

Rapidly build an API with Laravel and JWT authentication.

v1.0.0 2019-09-10 17:37 UTC

Requires

• php: ^7.1.3
• barryvdh/laravel-cors: ^0.11.3
• fideloper/proxy: ^4.0
• laravel/framework: ^6.0
• laravel/tinker: ^1.0
• tymon/jwt-auth: 1.0.*

Requires (Dev)

• beyondcode/laravel-dump-server: ^1.0
• filp/whoops: ^2.0
• fzaninotto/faker: ^1.4
• mockery/mockery: ^1.0
• nunomaduro/collision: ^3.0
• phpunit/phpunit: ^7.5

MIT

• Geoff Selby

• rest
• api
• boilerplate
• auth
• laravel
• jwt

README

This boilerplate is meant to be used to rapidly build an API with Laravel using JWT authentication.

Features inlude:

• Full authentication suite with JWT-Auth - tymondesigns/jwt-auth
• CORS handling with Laravel-CORS - barryvdh/laravel-cors
• Email verification handling done for you 🙌

Installation

First, run composer create-project geoffselby/laravel-jwt-boilerplate

Then, have a 🍺 and wait for composer to do it's thing.

Once you have installed the boilerplate with Composer, set up your database in .env and run the php artisan migrate command to migrate the database. The JWT secret is generated automatically when you install the boilerplate with Composer.

Usage

API Development

Develop your API the same way you would normally develop a Laravel powered API with JWT authentication implemented out of the box.

Frontend Implementation

This boilerplate is designed so that you can use whatever frontend implementation you choose (i.e. Create React App or Vue CLI) as long as you implement authentication correctly.

Create React App example: Coming Soon

Enabling CORS

By default, CORS is enabled for all routes since it is assumed you are using a seperate front end.

Check the Laravel-CORS docs for more info.

Contributing

If you would like to contribute to this project, submit a PR for review. A more detailed contribution guide is in the works.

License

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