🗡️ Tachi Kit

My opinionated Laravel/React/Inertia starter kit with batteries included.

✨ Features

Built on top of Laravel React Starter Kit, extended with:

Role-based Permissions - Complete authorization system
User Management - Admin interface for managing users
Team Management - Multi-tenant team support
React 18 + Inertia.js - Modern SPA experience
Tailwind CSS - Utility-first styling
Responsive Design - Mobile-friendly out of the box
Bun - Fast package manager and dev server
Ready to Deploy - Production-ready setup

Frontend Components

Pre-built, reusable React components to jumpstart your development:

Data Display:

DataTable - Sortable, filterable, paginated table
StatCard - Dashboard stats/metrics cards
Chart - Data visualization components
Badge - Status indicators
Avatar - User avatars with fallbacks

Forms:

FormInput - Text inputs with validation
Select - Dropdowns with search
DatePicker - Date selection
FileUpload - Drag & drop file uploads

UI Elements:

🚀 Quick Start

This project uses Bun for faster installs and development, but npm/pnpm work fine too.

Using GitHub Template

Click the "Use this template" button above
Name your new project
Clone and set up:

git clone https://github.com/monciego/<your-app-name>
cd <your-app-name>
composer install
bun install
cp .env.example .env
php artisan key:generate
php artisan migrate
bun run dev

Using degit

npx degit monciego/tachi-kit <your-app-name>
cd <your-app-name>
composer install
bun install
cp .env.example .env
php artisan key:generate
php artisan migrate
bun run dev

💡 Using npm/pnpm? Just replace bun with your preferred package manager.

📋 Requirements

PHP 8.2+
Composer
Node.js 18+
MySQL/PostgreSQL/SQLite

🔧 Installation

Install dependencies
```
composer install
bun install
```

Environment setup

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

Database configuration

Update your .env file with database credentials:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

Run migrations
```
php artisan migrate
```
Seed default roles (optional)
```
php artisan db:seed
```

Start development server

# Terminal 1 - Laravel
php artisan serve

# Terminal 2 - Vite
bun run dev

Visit http://localhost:8000 🎉

📦 What's Included

Authentication

Login / Register
Password Reset
Email Verification
Profile Management

Authorization (added by Tachi Kit)

Role-based access control
Permission management
User role assignment
Protected routes and components

Developer Experience

Hot Module Replacement (HMR)
TypeScript support ready
ESLint & Prettier configured
Git hooks with Husky (optional)

🏗️ Project Structure

tachi-kit/
├── app/
│   ├── Http/
│   │   ├── Controllers/
│   │   └── Middleware/
│   ├── Models/
│   └── Policies/
├── resources/
│   ├── js/
│   │   ├── Components/
│   │   ├── Layouts/
│   │   └── Pages/
│   └── css/
├── routes/
│   ├── web.php
│   └── auth.php
└── database/
    ├── migrations/
    └── seeders/

🎨 Customization

Changing App Name

Update APP_NAME in .env:

APP_NAME="My Awesome App"

Changing Logo

Replace the logo component in:

resources/js/Components/ApplicationLogo.jsx

Adding New Roles

Edit the seeder or use the admin panel (if implemented).

🚢 Deployment

Build for Production

bun run build

Optimize Laravel

composer install --optimize-autoloader --no-dev
php artisan config:cache
php artisan route:cache
php artisan view:cache

🤝 Contributing

Feel free to submit issues and pull requests!

📄 License

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

🙏 Credits

Built on top of Laravel
Scaffolded with Laravel React Starter Kit
Powered by Inertia.js and React

💬 Support

If you find this starter kit helpful, please consider giving it a ⭐️!

Made with ❤️ by Jericho Bantiquete

monciego/tachi-kit