Skip to main content

Development Commands

This page lists all commonly used commands for developing with Saucebase, organized by category.

Development Workflow​

Starting Development Environment​

The quickest way to start development:

composer dev

This runs all development services in parallel:

  • Laravel dev server (php artisan serve)
  • Queue worker (php artisan queue:listen)
  • Pail logs (php artisan pail)
  • Vite dev server (npm run dev)
Recommended

Use composer dev for the best development experience with automatic log monitoring and hot reload.

Alternative: Individual Services​

If you prefer to run services separately:

# Terminal 1: Laravel dev server
php artisan serve

# Terminal 2: Vite dev server (hot reload)
npm run dev

# Terminal 3: Queue worker
php artisan queue:listen --tries=1

# Terminal 4: Monitor logs
php artisan pail --timeout=0

Docker Operations​

Starting Services​

# Start all services
docker compose up -d

# Start and wait for health checks
docker compose up -d --wait

# View logs while starting
docker compose up

Executing Commands​

# General syntax
docker compose exec app <command>

# Examples
docker compose exec app php artisan migrate
docker compose exec app composer install
docker compose exec app php artisan tinker

Service Management​

# Restart specific service
docker compose restart app

# Restart all services
docker compose restart

# Stop all services
docker compose down

# Stop and remove volumes
docker compose down -v

Viewing Logs​

# All services
docker compose logs -f

# Specific service
docker compose logs -f app
docker compose logs -f nginx
docker compose logs -f mysql

# Last 100 lines
docker compose logs --tail=100 app

Service Status​

# Check running services
docker compose ps

# Check specific service health
docker compose ps mysql

Installation & Setup​

Automated Installation​

The recommended way to install — only Docker and Node.js required:

# First-time installation
bash bin/setup-env

# With flags
bash bin/setup-env --no-ssl
bash bin/setup-env --force
bash bin/setup-env --no-docker

# After first install, Task is available via npm:
npm run saucebase install

The bootstrap script handles Docker, PHP dependencies, runs the artisan installer inside the container, then builds frontend assets.

Artisan Installer (runs inside container)​

When called directly (e.g. in CI or inside Docker):

# Standard installation
php artisan saucebase:install

# Skip SSL detection
php artisan saucebase:install --no-ssl

# Force reinstallation
php artisan saucebase:install --force

# Manual mode (instructions only)
php artisan saucebase:install --no-docker

# CI/CD mode (non-interactive)
php artisan saucebase:install --no-interaction

Module Management​

Installing Modules​

# Install module package
composer require saucebase/auth

# Regenerate autoloader
composer dump-autoload

# Enable module
php artisan module:enable Auth

# Run migrations and seeds
php artisan module:migrate Auth --seed

# Build frontend assets
npm run build

Managing Modules​

# List all modules
php artisan module:list

# Enable module
php artisan module:enable Auth

# Disable module
php artisan module:disable Auth

# Module status
php artisan module:list

Module Database Operations​

# Run migrations
php artisan module:migrate Auth

# Rollback migrations
php artisan module:migrate-rollback Auth

# Refresh migrations (drop + re-run)
php artisan module:migrate-refresh Auth

# Seed data
php artisan module:seed Auth

# Run specific seeder
php artisan module:seed Auth --class=AuthDatabaseSeeder

# Migrate and seed together
php artisan module:migrate Auth --seed

# Check migration status
php artisan module:migrate-status Auth

Frontend Assets​

Development​

# Start Vite dev server with HMR
npm run dev

# Start and expose to network
npm run host

Production Builds​

# Build for production
npm run build

# Build with SSR
npm run build:ssr

# Preview production build
npm run preview

Screenshots & Videos​

# Capture screenshots
npm run screenshots

# Capture videos
npm run videos

Testing​

Backend Tests (PHPUnit)​

# Run all tests
php artisan test

# Run specific test file
php artisan test tests/Feature/AuthTest.php

# Run specific test method
php artisan test --filter test_user_can_login

# Run specific test suite
php artisan test --testsuite=Feature
php artisan test --testsuite=Unit
php artisan test --testsuite=Modules

# Run with coverage
php artisan test --coverage

# Parallel testing
php artisan test --parallel

Frontend Tests (Playwright)​

# Run all E2E tests
npm run test:e2e

# Open Playwright UI
npm run test:e2e:ui

# Run in headed mode (see browser)
npm run test:e2e:headed

# Debug tests
npm run test:e2e:debug

# View test report
npm run test:e2e:report

Code Quality​

PHP​

# Run PHPStan static analysis
composer analyse

# Alternative
vendor/bin/phpstan analyse --memory-limit=2G

# Format code with Laravel Pint
composer lint

# Alternative
vendor/bin/pint

# Check specific directory
vendor/bin/pint app/

JavaScript/TypeScript​

# Lint and auto-fix
npm run lint

# Format with Prettier
npm run format

# Check formatting only
npm run format:check

Pre-commit Hooks​

# Test commit message format
echo "feat: test commit" | npx commitlint

# Run pre-commit hooks manually
npx husky run pre-commit

Cache Management​

Clearing Caches​

# Clear all caches
php artisan optimize:clear

# Clear specific caches
php artisan config:clear
php artisan route:clear
php artisan view:clear
php artisan cache:clear
php artisan event:clear

# Clear compiled classes
php artisan clear-compiled

Optimizing for Production​

# Cache everything
php artisan optimize

# Cache specific items
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan event:cache

Cache Inspection​

# Show cached config
php artisan config:show

# Show specific config
php artisan config:show app
php artisan config:show database

Logging​

Monitor Logs​

# Real-time log monitoring
php artisan pail

# With no timeout
php artisan pail --timeout=0

# Filter by level
php artisan pail --level=error

# Filter by message
php artisan pail --message="User created"

Server-Side Rendering (SSR)​

Managing SSR Server​

# Start SSR server
php artisan inertia:start-ssr

# Start in background
php artisan inertia:start-ssr &

# Stop SSR server
php artisan inertia:stop-ssr

# Check SSR server status
curl http://127.0.0.1:13714

Next Steps​

Bookmark this page for quick reference during development!