Skip to content

UI design system

The publication uses an off-white light background (#F8FAFC) and charcoal dark background (#0B1220). Surfaces are white / #111827; primary text is #0F172A / #E5E7EB; muted text is #475569 / #CBD5E1; borders are #E2E8F0 / #334155. The sole accent family is teal (#0F766E light, #5EEAD4 dark). Status text supplements color. No third-party fonts or visual evidence generation are used.

System typography is 17px for desktop prose with line height 1.78. Reading width is approximately 49rem; navigation and page contents frame long articles. Spacing follows 4/8/12/16/24/32/48/64px increments. Cards use 8–12px corners and quiet borders. Only the release model adds a subtle shadow. Code uses monospace identifiers and labeled copy controls supplied by Expressive Code.

The Hero override uses a two-column desktop layout: release question and primary routes on the left, a four-stage decision model on the right. It collapses to a continuous single-column mobile page. A restrained Satyam Agnihotri byline connects to About. Below the hero, a connected runtime/release map leads to three engineer cases, separately dated positive/negative evidence, three dependency hypotheses and three reading paths. Historical status is always dated and described as recorded.

Starlight provides one H1, left sidebar and right table of contents on wider screens. A mobile menu and compact contents replace these at smaller widths. Article paragraphs remain continuous rather than individually card-wrapped. Tables and code scroll internally; identifiers wrap. Heading targets use header-aware scroll padding. Previous/next and related-reading links provide paths through the publication.

Static SVGs use dark text on a neutral light canvas in both themes. Every diagram has a descriptive title/description and nearby prose. The registry reserves each actual SVG aspect ratio. A nearby HTML description and step-by-step disclosure provide readable mobile equivalents when labels shrink. Direct full-size/download links remain usable without JavaScript; a native dialog adds optional enlargement. Diagrams are source-derived explanations, never live telemetry.

The static ProjectFooter override preserves Starlight’s default footer, then adds a maintainer block and a labeled related-project navigation landmark. It names Satyam Agnihotri (devSatym) with the owner-published headline “DevOps & Cloud Engineer,” as recorded in the pinned handbook author metadata. It links the public GitHub/LinkedIn profiles and Resilience Gate implementation source.

Related navigation links the available GCP Security Architecture Handbook and the public Azure AKS GitOps Observability source. It makes no availability claim for the planned portfolio or AKS documentation hostname. Link groups wrap on small screens, inherit theme/focus styles, and work without JavaScript. The block adds no images and is excluded from Pagefind with data-pagefind-ignore.

Author/profile/related-project data is centralized in site/config/author.json and shared by the hero/footer. About and Engineering Work are first-class routes. Current local V2 checks and earlier hosted V1 checks are different evidence.

Evidence category and observed outcome are independent fields. EvidenceCard prints both, along with window and scope. Report-level EvidenceCard outcomes remain explicitly dated and sourced. Screenshot availability is public-original, material kind is screenshot, and numerical result is not-assessed. Gallery cards do not infer success: configuration snapshots, historical dashboard windows and raw scorecard outcomes have different evidential roles. The normalized view model preserves all source metadata while adding derivative/original locations and derivative hashes.

Selected evidence leads with a question, narrow interpretation and observation window. It displays the original PNG at natural aspect ratio, while long IDs/hashes remain in a disclosure. Gallery images use reading-column width instead of a fixed190px slot.

Gallery filters use two labeled native selects and a reset button. The live count and no-match message provide feedback. With JavaScript absent filters remain hidden and all captures/original links remain useful. Image enlargement uses native dialog.showModal(), Escape, a visible close button, a direct original link and focus restoration.

Landmarks, skip link, accessible controls and theme persistence come from supported Starlight components. Project controls have visible focus outlines, text labels and keyboard behavior. Initial theme follows the system; reader selection persists. Reduced-motion preference disables project motion. Links wrap rather than causing viewport overflow. The gallery never requires hover to expose metadata.

The initial monorepo audits covered representative widths of 360, 390, 768, 1280 and 1536px, dark/light themes, navigation, dialog focus and search. They remain under migration-evidence/monorepo-audit/; repository-separation checks remain under docs/website/audit/migration/. The earlier Workers checks remain under docs/website/audit/cloudflare/; current Pages root-base/local-asset and hosted checks have separate receipts under docs/website/audit/cloudflare-pages/. Hosting changes preserve this reader interaction contract; earlier scans do not certify a new served build. Axe results are a measured sample, not a conformance certificate. Read the audit report for observed findings and exact coverage.

Six authored1200×630 PNGs are bundled for the default page and five engineering cases. Open Graph/Twitter image URLs, dimensions and alt text are route-aware. No remote image runtime is used. Local V2 tests cover320/390/768/1024/1440px, both themes,200% zoom, delayed images, print/reduced-motion and no-JavaScript reading; the audit report records actual outcomes rather than treating these design targets as passes.

Open original image

Maintained by Satyam Agnihotri · DevOps & Cloud Engineer