luis-developer-08/yui

Welcome to my personal starter kit! This setup is designed for developers who want a lightweight, modern, and efficient foundation for building Laravel applications with a React frontend powered by InertiaJs.

v1.0.0.0-alpha 2025-03-16 05:38 UTC

Requires

• php: ^8.2
• inertiajs/inertia-laravel: ^2.0
• laravel/breeze: ^2.3
• laravel/framework: ^12.0
• laravel/sanctum: ^4.0
• laravel/tinker: ^2.10.1
• spatie/laravel-permission: ^6.16
• tailflow/laravel-orion: ^2.23
• tightenco/ziggy: ^2.0

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/pail: ^1.2.2
• laravel/pint: ^1.13
• laravel/sail: ^1.41
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• pestphp/pest: ^3.7
• pestphp/pest-plugin-laravel: ^3.1

MIT

• framework
• laravel

README

🚀 Introduction

Welcome to my personal starter kit YUI! This setup is designed for developers who want a lightweight, modern, and efficient foundation for building Laravel applications with a React frontend powered by Inertia.js.

This kit is JavaScript-first, using JSX instead of TSX, making it accessible to developers who prefer plain JavaScript over TypeScript. It includes React 19, TailwindCSS 4, and Breeze for simple authentication and scaffolding.

🎯 Features

✔️ React 19 + JSX – Simple, clean, and TypeScript-free
✔️ Laravel 12 + Breeze – Lightweight authentication with Inertia.js
✔️ Inertia.js – Create modern single-page React, Vue, and Svelte apps using classic server-side routing.
✔️ Orion – The simplest way to create REST API with Laravel
✔️ TanStack Query – Powerful asynchronous state management for TS/JS
✔️ Laravel-permission – Associate users with roles and permissions
✔️ TailwindCSS 4 – Modern styling with utility-first CSS
✔️ Vite-Powered – Lightning-fast HMR for smooth development
✔️ Pre-configured Testing – Includes PHPUnit & Pest
✔️ Quick Setup – Get started in minutes!

🛠 Getting Started

1️⃣ Install

laravel new --using=luis-developer-08/yui

2️⃣ Install Dependencies

npm install

3️⃣ Run Migrations

php artisan migrate --seed

4️⃣ Start Development

composer run dev

🎉 Your application is now up and running!

⚡ Create Inertia Components Easily

This starter kit includes a custom Artisan command to quickly generate Inertia.js React components:

🏗️ Generate a New Component

php artisan make:inertia Components/MyComponent

This will create a new file at resources/js/Components/MyComponent.jsx with a basic component template.

📂 File Structure

resources/js/Components/MyComponent.jsx

✨ Example Generated Component

import React from "react";

const MyComponent = () => {
    return <div>{/* MyComponent component */}</div>;
};

export default MyComponent;

This command ensures that components are placed in the correct directory and prevents overwriting existing files. It also automatically opens the newly created file for editing.

⚡ Create Orion Controllers Easily

This starter kit also includes a command to quickly generate Orion controllers along with their associated models:

🏗️ Generate a New Orion Controller

php artisan make:orion PostController

This will create:

• app/Http/Controllers/Orion/PostController.php
• app/Models/Post.php (if it doesn’t exist)
• Adds a route in routes/api.php

📂 File Structure

app/Http/Controllers/Orion/PostController.php
app/Models/Post.php

✨ Example Generated Controller

<?php

namespace App\Http\Controllers\Orion;

use Orion\Http\Controllers\Controller;
use App\Models\Post;

class PostController extends Controller
{
    protected $model = Post::class;
}

✨ Example Generated Model (if not existing)

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    use HasFactory;

    protected $guarded = [];
}

🔗 Auto-Registered Route in routes/api.php

Orion::resource('posts', \App\Http\Controllers\Orion\PostController::class);

This command ensures that controllers are correctly placed, models are created if missing, and routes are automatically registered.

📖 Documentation

For more details on Laravel Breeze, visit the official Laravel Starter Kit docs.

🤝 Contributing

We welcome contributions! Check out the Laravel contribution guide to get involved.

📜 Code of Conduct

Be kind and respectful. Please follow Laravel's Code of Conduct.

⚖️ License

This starter kit is open-source under the MIT license.