# iwodud/partyplanner architecture

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

- Interactive diagram: https://gitdiagram.com/iwodud/partyplanner
- Repository: https://github.com/iwodud/partyplanner

## Overview

PartyPlanner is a React/Supabase app for coordinating friend-group meetups. Members authenticate, create or join groups, manage membership and invitations, then schedule group events and record RSVP responses in a calendar. The frontend calls Supabase Auth and Postgres through a shared client; database migrations define the schema and access policies. The excerpts show group and calendar operations, while README documents the Supabase backend setup. Other migration behavior and unsampled pages are not inferred beyond those documented capabilities.

Main entry points: [`frontend/src/router.jsx`](https://github.com/iwodud/partyplanner/blob/main/frontend/src/router.jsx) (Route dispatch), [`frontend/src/Context/AuthContext.jsx`](https://github.com/iwodud/partyplanner/blob/main/frontend/src/Context/AuthContext.jsx) (Session and auth), [`frontend/src/Context/groupsApi.js`](https://github.com/iwodud/partyplanner/blob/main/frontend/src/Context/groupsApi.js) (Group operations), [`frontend/src/Context/supabaseClient.js`](https://github.com/iwodud/partyplanner/blob/main/frontend/src/Context/supabaseClient.js) (Supabase client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry and routing"]
  node_main["Frontend bootstrap<br/>[main.jsx]"]
  node_router["Route dispatch<br/>[router.jsx]"]
  node_app["Root redirect<br/>[App.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_authpages["Sign in and signup<br/>[SignInPage.jsx]"]
  node_signuppage["Registration form<br/>[SignUpPage.jsx]"]
  node_validation["Input validation<br/>[validation.js]"]
  node_authcontext["Session and auth<br/>[AuthContext.jsx]"]
  node_routeguards["Route guards<br/>[PrivateRoute.jsx]"]
end

subgraph group_groups["Group coordination"]
  node_dashboard["Group dashboard<br/>[Dashboard.jsx]"]
  node_groupdetail["Group details<br/>[GroupPage.jsx]"]
  node_joinpage["Join invitation<br/>[JoinGroupPage.jsx]"]
  node_groupapi["Group operations<br/>[groupsApi.js]"]
end

subgraph group_meetups["Events and responses"]
  node_calendar["Group calendar<br/>[CalendarPage.jsx]"]
end

subgraph group_platform["Supabase services"]
  node_authservice["Supabase Auth"]
  node_supabaseclient["Supabase client<br/>[supabaseClient.js]"]
  node_grouptable[("Groups and profiles")]
  node_groupinvites[("Invite procedures")]
  node_eventdata[("Events and RSVPs")]
end

node_member(("Group member"))

node_member -->|"opens app"| node_main
node_main -->|"provides session"| node_authcontext
node_main -->|"renders routes"| node_router
node_router -->|"routes root"| node_app
node_router -->|"routes signin"| node_authpages
node_router -->|"routes signup"| node_signuppage
node_router -->|"routes dashboard"| node_dashboard
node_router -->|"routes group"| node_groupdetail
node_router -->|"routes invitation"| node_joinpage
node_router -->|"routes calendar"| node_calendar
node_authpages -->|"validates input"| node_validation
node_signuppage -->|"validates input"| node_validation
node_authpages -->|"authenticates"| node_authcontext
node_signuppage -->|"registers account"| node_authcontext
node_authcontext -->|"uses client"| node_supabaseclient
node_authcontext -->|"calls auth API"| node_authservice
node_authcontext -->|"supplies session"| node_routeguards
node_dashboard -->|"manages groups"| node_groupapi
node_groupdetail -->|"loads and updates"| node_groupapi
node_joinpage -->|"joins group"| node_groupapi
node_groupapi -->|"queries data"| node_supabaseclient
node_supabaseclient -->|"reads and writes"| node_grouptable
node_groupapi -->|"calls group RPCs"| node_groupinvites
node_calendar -->|"queries events"| node_supabaseclient
node_supabaseclient -->|"reads and writes"| node_eventdata
node_calendar -->|"reads session"| node_authcontext

click node_main "https://github.com/iwodud/partyplanner/blob/main/frontend/src/main.jsx"
click node_router "https://github.com/iwodud/partyplanner/blob/main/frontend/src/router.jsx"
click node_app "https://github.com/iwodud/partyplanner/blob/main/frontend/src/App.jsx"
click node_authpages "https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/SignInPage.jsx"
click node_signuppage "https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/SignUpPage.jsx"
click node_validation "https://github.com/iwodud/partyplanner/blob/main/frontend/src/utils/validation.js"
click node_authcontext "https://github.com/iwodud/partyplanner/blob/main/frontend/src/Context/AuthContext.jsx"
click node_routeguards "https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/PrivateRoute.jsx"
click node_dashboard "https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/Dashboard.jsx"
click node_groupdetail "https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/GroupPage.jsx"
click node_joinpage "https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/JoinGroupPage.jsx"
click node_groupapi "https://github.com/iwodud/partyplanner/blob/main/frontend/src/Context/groupsApi.js"
click node_supabaseclient "https://github.com/iwodud/partyplanner/blob/main/frontend/src/Context/supabaseClient.js"
click node_grouptable "https://github.com/iwodud/partyplanner/blob/main/backend/supabase/migrations/20261102115422_initial_schema.sql"
click node_groupinvites "https://github.com/iwodud/partyplanner/blob/main/backend/supabase/migrations/20261103160000_group_invites.sql"
click node_calendar "https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/CalendarPage.jsx"
click node_eventdata "https://github.com/iwodud/partyplanner/blob/main/backend/supabase/migrations/20261114120000_events_and_rsvps.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_main,node_router,node_app toneBlue
class node_authpages,node_signuppage,node_validation,node_authcontext,node_routeguards toneAmber
class node_dashboard,node_groupdetail,node_joinpage,node_groupapi toneMint
class node_calendar toneRose
class node_authservice,node_supabaseclient,node_grouptable,node_groupinvites,node_eventdata,node_member toneIndigo
```

## Components

### App entry and routing

- [Frontend bootstrap](https://github.com/iwodud/partyplanner/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Route dispatch](https://github.com/iwodud/partyplanner/blob/main/frontend/src/router.jsx): `frontend/src/router.jsx`
- [Root redirect](https://github.com/iwodud/partyplanner/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### Identity and access

- [Sign in and signup](https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/SignInPage.jsx): `frontend/src/components/SignInPage.jsx`
- [Registration form](https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/SignUpPage.jsx): `frontend/src/components/SignUpPage.jsx`
- [Input validation](https://github.com/iwodud/partyplanner/blob/main/frontend/src/utils/validation.js): `frontend/src/utils/validation.js`
- [Session and auth](https://github.com/iwodud/partyplanner/blob/main/frontend/src/Context/AuthContext.jsx): `frontend/src/Context/AuthContext.jsx`
- [Route guards](https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/PrivateRoute.jsx): `frontend/src/components/PrivateRoute.jsx`

### Group coordination

- [Group dashboard](https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/Dashboard.jsx): `frontend/src/components/Dashboard.jsx`
- [Group details](https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/GroupPage.jsx): `frontend/src/components/GroupPage.jsx`
- [Join invitation](https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/JoinGroupPage.jsx): `frontend/src/components/JoinGroupPage.jsx`
- [Group operations](https://github.com/iwodud/partyplanner/blob/main/frontend/src/Context/groupsApi.js): `frontend/src/Context/groupsApi.js`

### Events and responses

- [Group calendar](https://github.com/iwodud/partyplanner/blob/main/frontend/src/components/CalendarPage.jsx): `frontend/src/components/CalendarPage.jsx`

### Supabase services

- **Supabase Auth**
- [Supabase client](https://github.com/iwodud/partyplanner/blob/main/frontend/src/Context/supabaseClient.js): `frontend/src/Context/supabaseClient.js`
- [Groups and profiles](https://github.com/iwodud/partyplanner/blob/main/backend/supabase/migrations/20261102115422_initial_schema.sql): `backend/supabase/migrations/20261102115422_initial_schema.sql`
- [Invite procedures](https://github.com/iwodud/partyplanner/blob/main/backend/supabase/migrations/20261103160000_group_invites.sql): `backend/supabase/migrations/20261103160000_group_invites.sql`
- [Events and RSVPs](https://github.com/iwodud/partyplanner/blob/main/backend/supabase/migrations/20261114120000_events_and_rsvps.sql): `backend/supabase/migrations/20261114120000_events_and_rsvps.sql`

### Other components

- **Group member**

## Connections

- Group member → Frontend bootstrap: opens app (evidence: `README.md`)
- Frontend bootstrap → Session and auth: provides session (evidence: `frontend/src/main.jsx`)
- Frontend bootstrap → Route dispatch: renders routes (evidence: `frontend/src/main.jsx`)
- Route dispatch → Root redirect: routes root (evidence: `frontend/src/router.jsx`)
- Route dispatch → Sign in and signup: routes signin (evidence: `frontend/src/router.jsx`)
- Route dispatch → Registration form: routes signup (evidence: `frontend/src/router.jsx`)
- Route dispatch → Group dashboard: routes dashboard (evidence: `frontend/src/router.jsx`)
- Route dispatch → Group details: routes group (evidence: `frontend/src/router.jsx`)
- Route dispatch → Join invitation: routes invitation (evidence: `frontend/src/router.jsx`)
- Route dispatch → Group calendar: routes calendar (evidence: `frontend/src/router.jsx`)
- Sign in and signup → Input validation: validates input (evidence: `frontend/src/components/SignInPage.jsx`)
- Registration form → Input validation: validates input (evidence: `frontend/src/components/SignUpPage.jsx`)
- Sign in and signup → Session and auth: authenticates (evidence: `frontend/src/components/SignInPage.jsx`)
- Registration form → Session and auth: registers account (evidence: `frontend/src/components/SignUpPage.jsx`)
- Session and auth → Supabase client: uses client (evidence: `frontend/src/Context/AuthContext.jsx`)
- Session and auth → Supabase Auth: calls auth API (evidence: `frontend/src/Context/AuthContext.jsx`)
- Session and auth → Route guards: supplies session (evidence: `frontend/src/Context/AuthContext.jsx`)
- Group dashboard → Group operations: manages groups (evidence: `frontend/src/components/Dashboard.jsx`)
- Group details → Group operations: loads and updates (evidence: `frontend/src/components/GroupPage.jsx`)
- Join invitation → Group operations: joins group (evidence: `frontend/src/components/JoinGroupPage.jsx`)
- Group operations → Supabase client: queries data (evidence: `frontend/src/Context/groupsApi.js`)
- Supabase client → Groups and profiles: reads and writes
- Group operations → Invite procedures: calls group RPCs (evidence: `frontend/src/Context/groupsApi.js`)
- Group calendar → Supabase client: queries events (evidence: `frontend/src/components/CalendarPage.jsx`)
- Supabase client → Events and RSVPs: reads and writes
- Group calendar → Session and auth: reads session (evidence: `frontend/src/components/CalendarPage.jsx`)
