# satnaing/shadcn-admin architecture

> Architecture diagram of the GitHub repository satnaing/shadcn-admin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/satnaing/shadcn-admin
- Repository: https://github.com/satnaing/shadcn-admin

## Overview

Shadcn Admin is a responsive admin-dashboard UI: users enter through routed sign-in or authenticated areas, then work with dashboard pages such as tasks, users, settings, and apps. The sampled task UI demonstrates a local-data table workflow with filtering, sorting, pagination, and form-based edits; it does not show a backend persistence layer. The README also documents global search, theme and RTL support. Some page capabilities are represented from the tree and README; their internal wiring was not sampled.

Main entry points: [`src/components/layout/authenticated-layout.tsx`](https://github.com/satnaing/shadcn-admin/blob/main/src/components/layout/authenticated-layout.tsx) (App Layout), [`src/features/tasks/components/tasks-table.tsx`](https://github.com/satnaing/shadcn-admin/blob/main/src/features/tasks/components/tasks-table.tsx) (Task Table), [`src/main.tsx`](https://github.com/satnaing/shadcn-admin/blob/main/src/main.tsx) (React Entry), [`src/routeTree.gen.ts`](https://github.com/satnaing/shadcn-admin/blob/main/src/routeTree.gen.ts) (Route Tree)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App Entry"]
  node_main["React Entry<br/>[main.tsx]"]
  node_routes["Route Tree<br/>[routeTree.gen.ts]"]
  node_authroutes["Auth Routes<br/>[sign-in.tsx]"]
  node_authenticated["Authenticated Routes<br/>[route.tsx]"]
  node_clerkroute["Clerk Integration<br/>[route.tsx]"]
end

subgraph group_shell["Dashboard Shell"]
  node_layout["App Layout"]
  node_search["Global Search<br/>[command-menu.tsx]"]
  node_providers["UI Providers<br/>[theme-provider.tsx]"]
end

subgraph group_pages["Dashboard Pages"]
  node_authforms["Auth Screens"]
  node_dashboard["Dashboard"]
  node_tasks["Task Management<br/>[index.tsx]"]
  node_tasktable["Task Table<br/>[tasks-table.tsx]"]
  node_taskdata["Sample Task Data<br/>[tasks.ts]"]
  node_taskedit["Task Editor"]
  node_users["User Management<br/>[index.tsx]"]
  node_settings["Settings<br/>[index.tsx]"]
  node_apps["Apps Catalog<br/>[index.tsx]"]
  node_chats["Chats<br/>[index.tsx]"]
  node_errors["Error Pages"]
end

subgraph group_shared["Shared UI"]
  node_sharedtable["Table Controls<br/>[index.ts]"]
  node_uikit["UI Components"]
end

node_visitor(("Dashboard User"))
node_clerk(("Clerk Service"))

node_visitor -->|"opens app"| node_main
node_main -->|"installs router"| node_routes
node_routes -->|"dispatches routes"| node_authroutes
node_routes -->|"dispatches routes"| node_authenticated
node_authenticated -->|"renders layout"| node_layout
node_authroutes -->|"renders screens"| node_authforms
node_layout -->|"hosts page"| node_dashboard
node_layout -->|"hosts page"| node_tasks
node_layout -->|"hosts page"| node_users
node_layout -->|"hosts page"| node_settings
node_layout -->|"hosts page"| node_apps
node_layout -->|"hosts page"| node_chats
node_layout -->|"hosts page"| node_errors
node_layout -->|"provides access"| node_search
node_main -->|"wraps app"| node_providers
node_tasks -->|"renders table"| node_tasktable
node_tasktable -->|"reads sample rows"| node_taskdata
node_tasktable -->|"uses controls"| node_sharedtable
node_tasktable -->|"opens editor"| node_taskedit
node_taskedit -->|"uses primitives"| node_uikit
node_sharedtable -->|"uses primitives"| node_uikit
node_clerkroute -.->|"uses provider"| node_clerk

click node_main "https://github.com/satnaing/shadcn-admin/blob/main/src/main.tsx"
click node_routes "https://github.com/satnaing/shadcn-admin/blob/main/src/routeTree.gen.ts"
click node_authroutes "https://github.com/satnaing/shadcn-admin/blob/main/src/routes/(auth)/sign-in.tsx"
click node_authforms "https://github.com/satnaing/shadcn-admin/tree/main/src/features/auth"
click node_authenticated "https://github.com/satnaing/shadcn-admin/blob/main/src/routes/_authenticated/route.tsx"
click node_layout "https://github.com/satnaing/shadcn-admin/blob/main/src/components/layout/authenticated-layout.tsx"
click node_dashboard "https://github.com/satnaing/shadcn-admin/tree/main/src/features/dashboard"
click node_tasks "https://github.com/satnaing/shadcn-admin/blob/main/src/features/tasks/index.tsx"
click node_tasktable "https://github.com/satnaing/shadcn-admin/blob/main/src/features/tasks/components/tasks-table.tsx"
click node_taskdata "https://github.com/satnaing/shadcn-admin/blob/main/src/features/tasks/data/tasks.ts"
click node_taskedit "https://github.com/satnaing/shadcn-admin/blob/main/src/features/tasks/components/tasks-mutate-drawer.tsx"
click node_users "https://github.com/satnaing/shadcn-admin/blob/main/src/features/users/index.tsx"
click node_settings "https://github.com/satnaing/shadcn-admin/blob/main/src/features/settings/index.tsx"
click node_apps "https://github.com/satnaing/shadcn-admin/blob/main/src/features/apps/index.tsx"
click node_chats "https://github.com/satnaing/shadcn-admin/blob/main/src/features/chats/index.tsx"
click node_errors "https://github.com/satnaing/shadcn-admin/tree/main/src/features/errors"
click node_search "https://github.com/satnaing/shadcn-admin/blob/main/src/components/command-menu.tsx"
click node_providers "https://github.com/satnaing/shadcn-admin/blob/main/src/context/theme-provider.tsx"
click node_sharedtable "https://github.com/satnaing/shadcn-admin/blob/main/src/components/data-table/index.ts"
click node_uikit "https://github.com/satnaing/shadcn-admin/tree/main/src/components/ui"
click node_clerkroute "https://github.com/satnaing/shadcn-admin/blob/main/src/routes/clerk/route.tsx"

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_main,node_routes,node_authroutes,node_authenticated,node_clerkroute,node_visitor toneBlue
class node_layout,node_search,node_providers toneAmber
class node_authforms,node_dashboard,node_tasks,node_tasktable,node_taskdata,node_taskedit,node_users,node_settings,node_apps,node_chats,node_errors toneMint
class node_sharedtable,node_uikit toneRose
class node_clerk toneIndigo
```

## Components

### App Entry

- [React Entry](https://github.com/satnaing/shadcn-admin/blob/main/src/main.tsx): `src/main.tsx`
- [Route Tree](https://github.com/satnaing/shadcn-admin/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [Auth Routes](https://github.com/satnaing/shadcn-admin/blob/main/src/routes/(auth)/sign-in.tsx): `src/routes/(auth)/sign-in.tsx`
- [Authenticated Routes](https://github.com/satnaing/shadcn-admin/blob/main/src/routes/_authenticated/route.tsx): `src/routes/_authenticated/route.tsx`
- [Clerk Integration](https://github.com/satnaing/shadcn-admin/blob/main/src/routes/clerk/route.tsx): `src/routes/clerk/route.tsx`

### Dashboard Shell

- [App Layout](https://github.com/satnaing/shadcn-admin/blob/main/src/components/layout/authenticated-layout.tsx): `src/components/layout/authenticated-layout.tsx`
- [Global Search](https://github.com/satnaing/shadcn-admin/blob/main/src/components/command-menu.tsx): `src/components/command-menu.tsx`
- [UI Providers](https://github.com/satnaing/shadcn-admin/blob/main/src/context/theme-provider.tsx): `src/context/theme-provider.tsx`

### Dashboard Pages

- [Auth Screens](https://github.com/satnaing/shadcn-admin/tree/main/src/features/auth): `src/features/auth`
- [Dashboard](https://github.com/satnaing/shadcn-admin/tree/main/src/features/dashboard): `src/features/dashboard`
- [Task Management](https://github.com/satnaing/shadcn-admin/blob/main/src/features/tasks/index.tsx): `src/features/tasks/index.tsx`
- [Task Table](https://github.com/satnaing/shadcn-admin/blob/main/src/features/tasks/components/tasks-table.tsx): `src/features/tasks/components/tasks-table.tsx`
- [Sample Task Data](https://github.com/satnaing/shadcn-admin/blob/main/src/features/tasks/data/tasks.ts): `src/features/tasks/data/tasks.ts`
- [Task Editor](https://github.com/satnaing/shadcn-admin/blob/main/src/features/tasks/components/tasks-mutate-drawer.tsx): `src/features/tasks/components/tasks-mutate-drawer.tsx`
- [User Management](https://github.com/satnaing/shadcn-admin/blob/main/src/features/users/index.tsx): `src/features/users/index.tsx`
- [Settings](https://github.com/satnaing/shadcn-admin/blob/main/src/features/settings/index.tsx): `src/features/settings/index.tsx`
- [Apps Catalog](https://github.com/satnaing/shadcn-admin/blob/main/src/features/apps/index.tsx): `src/features/apps/index.tsx`
- [Chats](https://github.com/satnaing/shadcn-admin/blob/main/src/features/chats/index.tsx): `src/features/chats/index.tsx`
- [Error Pages](https://github.com/satnaing/shadcn-admin/tree/main/src/features/errors): `src/features/errors`

### Shared UI

- [Table Controls](https://github.com/satnaing/shadcn-admin/blob/main/src/components/data-table/index.ts): `src/components/data-table/index.ts`
- [UI Components](https://github.com/satnaing/shadcn-admin/tree/main/src/components/ui): `src/components/ui`

### Other components

- **Dashboard User**
- **Clerk Service**

## Connections

- Dashboard User → React Entry: opens app
- React Entry → Route Tree: installs router
- Route Tree → Auth Routes: dispatches routes
- Route Tree → Authenticated Routes: dispatches routes
- Authenticated Routes → App Layout: renders layout
- Auth Routes → Auth Screens: renders screens
- App Layout → Dashboard: hosts page
- App Layout → Task Management: hosts page
- App Layout → User Management: hosts page
- App Layout → Settings: hosts page
- App Layout → Apps Catalog: hosts page
- App Layout → Chats: hosts page
- App Layout → Error Pages: hosts page
- App Layout → Global Search: provides access
- React Entry → UI Providers: wraps app
- Task Management → Task Table: renders table
- Task Table → Sample Task Data: reads sample rows
- Task Table → Table Controls: uses controls
- Task Table → Task Editor: opens editor
- Task Editor → UI Components: uses primitives
- Table Controls → UI Components: uses primitives
- Clerk Integration → Clerk Service: uses provider
