README

A reusable Laravel starter kit for internal and client projects — authentication, roles, a blog, and a back office ready to go, so every new engagement starts from a working foundation instead of a blank repo.

Stack


PHP	8.4
Laravel	13
Auth	Fortify (login, registration, password reset — no 2FA/passkeys)
Frontend	Livewire 4 + Flux UI
Styling	Tailwind CSS v4
Roles	Spatie Permission
Media	Spatie Media Library
Quality	Pest 4, Pint, Larastan

Features

Authentication — login, registration, password reset out of the box; logging out always lands back on the login page.
Roles & permissions — every new user gets staff automatically; admin and super-admin unlock more of the back office. Roles and permissions are managed at runtime from a Super Admin-only Access Control page, no migration required to add a role.
Blog — the one piece of public content that's editable without a redeploy: title, excerpt, body, featured image, publish toggle, auto-generated slugs that never change on edit. The featured image runs on Spatie Media Library, with thumb/card/hero conversions generated automatically and a reusable <x-media-upload> component ready for other models.
System panel (admin/super-admin) — user management (list, create, change role, delete), a sitemap viewer, and site settings (SEO description, Google Analytics, social links, contact info). Super admins alone additionally get Access Control and the audit trail of admin actions.
Per-role dashboard — a thin dashboard shell dispatches to a self-contained Livewire component per role (super-admin, admin, staff), each showing the stats relevant to that role.
Branded system pages — error pages (404, 500, ...) and transactional emails match the app's look, not the framework defaults.
In-app docs — a docs page inside the app with project-specific setup and architecture notes.
Tests from day one — Pest feature tests, Pint formatting, and Larastan static analysis wired into CI.

Getting started

Uses SQLite by default — no separate database server to set up first.

Starting a brand new project, via the Laravel installer:

laravel new my-app --using=recodex-id/rewire

Or clone it directly:

git clone https://github.com/Recodex-ID/rewire.git
cd rewire
composer install
npm install
cp .env.example .env
touch database/database.sqlite
php artisan key:generate
php artisan storage:link
php artisan migrate --seed
composer run dev

Visit http://localhost:8000. composer run dev runs the app server, queue listener, and Vite together.

Default accounts

Seeded by database/seeders/DatabaseSeeder.php, password password for all three:

Email	Role
`super-admin@mail.test`	super-admin
`admin@mail.test`	admin
`staff@mail.test`	staff

Quality checks

php artisan test --compact
vendor/bin/pint --dirty
vendor/bin/phpstan analyse

Or composer test, which runs formatting, static analysis, and the full suite together — the same thing CI runs on every push.

Reusing this for a new project

Update APP_NAME and other .env values for the new project.
Swap the brand palette in resources/css/app.css (--color-brand-*) and the logo mark in public/images/logo.png.
Replace the seeded accounts (database/seeders/UserSeeder.php) and the landing page copy, which is hardcoded directly in resources/views/components/landing/*.
Update composer.json's name/description if the repo is being renamed too.

More detail — architecture notes, where each feature lives, how to extend the landing page — is in the in-app docs at /docs once you're logged in.

License

MIT.

recodex-id / rewire

Maintainers

Package info

Statistics

Security