# jonish96/together_task architecture

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

- Interactive diagram: https://gitdiagram.com/jonish96/together_task
- Repository: https://github.com/jonish96/together_task

## Overview

Together Tasks is a mobile app for two people to manage personal and shared household tasks. The main workflow is account access, household setup, task entry or clarification, and task listing, filtering, editing, and completion. App.tsx owns the authenticated app and task interactions; src/taskAgent.ts provides local task interpretation. Supabase authentication and task persistence are implemented through the client and schema. A separate Edge Function parses task requests with OpenAI, but the README says connecting it to the app is a future step; its invocation is therefore not shown.

Main entry points: [`src/supabase.ts`](https://github.com/jonish96/together_task/blob/main/src/supabase.ts) (Supabase client), [`App.tsx`](https://github.com/jonish96/together_task/blob/main/App.tsx) (App coordinator), [`src/AuthScreen.tsx`](https://github.com/jonish96/together_task/blob/main/src/AuthScreen.tsx) (Sign-in screen), [`supabase/functions/parse-task/index.ts`](https://github.com/jonish96/together_task/blob/main/supabase/functions/parse-task/index.ts) (Task parse function)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile app"]
  node_app["App coordinator<br/>[App.tsx]"]
  node_authscreen["Sign-in screen<br/>[AuthScreen.tsx]"]
end

subgraph group_task["Task workflow"]
  node_household["Household setup<br/>[App.tsx]"]
  node_taskhome["Task home<br/>[App.tsx]"]
  node_agent["Local task agent<br/>[taskAgent.ts]"]
end

subgraph group_backend["Supabase backend"]
  node_client["Supabase client<br/>[supabase.ts]"]
  node_authservice["Supabase Auth"]
  node_taskdb[("Task database<br/>[schema.sql]")]
end

subgraph group_ai["AI parsing"]
  node_parse["Task parse function<br/>[index.ts]"]
end

node_person(("Household member"))
node_openai["OpenAI API"]

node_person -->|"uses"| node_app
node_app -->|"renders when signed out"| node_authscreen
node_authscreen -->|"submits credentials"| node_client
node_app -->|"checks session"| node_client
node_client -->|"authenticates"| node_authservice
node_app -->|"routes after sign-in"| node_household
node_household -->|"loads and saves household"| node_client
node_household -->|"opens when configured"| node_taskhome
node_taskhome -->|"interprets task input"| node_agent
node_taskhome -->|"loads and writes tasks"| node_client
node_client -->|"queries and updates"| node_taskdb
node_parse -->|"requests structured draft"| node_openai

click node_app "https://github.com/jonish96/together_task/blob/main/App.tsx"
click node_authscreen "https://github.com/jonish96/together_task/blob/main/src/AuthScreen.tsx"
click node_household "https://github.com/jonish96/together_task/blob/main/App.tsx"
click node_taskhome "https://github.com/jonish96/together_task/blob/main/App.tsx"
click node_agent "https://github.com/jonish96/together_task/blob/main/src/taskAgent.ts"
click node_client "https://github.com/jonish96/together_task/blob/main/src/supabase.ts"
click node_taskdb "https://github.com/jonish96/together_task/blob/main/supabase/schema.sql"
click node_parse "https://github.com/jonish96/together_task/blob/main/supabase/functions/parse-task/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_app,node_authscreen toneBlue
class node_household,node_taskhome,node_agent toneAmber
class node_client,node_authservice,node_taskdb,node_openai toneMint
class node_parse toneRose
class node_person toneIndigo
```

## Components

### Mobile app

- [App coordinator](https://github.com/jonish96/together_task/blob/main/App.tsx): `App.tsx`
- [Sign-in screen](https://github.com/jonish96/together_task/blob/main/src/AuthScreen.tsx): `src/AuthScreen.tsx`

### Task workflow

- [Household setup](https://github.com/jonish96/together_task/blob/main/App.tsx): `App.tsx`
- [Task home](https://github.com/jonish96/together_task/blob/main/App.tsx): `App.tsx`
- [Local task agent](https://github.com/jonish96/together_task/blob/main/src/taskAgent.ts): `src/taskAgent.ts`

### Supabase backend

- [Supabase client](https://github.com/jonish96/together_task/blob/main/src/supabase.ts): `src/supabase.ts`
- **Supabase Auth**
- [Task database](https://github.com/jonish96/together_task/blob/main/supabase/schema.sql): `supabase/schema.sql`

### AI parsing

- [Task parse function](https://github.com/jonish96/together_task/blob/main/supabase/functions/parse-task/index.ts): `supabase/functions/parse-task/index.ts`

### Other components

- **Household member**
- **OpenAI API**

## Connections

- Household member → App coordinator: uses
- App coordinator → Sign-in screen: renders when signed out
- Sign-in screen → Supabase client: submits credentials
- App coordinator → Supabase client: checks session
- Supabase client → Supabase Auth: authenticates
- App coordinator → Household setup: routes after sign-in
- Household setup → Supabase client: loads and saves household
- Household setup → Task home: opens when configured
- Task home → Local task agent: interprets task input
- Task home → Supabase client: loads and writes tasks
- Supabase client → Task database: queries and updates
- Task parse function → OpenAI API: requests structured draft
