enijar/laravel-react-spa

Single page application boilerplate using laravel and react

Laravel React SPA

Starting boilerplate for building a single page application using Laravel as an API and React in the front end.

This is using an optimized webpack config and

Running

Setup default ENV variables, run:

cp .env.example .env

Install PHP dependencies, run:

composer install

Generate app key, run:

php artisan key:generate

Generate JWT secret key, run:

php artisan jwt:secret

If you are using Docker, setup your database in docker-compose.yml and run:

docker-compose up

Database

Setup database tables and default data.

By default the ENV variables will be setup to use the MySQL service inside the Docker container.

To seed the database, run:

docker-compose exec app php artisan migrate:fresh --seed

If you are using a MySQL database outside of the Docker container, run:

php artisan migrate:fresh --seed

Adding Packages

To install additional PHP/Node.JS dependencies you will need to execute these inside the Docker container.

Install PHP dependencies inside the Docker container

docker-compose exec app composer require `package_name`

Install Node.JS dependencies inside the Docker container

docker-compose exec node npm add `package_name`

Deploying to Staging/Production

Follow the steps outlined in the Running section (the Docker step is optional). Then run:

npm run build

Make sure www-data owns the correct directories, run:

chown www-data:www-data -R storage bootstrap public

Redis

If you're using redis, make sure you use a different instances for storage / caching otherwise it can create conflicts. Make sure you're running redis on a port that is available as well.