How srinathsupes/constellation6 works
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: experience-mission-screen.tsx Mission screen · app-data-provider.tsx App data provider · entitlement-provider.tsx Membership access · home-screen.tsx Home discovery
Components 22
Setup and discovery
- Onboarding setup
src/screens/guardian/contexts-setup-screen.tsx - Home discovery
src/screens/main/home-screen.tsx - Experience matching
src/features/recommendations/recommendation-engine.ts - Experience catalog
src/data/catalog/experience-catalog.ts - Curiosity areas
src/data/catalog/curiosity-areas.ts - Constellation explorer
src/screens/main/constellation-screen.tsx
Mission experience
- Mission screen
src/screens/main/experience-mission-screen.tsx - Mission interactions
src/features/missions/mission-interaction.tsx - Mission definitions
src/data/catalog/mission-registry-v2.ts - Interaction state
src/features/missions/mission-state.ts - Visual lessons
src/features/lessons/VisualLesson.tsx - Pocket Planet
src/features/planet/paper-post-engine.ts
App state and services
- App data provider
src/features/app/app-data-provider.tsx - Platform persistence
src/data/persistence/app-repository.native.ts - Web persistence
src/data/persistence/app-repository.web.ts - Experience session
src/features/session/experience-session-provider.tsx
Guardian and access
- Guardian controls
src/screens/guardian/grown-up-controls-screen.tsx - Membership access
src/features/entitlements/entitlement-provider.tsx - Access policy
src/features/entitlements/access-policy.ts
Other components
- Child and guardian
- Guardian
- RevenueCat service
Connections 24
- Child and guardian → Onboarding setup: sets up
README.md - Onboarding setup → Home discovery: enters app
- Home discovery → Experience matching: requests matches
- Experience matching → Experience catalog: filters experiences
src/features/recommendations/recommendation-engine.ts - Experience matching → Access policy: checks access
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
README.md - Mission screen → Mission interactions: renders prompts
src/screens/main/experience-mission-screen.tsx - Mission interactions → Interaction state: updates state
src/features/missions/mission-interaction.tsx - Mission screen → Mission definitions: loads definitions
src/screens/main/experience-mission-screen.tsx - Mission screen → App data provider: saves progress
src/screens/main/experience-mission-screen.tsx - Mission screen → Experience session: uses session
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
src/features/app/app-data-provider.tsx - App data provider → Web persistence: loads and saves
src/features/app/app-data-provider.tsx - Platform persistence → Pocket Planet: applies commands
src/data/persistence/app-repository.native.ts - Web persistence → Pocket Planet: parses planet data
src/data/persistence/app-repository.web.ts - App data provider → Membership access: loads access
src/features/app/app-data-provider.tsx - Membership access → Platform persistence: caches entitlement
src/features/entitlements/entitlement-provider.tsx - Membership access → RevenueCat service: checks purchases
src/features/entitlements/entitlement-provider.tsx - Guardian → Guardian controls: manages settings
- Child and guardian → Membership access: may subscribe
README.md