README

Introduction

A starter kit for Laravel applications with React, Inertia.js, Shadcn UI, and Tailwind CSS v4. Designed to help you quickly set up a new full-stack Laravel project with a modern development environment.

Installation

laravel new my-app --pest --npm --using=webmintydotcom/laravel-quickstart-inertia

Tech Stack

Included Packages

• Laravel
  • Inertia.js
  • Ziggy
  • Spatie Laravel Data
• Frontend
  • React
  • Shadcn UI
  • Tailwind CSS
• Debugging
  • Spatie Laravel Ray
• Testing
  • Pest
    • Spatie Pest Expectations
    • Pest Plugin - Faker
    • Pest Plugin - Laravel
    • Pest Plugin - Type Coverage
  • Larastan
  • Pint
  • Rector
• Formatting
  • Prettier
    • Prettier Plugin - Tailwind CSS
    • Prettier Plugin - Blade

Laravel

Version 12 of Laravel is used in this starter kit.

Inertia.js

Inertia.js connects the Laravel backend to the React frontend without needing an API. Pages are React components rendered via Inertia::render() in your routes and controllers.

Homepage | Docs

Ziggy

Ziggy provides a route() helper in JavaScript, so you can use Laravel named routes in your React components.

Docs

Spatie Laravel Data

Spatie Laravel Data is included to help you create data transfer objects (DTOs) in a simple and elegant way.

Docs

Frontend

React

React 19 with TypeScript. Entry point is resources/js/app.tsx with SSR support via resources/js/ssr.tsx.

Docs

Shadcn UI

Pre-configured with components.json pointing to resources/js/components/ui/. Includes all required dependencies (Radix UI, class-variance-authority, clsx, tailwind-merge, Lucide icons).

Homepage | Docs

Tailwind CSS

Tailwind CSS v4 with the Vite plugin. Configured with Shadcn's full oklch color palette and dark mode support.

Homepage | Docs

Debugging

Spatie Laravel Ray

Spatie Laravel Ray is included to help you debug your Laravel applications with ease.

Homepage | Docs

Testing

Pest

Pest is included to help you write expressive and elegant tests for your Laravel applications.

Homepage | Docs

Spatie Pest Expectations

Docs

Pest Plugin - Faker

Docs

Pest Plugin - Laravel

Docs

Pest Plugin - Type Coverage

Docs

Larastan

Larastan is included to help you catch type errors in your Laravel applications using PHPStan.

Docs

Pint

Pint is included to help you format your Laravel code according to the Webminty coding standard.

Docs

Laravel Rector

Rector is included to help you refactor and upgrade your Laravel codebase automatically.

Docs

Formatting

Prettier

Prettier is included to help you format your code consistently across your project.

Homepage | Docs

Prettier Plugin - Tailwind CSS

Docs

Prettier Plugin - Blade

Docs

Additional Configurations

Changes to the default Laravel files are included in this starter kit to improve performance and developer experience.

app/Providers/AppServiceProvider.php

Model::preventLazyLoading();

if ($this->app->isProduction()) {
    Model::handleLazyLoadingViolationUsing(function ($model, $relation) {
        $class = get_class($model);

        info("Attempted to lazy load [{$relation}] on model [{$class}].");
    });
    DB::prohibitDestructiveCommands();
} else {
    Model::preventAccessingMissingAttributes();
    Model::preventSilentlyDiscardingAttributes();
    Model::shouldBeStrict();
}

Vite::usePrefetchStrategy('aggressive');

Thank you Webminty Team