Svelte Inertia Laravel - Project Starter

A modern, full-stack web application boilerplate built with Laravel 12, Inertia.js, Svelte 5 (with Runes), TypeScript, Tailwind CSS 4, and Shadcn UI components — powered by Vite 7 for a fast DX.

Features

• Modern Svelte 5 with Runes
  • Explicit reactivity with $state, $derived, and $effect
  • Type-safe props with $props
  • Improved component composition with $snippet
• Full-Stack Integration
  • Laravel 12 backend with robust authentication via Fortify
  • Seamless frontend-backend communication with Inertia.js
  • Server-side rendering for optimal performance
• Developer Experience
  • Hot Module Replacement (HMR) and fast refresh
  • TypeScript with strict type checking
  • Modern UI powered by Tailwind CSS 4 and Shadcn
  • Comprehensive ESLint and Prettier configuration

Architecture Overview

This project implements a modern monolithic architecture using Laravel as the backend framework and Svelte 5 for the frontend, seamlessly connected via Inertia.js. This architecture provides:

• Single Codebase: All code lives in one repository, simplifying deployment and maintenance
• Modern Reactivity: Svelte 5's Runes system for explicit and powerful state management
• Type Safety: Full TypeScript support with improved type inference
• Modern UI: Powered by Tailwind CSS 4 and Shadcn components
• Authentication: Built-in auth system using Laravel Fortify
• Developer Experience: Enhanced development workflow with Runes and TypeScript

Tech Stack

• Backend

  • Laravel 12.x (PHP 8.x)
  • Laravel Fortify for Auth features
  • SQLite

• Frontend

  • Svelte 5 with Runes
  • TypeScript 5.x
  • Vite 7.x
  • Tailwind CSS 4.x
  • Shadcn UI Components
  • Lucide Svelte Icons

• Frontend-Backend communication

  • Inertia.js for seamless frontend-backend communication

Getting Started

Prerequisites

• PHP 8.x
• Composer
• Node.js (Latest LTS version)
• SQLite (but you can use any other RDBMS)
• Laravel Herd (to run the application)

Installation

1. Clone the repository:

git clone https://github.com/ferjal0/svelte-inertia-laravel
cd svelte-inertia-laravel

2. Install PHP dependencies:

composer install

3. Install Node.js dependencies:

pnpm install

4. Set up your environment:

cp .env.example .env
php artisan key:generate

5. Configure your database in .env and run migrations:

php artisan migrate

6. Start the development servers:

pnpm run dev

Visit http://svelte-inertia-laravel.test to see your application.

Tailwind CSS 4 + Vite 7

• Tailwind 4: Zero-config by default. The starter already includes @tailwindcss/vite and @tailwindcss/postcss so @tailwind base; @tailwind components; @tailwind utilities; Just Works.
• Vite 7: Faster HMR and improved SSR build. No action needed — scripts are wired up for dev and build.
• If you're migrating an older clone, update your local deps:

pnpm install

Documentation Structure

The documentation is split into three main sections:

1. Getting Started - This file, containing project overview and setup instructions
2. Backend Documentation - Details about Laravel implementation, API endpoints, and authentication
3. Frontend Documentation - Svelte components, Inertia.js integration, and UI architecture

Code Style

• PHP code follows PSR-12 standards
• TypeScript/Svelte code follows the project's ESLint and Prettier configuration
• Run style checks with:

# PHP
./vendor/bin/pint

# TypeScript/Svelte
pnpm run lint

Building for Production

pnpm run build