# abhi-dhakar/nagar-platform architecture

> Architecture diagram of the GitHub repository abhi-dhakar/nagar-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abhi-dhakar/nagar-platform
- Repository: https://github.com/abhi-dhakar/nagar-platform

## Overview

Nagar is a developer platform, with NagarHub as the implemented product: users create and browse repositories, push Git history, and collaborate through issues, pull requests, organizations, notifications, and webhooks. NagarCode and NagarDeploy are currently app shells, not working development or deployment workflows. The graph combines README-documented capabilities with sampled API wiring and UI references; unsampled feature routes are represented at their existing directories, with relationships included only where documented or indexed.

Main entry points: [`services/api/src/app.ts`](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/app.ts) (HTTP API), [`apps/hub/src/app`](https://github.com/abhi-dhakar/nagar-platform/tree/main/apps/hub/src/app) (Hub pages and navigation), [`services/api/src/modules/repositories/repository-routes.ts`](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/repositories/repository-routes.ts) (Repository management), [`services/api/src/modules/auth/current-user.ts`](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/auth/current-user.ts) (Session identity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_hub["NagarHub interface"]
  node_hub_ui["Hub pages and navigation"]
  node_repo_browser["Repository browser"]
  node_commit_history["Commit history<br/>[commit-history.tsx]"]
  node_hub_frame["Hub frame<br/>[hub-frame.tsx]"]
  node_auth_ui["Sign-in and signup<br/>[auth-form.tsx]"]
  node_collaboration_ui["Issues and pull requests"]
  node_org_ui["Organization workflows"]
  node_settings_ui["Repository settings"]
  node_notifications_ui["Notification inbox"]
  node_code_shell["NagarCode shell<br/>[page.tsx]"]
  node_deploy_shell["NagarDeploy shell<br/>[page.tsx]"]
end

subgraph group_api["API workflows"]
  node_api_app["HTTP API<br/>[app.ts]"]
  node_profile_api["Profiles<br/>[profile-routes.ts]"]
  node_repository_api["Repository management"]
  node_history_api["Branches and history<br/>[history-routes.ts]"]
  node_git_api["Git smart HTTP<br/>[git-routes.ts]"]
  node_collaboration_api["Issues and reviews"]
  node_organization_api["Organizations and members"]
  node_settings_api["Access and webhooks<br/>[settings-routes.ts]"]
  node_notification_api["Notifications"]
  node_webhook_events["Event dispatch<br/>[events.ts]"]
end

subgraph group_identity["Identity and access"]
  node_session_auth["Session identity<br/>[current-user.ts]"]
  node_access_policy["Repository permissions"]
end

subgraph group_storage["Persistence and Git"]
  node_database[("PostgreSQL and Redis<br/>[client.ts]")]
  node_git_store[("Bare Git storage<br/>[git-store.ts]")]
  node_git_backend["Git HTTP backend<br/>[git-http.ts]"]
end

subgraph group_integrations["External integrations"]
end

node_developer(("Developer"))
node_git_client(("Git client"))
node_webhook_receiver["HTTPS webhook receiver"]

node_developer -->|"uses"| node_hub_ui
node_hub_ui -->|"requests API"| node_api_app
node_hub_ui -->|"renders"| node_repo_browser
node_hub_ui -->|"renders"| node_commit_history
node_repo_browser -->|"uses"| node_hub_frame
node_repo_browser -->|"loads repository"| node_api_app
node_hub_ui -.->|"renders"| node_auth_ui
node_hub_ui -.->|"renders"| node_collaboration_ui
node_hub_ui -.->|"renders"| node_org_ui
node_hub_ui -.->|"renders"| node_settings_ui
node_hub_ui -.->|"renders"| node_notifications_ui
node_auth_ui -->|"authenticates"| node_api_app
node_collaboration_ui -->|"requests collaboration"| node_api_app
node_org_ui -->|"requests organizations"| node_api_app
node_settings_ui -->|"configures webhooks"| node_api_app
node_notifications_ui -->|"loads inbox"| node_api_app
node_git_client -->|"clones and pushes"| node_git_api
node_api_app -->|"registers routes"| node_profile_api
node_api_app -->|"registers routes"| node_repository_api
node_api_app -->|"registers routes"| node_history_api
node_api_app -->|"registers routes"| node_git_api
node_api_app -->|"registers routes"| node_collaboration_api
node_api_app -->|"registers routes"| node_organization_api
node_api_app -->|"registers routes"| node_settings_api
node_api_app -->|"registers routes"| node_notification_api
node_profile_api -->|"resolves identity"| node_session_auth
node_repository_api -->|"resolves identity"| node_session_auth
node_repository_api -->|"checks access"| node_access_policy
node_repository_api -->|"reads and writes"| node_git_store
node_history_api -->|"finds readable repository"| node_repository_api
node_history_api -->|"reads history"| node_git_store
node_git_api -->|"resolves identity"| node_session_auth
node_git_api -->|"checks role"| node_access_policy
node_git_api -->|"runs backend"| node_git_backend
node_git_backend -->|"accesses repositories"| node_git_store
node_collaboration_api -->|"resolves identity"| node_session_auth
node_collaboration_api -->|"finds readable repository"| node_repository_api
node_collaboration_api -->|"checks access"| node_access_policy
node_collaboration_api -->|"dispatches events"| node_webhook_events
node_organization_api -->|"resolves identity"| node_session_auth
node_settings_api -->|"resolves identity"| node_session_auth
node_settings_api -->|"finds readable repository"| node_repository_api
node_settings_api -->|"checks access"| node_access_policy
node_notification_api -->|"resolves identity"| node_session_auth
node_notification_api -->|"reads and writes"| node_database
node_webhook_events -->|"records deliveries"| node_database
node_webhook_events -->|"sends signed events"| node_webhook_receiver
node_repository_api -->|"reads and writes"| node_database

click node_hub_ui "https://github.com/abhi-dhakar/nagar-platform/tree/main/apps/hub/src/app"
click node_repo_browser "https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/repository-browser.tsx"
click node_commit_history "https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/commit-history.tsx"
click node_hub_frame "https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/hub-frame.tsx"
click node_auth_ui "https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/auth-form.tsx"
click node_collaboration_ui "https://github.com/abhi-dhakar/nagar-platform/tree/main/apps/hub/src/app/%5Busername%5D/%5Brepository%5D"
click node_org_ui "https://github.com/abhi-dhakar/nagar-platform/tree/main/apps/hub/src/app/organizations"
click node_settings_ui "https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/repository-settings.tsx"
click node_notifications_ui "https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/notifications-inbox.tsx"
click node_api_app "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/app.ts"
click node_profile_api "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/users/profile-routes.ts"
click node_repository_api "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/repositories/repository-routes.ts"
click node_history_api "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/repositories/history-routes.ts"
click node_git_api "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/git/git-routes.ts"
click node_collaboration_api "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/collaboration/repository-routes.ts"
click node_organization_api "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/collaboration/organization-routes.ts"
click node_settings_api "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/collaboration/settings-routes.ts"
click node_notification_api "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/collaboration/notification-routes.ts"
click node_webhook_events "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/collaboration/events.ts"
click node_session_auth "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/auth/current-user.ts"
click node_access_policy "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/repositories/repository-access.ts"
click node_database "https://github.com/abhi-dhakar/nagar-platform/blob/main/packages/database/src/client.ts"
click node_git_store "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/git/git-store.ts"
click node_git_backend "https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/git/git-http.ts"
click node_code_shell "https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/code/src/app/page.tsx"
click node_deploy_shell "https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/deploy/src/app/page.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_hub_ui,node_repo_browser,node_commit_history,node_hub_frame,node_auth_ui,node_collaboration_ui,node_org_ui,node_settings_ui,node_notifications_ui,node_code_shell,node_deploy_shell,node_git_client toneBlue
class node_api_app,node_profile_api,node_repository_api,node_history_api,node_git_api,node_collaboration_api,node_organization_api,node_settings_api,node_notification_api,node_webhook_events toneAmber
class node_session_auth,node_access_policy,node_webhook_receiver toneMint
class node_database,node_git_store,node_git_backend toneRose
class node_developer toneIndigo
```

## Components

### NagarHub interface

- [Hub pages and navigation](https://github.com/abhi-dhakar/nagar-platform/tree/main/apps/hub/src/app): `apps/hub/src/app`
- [Repository browser](https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/repository-browser.tsx): `apps/hub/src/components/repository-browser.tsx`
- [Commit history](https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/commit-history.tsx): `apps/hub/src/components/commit-history.tsx`
- [Hub frame](https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/hub-frame.tsx): `apps/hub/src/components/hub-frame.tsx`
- [Sign-in and signup](https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/auth-form.tsx): `apps/hub/src/components/auth-form.tsx`
- [Issues and pull requests](https://github.com/abhi-dhakar/nagar-platform/tree/main/apps/hub/src/app/%5Busername%5D/%5Brepository%5D): `apps/hub/src/app/[username]/[repository]`
- [Organization workflows](https://github.com/abhi-dhakar/nagar-platform/tree/main/apps/hub/src/app/organizations): `apps/hub/src/app/organizations`
- [Repository settings](https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/repository-settings.tsx): `apps/hub/src/components/repository-settings.tsx`
- [Notification inbox](https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/hub/src/components/notifications-inbox.tsx): `apps/hub/src/components/notifications-inbox.tsx`
- [NagarCode shell](https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/code/src/app/page.tsx): `apps/code/src/app/page.tsx`
- [NagarDeploy shell](https://github.com/abhi-dhakar/nagar-platform/blob/main/apps/deploy/src/app/page.tsx): `apps/deploy/src/app/page.tsx`

### API workflows

- [HTTP API](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/app.ts): `services/api/src/app.ts`
- [Profiles](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/users/profile-routes.ts): `services/api/src/modules/users/profile-routes.ts`
- [Repository management](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/repositories/repository-routes.ts): `services/api/src/modules/repositories/repository-routes.ts`
- [Branches and history](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/repositories/history-routes.ts): `services/api/src/modules/repositories/history-routes.ts`
- [Git smart HTTP](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/git/git-routes.ts): `services/api/src/modules/git/git-routes.ts`
- [Issues and reviews](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/collaboration/repository-routes.ts): `services/api/src/modules/collaboration/repository-routes.ts`
- [Organizations and members](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/collaboration/organization-routes.ts): `services/api/src/modules/collaboration/organization-routes.ts`
- [Access and webhooks](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/collaboration/settings-routes.ts): `services/api/src/modules/collaboration/settings-routes.ts`
- [Notifications](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/collaboration/notification-routes.ts): `services/api/src/modules/collaboration/notification-routes.ts`
- [Event dispatch](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/collaboration/events.ts): `services/api/src/modules/collaboration/events.ts`

### Identity and access

- [Session identity](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/auth/current-user.ts): `services/api/src/modules/auth/current-user.ts`
- [Repository permissions](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/repositories/repository-access.ts): `services/api/src/modules/repositories/repository-access.ts`

### Persistence and Git

- [PostgreSQL and Redis](https://github.com/abhi-dhakar/nagar-platform/blob/main/packages/database/src/client.ts): `packages/database/src/client.ts`
- [Bare Git storage](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/git/git-store.ts): `services/api/src/modules/git/git-store.ts`
- [Git HTTP backend](https://github.com/abhi-dhakar/nagar-platform/blob/main/services/api/src/modules/git/git-http.ts): `services/api/src/modules/git/git-http.ts`

### Other components

- **Developer**
- **Git client**
- **HTTPS webhook receiver**

## Connections

- Developer → Hub pages and navigation: uses (evidence: `README.md`)
- Hub pages and navigation → HTTP API: requests API (evidence: `README.md`)
- Hub pages and navigation → Repository browser: renders (evidence: `apps/hub/src/app/[username]/[repository]/page.tsx`)
- Hub pages and navigation → Commit history: renders (evidence: `apps/hub/src/app/[username]/[repository]/commits/page.tsx`)
- Repository browser → Hub frame: uses (evidence: `apps/hub/src/components/repository-browser.tsx`)
- Repository browser → HTTP API: loads repository (evidence: `README.md`)
- Hub pages and navigation → Sign-in and signup: renders
- Hub pages and navigation → Issues and pull requests: renders
- Hub pages and navigation → Organization workflows: renders
- Hub pages and navigation → Repository settings: renders
- Hub pages and navigation → Notification inbox: renders
- Sign-in and signup → HTTP API: authenticates (evidence: `README.md`)
- Issues and pull requests → HTTP API: requests collaboration (evidence: `README.md`)
- Organization workflows → HTTP API: requests organizations (evidence: `README.md`)
- Repository settings → HTTP API: configures webhooks (evidence: `README.md`)
- Notification inbox → HTTP API: loads inbox (evidence: `README.md`)
- Git client → Git smart HTTP: clones and pushes (evidence: `README.md`)
- HTTP API → Profiles: registers routes (evidence: `services/api/src/app.ts`)
- HTTP API → Repository management: registers routes (evidence: `services/api/src/app.ts`)
- HTTP API → Branches and history: registers routes (evidence: `services/api/src/app.ts`)
- HTTP API → Git smart HTTP: registers routes (evidence: `services/api/src/app.ts`)
- HTTP API → Issues and reviews: registers routes (evidence: `services/api/src/app.ts`)
- HTTP API → Organizations and members: registers routes (evidence: `services/api/src/app.ts`)
- HTTP API → Access and webhooks: registers routes (evidence: `services/api/src/app.ts`)
- HTTP API → Notifications: registers routes (evidence: `services/api/src/app.ts`)
- Profiles → Session identity: resolves identity (evidence: `services/api/src/modules/users/profile-routes.ts`)
- Repository management → Session identity: resolves identity (evidence: `services/api/src/modules/repositories/repository-routes.ts`)
- Repository management → Repository permissions: checks access (evidence: `services/api/src/modules/repositories/repository-routes.ts`)
- Repository management → Bare Git storage: reads and writes (evidence: `services/api/src/modules/repositories/repository-routes.ts`)
- Branches and history → Repository management: finds readable repository (evidence: `services/api/src/modules/repositories/history-routes.ts`)
- Branches and history → Bare Git storage: reads history (evidence: `services/api/src/modules/repositories/history-routes.ts`)
- Git smart HTTP → Session identity: resolves identity (evidence: `services/api/src/modules/git/git-routes.ts`)
- Git smart HTTP → Repository permissions: checks role (evidence: `services/api/src/modules/git/git-routes.ts`)
- Git smart HTTP → Git HTTP backend: runs backend (evidence: `services/api/src/modules/git/git-routes.ts`)
- Git HTTP backend → Bare Git storage: accesses repositories (evidence: `README.md`)
- Issues and reviews → Session identity: resolves identity (evidence: `services/api/src/modules/collaboration/repository-routes.ts`)
- Issues and reviews → Repository management: finds readable repository (evidence: `services/api/src/modules/collaboration/repository-routes.ts`)
- Issues and reviews → Repository permissions: checks access (evidence: `services/api/src/modules/collaboration/repository-routes.ts`)
- Issues and reviews → Event dispatch: dispatches events (evidence: `services/api/src/modules/collaboration/repository-routes.ts`)
- Organizations and members → Session identity: resolves identity (evidence: `services/api/src/modules/collaboration/organization-routes.ts`)
- Access and webhooks → Session identity: resolves identity (evidence: `services/api/src/modules/collaboration/settings-routes.ts`)
- Access and webhooks → Repository management: finds readable repository (evidence: `services/api/src/modules/collaboration/settings-routes.ts`)
- Access and webhooks → Repository permissions: checks access (evidence: `services/api/src/modules/collaboration/settings-routes.ts`)
- Notifications → Session identity: resolves identity (evidence: `services/api/src/modules/collaboration/notification-routes.ts`)
- Notifications → PostgreSQL and Redis: reads and writes (evidence: `services/api/src/modules/collaboration/notification-routes.ts`)
- Event dispatch → PostgreSQL and Redis: records deliveries (evidence: `services/api/src/modules/collaboration/events.ts`)
- Event dispatch → HTTPS webhook receiver: sends signed events (evidence: `README.md`)
- Repository management → PostgreSQL and Redis: reads and writes (evidence: `services/api/src/modules/repositories/repository-routes.ts`)
