# thomasdepaulacoelho-maker/questudo architecture

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

- Interactive diagram: https://gitdiagram.com/thomasdepaulacoelho-maker/questudo
- Repository: https://github.com/thomasdepaulacoelho-maker/questudo

## Overview

Questudo is a small quest-tracking web app. A user adds quests or manages them in open and concluded lists; the page component owns Firestore reads and mutations, while form and item components invoke its callbacks. Firebase initialization supplies the database client. The graph reflects the shown imports and calls; it does not infer behavior beyond the sampled source.

Main entry points: [`app/page.js`](https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/page.js) (Quest controller), [`app/components/QuestItem.jsx`](https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/components/QuestItem.jsx) (Quest item), [`app/components/AddQuest..jsx`](https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/components/AddQuest..jsx) (Add quest form), [`app/components/QuestList.jsx`](https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/components/QuestList.jsx) (Quest lists)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Quest interface"]
  node_add["Add quest form<br/>[AddQuest..jsx]"]
  node_lists["Quest lists<br/>[QuestList.jsx]"]
  node_item["Quest item<br/>[QuestItem.jsx]"]
end

subgraph group_app["Application logic"]
  node_page["Quest controller<br/>[page.js]"]
end

subgraph group_data["Data access"]
  node_firebase["Firebase client<br/>[firebase.js]"]
  node_store[("Firestore")]
end

node_user(("User"))

node_user -->|"enters quests"| node_add
node_user -->|"manages quests"| node_item
node_add -->|"submits callback"| node_page
node_page -->|"renders lists"| node_lists
node_lists -->|"renders items"| node_item
node_item -->|"invokes callbacks"| node_page
node_page -->|"imports db"| node_firebase
node_page -->|"reads and writes"| node_store
node_firebase -->|"initializes client"| node_store

click node_add "https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/components/AddQuest..jsx"
click node_lists "https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/components/QuestList.jsx"
click node_item "https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/components/QuestItem.jsx"
click node_page "https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/page.js"
click node_firebase "https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/components/firebase.js"

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_add,node_lists,node_item,node_user toneBlue
class node_page toneAmber
class node_firebase,node_store toneMint
```

## Components

### Quest interface

- [Add quest form](https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/components/AddQuest..jsx): `app/components/AddQuest..jsx`
- [Quest lists](https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/components/QuestList.jsx): `app/components/QuestList.jsx`
- [Quest item](https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/components/QuestItem.jsx): `app/components/QuestItem.jsx`

### Application logic

- [Quest controller](https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/page.js): `app/page.js`

### Data access

- [Firebase client](https://github.com/thomasdepaulacoelho-maker/questudo/blob/main/app/components/firebase.js): `app/components/firebase.js`
- **Firestore**

### Other components

- **User**

## Connections

- User → Add quest form: enters quests (evidence: `app/components/AddQuest..jsx`)
- User → Quest item: manages quests (evidence: `app/components/QuestItem.jsx`)
- Add quest form → Quest controller: submits callback (evidence: `app/components/AddQuest..jsx`)
- Quest controller → Quest lists: renders lists (evidence: `app/page.js`)
- Quest lists → Quest item: renders items (evidence: `app/components/QuestList.jsx`)
- Quest item → Quest controller: invokes callbacks (evidence: `app/components/QuestItem.jsx`)
- Quest controller → Firebase client: imports db (evidence: `app/page.js`)
- Quest controller → Firestore: reads and writes (evidence: `app/page.js`)
- Firebase client → Firestore: initializes client (evidence: `app/components/firebase.js`)
