Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/apursley2012/sys-core/llms.txt

Use this file to discover all available pages before exploring further.

The Writing page surfaces the developer’s published technical articles in the same radio-communications language as the rest of sys-core. Each article carries a stardate, a radio band (UHF, VHF, or HF), a signal strength rating from 1 to 5, and a classification tag such as PERFORMANCE or DESIGN. The SignalBars component renders the signal strength visually next to each entry. The route is #/writing and the static entry point is pages/Writing.html.

​
Components Used

ComponentRole
SignalBarsRenders a 1–5 bar indicator for each article’s signal strength
HudFrameDecorative panel wrapper around the article list
StarfieldFull-viewport animated background
NebulaBackgroundAtmospheric depth layer
HudNavPersistent top navigation
PageTransitionEnter/exit animation wrapper

Signal Bars

Bar-graph component used to display each article’s signal strength rating.

Articles Data

Full schema reference for data/articles.js.

​
Classification System

​
Radio Band

The band field places each article on a section of the radio spectrum. This is a thematic label rather than a technical measurement — use it to group articles by reach, complexity, or intended audience.
BandMeaning (suggested convention)
UHFUltra High Frequency — deep technical dives, high information density
VHFVery High Frequency — intermediate topics, broad developer audience
HFHigh Frequency — architectural discussions, longer-range conceptual pieces

​
Signal Strength

The signalStrength field is an integer from 1 to 5. Higher values indicate articles with stronger, more confident recommendations or more thoroughly researched content. The SignalBars component illuminates one bar per point.
ValueMeaning (suggested convention)
5Definitive — battle-tested, production-proven guidance
4Strong — well-researched with caveats noted
3Moderate — exploratory, trade-offs actively discussed
1–2Experimental — early thoughts, subject to revision

​
Classification Tag

The classification string is a freeform uppercase label displayed as a badge. Current values in use: PERFORMANCE, DESIGN, ARCHITECTURE, ENGINEERING.

​
All Four Articles

#TitleDateBandSignalClassification
1Optimizing React Context for High-Frequency TelemetrySTARDATE 2025.301UHF5PERFORMANCE
2The Anatomy of a Perfect Dark ModeSTARDATE 2025.142VHF4DESIGN
3Migrating from REST to GraphQL: A Post-MortemSTARDATE 2024.089HF3ARCHITECTURE
4Building Resilient UIs with State MachinesSTARDATE 2024.012UHF5ENGINEERING

​
Article Previews

Optimizing React Context for High-Frequency Telemetry — When your dashboard receives 60 updates per second, standard React Context becomes a bottleneck. Covers how to bypass the render cycle for high-throughput data streams. The Anatomy of a Perfect Dark Mode — Dark mode is not simply inverting colours. This article walks through calibrating elevation, contrast ratios, and desaturated primary colours to reduce eye strain. Migrating from REST to GraphQL: A Post-Mortem — A detailed post-mortem of transitioning the primary data-fetching layer to GraphQL, including the caching strategies that required a complete infrastructure rethink. Building Resilient UIs with State Machines — The case for replacing boolean flag clusters with XState finite state machines to eliminate impossible UI states.

​
Article Data Shape

Each entry in data/articles.js follows this schema: 
{
  id: "a1",                          // unique identifier
  title: "Optimizing React Context for High-Frequency Telemetry",
  date: "STARDATE 2025.301",         // display date in stardate format
  band: "UHF",                       // "UHF" | "VHF" | "HF"
  signalStrength: 5,                 // integer 1–5
  classification: "PERFORMANCE",    // uppercase freeform tag
  preview: "One or two sentence teaser shown in the article list.",
  content: "Full article body — markdown or HTML string."
}

​
Adding a New Article

Open data/articles.js and push a new object into the exported array. Articles render in array order, so place newer entries at the top to show them first: 
{
  id: "a5",
  title: "Why I Stopped Writing Custom Hooks for Everything",
  date: "STARDATE 2025.400",
  band: "VHF",
  signalStrength: 4,
  classification: "ENGINEERING",
  preview: "Custom hooks are powerful, but composing too many layers of abstraction creates debugging nightmares.",
  content: "Full article content here..."
}
The content field currently holds a placeholder string ("Full transmission content would go here..."). Replace this with real Markdown or HTML content to enable full article rendering if your Writing page component supports it.

Articles Data

Full schema reference for data/articles.js.

Signal Bars

Component reference for the 1–5 signal strength indicator.

Case Studies

Long-form mission reports — a companion to the Writing section.

Home

The Home page routes visitors into Writing via HudNav.

Build docs developers (and LLMs) love

Get started for freeTalk to us