Skip to main content
Migrate both documentation sets (Lucia Canon and Eval Labs Canon) off Obsidian Publish onto a single Mintlify library, served at helloluciallc.com, with a new git repo as the source of truth. Accepted 2026-06-23 and live at helloluciallc.com the same day. Cutover (redirecting the old docs domains, retiring Obsidian Publish) and design refinement are ongoing.

​
Status

accepted — LIVE at https://helloluciallc.com (2026-06-23)
cutover in progress: old-domain redirects + Obsidian Publish retirement pending

​
Context

Lucia Canon (docs.hellolucia.ai) and Eval Labs Canon (docs.evaluationlabs.ai) are two separate Obsidian Publish sites with independent navigation, search, and publish.css design systems. The goal is a single unified “library” that splits and groups the content better and presents both brands as one coherent home. Mintlify’s Products feature (a product switcher over two distinct doc trees, one project, one custom domain) matches this directly. The trade-off is that Mintlify is not additive to Obsidian Publish — it replaces it: git/MDX authoring instead of the Obsidian app, no wikilinks/graph, and theming instead of hand-built publish.css. The founder accepted leaving the Obsidian authoring workflow.

​
Decision

  • Build a unified Mintlify library with two products (Lucia, Eval Labs) and a product switcher, plus a custom branded landing page.
  • New repo hello-lucia/lucia-library becomes the source of truth for published docs. The two Obsidian vaults move to legacy/archive authoring.
  • Primary domain helloluciallc.com; docs.hellolucia.ai and docs.evaluationlabs.ai redirect into it after cutover.
  • Lucia’s 99 Archives migrate to a hidden/unlisted Legacy section (reachable by URL, not in main nav).
  • Conversion is scripted and repeatable (scripts/convert.mjs + scripts/build-docs.mjs).

​
Consequences

Easier / better
  • One library, unified navigation, search, and design across both brands.
  • Deploys on git push — the manual “click Publish in Obsidian” step goes away.
  • A neutral parent domain (the LLC) hosts both brands without one dominating.
Harder / changed
  • Obsidian authoring (app, wikilinks, graph, callout/cssclass styling) is retired; editing becomes git/MDX.
  • The two publish.css design systems are rebuilt in Mintlify theming + MDX components, not ported. Raw-HTML pages (heroes, color swatches, the Eval Labs access matrix) need dedicated components before they ship.
  • Canon doctrine shifts: the published docs source of truth is the new repo, not these vaults. This document and Current System State must reflect that.
Truth-state note: This is documentation infrastructure only. It does not change product/runtime live status, and the library must not be described as live until it is actually deployed on helloluciallc.com.

​
Validation

  • Phase 1 conversion complete and pushed to hello-lucia/lucia-library:
    • 782 wikilinks resolved, 0 unresolved; 34 image embeds migrated.
    • 159 pages wired into docs.json (Lucia 93 / Eval Labs 66); 16 legacy unlisted; 12 raw-HTML pages held back for component work.
    • MDX pre-flight clean (no bare <, braces, or autolinks in included pages).
  • Pending: Mintlify cloud build + preview, full nav (after the 12 components), domain + DNS cutover, redirects.