Essentials Laravel Package

nyumbani-auth

Invoke when working on sign-in, logout, password reset, the login throttle, where a user lands after signing in (HasHomeRoute), or impersonating a user in a Nyumbani app. Skip for roles and permissions (see nyumbani-permissions) and for registration, which Nyumbani apps do not have.

claude-code

nyumbani-defaults

Invoke when a Nyumbani app behaves unexpectedly because of an app-wide default (lazy loading throws, migrate:fresh refuses, JSON resources are not wrapped, the debugbar, the log context) or when switching one off in config/essentials.php. Skip for the discord log channel itself (see nyumbani-logging).

claude-code

nyumbani-helpers

Invoke when formatting money, numbers, percentages, dates, times, durations or text in a Nyumbani app, using the Blade directives or JavaScript equivalents, or scoping a report to a month, year, day or date range with request()->period(). Skip for validation rules and model traits.

claude-code

nyumbani-install

Invoke when setting up a Nyumbani app, running or changing php artisan nyumbani:install, reading its setup checklist, or fixing a checklist item: rules, Boost, config files, migrations, imports, the discord log channel, the HasDefaultPermissions trait, the UI package's own installer (`ui:install`, `--portal`), or the Pint step. Skip for using a feature once it is installed.

claude-code

nyumbani-logging

Invoke when a Nyumbani app sends errors or logs to Discord: adding the discord log channel, its webhook URL, level, throttle or message length, or when log records do not reach Discord. Skip for other log channels.

claude-code

nyumbani-model-traits

Invoke when writing or changing an Eloquent model, an enum, an Upload model or a factory in a Nyumbani app: ulid route keys (HasUlids), HasMorphRouteKey, year-scoped numbers (HasNumberIdentifiers), money on a model (HasMoney), enum labels (HasEnumElements), uploads and profile images (HasUploads, HasProfileImage), or Kenyan fake names and numbers (HasKenyans). Skip for roles and permissions traits (see nyumbani-permissions).

claude-code

nyumbani-permissions

Invoke when adding or changing roles and permissions in a Nyumbani app: database/seeders/data/permissions.json, php artisan nyumbani:permissions, assigning a role to a user (assignDefaultPermissions), checking a permission in a policy, the role list for a select box, or the permission tables' group column. Skip for sign-in and impersonation (see nyumbani-auth).

claude-code

nyumbani-validation

Invoke when validating input in a Nyumbani app: Form Requests, the phone rules KenyanNumberValid and PhoneNumberValid, the CleanName cast for names, friendly attribute names, or password rules. Skip for several forms on one page (see nyumbani-error-bags) and for sign-in (see nyumbani-auth).

claude-code