JustAPI Docs β WebTUI Terminal Site
A from-scratch documentation site built on WebTUI (https://webtui.ironclad.sh)
β the pure-CSS library that brings Terminal UIs to the browser.
Structure
webtui/
βββ build.py # static site generator (markdown β HTML)
β # Β· sidebar auto-discovered from content dir (never stale)
β # Β· 160 pages = docs_site parity
βββ css/ # vendored WebTUI (base, components, nf, themes)
βββ src/
β βββ main.css # terminal design system (navbar, dual sidebar, landing)
β βββ main.js # theme switcher, tabs, bars, sidebar active states
βββ templates/
β βββ base.html # page template (navbar + left nav + content + right TOC)
β βββ landing.html # home page (hero, stats, terminal, bars, cards)
βββ content/ # (empty β source markdown lives in ../docs_site/src/content/docs)
βββ dist/ # generated static site (deploy this)
Build
python3 build.py # reads ../docs_site/src/content/docs β dist/
Output: static HTML with zero JS framework β WebTUI is pure CSS + a small
vanilla JS file for theme switching and the terminal interactions.
Design
- 8-bit terminal palette β classic ANSI colors (
--bit0..--bit15) - Themes: dark Β· light Β· catppuccin (default) Β· everforest Β· nord
(floating switcher, bottom-right) - Nerd Font icons β Symbols Nerd Font via CDN + vendored
nf.css - Font: JetBrains Mono + Symbols Nerd Font fallback
- Layout: terminal title-bar navbar, left docs sidebar, content, right
per-page TOC β the classic dual-sidebar docs layout, terminal-styled
Deploy
npx wrangler pages deploy dist --project-name=justapi