# dhara-24-thakar/mind-your-own-manas architecture

> Architecture diagram of the GitHub repository dhara-24-thakar/mind-your-own-manas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dhara-24-thakar/mind-your-own-manas
- Repository: https://github.com/dhara-24-thakar/mind-your-own-manas

## Overview

MANAS is documented as a privacy-first journaling and reflection application. Its main flow takes voice, text, memories, or photos through input handling and an Express API, uses Gemini to produce structured reflection, and stores a unified entry for the journal and Universal Timeline. The README also describes environmental tracking, mind maps, monthly synthesis, multi-turn consultation, and longitudinal personality analysis. Only README.md is available, so implementation paths and undocumented internal links are omitted; edges reflect documented relationships only.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture &amp; Journal"]
  node_home["Home Screen"]
  node_input["Speech &amp; Input"]
  node_entry["Universal Entry"]
  node_timeline["Journal Timeline"]
end

subgraph group_reflection["AI Reflection"]
  node_api["Express API"]
  node_gemini["Gemini API"]
  node_interpretation["Structured Reflection"]
  node_pivot["Pivot Engine"]
  node_confidant["Philosophical Confidant"]
  node_monthly["Monthly Synthesis"]
end

subgraph group_wellbeing["Impact &amp; Synthesis"]
  node_stewardship["Physical Stewardship"]
  node_footprint["Digital Footprint"]
  node_balance["Mindful Balance"]
end

subgraph group_cognition["Cognitive Tools"]
  node_maps["Living Mind Maps"]
  node_graphhealth["Graph Health"]
  node_thinking["Thinking Modes"]
  node_personality["Mind Personality"]
end

subgraph group_data["Personal Data"]
  node_firestore[("Cloud Firestore")]
  node_security["Owner-Bound Rules"]
end

node_user(("User"))

node_user -->|"uses"| node_home
node_home -->|"captures"| node_input
node_input -->|"submits to"| node_api
node_api -->|"requests reflection"| node_gemini
node_gemini -->|"returns interpretation"| node_interpretation
node_interpretation -->|"forms entry"| node_entry
node_entry -->|"stores in"| node_firestore
node_firestore -->|"feeds"| node_timeline
node_interpretation -->|"yields action plan"| node_pivot
node_user -->|"consults"| node_confidant
node_user -->|"requests synthesis"| node_monthly
node_user -->|"logs actions"| node_stewardship
node_user -->|"tracks estimates"| node_footprint
node_user -->|"requests reflection"| node_balance
node_user -->|"creates maps"| node_maps
node_maps -->|"evaluated by"| node_graphhealth
node_user -->|"chooses mode"| node_thinking
node_user -->|"profiles over time"| node_personality
node_firestore -->|"protected by"| node_security

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_home,node_input,node_entry,node_timeline,node_user toneBlue
class node_api,node_gemini,node_interpretation,node_pivot,node_confidant,node_monthly toneAmber
class node_stewardship,node_footprint,node_balance toneMint
class node_maps,node_graphhealth,node_thinking,node_personality toneRose
class node_firestore,node_security toneIndigo
```

## Components

### Capture & Journal

- **Home Screen**
- **Speech & Input**
- **Universal Entry**
- **Journal Timeline**

### AI Reflection

- **Express API**
- **Gemini API**
- **Structured Reflection**
- **Pivot Engine**
- **Philosophical Confidant**
- **Monthly Synthesis**

### Impact & Synthesis

- **Physical Stewardship**
- **Digital Footprint**
- **Mindful Balance**

### Cognitive Tools

- **Living Mind Maps**
- **Graph Health**
- **Thinking Modes**
- **Mind Personality**

### Personal Data

- **Cloud Firestore**
- **Owner-Bound Rules**

### Other components

- **User**

## Connections

- User → Home Screen: uses (evidence: `README.md`)
- Home Screen → Speech & Input: captures (evidence: `README.md`)
- Speech & Input → Express API: submits to (evidence: `README.md`)
- Express API → Gemini API: requests reflection (evidence: `README.md`)
- Gemini API → Structured Reflection: returns interpretation (evidence: `README.md`)
- Structured Reflection → Universal Entry: forms entry (evidence: `README.md`)
- Universal Entry → Cloud Firestore: stores in (evidence: `README.md`)
- Cloud Firestore → Journal Timeline: feeds (evidence: `README.md`)
- Structured Reflection → Pivot Engine: yields action plan (evidence: `README.md`)
- User → Philosophical Confidant: consults (evidence: `README.md`)
- User → Monthly Synthesis: requests synthesis (evidence: `README.md`)
- User → Physical Stewardship: logs actions (evidence: `README.md`)
- User → Digital Footprint: tracks estimates (evidence: `README.md`)
- User → Mindful Balance: requests reflection (evidence: `README.md`)
- User → Living Mind Maps: creates maps (evidence: `README.md`)
- Living Mind Maps → Graph Health: evaluated by (evidence: `README.md`)
- User → Thinking Modes: chooses mode (evidence: `README.md`)
- User → Mind Personality: profiles over time (evidence: `README.md`)
- Cloud Firestore → Owner-Bound Rules: protected by (evidence: `README.md`)
