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.4 - 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

# 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 lint:fix

# Generate IDE helpers
composer annotate

# Run tests
composer test

Project Structure

app/
├── Actions/                   # Business logic (Action pattern)
│   ├── Auth/                  # Authentication actions
│   └── User/                  # User domain actions (profile, password, account)
├── Enums/                     # Enum classes
├── Http/
│   ├── Controllers/           # Thin controllers (delegate to Actions)
│   ├── Requests/              # Form validation with custom messages
│   └── Middleware/            # Custom middleware
├── Jobs/                      # Queue jobs
├── Models/                    # Eloquent models with typed properties
├── Policies/                  # Authorization logic
├── Providers/                 # Service providers
└── Services/                  # Service classes

resources/
├── css/
│   └── app.css               # Global CSS
└── js/
    ├── actions/              # Wayfinder-generated actions
    ├── components/           # Svelte components
    │   └── ui/               # shadcn-svelte UI components
    ├── hooks/                # Svelte hooks and utilities
    ├── layouts/              # Page layouts (auth, app, settings)
    ├── lib/                  # Utility functions
    ├── pages/                # Inertia.js pages
    ├── routes/               # Wayfinder-generated routes
    ├── types/                # TypeScript type definitions
    ├── wayfinder/            # Wayfinder (automatically generated)
    ├── app.ts                # Main entry point
    └── ssr.ts                # Server-side rendering entry point

tests/
├── Browser/                  # Browser tests (end-to-end)
├── Feature/                  # Feature tests
└── Unit/
    ├── Actions/              # Business logic
    ├── Models/               # Model behavior
    ├── Requests/             # Request validation
    ├── Policies/             # Authorization logic
    ├── Jobs/                 # Queue jobs
    └── Services/             # Service classes

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

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

Human reference documentation is available in the /docs folder:

• Documentation Index - Quick reference and overview
• 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
• Project-specific rules: See .ai/guidelines/ directory

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

Contributing

Contributions are welcome! Please review the documentation in /docs and 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