LaraStart

The ultimate mise en place for your next Laravel + Svelte project 🚀

🌐 View Demo · ⚡ Quick Start · 📚 Documentation

Tech Stack

• 🐘 Laravel 12 - Latest PHP framework with modern features
• 🔧 PHP 8.5 - Latest PHP with property hooks and performance improvements
• 🛡️ Inertia.js 2.0 - Modern monolith approach with SPA feel
• 🛣️ Laravel Wayfinder - Type-safe routing for Laravel + TypeScript
• 🟠 Svelte 5 - Revolutionary frontend framework with runes
• 💨 TailwindCSS v4 - Utility-first CSS with latest features
• 🎨 shadcn-svelte - Beautiful, accessible component library
• 📘 TypeScript - Type safety and enhanced developer experience
• 🧪 Pest PHP - Elegant PHP testing framework
• 🔍 PHPStan - Static analysis for PHP (Level 6)
• ✨ Laravel Pint - Opinionated PHP code style fixer
• 🔄 Rector - Automated code upgrades and refactoring
• 📏 ESLint - JavaScript/TypeScript linting with Antfu config

...and more!

Getting Started

Installation

# Clone the repository
git clone https://github.com/n00ki/larastart.git my-app
cd my-app

# Install PHP dependencies
composer install

# Install Node.js dependencies
bun install

# Setup environment variables
cp .env.example .env
# Edit .env with your configuration

# Generate application key
php artisan key:generate

# Setup database
touch database/database.sqlite
php artisan migrate

# Generate AI assistant guidelines (optional)
php artisan boost:install

# Build frontend (required once)
bun run build

# Start development environment
composer dev

Development

# Standard development (all services)
composer dev

# Development with SSR
composer dev:ssr

# Check format & linting
composer lint

# Format and Lint code
composer fix

# Generate IDE helpers
composer annotate

# Run tests
composer test

Project Structure

app/
├── Actions/                   # Business logic (Action pattern)
│   ├── Fortify/               # Fortify authentication actions
│   └── User/                  # User domain actions (profile, password, account)
├── Concerns/                  # Reusable traits (validation rules, etc.)
├── Http/
│   ├── Controllers/           # Thin controllers (delegate to Actions)
│   ├── Middleware/            # Custom middleware
│   ├── Requests/              # Form validation with custom messages
│   └── Responses/             # Custom response contracts (Fortify, etc.)
│       └── Auth/              # Login / logout / register response handling
├── Jobs/                      # Queue jobs
├── Models/                    # Eloquent models with typed properties
├── Policies/                  # Authorization logic
├── Providers/                 # Service providers


resources/
├── css/
│   └── app.css               # Global CSS
└── js/
    ├── actions/              # Wayfinder-generated actions
    ├── components/           # Svelte components
    │   └── ui/               # shadcn-svelte UI components
    ├── hooks/                # Svelte hooks (theme, utilities)
    ├── layouts/              # Page layouts (auth, app, settings)
    ├── lib/                  # Utilities and state machines
    │   └── state/            # Global state (class-based, *.svelte.ts)
    ├── pages/                # Inertia.js pages
    ├── routes/               # Wayfinder-generated routes
    ├── types/                # TypeScript type definitions
    ├── wayfinder/            # Wayfinder runtime setup
    ├── app.ts                # Main entry point
    └── ssr.ts                # SSR entry point

tests/
├── Browser/                  # Browser tests (end-to-end)
├── Feature/                  # Feature tests
└── Unit/                     # Unit tests

Architecture Decisions

• No Abstract Controllers: Composition over inheritance
• Action Pattern: Single responsibility for business logic
• Request Validation: Centralized form validation with custom messages
• Type Safety: End-to-end type safety from PHP to TypeScript
• Auth Response Contracts: Fortify responses are customized via app/Http/Responses/Auth/*Response.php
• Flash Toasts: One-time toasts use Inertia::flash() + centralized frontend handling in resources/js/layouts/base-layout.svelte

Testing

# Run all tests
composer test

# Run specific test suites
composer test:unit          # Unit tests only
composer test:feature       # Feature tests only
composer test:browser       # Browser tests only
composer test:types         # PHPStan static analysis
composer test:type-coverage # 100% type coverage verification
composer test:all           # All tests with coverage

Documentation

For Humans

• Architecture Decisions - Why we chose certain patterns

For AI Assistants

This project uses Laravel Boost for AI guidance:

• Laravel/Inertia/Pest/Wayfinder: Automatically detected and provided by Laravel Boost
• Svelte 5: Use the Svelte MCP server for up-to-date documentation, patterns and conventions

After updating packages, run php artisan boost:update to refresh AI guidelines.

Contributing

Contributions are welcome! Feel free to submit a Pull Request.

Acknowledgments

Special thanks to all incredible contributors to the open-source community!

Built with ❤️ for the Laravel and Svelte communities