# sumant-vidyaai/spashta architecture

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

- Interactive diagram: https://gitdiagram.com/sumant-vidyaai/spashta
- Repository: https://github.com/sumant-vidyaai/spashta

## Overview

Spashta is a browser-based, tool-agnostic project analytics app. A user opens the app, imports an export or uses the template, and works with project metrics, health, forecasts, and lifecycle views. The core library provides canonical project data and calculation capabilities; the web app presents them in separate screens. The README documents substantial features whose detailed implementations were not sampled, so those appear as capability nodes without speculative internal links. App-to-screen routing is visible in the sampled App excerpt; other uncertain implementation relationships are omitted.

Main entry points: [`packages/web/src/App.tsx`](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/App.tsx) (Analytics app), [`packages/web/src/Import.tsx`](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Import.tsx) (File import), [`packages/core/src/importTasks.ts`](https://github.com/sumant-vidyaai/spashta/blob/main/packages/core/src/importTasks.ts) (Task normalization), [`packages/web/src/site/Root.tsx`](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/site/Root.tsx) (Site router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_site_root["Site router<br/>[Root.tsx]"]
  node_app["Analytics app<br/>[App.tsx]"]
end

subgraph group_ingest["Import and data"]
  node_import["File import<br/>[Import.tsx]"]
  node_read_file["File reader<br/>[readFile.ts]"]
  node_canonical_model["Canonical model<br/>[model.ts]"]
  node_task_import["Task normalization<br/>[importTasks.ts]"]
  node_date_rules["Date handling<br/>[dates.ts]"]
  node_template["Template workflow<br/>[Template.tsx]"]
end

subgraph group_analytics["Project analytics"]
  node_overview["Overview<br/>[Overview.tsx]"]
  node_portfolio["Portfolio roll-up<br/>[Portfolio.tsx]"]
  node_flow["Flow metrics<br/>[Flow.tsx]"]
  node_schedule["Schedule analysis<br/>[ScheduleScreen.tsx]"]
  node_cost["Cost analysis<br/>[CostScreen.tsx]"]
  node_resource["Resource analysis<br/>[ResourceScreen.tsx]"]
  node_quality["Quality analysis<br/>[QualityScreen.tsx]"]
  node_forecast["Forecasting<br/>[Forecast.tsx]"]
  node_trends["Dated trends<br/>[Trends.tsx]"]
end

subgraph group_lifecycle["Lifecycle and guidance"]
  node_raid["Risks and changes<br/>[Raid.tsx]"]
  node_initiate["Project initiation<br/>[Initiate.tsx]"]
  node_planning["Project planning<br/>[Planning.tsx]"]
  node_close["Project closure<br/>[Close.tsx]"]
  node_learn["Learn section<br/>[Learn.tsx]"]
  node_status_report["Status report<br/>[StatusReport.tsx]"]
end

node_user(("Project user"))

node_user -->|"opens app"| node_site_root
node_site_root -->|"routes app"| node_app
node_app -->|"renders import"| node_import
node_app -->|"renders template"| node_template
node_app -->|"renders overview"| node_overview
node_app -->|"renders portfolio"| node_portfolio
node_app -->|"renders flow"| node_flow
node_app -->|"renders schedule"| node_schedule
node_app -->|"renders cost"| node_cost
node_app -->|"renders resources"| node_resource
node_app -->|"renders quality"| node_quality
node_app -->|"renders RAID"| node_raid
node_app -->|"renders initiation"| node_initiate
node_app -->|"renders planning"| node_planning
node_app -->|"renders closure"| node_close
node_app -->|"renders forecasts"| node_forecast
node_app -->|"renders report"| node_status_report
node_import -->|"reads file"| node_read_file
node_import -.->|"normalizes tasks"| node_task_import
node_task_import -->|"uses types"| node_canonical_model
node_task_import -->|"parses dates"| node_date_rules
node_user -->|"downloads template"| node_template
node_app -.->|"offers trends"| node_trends
node_app -.->|"offers guidance"| node_learn

click node_site_root "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/site/Root.tsx"
click node_app "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/App.tsx"
click node_import "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Import.tsx"
click node_read_file "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/readFile.ts"
click node_canonical_model "https://github.com/sumant-vidyaai/spashta/blob/main/packages/core/src/model.ts"
click node_task_import "https://github.com/sumant-vidyaai/spashta/blob/main/packages/core/src/importTasks.ts"
click node_date_rules "https://github.com/sumant-vidyaai/spashta/blob/main/packages/core/src/dates.ts"
click node_template "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Template.tsx"
click node_overview "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Overview.tsx"
click node_portfolio "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Portfolio.tsx"
click node_flow "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Flow.tsx"
click node_schedule "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/ScheduleScreen.tsx"
click node_cost "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/CostScreen.tsx"
click node_resource "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/ResourceScreen.tsx"
click node_quality "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/QualityScreen.tsx"
click node_forecast "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Forecast.tsx"
click node_trends "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Trends.tsx"
click node_raid "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Raid.tsx"
click node_initiate "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Initiate.tsx"
click node_planning "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Planning.tsx"
click node_close "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Close.tsx"
click node_learn "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Learn.tsx"
click node_status_report "https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/StatusReport.tsx"

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_site_root,node_app,node_user toneBlue
class node_import,node_read_file,node_canonical_model,node_task_import,node_date_rules,node_template toneAmber
class node_overview,node_portfolio,node_flow,node_schedule,node_cost,node_resource,node_quality,node_forecast,node_trends toneMint
class node_raid,node_initiate,node_planning,node_close,node_learn,node_status_report toneRose
```

## Components

### Web entry

- [Site router](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/site/Root.tsx): `packages/web/src/site/Root.tsx`
- [Analytics app](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/App.tsx): `packages/web/src/App.tsx`

### Import and data

- [File import](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Import.tsx): `packages/web/src/Import.tsx`
- [File reader](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/readFile.ts): `packages/web/src/readFile.ts`
- [Canonical model](https://github.com/sumant-vidyaai/spashta/blob/main/packages/core/src/model.ts): `packages/core/src/model.ts`
- [Task normalization](https://github.com/sumant-vidyaai/spashta/blob/main/packages/core/src/importTasks.ts): `packages/core/src/importTasks.ts`
- [Date handling](https://github.com/sumant-vidyaai/spashta/blob/main/packages/core/src/dates.ts): `packages/core/src/dates.ts`
- [Template workflow](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Template.tsx): `packages/web/src/Template.tsx`

### Project analytics

- [Overview](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Overview.tsx): `packages/web/src/Overview.tsx`
- [Portfolio roll-up](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Portfolio.tsx): `packages/web/src/Portfolio.tsx`
- [Flow metrics](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Flow.tsx): `packages/web/src/Flow.tsx`
- [Schedule analysis](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/ScheduleScreen.tsx): `packages/web/src/ScheduleScreen.tsx`
- [Cost analysis](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/CostScreen.tsx): `packages/web/src/CostScreen.tsx`
- [Resource analysis](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/ResourceScreen.tsx): `packages/web/src/ResourceScreen.tsx`
- [Quality analysis](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/QualityScreen.tsx): `packages/web/src/QualityScreen.tsx`
- [Forecasting](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Forecast.tsx): `packages/web/src/Forecast.tsx`
- [Dated trends](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Trends.tsx): `packages/web/src/Trends.tsx`

### Lifecycle and guidance

- [Risks and changes](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Raid.tsx): `packages/web/src/Raid.tsx`
- [Project initiation](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Initiate.tsx): `packages/web/src/Initiate.tsx`
- [Project planning](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Planning.tsx): `packages/web/src/Planning.tsx`
- [Project closure](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Close.tsx): `packages/web/src/Close.tsx`
- [Learn section](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/Learn.tsx): `packages/web/src/Learn.tsx`
- [Status report](https://github.com/sumant-vidyaai/spashta/blob/main/packages/web/src/StatusReport.tsx): `packages/web/src/StatusReport.tsx`

### Other components

- **Project user**

## Connections

- Project user → Site router: opens app (evidence: `packages/web/src/site/Root.tsx`)
- Site router → Analytics app: routes app (evidence: `packages/web/src/site/Root.tsx`)
- Analytics app → File import: renders import (evidence: `packages/web/src/App.tsx`)
- Analytics app → Template workflow: renders template (evidence: `packages/web/src/App.tsx`)
- Analytics app → Overview: renders overview (evidence: `packages/web/src/App.tsx`)
- Analytics app → Portfolio roll-up: renders portfolio (evidence: `packages/web/src/App.tsx`)
- Analytics app → Flow metrics: renders flow (evidence: `packages/web/src/App.tsx`)
- Analytics app → Schedule analysis: renders schedule (evidence: `packages/web/src/App.tsx`)
- Analytics app → Cost analysis: renders cost (evidence: `packages/web/src/App.tsx`)
- Analytics app → Resource analysis: renders resources (evidence: `packages/web/src/App.tsx`)
- Analytics app → Quality analysis: renders quality (evidence: `packages/web/src/App.tsx`)
- Analytics app → Risks and changes: renders RAID (evidence: `packages/web/src/App.tsx`)
- Analytics app → Project initiation: renders initiation (evidence: `packages/web/src/App.tsx`)
- Analytics app → Project planning: renders planning (evidence: `packages/web/src/App.tsx`)
- Analytics app → Project closure: renders closure (evidence: `packages/web/src/App.tsx`)
- Analytics app → Forecasting: renders forecasts (evidence: `packages/web/src/App.tsx`)
- Analytics app → Status report: renders report (evidence: `packages/web/src/App.tsx`)
- File import → File reader: reads file (evidence: `packages/web/src/Import.tsx`)
- File import → Task normalization: normalizes tasks
- Task normalization → Canonical model: uses types (evidence: `packages/core/src/importTasks.ts`)
- Task normalization → Date handling: parses dates (evidence: `packages/core/src/importTasks.ts`)
- Project user → Template workflow: downloads template
- Analytics app → Dated trends: offers trends (evidence: `packages/web/src/App.tsx`)
- Analytics app → Learn section: offers guidance (evidence: `packages/web/src/App.tsx`)
