Foundation Kit - Docker Development Setup

Overview

Foundation Kit — Docker Development Setup is a ready-to-run Docker Compose environment built specifically for the Foundation Kit Laravel + React starter kit. Cloning the repository and running one command provisions the full application stack — runtime, web server, database, cache, mail testing, and a database admin UI — with Foundation Kit itself installed and bootstrapped automatically on first boot.

Why this exists

Getting a Laravel 12 + React 19 + Inertia project running locally normally means installing the right PHP version and extensions, Composer, Node.js, a database server, and a cache/queue backend, then keeping all of that consistent across every machine on the team. This setup collapses that entire process into a single Dockerfile, a docker-compose.yml, an Nginx config, and one shell entrypoint script.

What is included

• App container: PHP 8.4-FPM with Node.js 24, Composer, and the extensions Laravel needs — pdo_mysql, gd, bcmath, pcntl, exif, and redis. Xdebug is preinstalled but disabled by default.
• Nginx: serves the Laravel public directory and forwards requests to PHP-FPM.
• MySQL 8: the application database, with a healthcheck and a named volume so data survives ordinary container recreation.
• Redis 7: cache, session, and queue backend.
• Mailhog: catches every email Fortify sends (verification, password reset, 2FA) and exposes a browser inbox instead of a real inbox.
• phpMyAdmin: a browser-based admin UI wired directly to the MySQL service.

Automated first boot

docker-entrypoint.sh does the work a developer would otherwise do by hand: it installs yasiramin380/foundation-kit via Composer if the project is not present yet, copies the Docker .env, installs PHP and Node dependencies, generates the app key, waits for MySQL to accept connections, runs migrations and seeders, creates the storage symlink, generates Wayfinder route types, builds the frontend with Vite, and starts Laravel Reverb in the background before handing off to PHP-FPM.

Quick start

git clone https://gitlab.com/yasiramin380/foundation-kit-docker-setup.git my-app
cd my-app
docker compose up -d --build

Everyday commands

docker compose ps
docker compose logs -f app
docker compose exec app bash
docker compose exec app php artisan migrate
docker compose exec app php artisan make:module ModuleName
docker compose exec app npm run build
docker compose down

Default access

• Application: http://localhost:8000 — hello@admin.dev / password
• Reverb WebSockets: ws://localhost:8080
• phpMyAdmin: http://localhost:8081 — user / user123
• Mailhog inbox: http://localhost:8025

Created by Yasir Amin. View repository · Foundation Kit package