# rounakraaj/nexspace architecture

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

- Interactive diagram: https://gitdiagram.com/rounakraaj/nexspace
- Repository: https://github.com/rounakraaj/nexspace

## Overview

NexSpace is a collaborative workspace app. Its main authenticated workflow is account access, workspace selection, then creating or opening a page or canvas; users edit, collaborate, and manage workspace content. The graph also captures invitations, comments, search, attachments, snapshots, and AI as distinct product capabilities. Evidence is limited to the supplied excerpts, SOURCE INDEX references, and README; unsampled routes and services are represented at their exact tree paths, without guessing their internal call paths.

Main entry points: [`components/editor/document-editor.tsx`](https://github.com/rounakraaj/nexspace/blob/main/components/editor/document-editor.tsx) (Page editor), [`app/dashboard/workspace-dashboard.tsx`](https://github.com/rounakraaj/nexspace/blob/main/app/dashboard/workspace-dashboard.tsx) (Workspace dashboard), [`app/api/documents`](https://github.com/rounakraaj/nexspace/tree/main/app/api/documents) (Document APIs), [`lib/prisma.ts`](https://github.com/rounakraaj/nexspace/blob/main/lib/prisma.ts) (PostgreSQL database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Identity and access"]
  node_auth_ui["Sign-in and registration UI<br/>[auth-forms.tsx]"]
  node_registration["Account registration<br/>[route.ts]"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_permissions["Access control<br/>[permissions.ts]"]
end

subgraph group_workspace["Workspace management"]
  node_dashboard["Workspace dashboard"]
  node_workspace_api["Workspace APIs"]
  node_members["Members and invitations"]
  node_search["Search<br/>[route.ts]"]
end

subgraph group_content["Documents and editing"]
  node_documents_api["Document APIs"]
  node_editor["Page editor"]
  node_canvas_editor["Canvas editor<br/>[canvas-editor.tsx]"]
  node_ai["AI copilot<br/>[route.ts]"]
  node_comments["Comments and replies<br/>[route.ts]"]
  node_attachments["Attachments<br/>[route.ts]"]
  node_snapshots["Snapshots and restore"]
end

subgraph group_realtime["Live collaboration"]
  node_page_collab["Page collaboration service<br/>[server.ts]"]
  node_canvas_collab["Canvas collaboration service<br/>[canvas-server.ts]"]
end

subgraph group_platform["Data and integrations"]
  node_database[("PostgreSQL database<br/>[prisma.ts]")]
  node_storage["Private object storage"]
  node_redis[("Redis services<br/>[rate-limit.ts]")]
end

node_user(("User"))

node_user -->|"signs in"| node_auth_ui
node_user -->|"registers"| node_registration
node_auth_ui -.->|"authenticates"| node_auth
node_registration -->|"creates account and workspace"| node_database
node_dashboard -->|"uses workspace APIs"| node_workspace_api
node_dashboard -->|"uses document APIs"| node_documents_api
node_user -->|"opens dashboard"| node_dashboard
node_workspace_api -->|"reads and writes"| node_database
node_members -->|"manages memberships"| node_database
node_members -.->|"limits requests"| node_redis
node_dashboard -->|"manages people"| node_members
node_documents_api -->|"reads and writes documents"| node_database
node_documents_api -->|"checks access"| node_permissions
node_dashboard -->|"opens pages"| node_editor
node_dashboard -->|"opens canvas"| node_canvas_editor
node_editor -.->|"loads and saves"| node_documents_api
node_editor -.->|"requests assistance"| node_ai
node_editor -.->|"uses comments"| node_comments
node_editor -.->|"uses attachments"| node_attachments
node_editor -.->|"uses snapshots"| node_snapshots
node_dashboard -.->|"searches workspace"| node_search
node_documents_api -->|"sends page commands"| node_page_collab
node_documents_api -->|"sends canvas commands"| node_canvas_collab
node_editor -->|"collaborates over WebSocket"| node_page_collab
node_canvas_editor -->|"syncs over WebSocket"| node_canvas_collab
node_page_collab -->|"persists collaboration state"| node_database
node_attachments -->|"stores private files"| node_storage
node_registration -->|"limits attempts"| node_redis

click node_auth_ui "https://github.com/rounakraaj/nexspace/blob/main/app/login/auth-forms.tsx"
click node_registration "https://github.com/rounakraaj/nexspace/blob/main/app/api/register/route.ts"
click node_auth "https://github.com/rounakraaj/nexspace/blob/main/lib/auth.ts"
click node_dashboard "https://github.com/rounakraaj/nexspace/blob/main/app/dashboard/workspace-dashboard.tsx"
click node_workspace_api "https://github.com/rounakraaj/nexspace/tree/main/app/api/workspaces"
click node_members "https://github.com/rounakraaj/nexspace/tree/main/app/api/workspaces"
click node_documents_api "https://github.com/rounakraaj/nexspace/tree/main/app/api/documents"
click node_editor "https://github.com/rounakraaj/nexspace/blob/main/components/editor/document-editor.tsx"
click node_canvas_editor "https://github.com/rounakraaj/nexspace/blob/main/components/editor/canvas-editor.tsx"
click node_ai "https://github.com/rounakraaj/nexspace/blob/main/app/api/documents/%5BdocumentId%5D/ai/route.ts"
click node_comments "https://github.com/rounakraaj/nexspace/blob/main/app/api/documents/%5BdocumentId%5D/comments/route.ts"
click node_attachments "https://github.com/rounakraaj/nexspace/blob/main/app/api/documents/%5BdocumentId%5D/attachments/route.ts"
click node_snapshots "https://github.com/rounakraaj/nexspace/tree/main/app/api/documents/%5BdocumentId%5D/snapshots"
click node_search "https://github.com/rounakraaj/nexspace/blob/main/app/api/search/route.ts"
click node_page_collab "https://github.com/rounakraaj/nexspace/blob/main/collaboration/server.ts"
click node_canvas_collab "https://github.com/rounakraaj/nexspace/blob/main/collaboration/canvas-server.ts"
click node_permissions "https://github.com/rounakraaj/nexspace/blob/main/lib/permissions.ts"
click node_database "https://github.com/rounakraaj/nexspace/blob/main/lib/prisma.ts"
click node_storage "https://github.com/rounakraaj/nexspace/blob/main/lib/supabase-storage.ts"
click node_redis "https://github.com/rounakraaj/nexspace/blob/main/lib/rate-limit.ts"

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_ui,node_registration,node_auth,node_permissions,node_user toneBlue
class node_dashboard,node_workspace_api,node_members,node_search toneAmber
class node_documents_api,node_editor,node_canvas_editor,node_ai,node_comments,node_attachments,node_snapshots toneMint
class node_page_collab,node_canvas_collab toneRose
class node_database,node_storage,node_redis toneIndigo
```

## Components

### Identity and access

- [Sign-in and registration UI](https://github.com/rounakraaj/nexspace/blob/main/app/login/auth-forms.tsx): `app/login/auth-forms.tsx`
- [Account registration](https://github.com/rounakraaj/nexspace/blob/main/app/api/register/route.ts): `app/api/register/route.ts`
- [Authentication](https://github.com/rounakraaj/nexspace/blob/main/lib/auth.ts): `lib/auth.ts`
- [Access control](https://github.com/rounakraaj/nexspace/blob/main/lib/permissions.ts): `lib/permissions.ts`

### Workspace management

- [Workspace dashboard](https://github.com/rounakraaj/nexspace/blob/main/app/dashboard/workspace-dashboard.tsx): `app/dashboard/workspace-dashboard.tsx`
- [Workspace APIs](https://github.com/rounakraaj/nexspace/tree/main/app/api/workspaces): `app/api/workspaces`
- [Members and invitations](https://github.com/rounakraaj/nexspace/tree/main/app/api/workspaces): `app/api/workspaces`
- [Search](https://github.com/rounakraaj/nexspace/blob/main/app/api/search/route.ts): `app/api/search/route.ts`

### Documents and editing

- [Document APIs](https://github.com/rounakraaj/nexspace/tree/main/app/api/documents): `app/api/documents`
- [Page editor](https://github.com/rounakraaj/nexspace/blob/main/components/editor/document-editor.tsx): `components/editor/document-editor.tsx`
- [Canvas editor](https://github.com/rounakraaj/nexspace/blob/main/components/editor/canvas-editor.tsx): `components/editor/canvas-editor.tsx`
- [AI copilot](https://github.com/rounakraaj/nexspace/blob/main/app/api/documents/%5BdocumentId%5D/ai/route.ts): `app/api/documents/[documentId]/ai/route.ts`
- [Comments and replies](https://github.com/rounakraaj/nexspace/blob/main/app/api/documents/%5BdocumentId%5D/comments/route.ts): `app/api/documents/[documentId]/comments/route.ts`
- [Attachments](https://github.com/rounakraaj/nexspace/blob/main/app/api/documents/%5BdocumentId%5D/attachments/route.ts): `app/api/documents/[documentId]/attachments/route.ts`
- [Snapshots and restore](https://github.com/rounakraaj/nexspace/tree/main/app/api/documents/%5BdocumentId%5D/snapshots): `app/api/documents/[documentId]/snapshots`

### Live collaboration

- [Page collaboration service](https://github.com/rounakraaj/nexspace/blob/main/collaboration/server.ts): `collaboration/server.ts`
- [Canvas collaboration service](https://github.com/rounakraaj/nexspace/blob/main/collaboration/canvas-server.ts): `collaboration/canvas-server.ts`

### Data and integrations

- [PostgreSQL database](https://github.com/rounakraaj/nexspace/blob/main/lib/prisma.ts): `lib/prisma.ts`
- [Private object storage](https://github.com/rounakraaj/nexspace/blob/main/lib/supabase-storage.ts): `lib/supabase-storage.ts`
- [Redis services](https://github.com/rounakraaj/nexspace/blob/main/lib/rate-limit.ts): `lib/rate-limit.ts`

### Other components

- **User**

## Connections

- User → Sign-in and registration UI: signs in
- User → Account registration: registers
- Sign-in and registration UI → Authentication: authenticates
- Account registration → PostgreSQL database: creates account and workspace (evidence: `app/api/register/route.ts`)
- Workspace dashboard → Workspace APIs: uses workspace APIs
- Workspace dashboard → Document APIs: uses document APIs
- User → Workspace dashboard: opens dashboard
- Workspace APIs → PostgreSQL database: reads and writes (evidence: `app/api/workspaces/route.ts`)
- Members and invitations → PostgreSQL database: manages memberships (evidence: `app/api/workspaces/[workspaceId]/members/route.ts`)
- Members and invitations → Redis services: limits requests (evidence: `app/api/workspaces/[workspaceId]/members/route.ts`)
- Workspace dashboard → Members and invitations: manages people
- Document APIs → PostgreSQL database: reads and writes documents (evidence: `app/api/documents/route.ts`)
- Document APIs → Access control: checks access (evidence: `app/api/documents/[documentId]/route.ts`)
- Workspace dashboard → Page editor: opens pages
- Workspace dashboard → Canvas editor: opens canvas
- Page editor → Document APIs: loads and saves
- Page editor → AI copilot: requests assistance
- Page editor → Comments and replies: uses comments
- Page editor → Attachments: uses attachments
- Page editor → Snapshots and restore: uses snapshots
- Workspace dashboard → Search: searches workspace
- Document APIs → Page collaboration service: sends page commands (evidence: `app/api/documents/[documentId]/route.ts`)
- Document APIs → Canvas collaboration service: sends canvas commands (evidence: `app/api/documents/[documentId]/route.ts`)
- Page editor → Page collaboration service: collaborates over WebSocket
- Canvas editor → Canvas collaboration service: syncs over WebSocket
- Page collaboration service → PostgreSQL database: persists collaboration state (evidence: `collaboration/server.ts`)
- Attachments → Private object storage: stores private files (evidence: `app/api/documents/[documentId]/attachments/route.ts`)
- Account registration → Redis services: limits attempts (evidence: `app/api/register/route.ts`)
