house-style
The house style for this codebase — read it before writing any PHP or Blade here. Covers where code goes (the 13 app/ folders and the pages:: view tree), Livewire 4 single-file components and the ⚡ filename convention, the With* traits, the k*() helper inventory, enum naming and WithEnumHelpers, #[Singleton] services, #[Unguarded] models with casts() and #[Scope], the nine-step form save and respondSuccess(), Flux UI usage and the tone palette, activity logging on admin writes, the two workspaces and their route files, and Pest conventions. Also says what this project deliberately does NOT use — no Actions, Repositories, Jobs, Events, Policies, or Form Requests — and what to reach for instead. Trigger whenever adding a screen, model, migration, service, trait, enum, helper, component, or test; whenever naming a file, class, method, route, or column; and whenever a Laravel default would conflict with how this project is written.