# srinathsupes/constellation6 architecture

> Architecture diagram of the GitHub repository srinathsupes/constellation6, 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/srinathsupes/constellation6
- Repository: https://github.com/srinathsupes/constellation6

## Overview

Constellation is a child-focused mobile guide to reviewed, age-adapted real-world story-missions. The core journey is guardian/child setup, choosing a fitting experience, completing its on-screen prompts, then taking the activity off-screen and recording a reflection or outcome. The app also includes a constellation discovery surface, curiosity areas, lessons, a Pocket Planet creation activity, and guardian safety and membership controls. Relationships below are limited to README statements and shown source/index references; unsampled route wiring is not inferred.

Main entry points: [`src/screens/main/experience-mission-screen.tsx`](https://github.com/srinathsupes/constellation6/blob/main/src/screens/main/experience-mission-screen.tsx) (Mission screen), [`src/features/app/app-data-provider.tsx`](https://github.com/srinathsupes/constellation6/blob/main/src/features/app/app-data-provider.tsx) (App data provider), [`src/features/entitlements/entitlement-provider.tsx`](https://github.com/srinathsupes/constellation6/blob/main/src/features/entitlements/entitlement-provider.tsx) (Membership access), [`src/screens/main/home-screen.tsx`](https://github.com/srinathsupes/constellation6/blob/main/src/screens/main/home-screen.tsx) (Home discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_journey["Setup and discovery"]
  node_setup["Onboarding setup"]
  node_home["Home discovery<br/>[home-screen.tsx]"]
  node_recommend["Experience matching"]
  node_catalog["Experience catalog"]
  node_curiosity["Curiosity areas<br/>[curiosity-areas.ts]"]
  node_constellation["Constellation explorer"]
end

subgraph group_missions["Mission experience"]
  node_mission["Mission screen"]
  node_interaction["Mission interactions"]
  node_missiondata["Mission definitions"]
  node_missionstate["Interaction state<br/>[mission-state.ts]"]
  node_lessons["Visual lessons<br/>[VisualLesson.tsx]"]
  node_planet["Pocket Planet"]
end

subgraph group_state["App state and services"]
  node_appdata["App data provider"]
  node_repository[("Platform persistence")]
  node_webrepository[("Web persistence")]
  node_session["Experience session"]
end

subgraph group_guardian["Guardian and access"]
  node_guardiancontrols["Guardian controls"]
  node_membership["Membership access"]
  node_policy["Access policy<br/>[access-policy.ts]"]
end

node_child(("Child and guardian"))
node_guardian(("Guardian<br/>actor"))
node_revenuecat["RevenueCat service"]

node_child -->|"sets up"| node_setup
node_setup -.->|"enters app"| node_home
node_home -.->|"requests matches"| node_recommend
node_recommend -->|"filters experiences"| node_catalog
node_recommend -->|"checks access"| node_policy
node_home -.->|"offers areas"| node_curiosity
node_child -.->|"explores"| node_constellation
node_child -->|"starts mission"| node_mission
node_mission -->|"renders prompts"| node_interaction
node_interaction -->|"updates state"| node_missionstate
node_mission -->|"loads definitions"| node_missiondata
node_mission -->|"saves progress"| node_appdata
node_mission -->|"uses session"| node_session
node_child -.->|"views lessons"| node_lessons
node_child -.->|"plays activity"| node_planet
node_appdata -->|"loads and saves"| node_repository
node_appdata -->|"loads and saves"| node_webrepository
node_repository -->|"applies commands"| node_planet
node_webrepository -->|"parses planet data"| node_planet
node_appdata -->|"loads access"| node_membership
node_membership -->|"caches entitlement"| node_repository
node_membership -->|"checks purchases"| node_revenuecat
node_guardian -.->|"manages settings"| node_guardiancontrols
node_child -->|"may subscribe"| node_membership

click node_setup "https://github.com/srinathsupes/constellation6/blob/main/src/screens/guardian/contexts-setup-screen.tsx"
click node_home "https://github.com/srinathsupes/constellation6/blob/main/src/screens/main/home-screen.tsx"
click node_recommend "https://github.com/srinathsupes/constellation6/blob/main/src/features/recommendations/recommendation-engine.ts"
click node_catalog "https://github.com/srinathsupes/constellation6/blob/main/src/data/catalog/experience-catalog.ts"
click node_curiosity "https://github.com/srinathsupes/constellation6/blob/main/src/data/catalog/curiosity-areas.ts"
click node_constellation "https://github.com/srinathsupes/constellation6/blob/main/src/screens/main/constellation-screen.tsx"
click node_mission "https://github.com/srinathsupes/constellation6/blob/main/src/screens/main/experience-mission-screen.tsx"
click node_interaction "https://github.com/srinathsupes/constellation6/blob/main/src/features/missions/mission-interaction.tsx"
click node_missiondata "https://github.com/srinathsupes/constellation6/blob/main/src/data/catalog/mission-registry-v2.ts"
click node_missionstate "https://github.com/srinathsupes/constellation6/blob/main/src/features/missions/mission-state.ts"
click node_lessons "https://github.com/srinathsupes/constellation6/blob/main/src/features/lessons/VisualLesson.tsx"
click node_planet "https://github.com/srinathsupes/constellation6/blob/main/src/features/planet/paper-post-engine.ts"
click node_appdata "https://github.com/srinathsupes/constellation6/blob/main/src/features/app/app-data-provider.tsx"
click node_repository "https://github.com/srinathsupes/constellation6/blob/main/src/data/persistence/app-repository.native.ts"
click node_webrepository "https://github.com/srinathsupes/constellation6/blob/main/src/data/persistence/app-repository.web.ts"
click node_session "https://github.com/srinathsupes/constellation6/blob/main/src/features/session/experience-session-provider.tsx"
click node_guardiancontrols "https://github.com/srinathsupes/constellation6/blob/main/src/screens/guardian/grown-up-controls-screen.tsx"
click node_membership "https://github.com/srinathsupes/constellation6/blob/main/src/features/entitlements/entitlement-provider.tsx"
click node_policy "https://github.com/srinathsupes/constellation6/blob/main/src/features/entitlements/access-policy.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_setup,node_home,node_recommend,node_catalog,node_curiosity,node_constellation toneBlue
class node_mission,node_interaction,node_missiondata,node_missionstate,node_lessons,node_planet toneAmber
class node_appdata,node_repository,node_webrepository,node_session toneMint
class node_guardiancontrols,node_membership,node_policy toneRose
class node_child,node_guardian,node_revenuecat toneIndigo
```

## Components

### Setup and discovery

- [Onboarding setup](https://github.com/srinathsupes/constellation6/blob/main/src/screens/guardian/contexts-setup-screen.tsx): `src/screens/guardian/contexts-setup-screen.tsx`
- [Home discovery](https://github.com/srinathsupes/constellation6/blob/main/src/screens/main/home-screen.tsx): `src/screens/main/home-screen.tsx`
- [Experience matching](https://github.com/srinathsupes/constellation6/blob/main/src/features/recommendations/recommendation-engine.ts): `src/features/recommendations/recommendation-engine.ts`
- [Experience catalog](https://github.com/srinathsupes/constellation6/blob/main/src/data/catalog/experience-catalog.ts): `src/data/catalog/experience-catalog.ts`
- [Curiosity areas](https://github.com/srinathsupes/constellation6/blob/main/src/data/catalog/curiosity-areas.ts): `src/data/catalog/curiosity-areas.ts`
- [Constellation explorer](https://github.com/srinathsupes/constellation6/blob/main/src/screens/main/constellation-screen.tsx): `src/screens/main/constellation-screen.tsx`

### Mission experience

- [Mission screen](https://github.com/srinathsupes/constellation6/blob/main/src/screens/main/experience-mission-screen.tsx): `src/screens/main/experience-mission-screen.tsx`
- [Mission interactions](https://github.com/srinathsupes/constellation6/blob/main/src/features/missions/mission-interaction.tsx): `src/features/missions/mission-interaction.tsx`
- [Mission definitions](https://github.com/srinathsupes/constellation6/blob/main/src/data/catalog/mission-registry-v2.ts): `src/data/catalog/mission-registry-v2.ts`
- [Interaction state](https://github.com/srinathsupes/constellation6/blob/main/src/features/missions/mission-state.ts): `src/features/missions/mission-state.ts`
- [Visual lessons](https://github.com/srinathsupes/constellation6/blob/main/src/features/lessons/VisualLesson.tsx): `src/features/lessons/VisualLesson.tsx`
- [Pocket Planet](https://github.com/srinathsupes/constellation6/blob/main/src/features/planet/paper-post-engine.ts): `src/features/planet/paper-post-engine.ts`

### App state and services

- [App data provider](https://github.com/srinathsupes/constellation6/blob/main/src/features/app/app-data-provider.tsx): `src/features/app/app-data-provider.tsx`
- [Platform persistence](https://github.com/srinathsupes/constellation6/blob/main/src/data/persistence/app-repository.native.ts): `src/data/persistence/app-repository.native.ts`
- [Web persistence](https://github.com/srinathsupes/constellation6/blob/main/src/data/persistence/app-repository.web.ts): `src/data/persistence/app-repository.web.ts`
- [Experience session](https://github.com/srinathsupes/constellation6/blob/main/src/features/session/experience-session-provider.tsx): `src/features/session/experience-session-provider.tsx`

### Guardian and access

- [Guardian controls](https://github.com/srinathsupes/constellation6/blob/main/src/screens/guardian/grown-up-controls-screen.tsx): `src/screens/guardian/grown-up-controls-screen.tsx`
- [Membership access](https://github.com/srinathsupes/constellation6/blob/main/src/features/entitlements/entitlement-provider.tsx): `src/features/entitlements/entitlement-provider.tsx`
- [Access policy](https://github.com/srinathsupes/constellation6/blob/main/src/features/entitlements/access-policy.ts): `src/features/entitlements/access-policy.ts`

### Other components

- **Child and guardian**
- **Guardian**: actor
- **RevenueCat service**

## Connections

- Child and guardian → Onboarding setup: sets up (evidence: `README.md`)
- Onboarding setup → Home discovery: enters app
- Home discovery → Experience matching: requests matches
- Experience matching → Experience catalog: filters experiences (evidence: `src/features/recommendations/recommendation-engine.ts`)
- Experience matching → Access policy: checks access (evidence: `src/features/recommendations/recommendation-engine.ts`)
- Home discovery → Curiosity areas: offers areas
- Child and guardian → Constellation explorer: explores
- Child and guardian → Mission screen: starts mission (evidence: `README.md`)
- Mission screen → Mission interactions: renders prompts (evidence: `src/screens/main/experience-mission-screen.tsx`)
- Mission interactions → Interaction state: updates state (evidence: `src/features/missions/mission-interaction.tsx`)
- Mission screen → Mission definitions: loads definitions (evidence: `src/screens/main/experience-mission-screen.tsx`)
- Mission screen → App data provider: saves progress (evidence: `src/screens/main/experience-mission-screen.tsx`)
- Mission screen → Experience session: uses session (evidence: `src/screens/main/experience-mission-screen.tsx`)
- Child and guardian → Visual lessons: views lessons
- Child and guardian → Pocket Planet: plays activity
- App data provider → Platform persistence: loads and saves (evidence: `src/features/app/app-data-provider.tsx`)
- App data provider → Web persistence: loads and saves (evidence: `src/features/app/app-data-provider.tsx`)
- Platform persistence → Pocket Planet: applies commands (evidence: `src/data/persistence/app-repository.native.ts`)
- Web persistence → Pocket Planet: parses planet data (evidence: `src/data/persistence/app-repository.web.ts`)
- App data provider → Membership access: loads access (evidence: `src/features/app/app-data-provider.tsx`)
- Membership access → Platform persistence: caches entitlement (evidence: `src/features/entitlements/entitlement-provider.tsx`)
- Membership access → RevenueCat service: checks purchases (evidence: `src/features/entitlements/entitlement-provider.tsx`)
- Guardian → Guardian controls: manages settings
- Child and guardian → Membership access: may subscribe (evidence: `README.md`)
