Make the desktop app visible in the homepage, navigation, and README before CLI installation. Add localized installation guides and promotion copy across all five documentation languages, with Homebrew as the recommended macOS path.
The files were only discoverable by agents that already know the
convention. A footer link lets readers find the URL to hand to an AI tool.
Absolute URLs are used because the files exist only at the site root and a
pathname link would be locale-prefixed on translated pages.
AI coding agents and docs tooling increasingly look for /llms.txt to get a
site overview without crawling HTML. A local plugin builds both files from
the docs plugin's loaded content in sidebar order, so they never drift from
the published docs and need no extra dependency. Only the English build
emits them, since translated locales would otherwise duplicate the content.
The docs build spent over five minutes in webpack for five locales.
@docusaurus/faster swaps in Rspack and SWC and cuts a local build from
161s to 25s, with the same pages and an identical search index.
Rspack orders one Infima rule after the search box's padding, which
pushed the navbar items right; custom.css restores the padding.
Sets up Docusaurus i18n for Traditional Chinese, Simplified Chinese,
Japanese, and Korean: locale config, navbar/footer/sidebar UI chrome,
and translated content for intro, getting-started, understand, and
reference/commands. Untranslated pages fall back to English.
Pins explicit heading anchors ({#id}) on English source pages that are
linked to by fragment, so translated headings don't change the anchor
id and break cross-page links. Converts a handful of relative .md
links that crossed from an untranslated page into a now-translated
one, since Docusaurus resolves those per-locale and they'd otherwise
404 outside English.
The homepage now shows the product's core idea directly: one source
folder strung to many AI tools. Visitors can pin and unpin tools and
watch the sync output follow, instead of reading a feature list.
A new /features page groups all 33 commands by the job they serve with
a live filter, addressing the difficulty of finding the right command
among 100+ docs pages. Command data lives in src/data/featureMap.ts so
the homepage teaser and the map stay in sync.
ASCII box-drawing characters (┌─┐│└─┘) render inconsistently on
Windows due to monospace font width differences. Replace all 30+
diagrams across docs with Mermaid flowcharts rendered as SVG.
- Add Mermaid handDrawn config (Rough.js sketchy style, seed 42)
- Add CSS fix for foreignObject overflow clipping in handDrawn mode
- Convert supported-targets grid to HTML with anchor navigation
- Simplify all node labels to short, readable single-line text
- Strip redundant %%{init}%% directives (covered by global config)
Overhaul the documentation site with a hand-drawn design system:
- Custom CSS with paper textures, wobbly borders, and sketchy shadows
- Hero section with dashed ring, sparkle decorations, and floating animation
- Card components with post-it accent colors and tape decorations
- Replace README logo with hero-style version (ring + sparkles + paper bg)
- Sync all docs content from docs/ to website/docs/
- Copy demo images from .github/assets to static/img/
- Convert image paths to Docusaurus format (/img/)
- Add complete command reference with screenshots
- Include FAQ, team edition, cross-machine guides