About This Project

This is a simple template for conveniently standing up full-stack projects. It is dockerized and is composed of:

• An app service layer that is using Laravel 11.x
  • ... and is using Apache as a web server.
• A separate frontend layer using React.
  • ... and is using Vite as a frontend build tool.
• A MySQL database.

When initially built, the Laravel application should be accessible at:

http://localhost:8000

... and the React application should be accessible at:

http://localhost:3000

Prerequisites

• Docker
• Ideally a Unix-based shell to be able to utilize the included Makefile.

Initially building the project

1. make init - This will initially build + start the project.

Continuously building the project

• make build - This will build the project.
• make start - This will start the project.
• make stop - This will stop the project.
• make restart - This will restart the project.
• make migrate-fresh-seed - This will blow away and run fresh database migrations.
• make build-assets - This will build the frontend assets for the laravel app.
• make test - This will run tests.
• make test-with-coverage - This will run tests with coverage printed to standard out.
• make test-with-coverage-html - This will run tests with coverage and open the coverage report in a browser.

Additional Makefile commands

• make ssh - This is a shortcut to shell into the app container.
• make list-routes - This is a shortcut to list what routes are available in the application.