How chrisscastaneda/laravel-greenfield works
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: UserPolicy.php User policy · User.php User account model · UserController.php User browsing · UserAdminController.php Admin access controller
Components 20
Authentication
- Auth routes
routes/auth.php - Authentication callback
app/Http/Controllers/Auth/AuthenticateController.php - WorkOS user sync
app/Actions/Auth/SyncWorkOSUser.php
User administration
- Admin routes
routes/admin.php - User browsing
app/Http/Controllers/Admin/UserController.php - Admin access controller
app/Http/Controllers/Admin/UserAdminController.php - Account status controller
app/Http/Controllers/Admin/UserDeactivationController.php - User policy
app/Policies/UserPolicy.php - Grant admin action
app/Actions/Admin/GrantAdmin.php - Revoke admin action
app/Actions/Admin/RevokeAdmin.php - Deactivate action
app/Actions/Admin/DeactivateUser.php - Reactivate action
app/Actions/Admin/ReactivateUser.php - Admin user screens
resources/js/pages/admin/users
Accounts and settings
- User account model
app/Models/User.php - Profile and deletion
app/Http/Controllers/Settings/ProfileController.php - Profile and appearance UI
resources/js/pages/settings
Web request layer
- Web middleware setup
bootstrap/app.php - Active account guard
app/Http/Middleware/EnsureUserIsActive.php
Other components
- User
- WorkOS AuthKit
Connections 32
- User → WorkOS AuthKit: signs in through
- WorkOS AuthKit → Authentication callback: returns to callback
- Auth routes → Authentication callback: routes to
routes/auth.php - Authentication callback → WorkOS user sync: synchronizes identity
app/Http/Controllers/Auth/AuthenticateController.php - WorkOS user sync → User account model: finds or updates
app/Actions/Auth/SyncWorkOSUser.php - Web middleware setup → Active account guard: appends middleware
bootstrap/app.php - Admin routes → User browsing: routes to
routes/admin.php - Admin routes → Admin access controller: routes to
routes/admin.php - Admin routes → Account status controller: routes to
routes/admin.php - User → Admin user screens: browses and manages
- Admin user screens → Admin routes: submits admin requests
- User browsing → User policy: authorizes listing
app/Http/Controllers/Admin/UserController.php - User browsing → User account model: queries users
app/Http/Controllers/Admin/UserController.php - User browsing → Admin user screens: renders user data
app/Http/Controllers/Admin/UserController.php - Admin access controller → User policy: authorizes changes
app/Http/Controllers/Admin/UserAdminController.php - Admin access controller → Grant admin action: invokes grant
app/Http/Controllers/Admin/UserAdminController.php - Admin access controller → Revoke admin action: invokes revoke
app/Http/Controllers/Admin/UserAdminController.php - Account status controller → User policy: authorizes changes
- Account status controller → Deactivate action: invokes deactivation
app/Http/Controllers/Admin/UserDeactivationController.php - Account status controller → Reactivate action: invokes reactivation
app/Http/Controllers/Admin/UserDeactivationController.php - User policy → Grant admin action: checks safeguards
app/Policies/UserPolicy.php - User policy → Revoke admin action: checks safeguards
app/Policies/UserPolicy.php - User policy → Deactivate action: checks safeguards
app/Policies/UserPolicy.php - User policy → Reactivate action: checks safeguards
app/Policies/UserPolicy.php - Grant admin action → User account model: updates account
app/Actions/Admin/GrantAdmin.php - Revoke admin action → User account model: updates account
app/Actions/Admin/RevokeAdmin.php - Deactivate action → User account model: updates account
app/Actions/Admin/DeactivateUser.php - Reactivate action → User account model: updates account
app/Actions/Admin/ReactivateUser.php - User → Profile and deletion: manages account
- Profile and deletion → User account model: updates or deletes
app/Http/Controllers/Settings/ProfileController.php - Profile and deletion → Profile and appearance UI: renders settings
app/Http/Controllers/Settings/ProfileController.php - User → Profile and appearance UI: changes appearance