Brand Identity & Navigation
MolTrace brand identity is configured in astro.config.mjs and supported by assets in src/assets/ and public/.
Brand assets
Section titled “Brand assets”- The exact MolTrace navigation wordmark is copied from the frontend source into
src/assets/moltrace-wordmark.svg. - The dark-mode navigation wordmark in
src/assets/moltrace-wordmark-dark.svgpreserves the exact mark andTracecolor while switching onlyMolto white for the dark theme toggle. - The exact MolTrace mark is copied from the frontend source into
src/assets/moltrace-mark.svg. - Browser and app icons are copied from the frontend source into
public/andpublic/icons/. - Social preview metadata uses
public/icons/moltrace-wordmark.svg. - Global brand CSS lives in
src/styles/brand.css.
Navigation rules
Section titled “Navigation rules”- Authored docs belong under
src/content/docs/guides/. - Public guide routes should stay under
/guides/. - Header links should point only at stable, high-value destinations.
- Sidebar groups should expose the complete documentation map.
- New pages should be added to the sidebar when they represent a durable product, operations, or governance surface.
Authoring rules
Section titled “Authoring rules”- Include valid frontmatter with at least a
title. - Keep route labels short enough to scan in the sidebar.
- Pair frontend design changes with backend/API contract review when they expose new data or actions.
- Pair visible UI changes with visual baseline capture when they affect app surfaces.
Shipped — documentation, brand, and navigation
Section titled “Shipped — documentation, brand, and navigation”2026-05-11
Section titled “2026-05-11”- Added a dark-mode MolTrace wordmark variant so
Molswitches from dark text in light mode to white text in dark mode whileTraceremains MolTrace cyan. - Replaced temporary docs placeholder marks with byte-for-byte copies of the exact MolTrace frontend wordmark, mark, favicon, and PWA icon assets.
- Added a branded favicon, app icon, manifest, and social-preview metadata using the exact MolTrace assets.
- Added a custom header with top-level navigation for overview, modules, backend/API, visual baselines, and changelog.
- Added a branded footer with high-value operational links.
- Expanded the sidebar taxonomy with operations, brand governance, and module map destinations.
- Kept authored Starlight content under
src/content/docs/guides/so generated routes remain under/guides/.