monciego/tachi-kit

Tachi Kit

Cut through boilerplate.

Tachi Kit is an opinionated Laravel + React + Inertia starter kit with authentication, role-based permissions, user management and more. Skip the boring stuff and focus on what makes your app unique.

It is built on top of the official Laravel React starter kit and keeps its conventions, so everything in the Laravel docs still applies.

📖 Documentation: tachi-kit-docs.vercel.app

What's included

• Authentication: login, registration, email verification, password reset, two-factor authentication and passkeys (Laravel Fortify). Inactive accounts can't sign in.
• Roles & permissions: spatie/laravel-permission with built-in superadmin, admin and user roles, custom roles, and policies that protect superadmins from being edited, deactivated or deleted.
• User management: server-driven data tables with search, faceted filters, sorting, pagination, bulk delete and account status.
• Dashboard: stat cards, a monthly sign-ups chart and a recent users table, loaded as deferred props.
• Activity log: a searchable audit trail of user changes, role and permission changes, password changes, and sign-ins, sign-outs and failed sign-ins (spatie/laravel-activitylog). Visible to roles with the activity.view permission (superadmins by default); entries older than 365 days are pruned daily by the scheduler.
• Profile settings: name, email, avatar upload, password, 2FA, passkeys and appearance (light/dark/system).
• Typed end to end: Wayfinder route helpers, TypeScript role and permission constants generated from PHP enums, and PHPStan at level 7.
• Quality gates: Pest, Pint, PHPStan, oxlint, formatting and tsc, all run in GitHub Actions.

Stack: Laravel 13, React 19, Inertia 3, Tailwind CSS 4, shadcn/ui, Pest.

Requirements

• PHP 8.4+ and Composer
• Node.js 22+ and npm
• SQLite (the default) or MySQL

Getting started

1. Create your app with the Laravel installer:

laravel new my-app --using=monciego/tachi-kit

Or with Composer:

composer create-project monciego/tachi-kit my-app

Either one creates .env, a SQLite database, runs the migrations, seeds the roles and permissions, and links storage for avatars.

2. Install the frontend:

cd my-app && npm install

3. Start the dev server (the app and Vite together):

composer dev

Open http://localhost:8000. To explore with demo accounts, seed them first:

php artisan db:seed

Working from a clone of this repository instead? One command installs everything, creates .env, migrates, links storage and builds the assets:

composer setup

See the installation guide for details.

Using MySQL

SQLite works out of the box. To use MySQL, update .env before migrating:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=tachikit
DB_USERNAME=root
DB_PASSWORD=

Demo accounts

Outside production, seeding creates these accounts plus 50 members spread over the past year. The password for all of them is password.

Production

In production, php artisan db:seed --force only seeds roles and permissions; no demo accounts are created. Create your first account with:

php artisan tachi:superadmin

It asks for a name, email and password (or accepts --name, --email and --password).

Configuration

Kit-level settings live in config/tachi.php.

Roles & permissions

Only superadmins can view the activity log by default. Grant activity.view to another role from the Roles page to share it; superadmin activity stays hidden from non-superadmins.

System roles can't be renamed or deleted. Custom roles can be created from the Roles page.

Adding a permission

1. Add a case (and its label) to app/Enums/Permission.php, e.g. case PostsPublish = 'posts.publish';.
2. Regenerate the frontend types: php artisan tachi:types.
3. Seed it: php artisan db:seed --class=RolePermissionSeeder (grant it to admin there if needed).
4. Check it in a policy with $user->checkPermissionTo(Permission::PostsPublish->value), and in React with can(PERMISSIONS.POSTS_PUBLISH) from usePermissions().

A test fails if the generated file is out of date, so CI catches a forgotten step 2.

Commands

License

Tachi Kit is open-source software licensed under the MIT license.