--- title: "React Kit Pages & Routes" description: "Every Inertia page in the React kit with its route, access rules, layout and purpose, from sign-in and settings pages to tenants, users and setup." --- # Pages All pages are in `resources/js/pages`. A page is a function component exported as the default, and you refer to it in Inertia by its kebab-case path minus the `.tsx`: ```text Inertia::render('users/index') → resources/js/pages/users/index.tsx ``` The controllers behind them are in `Modules//Http/Controllers`. ::: info A route marked **central** exists only on the central domain (`APP_DOMAIN`, `central.only` middleware). The rest work on central and tenant domains alike, which is why their permissions name both variants (for example `View Users|View Tenant Users`). ::: ## Public and auth pages Auth pages are shown inside `AuthLayout` (card, simple or split). The routes come from Fortify, and `Modules/Auth/Providers/AuthServiceProvider.php` connects each one to its page. | Page file | Route | Purpose | | --- | --- | --- | | `home.tsx` | `GET /` (`home`) | Landing page on the central domain. Tenant domains redirect to `login`. No layout. | | `auth/login.tsx` | `GET /login` (`login`) | Email + password login, passkey login, links to reset/register when enabled for the domain | | `auth/register.tsx` | `GET /register` (`register`) | Registration, when enabled for the domain | | `auth/forgot-password.tsx` | `GET /forgot-password` (`password.request`) | Request a reset link | | `auth/reset-password.tsx` | `GET /reset-password/{token}` (`password.reset`) | Set a new password | | `auth/verify-email.tsx` | `GET /email/verify` (`verification.notice`) | Resend the verification email | | `auth/confirm-password.tsx` | `GET /user/confirm-password` (`password.confirm`) | Re-enter password before sensitive pages | | `auth/two-factor-challenge.tsx` | `GET /two-factor-challenge` (`two-factor.login`) | TOTP code or recovery code; switches the layout title with `setLayoutProps` | | `auth/accept-invitation.tsx` | `GET /invitation/accept` (`tenant.invitation.show`, tenant, signed) and `GET /users/invitation/{user}` (`users.invitation.show`, signed) | Invited tenant admin or user sets a password. `mode` prop: `'workspace'` or `'user'` | | `auth/maintenance.tsx` | Rendered by `EnsureTenantIsNotInMaintenance` on tenant domains | Animated maintenance page with the custom message. No layout. | | `auth/suspended.tsx` | Rendered by `EnsureTenantIsNotSuspended` on tenant domains | Suspended workspace notice with the custom message. No layout. | ## App pages These pages use `AppLayout`, and the user has to pass `auth` + `verified` to reach them. | Page file | Route | Permission | Purpose | | --- | --- | --- | --- | | `dashboard.tsx` | `GET /dashboard` (`dashboard`, `Route::inertia`) | `View Analytics Dashboard\|View Tenant Dashboard` | Dashboard placeholder grid | | `users/index.tsx` | `GET /users` (`users.index`) | `View Users\|View Tenant Users` | User list with search, stats, pagination, create/edit/delete, invitations, permission assignment | | `roles/index.tsx` | `GET /roles` (`roles.index`) | `View Roles\|View Tenant Roles` | Role list and create/edit/delete (system roles protected) | | `tenants/index.tsx` | `GET /tenants` (`tenants.index`), central | `View Tenants` | Tenant list with search, status filter and stats | | `tenants/create.tsx` | `GET /tenants/create` (`tenants.create`), central | `Create Tenant` | Create a tenant (company, subdomain, admin, profile data, status) | | `tenants/show.tsx` | `GET /tenants/{tenant}` (`tenants.show`), central | `View Tenants` | Tenant detail: edit, domains, reset admin password, resend invitation, delete | | `tenants/domains.tsx` | `GET /tenants/domains` (`tenants.domains`), central | `View Tenants` | All domains: filters, search, add, set primary, delete, per-domain settings and auth features | ## Settings pages Pages under `settings/*` get `AppLayout` with the settings sub-navigation (`layouts/settings/layout.tsx`) on top. Visiting `GET /settings` sends you to `/settings/profile`. | Page file | Route | Purpose | | --- | --- | --- | | `settings/profile.tsx` | `GET /settings/profile` (`profile.edit`) | Name, email, language ("Default" follows the domain), email verification notice, delete account | | `settings/security.tsx` | `GET /settings/security` (`security.edit`), requires password confirmation | Change password, two-factor authentication, passkeys | | `settings/appearance.tsx` | `GET /settings/appearance` (`appearance.edit`, `Route::inertia`) | Light / dark / system | | `settings/layout.tsx` | `GET /settings/layout` (`layout.edit`) | Personal layout: app layout, sidebar variant, collapsible mode | ## Setup pages Pages under `setup/*` use the plain `AppLayout`. On any URL starting with `/setup`, the sidebar swaps the main menu for `setupMenus`. `GET /setup` redirects to `/setup/menus`. | Page file | Route | Permission | Purpose | | --- | --- | --- | --- | | `setup/menus.tsx` | `GET /setup/menus` (`setup.menus.index`) | `View Navigation Menus\|View Tenant Menus` | Drag & drop menu order (`sortablejs`), reset to defaults | | `setup/layout.tsx` | `GET /setup/layout` (`setup.layout.index`) | `Update Layout Settings\|Update Tenant Layout` | Global default app layout, sidebar settings and auth layout | | `setup/tenant-settings.tsx` | `GET /setup/tenant-settings` (`setup.tenant-settings.edit`), central | `Manage Tenant Maintenance` | Global maintenance mode for tenant workspaces | ## Error page | Page file | Rendered by | Purpose | | --- | --- | --- | | `errors/error.tsx` | Exception handler in `bootstrap/app.php` | 403, 404, 500 and 503 responses. Uses `AppLayout` for signed-in users and `AuthLayout` for guests. | In `local` and `testing` you'll only see this page for a 403. Any other status shows Laravel's debug page. ## Partials Modals and sections that belong to a single page sit in a `partials/` folder beside it: | File | Used by | | --- | --- | | `users/partials/user-form-modal.tsx` | Create/edit user, "Send invitation email" | | `users/partials/assign-user-permissions-modal.tsx` | Grouped permission checkboxes for one user | | `roles/partials/role-form-modal.tsx` | Create/edit role | | `tenants/partials/edit-tenant-modal.tsx` | Edit tenant details and status | | `tenants/partials/organization-domains.tsx` | Domains card on the tenant detail page | | `tenants/partials/domain-modal.tsx` | Add a domain | | `tenants/partials/domain-settings-modal.tsx` | Per-domain App name and default language | | `tenants/partials/domain-auth-features-modal.tsx` | Per-domain registration / password reset / verification / 2FA / passkeys toggles | | `tenants/partials/reset-password-modal.tsx` | Send a reset link or set the tenant admin password | | `tenants/partials/maintenance-mode-form.tsx` | Maintenance message, secret bypass link, allowed IPs | ::: tip Building a new page? [Development → Adding a page](/docs/react/development#adding-a-page) takes you through it step by step. :::