# shadhin78/x-29 architecture

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

- Interactive diagram: https://gitdiagram.com/shadhin78/x-29
- Repository: https://github.com/shadhin78/x-29

## Overview

X-29 is a study-planning and execution dashboard, described in package metadata as a multi-track execution and tracking dashboard. Its principal workflow is to enter through the authenticated app, navigate to a study workspace, and manage study tasks, targets, schedules, and focus sessions while tracking progress and outcomes. The tree shows additional analytics and configuration capabilities. README content is only a product name, so feature details and most page-to-feature relationships are based on filenames; those uncertain links are omitted. Source excerpts establish the bootstrap and selected module relationships, not the complete runtime wiring.

Main entry points: [`js/core/app.js`](https://github.com/shadhin78/x-29/blob/main/js/core/app.js) (App bootstrap), [`js/features/dashboard/dashboard.js`](https://github.com/shadhin78/x-29/blob/main/js/features/dashboard/dashboard.js) (Dashboard core), [`router/router.js`](https://github.com/shadhin78/x-29/blob/main/router/router.js) (SPA router), [`js/services/auth.js`](https://github.com/shadhin78/x-29/blob/main/js/services/auth.js) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App runtime"]
  node_app["App bootstrap<br/>[app.js]"]
  node_router["SPA router<br/>[router.js]"]
  node_dashboard_page["Dashboard page<br/>[Dashboard.js]"]
  node_rollover["Date rollover<br/>[rollover.js]"]
  node_dom["DOM helpers<br/>[dom.js]"]
  node_colors["Color helpers<br/>[colors.js]"]
end

subgraph group_study["Study planning"]
  node_targets["Study targets"]
  node_tasks["Task engine<br/>[taskEngine.js]"]
  node_schedule["Study schedule"]
  node_exam["Exam routine"]
  node_pace["Pace management"]
  node_habits["Daily habits"]
end

subgraph group_tracking["Progress tracking"]
  node_dashboard["Dashboard core<br/>[dashboard.js]"]
  node_metrics["Progress metrics<br/>[metrics.js]"]
  node_analytics["Study analytics"]
  node_outcomes["Outcomes"]
  node_timer["Focus timer<br/>[timerService.js]"]
end

subgraph group_support["Identity and data"]
  node_state["App state<br/>[state.js]"]
  node_firebase[("Firebase data layer<br/>[firebase.js]")]
  node_auth["Authentication<br/>[auth.js]"]
  node_login["Login page<br/>[login.js]"]
end

node_user(("Learner"))

node_app -->|"hydrates state"| node_state
node_app -->|"initializes data"| node_firebase
node_app -->|"initializes auth"| node_auth
node_app -->|"starts service"| node_timer
node_app -->|"initializes navigation"| node_router
node_app -->|"initializes dashboard"| node_dashboard
node_app -->|"starts rollover"| node_rollover
node_user -.->|"signs in"| node_login
node_login -.->|"uses authentication"| node_auth
node_auth -.->|"uses Firebase auth"| node_firebase
node_user -.->|"navigates"| node_router
node_router -->|"mounts page"| node_dashboard_page
node_dashboard_page -->|"delegates to"| node_dashboard
node_dashboard -->|"uses helpers"| node_dom
node_dashboard -->|"uses colors"| node_colors
node_tasks -->|"uses helpers"| node_dom
node_tasks -->|"uses colors"| node_colors

click node_app "https://github.com/shadhin78/x-29/blob/main/js/core/app.js"
click node_router "https://github.com/shadhin78/x-29/blob/main/router/router.js"
click node_dashboard_page "https://github.com/shadhin78/x-29/blob/main/pages/Dashboard/Dashboard.js"
click node_dashboard "https://github.com/shadhin78/x-29/blob/main/js/features/dashboard/dashboard.js"
click node_metrics "https://github.com/shadhin78/x-29/blob/main/js/core/metrics.js"
click node_analytics "https://github.com/shadhin78/x-29/tree/main/js/features/analytics"
click node_outcomes "https://github.com/shadhin78/x-29/tree/main/js/features/outcome"
click node_targets "https://github.com/shadhin78/x-29/tree/main/js/features/targets"
click node_tasks "https://github.com/shadhin78/x-29/blob/main/js/features/tasks/taskEngine.js"
click node_schedule "https://github.com/shadhin78/x-29/tree/main/js/features/schedule"
click node_exam "https://github.com/shadhin78/x-29/tree/main/js/features/exam"
click node_pace "https://github.com/shadhin78/x-29/tree/main/js/features/pace"
click node_habits "https://github.com/shadhin78/x-29/tree/main/js/features/habits"
click node_timer "https://github.com/shadhin78/x-29/blob/main/shared/services/timerService.js"
click node_state "https://github.com/shadhin78/x-29/blob/main/js/state.js"
click node_firebase "https://github.com/shadhin78/x-29/blob/main/js/firebase.js"
click node_auth "https://github.com/shadhin78/x-29/blob/main/js/services/auth.js"
click node_login "https://github.com/shadhin78/x-29/blob/main/js/pages/login/login.js"
click node_rollover "https://github.com/shadhin78/x-29/blob/main/js/core/rollover.js"
click node_dom "https://github.com/shadhin78/x-29/blob/main/js/utils/dom.js"
click node_colors "https://github.com/shadhin78/x-29/blob/main/js/utils/colors.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_app,node_router,node_dashboard_page,node_rollover,node_dom,node_colors toneBlue
class node_targets,node_tasks,node_schedule,node_exam,node_pace,node_habits toneAmber
class node_dashboard,node_metrics,node_analytics,node_outcomes,node_timer toneMint
class node_state,node_firebase,node_auth,node_login toneRose
class node_user toneIndigo
```

## Components

### App runtime

- [App bootstrap](https://github.com/shadhin78/x-29/blob/main/js/core/app.js): `js/core/app.js`
- [SPA router](https://github.com/shadhin78/x-29/blob/main/router/router.js): `router/router.js`
- [Dashboard page](https://github.com/shadhin78/x-29/blob/main/pages/Dashboard/Dashboard.js): `pages/Dashboard/Dashboard.js`
- [Date rollover](https://github.com/shadhin78/x-29/blob/main/js/core/rollover.js): `js/core/rollover.js`
- [DOM helpers](https://github.com/shadhin78/x-29/blob/main/js/utils/dom.js): `js/utils/dom.js`
- [Color helpers](https://github.com/shadhin78/x-29/blob/main/js/utils/colors.js): `js/utils/colors.js`

### Study planning

- [Study targets](https://github.com/shadhin78/x-29/tree/main/js/features/targets): `js/features/targets`
- [Task engine](https://github.com/shadhin78/x-29/blob/main/js/features/tasks/taskEngine.js): `js/features/tasks/taskEngine.js`
- [Study schedule](https://github.com/shadhin78/x-29/tree/main/js/features/schedule): `js/features/schedule`
- [Exam routine](https://github.com/shadhin78/x-29/tree/main/js/features/exam): `js/features/exam`
- [Pace management](https://github.com/shadhin78/x-29/tree/main/js/features/pace): `js/features/pace`
- [Daily habits](https://github.com/shadhin78/x-29/tree/main/js/features/habits): `js/features/habits`

### Progress tracking

- [Dashboard core](https://github.com/shadhin78/x-29/blob/main/js/features/dashboard/dashboard.js): `js/features/dashboard/dashboard.js`
- [Progress metrics](https://github.com/shadhin78/x-29/blob/main/js/core/metrics.js): `js/core/metrics.js`
- [Study analytics](https://github.com/shadhin78/x-29/tree/main/js/features/analytics): `js/features/analytics`
- [Outcomes](https://github.com/shadhin78/x-29/tree/main/js/features/outcome): `js/features/outcome`
- [Focus timer](https://github.com/shadhin78/x-29/blob/main/shared/services/timerService.js): `shared/services/timerService.js`

### Identity and data

- [App state](https://github.com/shadhin78/x-29/blob/main/js/state.js): `js/state.js`
- [Firebase data layer](https://github.com/shadhin78/x-29/blob/main/js/firebase.js): `js/firebase.js`
- [Authentication](https://github.com/shadhin78/x-29/blob/main/js/services/auth.js): `js/services/auth.js`
- [Login page](https://github.com/shadhin78/x-29/blob/main/js/pages/login/login.js): `js/pages/login/login.js`

### Other components

- **Learner**

## Connections

- App bootstrap → App state: hydrates state (evidence: `js/core/app.js`)
- App bootstrap → Firebase data layer: initializes data (evidence: `js/core/app.js`)
- App bootstrap → Authentication: initializes auth (evidence: `js/core/app.js`)
- App bootstrap → Focus timer: starts service (evidence: `js/core/app.js`)
- App bootstrap → SPA router: initializes navigation (evidence: `js/core/app.js`)
- App bootstrap → Dashboard core: initializes dashboard (evidence: `js/core/app.js`)
- App bootstrap → Date rollover: starts rollover (evidence: `js/core/app.js`)
- Learner → Login page: signs in
- Login page → Authentication: uses authentication
- Authentication → Firebase data layer: uses Firebase auth
- Learner → SPA router: navigates
- SPA router → Dashboard page: mounts page (evidence: `pages/Dashboard/Dashboard.js`)
- Dashboard page → Dashboard core: delegates to (evidence: `pages/Dashboard/Dashboard.js`)
- Dashboard core → DOM helpers: uses helpers (evidence: `js/features/dashboard/dashboard.js`)
- Dashboard core → Color helpers: uses colors (evidence: `js/features/dashboard/dashboard.js`)
- Task engine → DOM helpers: uses helpers (evidence: `js/features/tasks/taskEngine.js`)
- Task engine → Color helpers: uses colors (evidence: `js/features/tasks/taskEngine.js`)
