Micool's Boilerplate Reference Project

Laravel project that uses JWT standard for authentication.

Getting started & Installation

This guide favors Ubuntu 20.4. For Windows user you can configure and enable WSL2 to run Ubuntu or use XAMPP.

WARNING: Please avoid using Windows 10 for development as the NPM behaviour becomes erratic, use WSL instead or other Linux based OS

Prerequisites

1. Git - latest

~$ sudo apt update
~$ sudo apt install git

2. PHP version ~7.4 & Composer ~2

~$ sudo apt update
~$ sudo apt dist-upgrade
~$ sudo apt install composer
~$ sudo apt-get update 
~$ sudo apt install php-xml 
~$ sudo apt-get install php-sqlite3
~$ sudo apt-get install php-curl php-mbstring php-pear php-dev
~$ sudo apt-get install php-mysql
~$ sudo apt-get install php-sqlite

3. MySQL 8
   • Download & install MySQL 8 [here](https://dev.mysql.com/downloads/installer/ MySQL Installer) (note: at the time of writing the link is v8 -- if it has changed please update this MD)
   • Or optionally use Docker

~$ docker run --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:8.0.22

4. NodeJs > 10.x.x (version installed is v14.5.3)

~$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh
~$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
~$ source ~/.bashrc
~$ nvm list-remote
~$ nvm install v14.15.4

5. .env File
   • Duplicate the .env.example and rename it to .env
   • Then define the values inside depending on your local setup

Running the project

~$ git clone https://github.com/meSmashsta/LaravelWithJWTAuth.git
~$ cd LaravelWithJWTAuth
~/LaravelWithJWTAuth$ composer install
~/LaravelWithJWTAuth$ php artisan key:generate
~/LaravelWithJWTAuth$ php artisan serve

Footnote

Have fun coding!