How abhi-dhakar/nagar-platform works
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: app.ts HTTP API · app Hub pages and navigation · repository-routes.ts Repository management · current-user.ts Session identity
Components 29
NagarHub interface
- Hub pages and navigation
apps/hub/src/app - Repository browser
apps/hub/src/components/repository-browser.tsx - Commit history
apps/hub/src/components/commit-history.tsx - Hub frame
apps/hub/src/components/hub-frame.tsx - Sign-in and signup
apps/hub/src/components/auth-form.tsx - Issues and pull requests
apps/hub/src/app/[username]/[repository] - Organization workflows
apps/hub/src/app/organizations - Repository settings
apps/hub/src/components/repository-settings.tsx - Notification inbox
apps/hub/src/components/notifications-inbox.tsx - NagarCode shell
apps/code/src/app/page.tsx - NagarDeploy shell
apps/deploy/src/app/page.tsx
API workflows
- HTTP API
services/api/src/app.ts - Profiles
services/api/src/modules/users/profile-routes.ts - Repository management
services/api/src/modules/repositories/repository-routes.ts - Branches and history
services/api/src/modules/repositories/history-routes.ts - Git smart HTTP
services/api/src/modules/git/git-routes.ts - Issues and reviews
services/api/src/modules/collaboration/repository-routes.ts - Organizations and members
services/api/src/modules/collaboration/organization-routes.ts - Access and webhooks
services/api/src/modules/collaboration/settings-routes.ts - Notifications
services/api/src/modules/collaboration/notification-routes.ts - Event dispatch
services/api/src/modules/collaboration/events.ts
Identity and access
- Session identity
services/api/src/modules/auth/current-user.ts - Repository permissions
services/api/src/modules/repositories/repository-access.ts
Persistence and Git
- PostgreSQL and Redis
packages/database/src/client.ts - Bare Git storage
services/api/src/modules/git/git-store.ts - Git HTTP backend
services/api/src/modules/git/git-http.ts
Other components
- Developer
- Git client
- HTTPS webhook receiver
Connections 48
- Developer → Hub pages and navigation: uses
README.md - Hub pages and navigation → HTTP API: requests API
README.md - Hub pages and navigation → Repository browser: renders
apps/hub/src/app/[username]/[repository]/page.tsx - Hub pages and navigation → Commit history: renders
apps/hub/src/app/[username]/[repository]/commits/page.tsx - Repository browser → Hub frame: uses
apps/hub/src/components/repository-browser.tsx - Repository browser → HTTP API: loads repository
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
README.md - Issues and pull requests → HTTP API: requests collaboration
README.md - Organization workflows → HTTP API: requests organizations
README.md - Repository settings → HTTP API: configures webhooks
README.md - Notification inbox → HTTP API: loads inbox
README.md - Git client → Git smart HTTP: clones and pushes
README.md - HTTP API → Profiles: registers routes
services/api/src/app.ts - HTTP API → Repository management: registers routes
services/api/src/app.ts - HTTP API → Branches and history: registers routes
services/api/src/app.ts - HTTP API → Git smart HTTP: registers routes
services/api/src/app.ts - HTTP API → Issues and reviews: registers routes
services/api/src/app.ts - HTTP API → Organizations and members: registers routes
services/api/src/app.ts - HTTP API → Access and webhooks: registers routes
services/api/src/app.ts - HTTP API → Notifications: registers routes
services/api/src/app.ts - Profiles → Session identity: resolves identity
services/api/src/modules/users/profile-routes.ts - Repository management → Session identity: resolves identity
services/api/src/modules/repositories/repository-routes.ts - Repository management → Repository permissions: checks access
services/api/src/modules/repositories/repository-routes.ts - Repository management → Bare Git storage: reads and writes
services/api/src/modules/repositories/repository-routes.ts - Branches and history → Repository management: finds readable repository
services/api/src/modules/repositories/history-routes.ts - Branches and history → Bare Git storage: reads history
services/api/src/modules/repositories/history-routes.ts - Git smart HTTP → Session identity: resolves identity
services/api/src/modules/git/git-routes.ts - Git smart HTTP → Repository permissions: checks role
services/api/src/modules/git/git-routes.ts - Git smart HTTP → Git HTTP backend: runs backend
services/api/src/modules/git/git-routes.ts - Git HTTP backend → Bare Git storage: accesses repositories
README.md - Issues and reviews → Session identity: resolves identity
services/api/src/modules/collaboration/repository-routes.ts - Issues and reviews → Repository management: finds readable repository
services/api/src/modules/collaboration/repository-routes.ts - Issues and reviews → Repository permissions: checks access
services/api/src/modules/collaboration/repository-routes.ts - Issues and reviews → Event dispatch: dispatches events
services/api/src/modules/collaboration/repository-routes.ts - Organizations and members → Session identity: resolves identity
services/api/src/modules/collaboration/organization-routes.ts - Access and webhooks → Session identity: resolves identity
services/api/src/modules/collaboration/settings-routes.ts - Access and webhooks → Repository management: finds readable repository
services/api/src/modules/collaboration/settings-routes.ts - Access and webhooks → Repository permissions: checks access
services/api/src/modules/collaboration/settings-routes.ts - Notifications → Session identity: resolves identity
services/api/src/modules/collaboration/notification-routes.ts - Notifications → PostgreSQL and Redis: reads and writes
services/api/src/modules/collaboration/notification-routes.ts - Event dispatch → PostgreSQL and Redis: records deliveries
services/api/src/modules/collaboration/events.ts - Event dispatch → HTTPS webhook receiver: sends signed events
README.md - Repository management → PostgreSQL and Redis: reads and writes
services/api/src/modules/repositories/repository-routes.ts