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 now astro-book/).
  • Issues: mirror GitHub issues or riff off docs/agent-task.md if 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.