README

React, authentication, Filament, and localization scaffolding for the Craft React starterkit.

Requirements

• PHP 8.3 or newer
• Laravel 12 or 13
• Node.js with npm, or Bun
• A Craft React starterkit application

Installation

composer require hardimpactdev/craft-laravel

Setups

The package exposes three setup commands:

The React scaffold registry is bundled with this package, so setup does not depend on a local craft-ui-react checkout.

Application setup

npm install
php artisan craft:setup app
php artisan migrate
npm run build

The generated application includes Fortify login and registration, password reset, email verification, passkeys, two-factor confirmation, dashboard and account settings pages, Waymaker controllers, Wayfinder imports, and feature tests.

Filament setup

npm install
php artisan craft:setup filament
php artisan migrate
php artisan make:filament-user
npm run build

Filament authentication redirects are configured for /admin. If the application scaffold already provides a dashboard, its redirect remains in place.

Multilanguage setup

php artisan craft:setup multilanguage
npm run build

This creates lang/en.json, lang/nl.json, and resources/js/pages/TranslationExample.tsx, then enables i18n in vite.config.ts.

All setups generate Waymaker routes and are safe to run again.

Development

composer test
composer analyse
composer format -- --test
composer validate --strict

The integration workflow also runs every public setup against the current Craft React starterkit and builds the resulting application.

Changelog

See CHANGELOG.md for release history.

Security

Report vulnerabilities through the repository's security policy.

License

The MIT License. See LICENSE.md.