Commit Graph
16 Commits
Author SHA1 Message Date
Willie 63affe976e feat(website): promote the desktop app as the primary entry point
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.
2026-10-01 11:14:28 +08:00
Willie cbaa140289 feat(website): link llms.txt files from the footer
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.
2026-09-28 23:09:19 +08:00
Willie 2782294b01 feat(website): generate llms.txt and llms-full.txt at build time
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.
2026-09-28 22:58:33 +08:00
Willie c1596262d5 build(website): compile the docs with Rspack
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.
2026-09-27 19:28:48 +08:00
Willie cf36965cea feat(website): add zh-Hant/zh-Hans/ja/ko locales with initial docs translation
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.
2026-09-20 11:08:48 +08:00
Willie 7bc370b71b feat(website): redesign homepage as string board and add feature map
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.
2026-09-17 12:39:48 +08:00
Willie caa525b8aa feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.

## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references

## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
  Codex, Multiple Tools, Dev Containers, Playground

## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
  comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md

## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
  cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained

## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
  Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 22:27:23 +08:00
Willie 0e25056df8 refactor(docs): replace ASCII box-drawing diagrams with Mermaid SVG
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)
2026-02-19 23:56:11 +08:00
Willie ac58c5e71e docs: reorganize sidebar, add project migration, fix metadata format
- Guides: split 10 flat items into 3 sub-categories (Skills, Sharing, Advanced)
- Workflows: move Troubleshooting Workflow into Troubleshooting category
- Migration: add project mode sections (committed skills, global→project, team options)
- Configuration: add audit section, project config format, custom audit rules
- Navbar: add Guides and Targets quick links
- Fix .skillshare.yaml → .skillshare-meta.json across all docs (wrong filename/format)
- Bump font sizes site-wide for readability (base 16→17px, components proportional)
2026-02-13 14:21:36 +08:00
Willie 380907b320 feat(website): redesign with hand-drawn aesthetic and update README logo
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)
2026-02-09 11:43:27 +08:00
Willie ecabe20d0e feat(docs): add search feature 2026-02-09 10:34:00 +08:00
Willie 080e29e0ff feat: add docker sandbox test/playground workflows and docs 2026-02-07 21:55:20 +08:00
Willie 1bbfb66a87 chore: update website links to new domain 2026-02-02 21:40:55 +08:00
Willie 087ac0bbfb feat(website): add SEO essentials - sitemap, robots.txt, social card
- Enable sitemap plugin in docusaurus.config.ts
- Add robots.txt with sitemap reference
- Add social-card.png for Open Graph sharing
- Remove unused Docusaurus default files (markdown-page, placeholder images)
2026-02-01 23:16:57 +08:00
Willie 9cef926a68 docs(website): refactor docs 2026-02-01 22:52:11 +08:00
Willie 4b914b0636 docs(website): add Docusaurus docs synced from docs/
- 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
2026-02-01 21:22:41 +08:00