val-- / app-skeleton

A web application skeleton using ReactJS and Symfony

A skeleton for web applications using React and Symfony

This is a skeleton to easily bootstrap a modern web application.

It is composed of two distinct applications:

• a client application, written in TypeScript, using ReactJS, and managed with webpack,
• a REST API written in PHP using Symfony 5.

How to use it?

Run the application

To be able to run both the API and the client in production-like mode, you'll first need to install mkcert.

Then you can start the full application using docker by running:

$ mkcert -install
$ make prod

The full list of commands is available by running:

$ make

This will describe how to serve only the API or the client in development mode, how to run the tests, to update the dependencies, to debug the API with XDebug, and more.

Using Docker BuildKit

To use the more efficient BuildKit toolkit to build the Docker images, export the following environment variables:

COMPOSE_DOCKER_CLI_BUILD=1
DOCKER_BUILDKIT=1

You can export them directly before running make prod, or make them permanent by adding them to your shell profile.

License

This repository is under the MIT license. See the complete license in the LICENSE file.