This template project aim to start a new project with the hexagonal architecture.
The hexagonal architecture intends to separate an application: user-side ; business logic ; server-side. The application depends on the business logic and the architecture, but the business logic can't depends on something else than itself.
This boilerplate is built with React and Symfony for learning purpose. You can replace each part at your convenience.
We will use Docker to make a development environment with 5 services:
- NodeJS to build the frontend
- PHP 8.1 as interpreter for the backend stack
- Nginx as HTTP Server
- MySQL as DBMS
- Traefik as reverse proxy (to replace 127.0.0.1 or localhost with local hostname)
Rather than using GNU Make, fancy commands shortcuts are writen with Taskfile. You can install it via their website, they also provide a convenient script to install it on Linux based system:
sudo sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b /usr/local/binOnce done, you can simply use task to start containers, lint files and run tests.
Available tasks for this project:
| commands | Description |
|---|---|
| docker:build | Build container images |
| docker:start | Start containers |
| docker:stop | Stop and remove containers |
| back:lint | Static analysis & enforce code style |
| front:graphql | Generate typed hooks |
| front:lint | Enforce code style and check type hinting |