Backend Setup

The Laravel backend is in the backend/ directory. Follow these steps to set it up.

1. Install Dependencies

cd backend
composer install

2. Environment Configuration

cp .env.example .env
php artisan key:generate

Edit .env with your database credentials:

DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=larastarter
DB_USERNAME=larastarter
DB_PASSWORD=password

FRONTEND_URL=http://localhost:5173
APP_URL=http://localhost:8000

3. Run Migrations & Seeders

php artisan migrate --seed

This creates all tables and seeds demo data:

  • Super admin user: admin@larastarter.test / password
  • Demo organization with members
  • Free plan with default features and limits
  • Org role templates (owner, admin, member)
  • Email templates for all system notifications
  • Default app settings

4. Storage Link

php artisan storage:link

Creates a symlink from public/storage to storage/app/public for file uploads (avatars, logos).

5. Start the Server

php artisan serve

The API is now available at http://localhost:8000.

Quick Start (All in One)

Use the composer dev script to start everything concurrently:

composer dev

This starts the API server, queue worker, log viewer (Pail), and Vite dev server simultaneously.