Dockerized template for your next project with Laravel and Nuxt
Well tested on Ubuntu 18.04, 19.10 and 20.04.
🍬 Stack includes
- Laravel (latest version)
- PostgreSQL (and separate database for testing)
- Nuxt 3 (latest version)
- Nginx (as reverse-proxy)
The project is just separate preconfigured Laravel and Nuxt applications that are stored in the same monorepo.
Each app has its own docker templates for development and production and does not have the actual application code. So you can install and run them completely separate from each other. There are also no restrictions to add more, for example, a mobile application or an admin panel.
If you want to host API and client apps on the single host machine, you may set up subdomains rather than rely on published ports.
The project includes a simple gateway application that can easily help with this.
It can be also useful to run locally and set up an application to use subdomains and test CORS and other possible issues.
Of course, you can replace it with a more professional tool, like Traefik.
- Clone or download the repository and enter its directory:
git clone https://github.com/nevadskiy/laravel-nuxt-docker.git app cd app
- Install the
cd api ./install.sh
This will install and run a fresh new Laravel app which will be available on
- Install the
cd client ./install.sh
This will install and run a fresh new Nuxt 3 app which will be available on
- (Optional) If you want to deploy your project using single host approach, install the
gatewayapplication according to its documentation. Otherwise, you can safely delete it. For local development you can ignore it as well.
🔌 Network communication
The following image demonstrates the request paths in a local development environment.
API and WEB requests sent by the browser are proxied directly via published ports to the running server instances.
But the SSR request is sent by the node server, not the browser, and should be sent directly to the host of the API docker service.
If you see anything that can be improved, feel free to make a pull request. Contributions are welcome and will be fully credited.
🔨 To Do
- try to set up CI/CD using GitHub actions (check cypress.io)