README

This project is a pre-configured skeleton application that combines Laravel, Filament Admin Panel, Inertia.js and React to provide a comprehensive starting point for web application development.

Quick start (with Docker)

composer create-project joris/laravel-skeleton
cd laravel-filament-inertia-react-skeleton
composer setup

Features

• Laravel 12.x - Latest version of Laravel framework
• Filament 3.x - Admin panel toolkit for Laravel
• Inertia.js - Server-side rendering without API boilerplate
• React 19 - Front-end library for building user interfaces
• TypeScript - Type safety for your JavaScript code
• Docker - Development environment using Laravel Sail
• TailwindCSS 4 - Utility-first CSS framework

Requirements

• PHP 8.2+
• Node.js
• Composer
• Docker & Docker Compose (for Sail)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/laravel-filament-inertia-react-skeleton.git
   cd laravel-filament-inertia-react-skeleton

2. Install PHP dependencies:

   composer install

3. Create environment file:

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

4. Install JavaScript dependencies:

   npm install
   # or if using pnpm
   pnpm install

5. Start the development environment:

   # Using Laravel Sail (Docker)
   ./vendor/bin/sail up
   
   # Or using the composer script
   composer dev

Usage

Development

# Start all services (Laravel server, queue worker, logs, and Vite)
composer dev

# Start with SSR enabled
composer dev:ssr

# Run only Vite dev server
npm run dev

Building for Production

# Build frontend assets
npm run build

# Build with SSR support
npm run build:ssr

Code Quality

# Format code with Prettier
npm run format

# Check formatting
npm run format:check

# Lint JavaScript/TypeScript
npm run lint

# Type checking
npm run types

# Run tests
composer test

Docker

This project uses Laravel Sail for Docker integration. The Docker setup includes:

• PHP 8.4 container
• MariaDB 10.6 database
• Node.js container for frontend development

You can start the Docker environment with:

./vendor/bin/sail up

Project Structure

The project follows the standard Laravel structure with some additions:

• /app - Laravel application code
• /resources/js - React components and frontend code
• /resources/css - CSS files including Tailwind CSS
• /public - Compiled assets and static files

License

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