🗡️ 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:

• Modal - Dialog/popup
• Dropdown - Action menus
• Tabs - Tabbed content
• Alert/Toast - Notifications
• Pagination - Page navigation

🚀 Quick Start

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

Using GitHub Template

1. Click the "Use this template" button above
2. Name your new project
3. 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

1. Install dependencies

   composer install
   bun install

2. Environment setup

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

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

4. Run migrations

   php artisan migrate

5. Seed default roles (optional)

   php artisan db:seed

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