catherinetagao/cath-starter-kit

A Laravel starter kit with Inertia.js, Laravel Breeze, Laravel Sanctum, Laravel Pail, Laravel Pint, Laravel Sail, Laravel Tinker, TightenCo Ziggy, FakerPHP, Mockery, NunoMaduro Collision, PestPHP, and PestPHP Laravel Plugin.

v1.0.1 2025-03-21 15:37 UTC

Requires

• php: ^8.2
• inertiajs/inertia-laravel: ^2.0
• laravel/framework: ^12.0
• laravel/sanctum: ^4.0
• laravel/tinker: ^2.10.1
• tightenco/ziggy: ^2.0

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/breeze: ^2.3
• 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

• Catherine Tagao

• framework
• laravel

README

🚀 Introduction

Welcome to the Cath 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 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.

🎯 Why Choose This Kit?

✔️ React 19 + JSX – Simple, clean, and TypeScript-free
✔️ Laravel 12 + Breeze – Lightweight authentication with Inertia.js
✔️ 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=catherinetagao/cath-starter-kit

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.

📖 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.