Local preview workflow: build demo → copy to docs/static/assets/ → serve
locally. CI workflow: fetch GIF from worktrunk-assets repo during build.
README references CDN URL for GitHub display.
Add publish-assets script to push built demos to external repo. Update
.gitignore to exclude both dev output and docs preview copies. Update
quickstart.md image path to /assets/wt-demo.gif for both local and CI
builds. Expand dev/wt-demo/CLAUDE.md with complete path documentation
showing how all three workflows (local preview, CI build, README CDN)
connect through the shared asset.
Restructure CI status documentation with colored indicator table and add
progressive rendering explanation. Convert CI status symbols from bullet
list to table format for clarity, and implement HTML colorization of CI
dots in web docs via new `colorize_ci_status_for_html()` function. Add
web compatibility guide to CLAUDE.md explaining post-processing of CLI
content for docs.
Reorganize command documentation (switch, list, merge, remove, select, config, step)
for consistency and clarity. Restructure around user tasks: intro, examples, features,
then technical details. Update CLAUDE.md with documentation guidelines.
Add `test_command_pages_are_in_sync()` integration test to auto-update command pages
when `wt <cmd> --help-page` output changes, eliminating manual regeneration.
Update docs/CLAUDE.md to document the new sync test workflow instead of manual
regeneration steps.
Adds a new section on the importance of visual verification for docs changes. This ensures rendered output matches expectations and avoids common display issues related to CSS and templates.
Implement a custom "warm workbench" theme for the Worktrunk documentation,
built on the Juice Zola theme. Key features:
- Warm color palette with WCAG AA compliant contrast ratios
- Sticky header and TOC with definitional CSS variable positioning
- Smooth scroll behavior for anchor links and hero buttons
- Logo preload to prevent flash on navigation
- Scrollbar-gutter: stable to prevent layout shift
- Responsive breakpoints with variable overrides
- IntersectionObserver intercept to disable conflicting scroll-spy
The layout system uses CSS custom properties (--wt-header-height,
--wt-main-padding-top) so all dependent calculations stay in sync
automatically, preventing visual jumps when the TOC transitions to
sticky mode.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
* Refactor: Standardize user messages for improved clarity
This commit introduces a set of refinements to user-facing messages across the application. The goal is to ensure consistency in tone, terminology, and presentation, making interactions more intuitive and understandable for users.
* feat: Add a documentation site for Worktrunk
This commit adds the initial scaffolding for the Worktrunk documentation site, built with Zola and a customized Juice theme.
The site includes:
- Basic configuration (`config.toml`)
- Custom SASS styling (`custom.scss`)
- Custom SVG logos and favicons
- Overridden Zola templates (`base.html`, `index.html`, `page.html`)
- Markdown content for:
- Quick Start
- Concepts
- Configuration
- Commands Reference
- Advanced Features
- FAQ
The content is an initial auto-generated draft and requires review for accuracy and completeness before being considered production-ready. A `CLAUDE.md` file is included to highlight this and list necessary verification steps.
* feat: Add GitHub Pages deployment workflows
Build Zola docs site and deploy to worktrunk.dev on push to main.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
---------
Co-authored-by: Claude <noreply@anthropic.com>
Maximilian Roos