Symfony + Next.js Starter Template 🧱⚡

A full-stack monorepo boilerplate combining Symfony (PHP) for the backend and Next.js (React + TypeScript) for the frontend, powered by Docker for easy local development.

🧰 Tech Stack

• Backend: Symfony 6.x (API-ready)
• Frontend: Next.js 14 (App Router, TypeScript, TailwindCSS)
• UI Kit: ShadCN/UI
• Database: MySQL 8
• Containerization: Docker & Docker Compose
• Dev Tools: PHPMyAdmin, Symfony CLI, Composer, Prettier, ESLint

---

🏁 Getting Started

🔧 Requirements

• Docker + Docker Compose
• Make sure ports 3100, 8082, 9500, 3307, and 8093 are available

🚀 Launch the project

docker-compose up --build

Then:

• Frontend: http://localhost:3100
• Symfony Backend (PHP-FPM): exposed at port 9500 (via nginx on 8082)
• PHPMyAdmin: http://localhost:8093
• MySQL: port 3307

---

📁 Folder Structure

.
├── backend/           # Symfony app
│   ├── Dockerfile
│   └── nginx.conf
├── frontend/          # Next.js app (App Router)
│   ├── Dockerfile
│   └── src/
├── docker-compose.yml

---

⚙️ Environment Configuration

Edit environment variables:

backend/.env
DATABASE_URL="mysql://symfony:symfony@db:3306/symfony?serverVersion=8.0.32&charset=utf8mb4"

---

✅ Features

• Symfony backend ready for API development
• Next.js frontend styled with Tailwind and ShadCN
• Clean folder structure with separation of concerns
• Instant dev environment with Docker
• Ready-to-use design system with components

---

🧪 Useful Commands

# Backend (inside the backend container)
composer install
symfony serve

# Frontend (inside the frontend container or locally)
npm install
npm run dev

---

📦 Use this as a template

You can mark this repo as a template and Use this template to start your own project.

---