Larament
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
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.';
}
}
function example(): string
{
return 'Your helper function here.';
}
}
Terminal Aliases
Simple Alias
alias larament="composer create-project --prefer-dist CodeWithDennis/larament"
larament my-project
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
}
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