# chrisscastaneda/laravel-greenfield architecture

> Architecture diagram of the GitHub repository chrisscastaneda/laravel-greenfield, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chrisscastaneda/laravel-greenfield
- Repository: https://github.com/chrisscastaneda/laravel-greenfield

## Overview

Greenfield is a Laravel SaaS starter whose runtime centers on WorkOS sign-in, user account/settings management, and an admin area for browsing and managing users. The main flow is an administrator request routed to a controller, checked by user policy, and carried out by an admin action against the user model; the authentication callback synchronizes WorkOS identity. The README also documents profile, appearance, account deletion, and deactivation safeguards. Unsampled frontend and runtime wiring is represented only where documented; source evidence is limited to the supplied excerpts and index.

Main entry points: [`app/Policies/UserPolicy.php`](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Policies/UserPolicy.php) (User policy), [`app/Models/User.php`](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Models/User.php) (User account model), [`app/Http/Controllers/Admin/UserController.php`](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Admin/UserController.php) (User browsing), [`app/Http/Controllers/Admin/UserAdminController.php`](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Admin/UserAdminController.php) (Admin access controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Authentication"]
  node_auth_routes["Auth routes<br/>[auth.php]"]
  node_auth_callback["Authentication callback"]
  node_identity_sync["WorkOS user sync<br/>[SyncWorkOSUser.php]"]
end

subgraph group_admin["User administration"]
  node_admin_routes["Admin routes<br/>[admin.php]"]
  node_user_list["User browsing<br/>[UserController.php]"]
  node_admin_access["Admin access controller"]
  node_deactivation["Account status controller"]
  node_admin_policy["User policy<br/>[UserPolicy.php]"]
  node_grant_admin["Grant admin action<br/>[GrantAdmin.php]"]
  node_revoke_admin["Revoke admin action<br/>[RevokeAdmin.php]"]
  node_deactivate["Deactivate action<br/>[DeactivateUser.php]"]
  node_reactivate["Reactivate action<br/>[ReactivateUser.php]"]
  node_admin_ui["Admin user screens"]
end

subgraph group_account["Accounts and settings"]
  node_user_model["User account model<br/>[User.php]"]
  node_profile["Profile and deletion"]
  node_settings_ui["Profile and appearance UI"]
end

subgraph group_web["Web request layer"]
  node_web_bootstrap["Web middleware setup<br/>[app.php]"]
  node_active_guard["Active account guard"]
end

node_visitor(("User"))
node_workos["WorkOS AuthKit"]

node_visitor -->|"signs in through"| node_workos
node_workos -->|"returns to callback"| node_auth_callback
node_auth_routes -->|"routes to"| node_auth_callback
node_auth_callback -->|"synchronizes identity"| node_identity_sync
node_identity_sync -->|"finds or updates"| node_user_model
node_web_bootstrap -->|"appends middleware"| node_active_guard
node_admin_routes -->|"routes to"| node_user_list
node_admin_routes -->|"routes to"| node_admin_access
node_admin_routes -->|"routes to"| node_deactivation
node_visitor -->|"browses and manages"| node_admin_ui
node_admin_ui -.->|"submits admin requests"| node_admin_routes
node_user_list -->|"authorizes listing"| node_admin_policy
node_user_list -->|"queries users"| node_user_model
node_user_list -->|"renders user data"| node_admin_ui
node_admin_access -->|"authorizes changes"| node_admin_policy
node_admin_access -->|"invokes grant"| node_grant_admin
node_admin_access -->|"invokes revoke"| node_revoke_admin
node_deactivation -.->|"authorizes changes"| node_admin_policy
node_deactivation -->|"invokes deactivation"| node_deactivate
node_deactivation -->|"invokes reactivation"| node_reactivate
node_admin_policy -->|"checks safeguards"| node_grant_admin
node_admin_policy -->|"checks safeguards"| node_revoke_admin
node_admin_policy -->|"checks safeguards"| node_deactivate
node_admin_policy -->|"checks safeguards"| node_reactivate
node_grant_admin -->|"updates account"| node_user_model
node_revoke_admin -->|"updates account"| node_user_model
node_deactivate -->|"updates account"| node_user_model
node_reactivate -->|"updates account"| node_user_model
node_visitor -->|"manages account"| node_profile
node_profile -->|"updates or deletes"| node_user_model
node_profile -->|"renders settings"| node_settings_ui
node_visitor -->|"changes appearance"| node_settings_ui

click node_auth_routes "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/routes/auth.php"
click node_auth_callback "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Auth/AuthenticateController.php"
click node_identity_sync "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Actions/Auth/SyncWorkOSUser.php"
click node_web_bootstrap "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/bootstrap/app.php"
click node_active_guard "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Middleware/EnsureUserIsActive.php"
click node_admin_routes "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/routes/admin.php"
click node_user_list "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Admin/UserController.php"
click node_admin_access "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Admin/UserAdminController.php"
click node_deactivation "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Admin/UserDeactivationController.php"
click node_admin_policy "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Policies/UserPolicy.php"
click node_grant_admin "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Actions/Admin/GrantAdmin.php"
click node_revoke_admin "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Actions/Admin/RevokeAdmin.php"
click node_deactivate "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Actions/Admin/DeactivateUser.php"
click node_reactivate "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Actions/Admin/ReactivateUser.php"
click node_user_model "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Models/User.php"
click node_profile "https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Settings/ProfileController.php"
click node_settings_ui "https://github.com/chrisscastaneda/laravel-greenfield/tree/main/resources/js/pages/settings"
click node_admin_ui "https://github.com/chrisscastaneda/laravel-greenfield/tree/main/resources/js/pages/admin/users"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_routes,node_auth_callback,node_identity_sync,node_visitor toneBlue
class node_admin_routes,node_user_list,node_admin_access,node_deactivation,node_admin_policy,node_grant_admin,node_revoke_admin,node_deactivate,node_reactivate,node_admin_ui toneAmber
class node_user_model,node_profile,node_settings_ui toneMint
class node_web_bootstrap,node_active_guard toneRose
class node_workos toneIndigo
```

## Components

### Authentication

- [Auth routes](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/routes/auth.php): `routes/auth.php`
- [Authentication callback](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Auth/AuthenticateController.php): `app/Http/Controllers/Auth/AuthenticateController.php`
- [WorkOS user sync](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Actions/Auth/SyncWorkOSUser.php): `app/Actions/Auth/SyncWorkOSUser.php`

### User administration

- [Admin routes](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/routes/admin.php): `routes/admin.php`
- [User browsing](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Admin/UserController.php): `app/Http/Controllers/Admin/UserController.php`
- [Admin access controller](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Admin/UserAdminController.php): `app/Http/Controllers/Admin/UserAdminController.php`
- [Account status controller](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Admin/UserDeactivationController.php): `app/Http/Controllers/Admin/UserDeactivationController.php`
- [User policy](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Policies/UserPolicy.php): `app/Policies/UserPolicy.php`
- [Grant admin action](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Actions/Admin/GrantAdmin.php): `app/Actions/Admin/GrantAdmin.php`
- [Revoke admin action](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Actions/Admin/RevokeAdmin.php): `app/Actions/Admin/RevokeAdmin.php`
- [Deactivate action](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Actions/Admin/DeactivateUser.php): `app/Actions/Admin/DeactivateUser.php`
- [Reactivate action](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Actions/Admin/ReactivateUser.php): `app/Actions/Admin/ReactivateUser.php`
- [Admin user screens](https://github.com/chrisscastaneda/laravel-greenfield/tree/main/resources/js/pages/admin/users): `resources/js/pages/admin/users`

### Accounts and settings

- [User account model](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Models/User.php): `app/Models/User.php`
- [Profile and deletion](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Controllers/Settings/ProfileController.php): `app/Http/Controllers/Settings/ProfileController.php`
- [Profile and appearance UI](https://github.com/chrisscastaneda/laravel-greenfield/tree/main/resources/js/pages/settings): `resources/js/pages/settings`

### Web request layer

- [Web middleware setup](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/bootstrap/app.php): `bootstrap/app.php`
- [Active account guard](https://github.com/chrisscastaneda/laravel-greenfield/blob/main/app/Http/Middleware/EnsureUserIsActive.php): `app/Http/Middleware/EnsureUserIsActive.php`

### Other components

- **User**
- **WorkOS AuthKit**

## Connections

- User → WorkOS AuthKit: signs in through
- WorkOS AuthKit → Authentication callback: returns to callback
- Auth routes → Authentication callback: routes to (evidence: `routes/auth.php`)
- Authentication callback → WorkOS user sync: synchronizes identity (evidence: `app/Http/Controllers/Auth/AuthenticateController.php`)
- WorkOS user sync → User account model: finds or updates (evidence: `app/Actions/Auth/SyncWorkOSUser.php`)
- Web middleware setup → Active account guard: appends middleware (evidence: `bootstrap/app.php`)
- Admin routes → User browsing: routes to (evidence: `routes/admin.php`)
- Admin routes → Admin access controller: routes to (evidence: `routes/admin.php`)
- Admin routes → Account status controller: routes to (evidence: `routes/admin.php`)
- User → Admin user screens: browses and manages
- Admin user screens → Admin routes: submits admin requests
- User browsing → User policy: authorizes listing (evidence: `app/Http/Controllers/Admin/UserController.php`)
- User browsing → User account model: queries users (evidence: `app/Http/Controllers/Admin/UserController.php`)
- User browsing → Admin user screens: renders user data (evidence: `app/Http/Controllers/Admin/UserController.php`)
- Admin access controller → User policy: authorizes changes (evidence: `app/Http/Controllers/Admin/UserAdminController.php`)
- Admin access controller → Grant admin action: invokes grant (evidence: `app/Http/Controllers/Admin/UserAdminController.php`)
- Admin access controller → Revoke admin action: invokes revoke (evidence: `app/Http/Controllers/Admin/UserAdminController.php`)
- Account status controller → User policy: authorizes changes
- Account status controller → Deactivate action: invokes deactivation (evidence: `app/Http/Controllers/Admin/UserDeactivationController.php`)
- Account status controller → Reactivate action: invokes reactivation (evidence: `app/Http/Controllers/Admin/UserDeactivationController.php`)
- User policy → Grant admin action: checks safeguards (evidence: `app/Policies/UserPolicy.php`)
- User policy → Revoke admin action: checks safeguards (evidence: `app/Policies/UserPolicy.php`)
- User policy → Deactivate action: checks safeguards (evidence: `app/Policies/UserPolicy.php`)
- User policy → Reactivate action: checks safeguards (evidence: `app/Policies/UserPolicy.php`)
- Grant admin action → User account model: updates account (evidence: `app/Actions/Admin/GrantAdmin.php`)
- Revoke admin action → User account model: updates account (evidence: `app/Actions/Admin/RevokeAdmin.php`)
- Deactivate action → User account model: updates account (evidence: `app/Actions/Admin/DeactivateUser.php`)
- Reactivate action → User account model: updates account (evidence: `app/Actions/Admin/ReactivateUser.php`)
- User → Profile and deletion: manages account
- Profile and deletion → User account model: updates or deletes (evidence: `app/Http/Controllers/Settings/ProfileController.php`)
- Profile and deletion → Profile and appearance UI: renders settings (evidence: `app/Http/Controllers/Settings/ProfileController.php`)
- User → Profile and appearance UI: changes appearance
