Skip to Content
drksci

Documentation

What the System section covers: how the site is built, and where each part is described.

The System section describes how the site is made. The overview is written by hand. The reference pages are generated from the source they describe, so they cannot disagree with it, and the audit fails when one is out of date.

  • Architecture: How the site fits together, from a piece's folder to a rendered page, the layers around it, and the rules that keep each part described once.
  • Layouts: Every layout in the kit, picked by a section from what it contains.
  • Player: The one frame for every figure that plays or responds, shown on three trivial stages at each size.
  • Catalog: Every unit of the system, from block to script, with when to use it, its inputs, its sizes, how its text is shortened and an example.
  • Tokens: Design tokens in three tiers, rendered from the token source.
  • Themes: The default and drksci themes side by side, in light and dark, drawn from their token files.
  • Writing guide: How language is written for each element of a piece, from title to alt text, with limits, voice and one example of each.
  • MCP tools: Tools the site serves to agents over MCP at /mcp, with the input each takes and when to call it.
  • Audit: Housekeeping rules, structure and naming conventions, and budgets that keep the repository small, with what each one reports.
  • Discovery: What each page type tells search engines, language models and social platforms, and the one inventory every surface reads.