# normious/30days-30projects architecture

> Architecture diagram of the GitHub repository normious/30days-30projects, 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/normious/30days-30projects
- Repository: https://github.com/normious/30days-30projects

## Overview

30 Days, 30 Projects is a multi-challenge submission platform: participants join challenges, submit work for review, and build permanent public portfolios that visitors can discover. Organisers manage challenges and submissions; admins moderate users, applications, and bulk imports. The map preserves those product areas and the Supabase-backed application layer. The README documents these capabilities, but the sampled source does not include most page or action implementations, so their internal wiring is intentionally left out.

Main entry points: [`lib/auth.ts`](https://github.com/normious/30days-30projects/blob/main/lib/auth.ts) (Session and roles), [`app/dashboard/page.tsx`](https://github.com/normious/30days-30projects/blob/main/app/dashboard/page.tsx) (Participant dashboard), [`app/organiser`](https://github.com/normious/30days-30projects/tree/main/app/organiser) (Organiser tools), [`app/admin`](https://github.com/normious/30days-30projects/tree/main/app/admin) (Admin tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_audience["People and discovery"]
  node_participant(("Participant"))
  node_organiser(("Organiser"))
  node_admin(("Admin"))
  node_visitor(("Visitor"))
end

subgraph group_product["Challenge and portfolio experience"]
  node_challenge_pages["Challenge pages<br/>[page.tsx]"]
  node_participant_dashboard["Participant dashboard<br/>[page.tsx]"]
  node_project_submission["Project management"]
  node_portfolio["Public portfolios<br/>[page.tsx]"]
  node_discovery["Project discovery<br/>[page.tsx]"]
end

subgraph group_operations["Platform operations"]
  node_organiser_tools["Organiser tools"]
  node_application_review["Organiser applications"]
  node_moderation["Submission moderation<br/>[page.tsx]"]
  node_admin_tools["Admin tools"]
  node_bulk_import["Challenge import<br/>[admin.ts]"]
end

subgraph group_services["Application services"]
  node_auth["Session and roles<br/>[auth.ts]"]
  node_server_supabase["Server data access<br/>[server.ts]"]
  node_supabase[("Supabase")]
  node_email_function["Email function<br/>[index.ts]"]
end

node_participant -->|"browse challenges"| node_challenge_pages
node_participant -->|"manage participation"| node_participant_dashboard
node_participant_dashboard -->|"manage projects"| node_project_submission
node_project_submission -->|"publish approved work"| node_portfolio
node_visitor -->|"browse projects"| node_discovery
node_visitor -->|"view portfolio"| node_portfolio
node_organiser -->|"run challenges"| node_organiser_tools
node_organiser_tools -->|"review submissions"| node_moderation
node_admin -->|"review applications"| node_application_review
node_admin -->|"manage platform"| node_admin_tools
node_admin_tools -->|"import data"| node_bulk_import
node_bulk_import -->|"writes records"| node_supabase
node_participant_dashboard -->|"checks session"| node_auth
node_organiser_tools -->|"checks session"| node_auth
node_admin_tools -->|"checks role"| node_auth
node_auth -->|"creates client"| node_server_supabase
node_server_supabase -->|"queries data"| node_supabase
node_email_function -.->|"accesses platform data"| node_supabase

click node_challenge_pages "https://github.com/normious/30days-30projects/blob/main/app/challenges/page.tsx"
click node_participant_dashboard "https://github.com/normious/30days-30projects/blob/main/app/dashboard/page.tsx"
click node_project_submission "https://github.com/normious/30days-30projects/tree/main/app/dashboard/projects"
click node_portfolio "https://github.com/normious/30days-30projects/blob/main/app/u/%5Busername%5D/page.tsx"
click node_discovery "https://github.com/normious/30days-30projects/blob/main/app/discover/page.tsx"
click node_organiser_tools "https://github.com/normious/30days-30projects/tree/main/app/organiser"
click node_application_review "https://github.com/normious/30days-30projects/tree/main/app/admin/organiser-applications"
click node_moderation "https://github.com/normious/30days-30projects/blob/main/app/organiser/challenges/%5Bslug%5D/moderation/page.tsx"
click node_admin_tools "https://github.com/normious/30days-30projects/tree/main/app/admin"
click node_bulk_import "https://github.com/normious/30days-30projects/blob/main/actions/admin.ts"
click node_auth "https://github.com/normious/30days-30projects/blob/main/lib/auth.ts"
click node_server_supabase "https://github.com/normious/30days-30projects/blob/main/lib/supabase/server.ts"
click node_email_function "https://github.com/normious/30days-30projects/blob/main/supabase/functions/send-email/index.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_participant,node_organiser,node_admin,node_visitor toneBlue
class node_challenge_pages,node_participant_dashboard,node_project_submission,node_portfolio,node_discovery toneAmber
class node_organiser_tools,node_application_review,node_moderation,node_admin_tools,node_bulk_import toneMint
class node_auth,node_server_supabase,node_supabase,node_email_function toneRose
```

## Components

### People and discovery

- **Participant**
- **Organiser**
- **Admin**
- **Visitor**

### Challenge and portfolio experience

- [Challenge pages](https://github.com/normious/30days-30projects/blob/main/app/challenges/page.tsx): `app/challenges/page.tsx`
- [Participant dashboard](https://github.com/normious/30days-30projects/blob/main/app/dashboard/page.tsx): `app/dashboard/page.tsx`
- [Project management](https://github.com/normious/30days-30projects/tree/main/app/dashboard/projects): `app/dashboard/projects`
- [Public portfolios](https://github.com/normious/30days-30projects/blob/main/app/u/%5Busername%5D/page.tsx): `app/u/[username]/page.tsx`
- [Project discovery](https://github.com/normious/30days-30projects/blob/main/app/discover/page.tsx): `app/discover/page.tsx`

### Platform operations

- [Organiser tools](https://github.com/normious/30days-30projects/tree/main/app/organiser): `app/organiser`
- [Organiser applications](https://github.com/normious/30days-30projects/tree/main/app/admin/organiser-applications): `app/admin/organiser-applications`
- [Submission moderation](https://github.com/normious/30days-30projects/blob/main/app/organiser/challenges/%5Bslug%5D/moderation/page.tsx): `app/organiser/challenges/[slug]/moderation/page.tsx`
- [Admin tools](https://github.com/normious/30days-30projects/tree/main/app/admin): `app/admin`
- [Challenge import](https://github.com/normious/30days-30projects/blob/main/actions/admin.ts): `actions/admin.ts`

### Application services

- [Session and roles](https://github.com/normious/30days-30projects/blob/main/lib/auth.ts): `lib/auth.ts`
- [Server data access](https://github.com/normious/30days-30projects/blob/main/lib/supabase/server.ts): `lib/supabase/server.ts`
- **Supabase**
- [Email function](https://github.com/normious/30days-30projects/blob/main/supabase/functions/send-email/index.ts): `supabase/functions/send-email/index.ts`

## Connections

- Participant → Challenge pages: browse challenges
- Participant → Participant dashboard: manage participation
- Participant dashboard → Project management: manage projects
- Project management → Public portfolios: publish approved work
- Visitor → Project discovery: browse projects
- Visitor → Public portfolios: view portfolio
- Organiser → Organiser tools: run challenges
- Organiser tools → Submission moderation: review submissions
- Admin → Organiser applications: review applications
- Admin → Admin tools: manage platform
- Admin tools → Challenge import: import data
- Challenge import → Supabase: writes records
- Participant dashboard → Session and roles: checks session
- Organiser tools → Session and roles: checks session
- Admin tools → Session and roles: checks role
- Session and roles → Server data access: creates client
- Server data access → Supabase: queries data
- Email function → Supabase: accesses platform data
