# muzzamilhassan/how-dev-works architecture

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

- Interactive diagram: https://gitdiagram.com/muzzamilhassan/how-dev-works
- Repository: https://github.com/muzzamilhassan/how-dev-works

## Overview

This repository is the How Dev Works channel engine: it discovers and curates topics, dispatches long-form rendering to the external quarry-render service, and publishes videos to YouTube. A separate Urdu lane renders queued documentary episodes and promo Shorts locally before publishing. The frontend is a control-room dashboard whose episode, workflow, channel, credential, and analytics views currently use demo data. The main pipeline stages and dashboard routes are documented or visible in sampled files; unsampled workflow wiring is represented only where the README describes it.

Main entry points: [`frontend/src/App.tsx`](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/App.tsx) (Dashboard routing), [`publish.mjs`](https://github.com/muzzamilhassan/how-dev-works/blob/main/publish.mjs) (Tech publish orchestration), [`frontend/src/lib/data.ts`](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/lib/data.ts) (Dashboard demo data), [`urdu-render/publish-episode.mjs`](https://github.com/muzzamilhassan/how-dev-works/blob/main/urdu-render/publish-episode.mjs) (Urdu publish orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Topic discovery"]
  node_topic_brain["Topic bank scoring"]
  node_trend_radar["Trend radar<br/>[trend-radar.mjs]"]
  node_topic_bank[("Tech topic bank")]
end

subgraph group_tech["Tech publishing"]
  node_tech_publish["Tech publish orchestration<br/>[publish.mjs]"]
  node_research["YouTube query research<br/>[yt-research.mjs]"]
  node_pending[("Pending renders")]
  node_published[("Publish log<br/>[published.json]")]
  node_short_publish["Short publishing<br/>[publish-short.mjs]"]
end

subgraph group_urdu["Urdu publishing"]
  node_urdu_publish["Urdu publish orchestration"]
  node_urdu_queue[("Urdu episode queue<br/>[urdu-queue.json]")]
  node_urdu_channel["Urdu YouTube channel<br/>[urdu-channel.mjs]"]
end

subgraph group_dashboard["Control room"]
  node_app["Dashboard routing<br/>[App.tsx]"]
  node_overview["Overview<br/>[Overview.tsx]"]
  node_queue_view["Queue view<br/>[Queue.tsx]"]
  node_studio["Studio<br/>[Studio.tsx]"]
  node_media["Media library<br/>[Media.tsx]"]
  node_channels["Channels<br/>[Channels.tsx]"]
  node_automation["Automation<br/>[Automation.tsx]"]
  node_analytics["Analytics<br/>[Analytics.tsx]"]
  node_settings["Settings<br/>[Settings.tsx]"]
  node_access["Access gate<br/>[access.ts]"]
  node_demo_data["Dashboard demo data<br/>[data.ts]"]
  node_ui["Shared UI components<br/>[ui.tsx]"]
  node_layout["App layout<br/>[layout.tsx]"]
end

subgraph group_rendering["Local rendering"]
  node_episode_build["Episode build<br/>[build-episode.mjs]"]
  node_clip_fetch["Clip sourcing<br/>[fetch-clips.mjs]"]
  node_docshort["Documentary Shorts<br/>[DocShort.tsx]"]
end

node_dailydev(("daily.dev"))
node_radar_sources(("Trend sources"))
node_quarry["quarry-render"]
node_youtube["YouTube"]
node_dashboard_user(("Channel operator"))

node_dailydev -->|"supplies trends"| node_topic_brain
node_topic_brain -->|"updates topics"| node_topic_bank
node_radar_sources -->|"provides signals"| node_trend_radar
node_trend_radar -->|"adds wave topics"| node_topic_bank
node_topic_bank -->|"provides next idea"| node_tech_publish
node_tech_publish -->|"dispatches render"| node_quarry
node_tech_publish -->|"tracks render"| node_pending
node_quarry -->|"returns artifact"| node_tech_publish
node_tech_publish -->|"imports research"| node_research
node_tech_publish -->|"uploads video"| node_youtube
node_tech_publish -->|"logs upload"| node_published
node_tech_publish -->|"marks used"| node_topic_bank
node_short_publish -->|"uploads Short"| node_youtube
node_urdu_queue -->|"provides next script"| node_urdu_publish
node_urdu_publish -->|"builds episode"| node_episode_build
node_episode_build -.->|"uses sourced clips"| node_clip_fetch
node_urdu_publish -->|"cuts promo Shorts"| node_docshort
node_urdu_publish -->|"publishes episode"| node_urdu_channel
node_urdu_publish -->|"publishes Shorts"| node_youtube
node_dashboard_user -->|"opens console"| node_app
node_app -->|"checks unlock"| node_access
node_app -->|"routes to"| node_overview
node_app -->|"routes to"| node_queue_view
node_app -->|"routes to"| node_studio
node_app -->|"routes to"| node_media
node_app -->|"routes to"| node_channels
node_app -->|"routes to"| node_automation
node_app -->|"routes to"| node_analytics
node_app -->|"routes to"| node_settings
node_app -->|"wraps routes"| node_layout
node_overview -->|"reads demo data"| node_demo_data
node_queue_view -->|"reads demo data"| node_demo_data
node_studio -->|"reads demo data"| node_demo_data
node_channels -->|"reads demo data"| node_demo_data
node_automation -->|"reads demo data"| node_demo_data
node_analytics -->|"reads demo data"| node_demo_data
node_overview -->|"renders with"| node_ui
node_layout -->|"renders with"| node_ui

click node_topic_brain "https://github.com/muzzamilhassan/how-dev-works/blob/main/tech-topic-brain.mjs"
click node_trend_radar "https://github.com/muzzamilhassan/how-dev-works/blob/main/tools/trend-radar.mjs"
click node_topic_bank "https://github.com/muzzamilhassan/how-dev-works/blob/main/state/tech-topic-bank.json"
click node_tech_publish "https://github.com/muzzamilhassan/how-dev-works/blob/main/publish.mjs"
click node_research "https://github.com/muzzamilhassan/how-dev-works/blob/main/tools/yt-research.mjs"
click node_pending "https://github.com/muzzamilhassan/how-dev-works/blob/main/state/pending-renders.json"
click node_published "https://github.com/muzzamilhassan/how-dev-works/blob/main/state/published.json"
click node_short_publish "https://github.com/muzzamilhassan/how-dev-works/blob/main/publish-short.mjs"
click node_urdu_publish "https://github.com/muzzamilhassan/how-dev-works/blob/main/urdu-render/publish-episode.mjs"
click node_urdu_queue "https://github.com/muzzamilhassan/how-dev-works/blob/main/state/urdu-queue.json"
click node_urdu_channel "https://github.com/muzzamilhassan/how-dev-works/blob/main/tools/urdu-channel.mjs"
click node_episode_build "https://github.com/muzzamilhassan/how-dev-works/blob/main/urdu-render/build-episode.mjs"
click node_clip_fetch "https://github.com/muzzamilhassan/how-dev-works/blob/main/urdu-render/fetch-clips.mjs"
click node_docshort "https://github.com/muzzamilhassan/how-dev-works/blob/main/urdu-render/remotion/DocShort.tsx"
click node_app "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/App.tsx"
click node_overview "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Overview.tsx"
click node_queue_view "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Queue.tsx"
click node_studio "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Studio.tsx"
click node_media "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Media.tsx"
click node_channels "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Channels.tsx"
click node_automation "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Automation.tsx"
click node_analytics "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Analytics.tsx"
click node_settings "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Settings.tsx"
click node_access "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/lib/access.ts"
click node_demo_data "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/lib/data.ts"
click node_ui "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/components/ui.tsx"
click node_layout "https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/components/layout.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_topic_brain,node_trend_radar,node_topic_bank toneBlue
class node_tech_publish,node_research,node_pending,node_published,node_short_publish toneAmber
class node_urdu_publish,node_urdu_queue,node_urdu_channel toneMint
class node_app,node_overview,node_queue_view,node_studio,node_media,node_channels,node_automation,node_analytics,node_settings,node_access,node_demo_data,node_ui,node_layout toneRose
class node_episode_build,node_clip_fetch,node_docshort,node_dailydev,node_radar_sources,node_quarry,node_youtube,node_dashboard_user toneIndigo
```

## Components

### Topic discovery

- [Topic bank scoring](https://github.com/muzzamilhassan/how-dev-works/blob/main/tech-topic-brain.mjs): `tech-topic-brain.mjs`
- [Trend radar](https://github.com/muzzamilhassan/how-dev-works/blob/main/tools/trend-radar.mjs): `tools/trend-radar.mjs`
- [Tech topic bank](https://github.com/muzzamilhassan/how-dev-works/blob/main/state/tech-topic-bank.json): `state/tech-topic-bank.json`

### Tech publishing

- [Tech publish orchestration](https://github.com/muzzamilhassan/how-dev-works/blob/main/publish.mjs): `publish.mjs`
- [YouTube query research](https://github.com/muzzamilhassan/how-dev-works/blob/main/tools/yt-research.mjs): `tools/yt-research.mjs`
- [Pending renders](https://github.com/muzzamilhassan/how-dev-works/blob/main/state/pending-renders.json): `state/pending-renders.json`
- [Publish log](https://github.com/muzzamilhassan/how-dev-works/blob/main/state/published.json): `state/published.json`
- [Short publishing](https://github.com/muzzamilhassan/how-dev-works/blob/main/publish-short.mjs): `publish-short.mjs`

### Urdu publishing

- [Urdu publish orchestration](https://github.com/muzzamilhassan/how-dev-works/blob/main/urdu-render/publish-episode.mjs): `urdu-render/publish-episode.mjs`
- [Urdu episode queue](https://github.com/muzzamilhassan/how-dev-works/blob/main/state/urdu-queue.json): `state/urdu-queue.json`
- [Urdu YouTube channel](https://github.com/muzzamilhassan/how-dev-works/blob/main/tools/urdu-channel.mjs): `tools/urdu-channel.mjs`

### Control room

- [Dashboard routing](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Overview](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Overview.tsx): `frontend/src/pages/Overview.tsx`
- [Queue view](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Queue.tsx): `frontend/src/pages/Queue.tsx`
- [Studio](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Studio.tsx): `frontend/src/pages/Studio.tsx`
- [Media library](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Media.tsx): `frontend/src/pages/Media.tsx`
- [Channels](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Channels.tsx): `frontend/src/pages/Channels.tsx`
- [Automation](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Automation.tsx): `frontend/src/pages/Automation.tsx`
- [Analytics](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Analytics.tsx): `frontend/src/pages/Analytics.tsx`
- [Settings](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/pages/Settings.tsx): `frontend/src/pages/Settings.tsx`
- [Access gate](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/lib/access.ts): `frontend/src/lib/access.ts`
- [Dashboard demo data](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/lib/data.ts): `frontend/src/lib/data.ts`
- [Shared UI components](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/components/ui.tsx): `frontend/src/components/ui.tsx`
- [App layout](https://github.com/muzzamilhassan/how-dev-works/blob/main/frontend/src/components/layout.tsx): `frontend/src/components/layout.tsx`

### Local rendering

- [Episode build](https://github.com/muzzamilhassan/how-dev-works/blob/main/urdu-render/build-episode.mjs): `urdu-render/build-episode.mjs`
- [Clip sourcing](https://github.com/muzzamilhassan/how-dev-works/blob/main/urdu-render/fetch-clips.mjs): `urdu-render/fetch-clips.mjs`
- [Documentary Shorts](https://github.com/muzzamilhassan/how-dev-works/blob/main/urdu-render/remotion/DocShort.tsx): `urdu-render/remotion/DocShort.tsx`

### Other components

- **daily.dev**
- **Trend sources**
- **quarry-render**
- **YouTube**
- **Channel operator**

## Connections

- daily.dev → Topic bank scoring: supplies trends (evidence: `README.md`)
- Topic bank scoring → Tech topic bank: updates topics (evidence: `README.md`)
- Trend sources → Trend radar: provides signals (evidence: `README.md`)
- Trend radar → Tech topic bank: adds wave topics (evidence: `README.md`)
- Tech topic bank → Tech publish orchestration: provides next idea (evidence: `README.md`)
- Tech publish orchestration → quarry-render: dispatches render (evidence: `README.md`)
- Tech publish orchestration → Pending renders: tracks render (evidence: `README.md`)
- quarry-render → Tech publish orchestration: returns artifact (evidence: `README.md`)
- Tech publish orchestration → YouTube query research: imports research (evidence: `publish.mjs`)
- Tech publish orchestration → YouTube: uploads video (evidence: `README.md`)
- Tech publish orchestration → Publish log: logs upload (evidence: `README.md`)
- Tech publish orchestration → Tech topic bank: marks used (evidence: `README.md`)
- Short publishing → YouTube: uploads Short (evidence: `README.md`)
- Urdu episode queue → Urdu publish orchestration: provides next script (evidence: `README.md`)
- Urdu publish orchestration → Episode build: builds episode (evidence: `README.md`)
- Episode build → Clip sourcing: uses sourced clips
- Urdu publish orchestration → Documentary Shorts: cuts promo Shorts (evidence: `README.md`)
- Urdu publish orchestration → Urdu YouTube channel: publishes episode (evidence: `README.md`)
- Urdu publish orchestration → YouTube: publishes Shorts (evidence: `README.md`)
- Channel operator → Dashboard routing: opens console (evidence: `frontend/src/App.tsx`)
- Dashboard routing → Access gate: checks unlock (evidence: `frontend/src/App.tsx`)
- Dashboard routing → Overview: routes to (evidence: `frontend/src/App.tsx`)
- Dashboard routing → Queue view: routes to (evidence: `frontend/src/App.tsx`)
- Dashboard routing → Studio: routes to (evidence: `frontend/src/App.tsx`)
- Dashboard routing → Media library: routes to (evidence: `frontend/src/App.tsx`)
- Dashboard routing → Channels: routes to (evidence: `frontend/src/App.tsx`)
- Dashboard routing → Automation: routes to (evidence: `frontend/src/App.tsx`)
- Dashboard routing → Analytics: routes to (evidence: `frontend/src/App.tsx`)
- Dashboard routing → Settings: routes to (evidence: `frontend/src/App.tsx`)
- Dashboard routing → App layout: wraps routes (evidence: `frontend/src/App.tsx`)
- Overview → Dashboard demo data: reads demo data (evidence: `frontend/src/pages/Overview.tsx`)
- Queue view → Dashboard demo data: reads demo data (evidence: `frontend/src/pages/Queue.tsx`)
- Studio → Dashboard demo data: reads demo data (evidence: `frontend/src/pages/Studio.tsx`)
- Channels → Dashboard demo data: reads demo data (evidence: `frontend/src/pages/Channels.tsx`)
- Automation → Dashboard demo data: reads demo data (evidence: `frontend/src/pages/Automation.tsx`)
- Analytics → Dashboard demo data: reads demo data (evidence: `frontend/src/pages/Analytics.tsx`)
- Overview → Shared UI components: renders with (evidence: `frontend/src/pages/Overview.tsx`)
- App layout → Shared UI components: renders with (evidence: `frontend/src/components/layout.tsx`)
