Project Name: The Practical Guide
Welcome to the newsroom cut of our build log. Every page in this guide is written like a field report for the High-Signal News HUD—equal parts engineering notebook and magazine feature.
Title
High-Signal News HUD: The Practical Guide — the edition you bookmark when someone asks “so how does this HUD really work?”
Tagline
Powered by Next.js and Supabase, tuned for focus-first news junkies, and narrated like a tech zine that cares about DX and dopamine levels in equal measure.
Version & Date
- Version: 0.1.0 (
web/package.json) - Published: 2025-09-23 (ISO, because consistency is calming)
Author
High-Signal News HUD Team — product-minded devs, caffeine, and a stubborn love of fast feedback loops.
Repo / Issue Tracker / License
- Repo: this monorepo (
web/,supabase/,docs/, and nowastro-book/). - Issues: mirror GitHub issues or riff off
docs/agent-task.mdif you’re pairing in MCP. - License: MIT for the docs app (see
LICENSE); the HUD app itself defaults to All Rights Reserved unless you add a license.
Reading Map
- Tutorial → Quickstart — boot HUD + docs in minutes, with smoke tests baked in.
- How-to → Recipes — copy/paste playbooks for new endpoints, jobs, CI, and rollbacks.
- Reference → API + Config — when you need exact params or env var precedence at 02:00.
- Explanation → Architecture + ADR Index — the “why” behind every trade-off.