# roshanjosua/continental architecture

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

- Interactive diagram: https://gitdiagram.com/roshanjosua/continental
- Repository: https://github.com/roshanjosua/continental

## Overview

Continental is currently a foundation release, not the completed productivity product. The visible user flow is a visitor opening the Next.js landing page and seeing the application status and foundation controls; the app shell adds shared React Query context. The repository also contains database migrations for the planned productivity, academic, collaboration, chat, gamification, and authorization foundations. README documents Supabase-backed services, but feature UI and authentication flows are not implemented. Some migration details are inferred only from filenames and README statements; unsampled behavior is not shown.

Main entry points: [`src/app/page.tsx`](https://github.com/roshanjosua/continental/blob/main/src/app/page.tsx) (Foundation landing), [`src/providers/app-providers.tsx`](https://github.com/roshanjosua/continental/blob/main/src/providers/app-providers.tsx) (App providers), [`src/app/layout.tsx`](https://github.com/roshanjosua/continental/blob/main/src/app/layout.tsx) (Root app shell), [`supabase/migrations/20261007000100_foundation.sql`](https://github.com/roshanjosua/continental/blob/main/supabase/migrations/20261007000100_foundation.sql) (Foundation schema)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web foundation"]
  node_landing["Foundation landing<br/>[page.tsx]"]
  node_button["UI button<br/>[button.tsx]"]
  node_app_shell["Root app shell<br/>[layout.tsx]"]
  node_app_providers["App providers<br/>[app-providers.tsx]"]
  node_query_provider["Query context<br/>[query-provider.tsx]"]
end

subgraph group_data["Database foundation"]
  node_foundation_schema["Foundation schema"]
  node_productivity_schema["Productivity and academic schema"]
  node_collaboration_schema["Collaboration and gamification schema"]
  node_row_security["Row-level security"]
end

subgraph group_backend["Backend integration"]
  node_browser_client["Supabase browser client<br/>[client.ts]"]
  node_supabase[("Supabase services")]
  node_postgres[("PostgreSQL database")]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_landing
node_landing -->|"renders"| node_button
node_app_shell -->|"wraps app"| node_app_providers
node_app_providers -->|"provides context"| node_query_provider
node_browser_client -.->|"connects to"| node_supabase
node_foundation_schema -->|"defines schema"| node_postgres
node_productivity_schema -->|"defines schema"| node_postgres
node_collaboration_schema -->|"defines schema"| node_postgres
node_row_security -->|"sets policies"| node_postgres

click node_landing "https://github.com/roshanjosua/continental/blob/main/src/app/page.tsx"
click node_button "https://github.com/roshanjosua/continental/blob/main/src/components/ui/button.tsx"
click node_app_shell "https://github.com/roshanjosua/continental/blob/main/src/app/layout.tsx"
click node_app_providers "https://github.com/roshanjosua/continental/blob/main/src/providers/app-providers.tsx"
click node_query_provider "https://github.com/roshanjosua/continental/blob/main/src/providers/query-provider.tsx"
click node_browser_client "https://github.com/roshanjosua/continental/blob/main/src/lib/supabase/client.ts"
click node_foundation_schema "https://github.com/roshanjosua/continental/blob/main/supabase/migrations/20261007000100_foundation.sql"
click node_productivity_schema "https://github.com/roshanjosua/continental/blob/main/supabase/migrations/20261007000200_productivity_and_academic.sql"
click node_collaboration_schema "https://github.com/roshanjosua/continental/blob/main/supabase/migrations/20261007000300_collaboration_chat_and_gamification.sql"
click node_row_security "https://github.com/roshanjosua/continental/blob/main/supabase/migrations/20261007000400_row_level_security.sql"

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_landing,node_button,node_app_shell,node_app_providers,node_query_provider toneBlue
class node_foundation_schema,node_productivity_schema,node_collaboration_schema,node_row_security toneAmber
class node_browser_client,node_supabase,node_postgres toneMint
class node_visitor toneIndigo
```

## Components

### Web foundation

- [Foundation landing](https://github.com/roshanjosua/continental/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [UI button](https://github.com/roshanjosua/continental/blob/main/src/components/ui/button.tsx): `src/components/ui/button.tsx`
- [Root app shell](https://github.com/roshanjosua/continental/blob/main/src/app/layout.tsx): `src/app/layout.tsx`
- [App providers](https://github.com/roshanjosua/continental/blob/main/src/providers/app-providers.tsx): `src/providers/app-providers.tsx`
- [Query context](https://github.com/roshanjosua/continental/blob/main/src/providers/query-provider.tsx): `src/providers/query-provider.tsx`

### Database foundation

- [Foundation schema](https://github.com/roshanjosua/continental/blob/main/supabase/migrations/20261007000100_foundation.sql): `supabase/migrations/20261007000100_foundation.sql`
- [Productivity and academic schema](https://github.com/roshanjosua/continental/blob/main/supabase/migrations/20261007000200_productivity_and_academic.sql): `supabase/migrations/20261007000200_productivity_and_academic.sql`
- [Collaboration and gamification schema](https://github.com/roshanjosua/continental/blob/main/supabase/migrations/20261007000300_collaboration_chat_and_gamification.sql): `supabase/migrations/20261007000300_collaboration_chat_and_gamification.sql`
- [Row-level security](https://github.com/roshanjosua/continental/blob/main/supabase/migrations/20261007000400_row_level_security.sql): `supabase/migrations/20261007000400_row_level_security.sql`

### Backend integration

- [Supabase browser client](https://github.com/roshanjosua/continental/blob/main/src/lib/supabase/client.ts): `src/lib/supabase/client.ts`
- **Supabase services**
- **PostgreSQL database**

### Other components

- **Visitor**

## Connections

- Visitor → Foundation landing: opens (evidence: `README.md`)
- Foundation landing → UI button: renders (evidence: `src/app/page.tsx`)
- Root app shell → App providers: wraps app (evidence: `src/app/layout.tsx`)
- App providers → Query context: provides context (evidence: `src/providers/app-providers.tsx`)
- Supabase browser client → Supabase services: connects to (evidence: `README.md`)
- Foundation schema → PostgreSQL database: defines schema (evidence: `README.md`)
- Productivity and academic schema → PostgreSQL database: defines schema (evidence: `README.md`)
- Collaboration and gamification schema → PostgreSQL database: defines schema (evidence: `README.md`)
- Row-level security → PostgreSQL database: sets policies (evidence: `README.md`)
