MealBuddy

Full stack: Next.js (frontend) + Laravel (API) + PostgreSQL (database).

Architecture

┌─────────────────┐     HTTP (API)      ┌─────────────────┐
│  Next.js :3000  │ ──────────────────► │ Laravel :8000   │
│  frontend/      │   Sanctum + CORS    │ backend/        │
└─────────────────┘                     └────────┬────────┘
                                                 │ SQL
                                                 ▼
                                        ┌─────────────────┐
                                        │ PostgreSQL :5432 │
                                        │ (Docker)         │
                                        └─────────────────┘

Structure

mealbuddy/
├── backend/            # Laravel 13 — REST API, Sanctum, Filament
├── frontend/           # Next.js 16 — React UI
├── docker-compose.yml  # PostgreSQL for local dev
├── package.json        # Root scripts
└── pnpm-workspace.yaml

Prerequisites

• Docker (for PostgreSQL)
• PHP 8.3+ with pdo_pgsql, Composer
• Node 20+, pnpm

Install the PHP PostgreSQL extension if needed:

# macOS (Homebrew PHP)
pecl install pdo_pgsql
# or ensure php is built with pgsql

Setup

1. Start PostgreSQL

pnpm db:up

2. Install dependencies and migrate

pnpm setup
cp frontend/.env.example frontend/.env.local

pnpm setup starts Postgres, installs Node/PHP deps, copies backend/.env, generates an app key, and runs migrations.

3. Run the stack

pnpm dev

Service	URL
Frontend	http://localhost:3000
API	http://localhost:8000
PostgreSQL	localhost:5432

Environment

Backend (backend/.env)

Defaults in .env.example match Docker Compose:

Variable	Default
DB_CONNECTION	pgsql
DB_HOST	127.0.0.1
DB_PORT	5432
DB_DATABASE	mealbuddy
DB_USERNAME	mealbuddy
DB_PASSWORD	secret

Frontend (frontend/.env.local)

NEXT_PUBLIC_API_URL=http://localhost:8000/api

Useful commands

pnpm db:up        # Start PostgreSQL
pnpm db:down      # Stop PostgreSQL
pnpm db:reset     # Wipe volume and recreate DB
pnpm dev          # Laravel + Next.js
pnpm dev:backend  # Laravel only
pnpm dev:frontend # Next.js only

Laravel (from backend/)

php artisan migrate
php artisan migrate:fresh --seed
php artisan tinker

Tests

PHPUnit uses in-memory SQLite (fast, no Docker required):

cd backend && composer test

Notes

• CORS and Sanctum allow http://localhost:3000 (backend/config/cors.php, backend/config/sanctum.php).
• Inertia pages under backend/resources/js are for Filament / legacy routes; the main app UI is in frontend/.
• Change Postgres credentials in both root .env (Docker) and backend/.env (Laravel) if you customize them.