How muzzamilhassan/how-dev-works works
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: App.tsx Dashboard routing · publish.mjs Tech publish orchestration · data.ts Dashboard demo data · publish-episode.mjs Urdu publish orchestration
Components 32
Topic discovery
- Topic bank scoring
tech-topic-brain.mjs - Trend radar
tools/trend-radar.mjs - Tech topic bank
state/tech-topic-bank.json
Tech publishing
- Tech publish orchestration
publish.mjs - YouTube query research
tools/yt-research.mjs - Pending renders
state/pending-renders.json - Publish log
state/published.json - Short publishing
publish-short.mjs
Urdu publishing
- Urdu publish orchestration
urdu-render/publish-episode.mjs - Urdu episode queue
state/urdu-queue.json - Urdu YouTube channel
tools/urdu-channel.mjs
Control room
- Dashboard routing
frontend/src/App.tsx - Overview
frontend/src/pages/Overview.tsx - Queue view
frontend/src/pages/Queue.tsx - Studio
frontend/src/pages/Studio.tsx - Media library
frontend/src/pages/Media.tsx - Channels
frontend/src/pages/Channels.tsx - Automation
frontend/src/pages/Automation.tsx - Analytics
frontend/src/pages/Analytics.tsx - Settings
frontend/src/pages/Settings.tsx - Access gate
frontend/src/lib/access.ts - Dashboard demo data
frontend/src/lib/data.ts - Shared UI components
frontend/src/components/ui.tsx - App layout
frontend/src/components/layout.tsx
Local rendering
- Episode build
urdu-render/build-episode.mjs - Clip sourcing
urdu-render/fetch-clips.mjs - Documentary Shorts
urdu-render/remotion/DocShort.tsx
Other components
- daily.dev
- Trend sources
- quarry-render
- YouTube
- Channel operator
Connections 38
- daily.dev → Topic bank scoring: supplies trends
README.md - Topic bank scoring → Tech topic bank: updates topics
README.md - Trend sources → Trend radar: provides signals
README.md - Trend radar → Tech topic bank: adds wave topics
README.md - Tech topic bank → Tech publish orchestration: provides next idea
README.md - Tech publish orchestration → quarry-render: dispatches render
README.md - Tech publish orchestration → Pending renders: tracks render
README.md - quarry-render → Tech publish orchestration: returns artifact
README.md - Tech publish orchestration → YouTube query research: imports research
publish.mjs - Tech publish orchestration → YouTube: uploads video
README.md - Tech publish orchestration → Publish log: logs upload
README.md - Tech publish orchestration → Tech topic bank: marks used
README.md - Short publishing → YouTube: uploads Short
README.md - Urdu episode queue → Urdu publish orchestration: provides next script
README.md - Urdu publish orchestration → Episode build: builds episode
README.md - Episode build → Clip sourcing: uses sourced clips
- Urdu publish orchestration → Documentary Shorts: cuts promo Shorts
README.md - Urdu publish orchestration → Urdu YouTube channel: publishes episode
README.md - Urdu publish orchestration → YouTube: publishes Shorts
README.md - Channel operator → Dashboard routing: opens console
frontend/src/App.tsx - Dashboard routing → Access gate: checks unlock
frontend/src/App.tsx - Dashboard routing → Overview: routes to
frontend/src/App.tsx - Dashboard routing → Queue view: routes to
frontend/src/App.tsx - Dashboard routing → Studio: routes to
frontend/src/App.tsx - Dashboard routing → Media library: routes to
frontend/src/App.tsx - Dashboard routing → Channels: routes to
frontend/src/App.tsx - Dashboard routing → Automation: routes to
frontend/src/App.tsx - Dashboard routing → Analytics: routes to
frontend/src/App.tsx - Dashboard routing → Settings: routes to
frontend/src/App.tsx - Dashboard routing → App layout: wraps routes
frontend/src/App.tsx - Overview → Dashboard demo data: reads demo data
frontend/src/pages/Overview.tsx - Queue view → Dashboard demo data: reads demo data
frontend/src/pages/Queue.tsx - Studio → Dashboard demo data: reads demo data
frontend/src/pages/Studio.tsx - Channels → Dashboard demo data: reads demo data
frontend/src/pages/Channels.tsx - Automation → Dashboard demo data: reads demo data
frontend/src/pages/Automation.tsx - Analytics → Dashboard demo data: reads demo data
frontend/src/pages/Analytics.tsx - Overview → Shared UI components: renders with
frontend/src/pages/Overview.tsx - App layout → Shared UI components: renders with
frontend/src/components/layout.tsx