# munaz-new/novnn architecture

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

- Interactive diagram: https://gitdiagram.com/munaz-new/novnn
- Repository: https://github.com/munaz-new/novnn

## Overview

OSMIUM is a cross-platform wellness app for exercise, yoga, meditation, and guided activities. Users enter through the home screen, choose an activity, complete a camera-tracked or guided session, and can review progress and session history. The graph separates navigation, guided wellness, camera exercise, and shared preferences/history. Several activity capabilities are evident from the source tree and imports, but their route wiring and unsampled implementations are not fully shown; those relationships are omitted rather than inferred.

Main entry points: [`src/app/exercise/session.tsx`](https://github.com/munaz-new/novnn/blob/main/src/app/exercise/session.tsx) (Exercise session screen), [`src/components/guided/guided-activity-screen.tsx`](https://github.com/munaz-new/novnn/blob/main/src/components/guided/guided-activity-screen.tsx) (Guided activity runner), [`src/app/(tabs)/index.tsx`](https://github.com/munaz-new/novnn/blob/main/src/app/(tabs)/index.tsx) (Home screen), [`src/exercise/session-store.ts`](https://github.com/munaz-new/novnn/blob/main/src/exercise/session-store.ts) (Session history store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_home["Home screen<br/>[index.tsx]"]
  node_activity_routes["Activity routes<br/>[activities.tsx]"]
  node_yoga_routes["Yoga screens<br/>[yoga.tsx]"]
  node_meditation_routes["Meditation screens<br/>[meditation.tsx]"]
  node_wellness_routes["Wellness screens<br/>[wellness.tsx]"]
end

subgraph group_wellness["Guided wellness"]
  node_guided_screen["Guided activity runner"]
  node_guided_clock["Guided session clock<br/>[guided-session.ts]"]
  node_breathing["Breathing cycles<br/>[breath-cycle.ts]"]
  node_meditation_content["Meditation guidance and audio"]
  node_yoga_content["Yoga pose rules<br/>[yoga-pose-rules.ts]"]
end

subgraph group_exercise["Camera exercise"]
  node_exercise_catalog["Exercise catalog<br/>[exercises.ts]"]
  node_exercise_session["Exercise session screen<br/>[session.tsx]"]
  node_pose_tracker["Pose tracker"]
  node_session_engine["Session engine<br/>[session-engine.ts]"]
  node_rep_detection["Rep detection<br/>[rep-detector.ts]"]
  node_feedback["Exercise feedback<br/>[feedback.ts]"]
end

subgraph group_state["History and preferences"]
  node_session_history[("Session history store<br/>[session-store.ts]")]
  node_storage_adapter["Device storage adapter<br/>[session-storage.ts]"]
  node_history_view["Session history view"]
  node_progress["Progress screens<br/>[progress.tsx]"]
  node_language["Language preferences<br/>[use-language.tsx]"]
  node_theme["Theme preference"]
end

node_user(("User"))

node_user -->|"opens"| node_home
node_home -->|"opens activities"| node_activity_routes
node_home -->|"opens yoga"| node_yoga_routes
node_home -->|"opens meditation"| node_meditation_routes
node_guided_screen -->|"runs session"| node_guided_clock
node_guided_screen -->|"uses cycles"| node_breathing
node_guided_screen -->|"uses guidance"| node_meditation_content
node_guided_screen -->|"uses pose rules"| node_yoga_content
node_exercise_session -->|"loads exercises"| node_exercise_catalog
node_exercise_session -->|"tracks movement"| node_pose_tracker
node_exercise_session -->|"processes frames"| node_session_engine
node_session_engine -->|"detects repetitions"| node_rep_detection
node_session_engine -->|"emits cues"| node_feedback
node_exercise_session -->|"records sessions"| node_session_history
node_storage_adapter -->|"backs with storage"| node_session_history
node_history_view -->|"loads history"| node_session_history
node_progress -.->|"reads progress data"| node_session_history
node_user -.->|"chooses wellness"| node_wellness_routes
node_user -.->|"starts exercise"| node_exercise_session
node_user -.->|"reviews sessions"| node_history_view
node_user -.->|"sets language"| node_language
node_user -.->|"sets appearance"| node_theme

click node_home "https://github.com/munaz-new/novnn/blob/main/src/app/(tabs)/index.tsx"
click node_activity_routes "https://github.com/munaz-new/novnn/blob/main/src/app/(tabs)/activities.tsx"
click node_yoga_routes "https://github.com/munaz-new/novnn/blob/main/src/app/yoga.tsx"
click node_meditation_routes "https://github.com/munaz-new/novnn/blob/main/src/app/meditation.tsx"
click node_wellness_routes "https://github.com/munaz-new/novnn/blob/main/src/app/wellness.tsx"
click node_guided_screen "https://github.com/munaz-new/novnn/blob/main/src/components/guided/guided-activity-screen.tsx"
click node_guided_clock "https://github.com/munaz-new/novnn/blob/main/src/activities/guided-session.ts"
click node_breathing "https://github.com/munaz-new/novnn/blob/main/src/activities/breath-cycle.ts"
click node_meditation_content "https://github.com/munaz-new/novnn/blob/main/src/activities/meditation-audio.ts"
click node_yoga_content "https://github.com/munaz-new/novnn/blob/main/src/activities/yoga-pose-rules.ts"
click node_exercise_catalog "https://github.com/munaz-new/novnn/blob/main/src/data/exercises.ts"
click node_exercise_session "https://github.com/munaz-new/novnn/blob/main/src/app/exercise/session.tsx"
click node_pose_tracker "https://github.com/munaz-new/novnn/blob/main/modules/pose-tracker/src/PoseTrackerView.tsx"
click node_session_engine "https://github.com/munaz-new/novnn/blob/main/src/exercise/session-engine.ts"
click node_rep_detection "https://github.com/munaz-new/novnn/blob/main/src/exercise/rep-detector.ts"
click node_feedback "https://github.com/munaz-new/novnn/blob/main/src/exercise/feedback.ts"
click node_session_history "https://github.com/munaz-new/novnn/blob/main/src/exercise/session-store.ts"
click node_storage_adapter "https://github.com/munaz-new/novnn/blob/main/src/exercise/session-storage.ts"
click node_history_view "https://github.com/munaz-new/novnn/blob/main/src/components/session/session-history.tsx"
click node_progress "https://github.com/munaz-new/novnn/blob/main/src/app/(tabs)/progress.tsx"
click node_language "https://github.com/munaz-new/novnn/blob/main/src/hooks/use-language.tsx"
click node_theme "https://github.com/munaz-new/novnn/blob/main/src/settings/theme-preference.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_home,node_activity_routes,node_yoga_routes,node_meditation_routes,node_wellness_routes,node_user toneBlue
class node_guided_screen,node_guided_clock,node_breathing,node_meditation_content,node_yoga_content toneAmber
class node_exercise_catalog,node_exercise_session,node_pose_tracker,node_session_engine,node_rep_detection,node_feedback toneMint
class node_session_history,node_storage_adapter,node_history_view,node_progress,node_language,node_theme toneRose
```

## Components

### App navigation

- [Home screen](https://github.com/munaz-new/novnn/blob/main/src/app/(tabs)/index.tsx): `src/app/(tabs)/index.tsx`
- [Activity routes](https://github.com/munaz-new/novnn/blob/main/src/app/(tabs)/activities.tsx): `src/app/(tabs)/activities.tsx`
- [Yoga screens](https://github.com/munaz-new/novnn/blob/main/src/app/yoga.tsx): `src/app/yoga.tsx`
- [Meditation screens](https://github.com/munaz-new/novnn/blob/main/src/app/meditation.tsx): `src/app/meditation.tsx`
- [Wellness screens](https://github.com/munaz-new/novnn/blob/main/src/app/wellness.tsx): `src/app/wellness.tsx`

### Guided wellness

- [Guided activity runner](https://github.com/munaz-new/novnn/blob/main/src/components/guided/guided-activity-screen.tsx): `src/components/guided/guided-activity-screen.tsx`
- [Guided session clock](https://github.com/munaz-new/novnn/blob/main/src/activities/guided-session.ts): `src/activities/guided-session.ts`
- [Breathing cycles](https://github.com/munaz-new/novnn/blob/main/src/activities/breath-cycle.ts): `src/activities/breath-cycle.ts`
- [Meditation guidance and audio](https://github.com/munaz-new/novnn/blob/main/src/activities/meditation-audio.ts): `src/activities/meditation-audio.ts`
- [Yoga pose rules](https://github.com/munaz-new/novnn/blob/main/src/activities/yoga-pose-rules.ts): `src/activities/yoga-pose-rules.ts`

### Camera exercise

- [Exercise catalog](https://github.com/munaz-new/novnn/blob/main/src/data/exercises.ts): `src/data/exercises.ts`
- [Exercise session screen](https://github.com/munaz-new/novnn/blob/main/src/app/exercise/session.tsx): `src/app/exercise/session.tsx`
- [Pose tracker](https://github.com/munaz-new/novnn/blob/main/modules/pose-tracker/src/PoseTrackerView.tsx): `modules/pose-tracker/src/PoseTrackerView.tsx`
- [Session engine](https://github.com/munaz-new/novnn/blob/main/src/exercise/session-engine.ts): `src/exercise/session-engine.ts`
- [Rep detection](https://github.com/munaz-new/novnn/blob/main/src/exercise/rep-detector.ts): `src/exercise/rep-detector.ts`
- [Exercise feedback](https://github.com/munaz-new/novnn/blob/main/src/exercise/feedback.ts): `src/exercise/feedback.ts`

### History and preferences

- [Session history store](https://github.com/munaz-new/novnn/blob/main/src/exercise/session-store.ts): `src/exercise/session-store.ts`
- [Device storage adapter](https://github.com/munaz-new/novnn/blob/main/src/exercise/session-storage.ts): `src/exercise/session-storage.ts`
- [Session history view](https://github.com/munaz-new/novnn/blob/main/src/components/session/session-history.tsx): `src/components/session/session-history.tsx`
- [Progress screens](https://github.com/munaz-new/novnn/blob/main/src/app/(tabs)/progress.tsx): `src/app/(tabs)/progress.tsx`
- [Language preferences](https://github.com/munaz-new/novnn/blob/main/src/hooks/use-language.tsx): `src/hooks/use-language.tsx`
- [Theme preference](https://github.com/munaz-new/novnn/blob/main/src/settings/theme-preference.ts): `src/settings/theme-preference.ts`

### Other components

- **User**

## Connections

- User → Home screen: opens (evidence: `src/app/(tabs)/index.tsx`)
- Home screen → Activity routes: opens activities (evidence: `src/app/(tabs)/index.tsx`)
- Home screen → Yoga screens: opens yoga (evidence: `src/app/(tabs)/index.tsx`)
- Home screen → Meditation screens: opens meditation (evidence: `src/app/(tabs)/index.tsx`)
- Guided activity runner → Guided session clock: runs session (evidence: `src/components/guided/guided-activity-screen.tsx`)
- Guided activity runner → Breathing cycles: uses cycles (evidence: `src/components/guided/guided-activity-screen.tsx`)
- Guided activity runner → Meditation guidance and audio: uses guidance (evidence: `src/components/guided/guided-activity-screen.tsx`)
- Guided activity runner → Yoga pose rules: uses pose rules (evidence: `src/components/guided/guided-activity-screen.tsx`)
- Exercise session screen → Exercise catalog: loads exercises (evidence: `src/app/exercise/session.tsx`)
- Exercise session screen → Pose tracker: tracks movement (evidence: `src/app/exercise/session.tsx`)
- Exercise session screen → Session engine: processes frames (evidence: `src/app/exercise/session.tsx`)
- Session engine → Rep detection: detects repetitions (evidence: `src/exercise/session-engine.ts`)
- Session engine → Exercise feedback: emits cues (evidence: `src/exercise/session-engine.ts`)
- Exercise session screen → Session history store: records sessions (evidence: `src/app/exercise/session.tsx`)
- Device storage adapter → Session history store: backs with storage (evidence: `src/exercise/session-storage.ts`)
- Session history view → Session history store: loads history (evidence: `src/components/session/session-history.tsx`)
- Progress screens → Session history store: reads progress data
- User → Wellness screens: chooses wellness
- User → Exercise session screen: starts exercise
- User → Session history view: reviews sessions
- User → Language preferences: sets language
- User → Theme preference: sets appearance
