Laravel + shadcn/ui Starter

A modern full-stack starter template combining the power of Laravel with the beautiful UI components of shadcn/ui and the seamless page transitions of Inertia.js.

Features

• Pre-configured shadcn/ui components
• Inertia.js for seamless SPA experience
• TypeScript support out of the box
• Dark mode ready
• Responsive design
• Fully implemented authentication flow (with email verification!)

Getting Started

Prerequisites

• PHP 8.3 or higher
• Composer
• Node.js 18+ and npm/bun
• SQLite (or your preferred database)

Installation

1. Clone the repository:

git clone https://github.com/Kleppinger/laravel-shadcn-starter.git
cd laravel-shadcn-starter

2. Install PHP dependencies:

composer install

3. Install JavaScript dependencies:

npm install
# or using bun (recommended)
bun install 

4. Copy the environment file and generate application key:

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

Notice: In the example, MAIL_MAILER is set to preview. If you dont want this, please configure a different viewer.

5. Run database migrations:

php artisan migrate

6. Start the Vite and Laravel development server:

composer run dev

Visit http://localhost:8000 in your browser.

Configuration

To easily disable/enable mail verification, just change the setting in config/template.php:

<?php

return [
    'enable_verification' => true,
];

Development

Adding shadcn/ui Components

Add new shadcn/ui components using the CLI:

npx shadcn@latest add button
npx shadcn@latest add card
# etc.

Code Formatting

Format your PHP code with Laravel Pint:

vendor/bin/pint

php artisan test

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open-sourced software licensed under the MIT license.

Acknowledgments

• Laravel - The PHP Framework
• Inertia.js - The Modern Monolith
• shadcn/ui - Beautiful UI Components
• Tailwind CSS - Utility-First CSS Framework