Larament

• What's Included
  • Core Dependencies
  • Development Tools
  • Testing
• GitHub Workflows
• Quick Start
• Features
  • Filament Admin Panel
  • Filament Tables
  • Development Workflow
• Customizations
  • Migration Stubs
  • Helper Functions
• Terminal Aliases
  • Simple Alias
  • Advanced Function (Example with Herd)

A bloat-free starter kit for Laravel 12.x with FilamentPHP 5.x pre-configured. Only essential development tools included.

[!NOTE] Requires PHP 8.3 or higher.

#What's Included

#Core Dependencies

• Laravel 12.x - The PHP framework
• FilamentPHP 5.x - Admin panel with SPA mode, custom theme, and MFA enabled
• nunomaduro/essentials - Better Laravel defaults (strict models, auto-eager loading, immutable dates)

#Development Tools

• larastan/larastan - Static analysis
• laravel/pint - Code style fixer
• pestphp/pest - Testing framework
• rector/rector - Automated refactoring
• fruitcake/laravel-debugbar - Development insights

#Testing

Includes a comprehensive test suite with PEST 4.x including browser testing - perfect for learning testing or as a reference for your own tests.

#GitHub Workflows

Comes with pre-configured GitHub Actions workflows for automated quality assurance:

• Tests - PEST 4.x testing with 4 parallel shards for faster CI/CD
• PHPStan - Static analysis and type checking
• Pint - Automated code style fixing with auto-commit

#Quick Start

composer create-project codewithdennis/larament your-project-name
cd your-project-name 
composer install
npm install
npm run build
php artisan serve

#Features

#Filament Admin Panel

• SPA mode enabled
• Custom login page with autofilled credentials in local environment
• Custom theme included
• Profile management enabled
• MFA (App Authentication) enabled

#Filament Tables

• Striped rows for better visual separation
• Deferred loading for improved performance

#Development Workflow

composer review  # Runs Pint, Rector, PHPStan, and Pest

#Customizations

#Migration Stubs

Custom stubs remove the down() method by default. Remove the custom stubs to use Laravel's default templates.

#Helper Functions

Add your own helpers in app/Helpers.php:

if (! function_exists('example')) {
    function example(): string
    {
        return 'Your helper function here.';
    }
}

#Terminal Aliases

#Simple Alias

alias larament="composer create-project --prefer-dist CodeWithDennis/larament"
larament my-project

#Advanced Function (Example with Herd)

Add this to your ~/.bashrc, ~/.zshrc, or shell configuration file:

function larament() {
  local cmd="$1"
  shift

  case "$cmd" in
    new)
      if [[ -z "$1" ]]; then
        return 1
      fi

      local project_name="$1"
      composer create-project --prefer-dist CodeWithDennis/larament "$project_name" || return 1
      cd "$project_name" || return 1

      # Update APP_URL in .env
      if [[ -f ".env" ]]; then
        sed -i '' "s|^APP_URL=.*|APP_URL=https://${project_name}.test|" .env
      fi

      herd link --secure && herd open
      ;;
    *)
      return 1
      ;;
  esac
}

Usage:

larament new my-project