https://github.com/kkamara/php-reactjs-boilerplate
(2021) A Laravel 12.x boilerplate with ReactJS 19 Redux SPA.
https://github.com/kkamara/php-reactjs-boilerplate
api react reactjs testing tests web web-app
Last synced: 2 months ago
JSON representation
(2021) A Laravel 12.x boilerplate with ReactJS 19 Redux SPA.
- Host: GitHub
- URL: https://github.com/kkamara/php-reactjs-boilerplate
- Owner: kkamara
- License: bsd-3-clause
- Created: 2021-08-14T18:03:53.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2026-03-20T00:30:40.000Z (3 months ago)
- Last Synced: 2026-03-20T09:25:25.106Z (3 months ago)
- Topics: api, react, reactjs, testing, tests, web, web-app
- Language: PHP
- Homepage: https://github.com/kkamara/php-reactjs-boilerplate/actions
- Size: 5.79 MB
- Stars: 1
- Watchers: 0
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# PHP ReactJS Boilerplate [](https://github.com/kkamara/php-reactjs-boilerplate/actions/workflows/build.yml)
(2021) A Laravel 13.x boilerplate with ReactJS 19 Redux SPA.
* [Using Postman?](#postman)
* [Installation](#installation)
* [Usage](#usage)
* [API Documentation](#api-documentation)
* [Feature Tests](#feature-tests)
* [Sending & Viewing Test Emails](#test-emails)
* [Misc.](#misc)
* [Contributing](#contributing)
* [License](#license)
[Get Postman HTTP client](https://www.postman.com/).
[Postman API Collection for PHP ReactJS Boilerplate](https://github.com/kkamara/php-reactjs-boilerplate/blob/main/database/php-reactjs-boilerplate.postman_collection.json).
[Postman API Environment for PHP ReactJS Boilerplate](https://github.com/kkamara/php-reactjs-boilerplate/blob/main/database/php-reactjs-boilerplate.postman_environment.json).
## Installation
* [XAMPP: Apache, MariaDB (MySQL alternative), and PHP](https://www.apachefriends.org/)
* If you find that the MariaDB XAMPP service fails to start (I get this on Windows) then install MySQL manually [here](https://dev.mysql.com/downloads/mysql/)
* [https://laravel.com/docs](https://laravel.com/docs)
```bash
# Create our environment file.
cp .env.example .env
# Update database values in .env file.
# Install our app dependencies.
composer i
php artisan key:generate
# Link storage/public to public/storage folder.
php artisan storage:link
# Before running the next command:
# Update your database details in .env
php artisan migrate:status --path=database/migrations/V1
php artisan migrate --path=database/migrations/V1 --seed
```
#### Frontend Installation
```bash
npm install --global yarn
yarn install
yarn build
```
## Usage
```bash
php artisan serve --port=8000
# Website accessible at http://localhost:8000
```
## API Documentation
```bash
php artisan route:list
```
View the API collection [here](https://documenter.getpostman.com/view/17125932/TzzAKvVe).
## Feature Tests
```bash
php artisan test --filter=API
```
View the feature test code [here](https://raw.githubusercontent.com/kkamara/php-reactjs-boilerplate/main/tests/Feature/API/UserTest.php).
## Sending & Viewing Test Emails
#### Requirements
- [Docker](https://www.docker.com)
```bash
docker run -p 8025:8025 -p 1025:1025 mailhog/mailhog
```
Ensure `MAIL_MAILER` setting in your `.env` file is set to `smtp`. After running the above command this app should now be able to connect to the Mailhog email server running through Docker.
## Misc.
* [See PHP ReactJS Boilerplate](https://github.com/kkamara/php-reactjs-boilerplate)
* [See ReactJS Native Mobile App Boilerplate](https://github.com/kkamara/ReactJSNativeMobileAppBoilerplate)
* [See MRVL Desktop](https://github.com/kkamara/mrvl-desktop)
* [See MRVL Web](https://github.com/kkamara/mrvl-web)
* [See PHP Docker Skeleton](https://github.com/kkamara/php-docker-skeleton)
* [See PHP Scraper](https://github.com/kkamara/php-scraper).
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
## License
[BSD](https://opensource.org/licenses/BSD-3-Clause)