# yomileonel/friendtasks architecture

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

- Interactive diagram: https://gitdiagram.com/yomileonel/friendtasks
- Repository: https://github.com/yomileonel/friendtasks

## Overview

PlanyourTasks is a Next.js/Supabase task app for friends. Users sign in, manage personal tasks through filtered views and a weekly calendar, and can create or join groups with shared lists, assignments, notes, and activity. The dashboard summarizes tasks and links to those areas. The graph separates app routes, task and collaboration capabilities, and the data/auth layer. The README documents broad product capabilities; detailed implementation edges are limited to the sampled dashboard, group page, auth callback, and client setup.

Main entry points: [`friendtasks/app/(app)/groups`](https://github.com/yomileonel/friendtasks/tree/main/friendtasks/app/(app)/groups) (Group pages), [`friendtasks/lib/supabase/server.ts`](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/lib/supabase/server.ts) (Server Supabase client), [`friendtasks/lib/data`](https://github.com/yomileonel/friendtasks/tree/main/friendtasks/lib/data) (Collaboration data), [`friendtasks/app/(app)/dashboard/page.tsx`](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/app/(app)/dashboard/page.tsx) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_landing["Landing page<br/>[landing.tsx]"]
  node_authui["Login and signup"]
  node_callback["Auth callback<br/>[route.ts]"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
end

subgraph group_tasks["Task management"]
  node_taskviews["Smart task views"]
  node_calendar["Weekly calendar<br/>[week-grid.tsx]"]
  node_todoitem["Todo interactions<br/>[todo-item.tsx]"]
  node_todoactions["Todo actions<br/>[todos.ts]"]
  node_tododata["Todo queries<br/>[todos.ts]"]
end

subgraph group_sharing["Shared spaces"]
  node_groupviews["Group pages"]
  node_groupfeatures["Group collaboration"]
  node_listfeatures["Shared lists"]
  node_collabdata["Collaboration data"]
end

subgraph group_platform["Data and identity"]
  node_authactions["Auth actions<br/>[auth.ts]"]
  node_actions["Domain actions"]
  node_supaclient["Server Supabase client<br/>[server.ts]"]
  node_dbtypes["Database model<br/>[database.ts]"]
end

node_visitor(("Visitor"))
node_supabase[("Supabase")]

node_visitor -->|"visits"| node_landing
node_landing -->|"signed-in redirect"| node_dashboard
node_visitor -.->|"registers or signs in"| node_authui
node_authui -->|"submits signup"| node_authactions
node_callback -->|"exchanges auth code"| node_supaclient
node_dashboard -->|"loads task summaries"| node_tododata
node_dashboard -->|"links to task views"| node_taskviews
node_taskviews -.->|"shows tasks"| node_todoitem
node_calendar -.->|"creates calendar tasks"| node_todoactions
node_todoitem -.->|"updates tasks"| node_todoactions
node_todoactions -.->|"persists task changes"| node_tododata
node_groupviews -->|"loads group content"| node_collabdata
node_groupviews -->|"invokes collaboration actions"| node_actions
node_groupviews -->|"renders group features"| node_groupfeatures
node_groupviews -->|"renders shared lists"| node_listfeatures
node_groupfeatures -.->|"manages membership"| node_collabdata
node_listfeatures -.->|"manages shared lists"| node_collabdata
node_authactions -.->|"uses auth service"| node_supaclient
node_supaclient -->|"connects with session"| node_supabase
node_tododata -.->|"reads task data"| node_supabase
node_collabdata -.->|"reads shared data"| node_supabase
node_supaclient -->|"types client"| node_dbtypes

click node_landing "https://github.com/yomileonel/friendtasks/blob/main/friendtasks/components/marketing/landing.tsx"
click node_authui "https://github.com/yomileonel/friendtasks/tree/main/friendtasks/app/(auth)"
click node_authactions "https://github.com/yomileonel/friendtasks/blob/main/friendtasks/lib/actions/auth.ts"
click node_callback "https://github.com/yomileonel/friendtasks/blob/main/friendtasks/app/auth/callback/route.ts"
click node_dashboard "https://github.com/yomileonel/friendtasks/blob/main/friendtasks/app/(app)/dashboard/page.tsx"
click node_taskviews "https://github.com/yomileonel/friendtasks/tree/main/friendtasks/app/(app)"
click node_calendar "https://github.com/yomileonel/friendtasks/blob/main/friendtasks/components/calendar/week-grid.tsx"
click node_todoitem "https://github.com/yomileonel/friendtasks/blob/main/friendtasks/components/todo/todo-item.tsx"
click node_todoactions "https://github.com/yomileonel/friendtasks/blob/main/friendtasks/lib/actions/todos.ts"
click node_tododata "https://github.com/yomileonel/friendtasks/blob/main/friendtasks/lib/data/todos.ts"
click node_groupviews "https://github.com/yomileonel/friendtasks/tree/main/friendtasks/app/(app)/groups"
click node_groupfeatures "https://github.com/yomileonel/friendtasks/tree/main/friendtasks/components/groups"
click node_listfeatures "https://github.com/yomileonel/friendtasks/tree/main/friendtasks/app/(app)/lists"
click node_collabdata "https://github.com/yomileonel/friendtasks/tree/main/friendtasks/lib/data"
click node_actions "https://github.com/yomileonel/friendtasks/tree/main/friendtasks/lib/actions"
click node_supaclient "https://github.com/yomileonel/friendtasks/blob/main/friendtasks/lib/supabase/server.ts"
click node_dbtypes "https://github.com/yomileonel/friendtasks/blob/main/friendtasks/lib/types/database.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_landing,node_authui,node_callback,node_dashboard toneBlue
class node_taskviews,node_calendar,node_todoitem,node_todoactions,node_tododata,node_supabase toneAmber
class node_groupviews,node_groupfeatures,node_listfeatures,node_collabdata toneMint
class node_authactions,node_actions,node_supaclient,node_dbtypes toneRose
class node_visitor toneIndigo
```

## Components

### App entry

- [Landing page](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/components/marketing/landing.tsx): `friendtasks/components/marketing/landing.tsx`
- [Login and signup](https://github.com/yomileonel/friendtasks/tree/main/friendtasks/app/(auth)): `friendtasks/app/(auth)`
- [Auth callback](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/app/auth/callback/route.ts): `friendtasks/app/auth/callback/route.ts`
- [Dashboard](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/app/(app)/dashboard/page.tsx): `friendtasks/app/(app)/dashboard/page.tsx`

### Task management

- [Smart task views](https://github.com/yomileonel/friendtasks/tree/main/friendtasks/app/(app)): `friendtasks/app/(app)`
- [Weekly calendar](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/components/calendar/week-grid.tsx): `friendtasks/components/calendar/week-grid.tsx`
- [Todo interactions](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/components/todo/todo-item.tsx): `friendtasks/components/todo/todo-item.tsx`
- [Todo actions](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/lib/actions/todos.ts): `friendtasks/lib/actions/todos.ts`
- [Todo queries](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/lib/data/todos.ts): `friendtasks/lib/data/todos.ts`

### Shared spaces

- [Group pages](https://github.com/yomileonel/friendtasks/tree/main/friendtasks/app/(app)/groups): `friendtasks/app/(app)/groups`
- [Group collaboration](https://github.com/yomileonel/friendtasks/tree/main/friendtasks/components/groups): `friendtasks/components/groups`
- [Shared lists](https://github.com/yomileonel/friendtasks/tree/main/friendtasks/app/(app)/lists): `friendtasks/app/(app)/lists`
- [Collaboration data](https://github.com/yomileonel/friendtasks/tree/main/friendtasks/lib/data): `friendtasks/lib/data`

### Data and identity

- [Auth actions](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/lib/actions/auth.ts): `friendtasks/lib/actions/auth.ts`
- [Domain actions](https://github.com/yomileonel/friendtasks/tree/main/friendtasks/lib/actions): `friendtasks/lib/actions`
- [Server Supabase client](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/lib/supabase/server.ts): `friendtasks/lib/supabase/server.ts`
- [Database model](https://github.com/yomileonel/friendtasks/blob/main/friendtasks/lib/types/database.ts): `friendtasks/lib/types/database.ts`

### Other components

- **Visitor**
- **Supabase**

## Connections

- Visitor → Landing page: visits
- Landing page → Dashboard: signed-in redirect
- Visitor → Login and signup: registers or signs in
- Login and signup → Auth actions: submits signup (evidence: `friendtasks/app/(auth)/signup/page.tsx`)
- Auth callback → Server Supabase client: exchanges auth code (evidence: `friendtasks/app/auth/callback/route.ts`)
- Dashboard → Todo queries: loads task summaries (evidence: `friendtasks/app/(app)/dashboard/page.tsx`)
- Dashboard → Smart task views: links to task views (evidence: `friendtasks/app/(app)/dashboard/page.tsx`)
- Smart task views → Todo interactions: shows tasks
- Weekly calendar → Todo actions: creates calendar tasks
- Todo interactions → Todo actions: updates tasks
- Todo actions → Todo queries: persists task changes
- Group pages → Collaboration data: loads group content (evidence: `friendtasks/app/(app)/groups/[groupId]/page.tsx`)
- Group pages → Domain actions: invokes collaboration actions (evidence: `friendtasks/app/(app)/groups/[groupId]/page.tsx`)
- Group pages → Group collaboration: renders group features (evidence: `friendtasks/app/(app)/groups/[groupId]/page.tsx`)
- Group pages → Shared lists: renders shared lists (evidence: `friendtasks/app/(app)/groups/[groupId]/page.tsx`)
- Group collaboration → Collaboration data: manages membership
- Shared lists → Collaboration data: manages shared lists
- Auth actions → Server Supabase client: uses auth service
- Server Supabase client → Supabase: connects with session (evidence: `friendtasks/lib/supabase/server.ts`)
- Todo queries → Supabase: reads task data
- Collaboration data → Supabase: reads shared data
- Server Supabase client → Database model: types client (evidence: `friendtasks/lib/supabase/server.ts`)
