joris/laravel-skeleton

Laravel Filament Inertia React Skeleton

v1.0.1 2025-05-17 13:14 UTC

Requires

• php: ^8.2
• filament/filament: ^3.3
• inertiajs/inertia-laravel: ^2.0
• laravel/framework: ^12.0
• laravel/tinker: ^2.10.1
• tightenco/ziggy: ^2.4

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/pail: ^1.2.2
• laravel/pint: ^1.18
• laravel/sail: ^1.43
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• phpunit/phpunit: ^11.5.3

MIT

• laravel
• Skeleton
• react
• inertia
• filament

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.