Running Locally

Once you've completed the backend and frontend setup, here's how to run everything together.

Option A: Composer Dev Script (Recommended)

From the backend/ directory, run:

cd backend
composer dev

This starts four processes concurrently:

• API server — php artisan serve at http://localhost:8000
• Queue worker — php artisan queue:listen for background jobs
• Log viewer — php artisan pail for real-time logs
• Vite dev server — npm run dev at http://localhost:5173

Option B: Manual (Separate Terminals)

# Terminal 1: Docker services
docker compose up -d

# Terminal 2: Backend API
cd backend && php artisan serve

# Terminal 3: Queue worker
cd backend && php artisan queue:listen

# Terminal 4: Frontend
cd frontend && npm run dev

# Terminal 5: Marketing (optional)
cd marketing/public && php -S localhost:8001 router.php

Default Credentials

• Super Admin: admin@larastarter.test / password
• Admin Panel: http://localhost:5173/admin
• Mailpit: http://localhost:8025 (catches all dev emails)

Common Issues

CORS errors

Make sure FRONTEND_URL in backend/.env matches the Vite dev server URL (including port):

FRONTEND_URL=http://localhost:5173

Database connection refused

Check that Docker services are running: docker compose ps. If using native MySQL, verify credentials in .env.

Queue jobs not processing

Make sure the queue worker is running. Emails, webhooks, and other background tasks require it.