Add animated underlines to footer and nav links, heading anchor reveal
on hover, code block glow effect, and text selection styling. Include
subtle background grain texture and gentle bounce animation for explore
button. Improves visual feedback and interactivity across documentation.
Reorganizes content to prioritize how-to information over technical implementation details. Removes the "two generation modes" section and replaces it with a streamlined "How it works" overview. Consolidates template variable documentation, updates command examples, and clarifies when each command generates messages. Also includes `wt step squash` in the integration list.
Updated the WorktreeState::PathMismatch indicator to use a red flag (⚑) instead of white flag (⚐), better conveying the severity of a path location error. Applied red color styling to distinguish this condition from other worktree warnings (prunable, locked) which remain yellow.
Updated documentation and test snapshots to reflect the new symbol and color scheme.
Enable View Transitions API for same-origin navigation with 50ms animation duration. Add instant.page for prefetching to improve perceived performance. Respect prefers-reduced-motion by disabling transition animations for users who prefer reduced motion.
Implements a floating copy button that appears on code block hover, with special handling to strip shell prompts from terminal blocks before copying.
New files:
- code-copy.js: Attaches copy buttons to all code blocks, strips leading `$ ` from bash/shell/terminal blocks, shows checkmark feedback for 2 seconds after successful copy
Style updates:
- .code-copy-btn: Positioned absolutely in top-right, hidden by default with opacity transition, styled to match design system colors
- .content pre:hover .code-copy-btn: Reveals button on code block hover
- Button includes copied state with accent color highlight
Remove font-weight change from active TOC items and button lift effect to prevent layout shifts. Add polished micro-interactions: animated link underlines, enhanced button shadows, search focus glow, and custom scrollbar styling for better visual feedback.
Remove async GitHub buttons script and replace the dynamic button with a static shield.io badge. This eliminates external script dependency and provides a lighter-weight alternative.
Remove separate intro page and merge its content into quickstart as the
primary entry point. Reorder documentation weights so quickstart appears
first, followed by concepts. Remove "Worktree addressing" section from
concepts as it duplicates information covered elsewhere. Update homepage
to display quickstart content directly instead of intro.
Command output blocks don't require language specification and render
correctly without it. Removing `bash` from the markdown fence makes
the markup cleaner and more semantically accurate.
Code blocks now feature a distinctive left accent border with subtle shadows
and hover effects for better visual hierarchy. Terminal output styling updated
with improved line-height calculations and gutter spacing.
Typography improved by adding Inter and Plus Jakarta Sans fonts for better
readability and visual distinction between body and heading text.
Hero section enhanced with warm radial gradient background, glowing logo effect
with hover animation, and floating "explore more" button animation. Dark mode
adjustments ensure consistent visual experience across color schemes.
Add responsive logo preloading with device pixel ratio media queries to serve high-DPI variants on appropriate devices. Include preload directives for syntax highlighting stylesheets and custom CSS to reduce render-blocking. Add explicit dimensions, decoding hints, and fetchpriority attributes to logo images for better perceived performance and Core Web Vitals.
Update help text and documentation across all commands to improve clarity:
- Simplify introductory descriptions to focus on what commands do, not why
- Reorganize status symbol tables into logical groups (working tree, branch, divergence, remote, other)
- Consolidate column descriptions for better readability
- Rewrite sections to use active voice and concrete language
- Add "See Also" cross-references to related commands
- Streamline examples to be more concise with inline comments
- Improve JSON query examples with shorter descriptions
- Clarify hook behavior descriptions without assuming user intent
- Update help snapshots to reflect documentation changes
Wrap TOC selectors in `main` to override juice.scss specificity and adjust
spacing values across group labels, items, and nested items for tighter,
more consistent visual hierarchy. Increases top margin for group labels to
create clearer section breaks while reducing horizontal margins and padding
for compact layout.
Adjusts line-height, heading margins, and content padding for more compact
visual hierarchy. Reduces paragraph bottom margin and list item padding to
decrease overall vertical whitespace.
Add comprehensive guide on how to override config options via environment variables with the `WORKTRUNK_` prefix. Includes naming conventions, nested key syntax with double underscores, array value handling, and CI/testing examples. Updates both user-config reference and main configuration 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.
This change reorganizes the configuration documentation for clarity.
It now clearly separates user config (personal settings) from project config (shared hooks), provides detailed examples for each setting, and uses tables for improved readability.
Add dedicated documentation pages for each command (switch, list, merge,
remove, select, config, step) generated from CLI help text via new
--help-page flag. Pages include prose documentation from after_long_help
and command reference at bottom.
- Add --help-page flag to main.rs for generating doc pages
- Create individual command pages with Zola frontmatter
- Add sidebar grouping (Commands/Reference) via page.extra.group
- Update page.html template to render group labels
- Delete monolithic commands.md in favor of individual pages
- Tighten TOC spacing for child items
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Add dedicated documentation pages for each command (switch, list, merge,
remove, select, config, step) generated from CLI help text via new
--help-page flag. Pages include prose documentation from after_long_help
and command reference at bottom.
- Add --help-page flag to main.rs for generating doc pages
- Create individual command pages with Zola frontmatter
- Add sidebar grouping (Commands/Reference) via page.extra.group
- Update page.html template to render group labels
- Delete monolithic commands.md in favor of individual pages
- Tighten TOC spacing for child items
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
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.
This commit updates the styling of tables in the documentation to enhance their visual appeal and make them easier to read.
Changes include:
- Reduced padding for `th` and `td` elements.
- Added `vertical-align: top` to table cells.
- Standardized `th` styles for better differentiation.
- Increased `td` font size.
- Highlighted first column `td` elements as row labels.
- Replaced zebra striping with row dividers for a cleaner look.
- Removed bold styling from the first column in the "Why git worktrees?" table.
Adds a new CSS variable for a subtle bright white color, and styles
gutter spans in the terminal output to form continuous vertical lines.
The line-height in the terminal class is also adjusted to allow
proper calculation of the gutter span's vertical margin and padding.
This commit introduces a new script `dev/generate-logo.sh` along with its prompt `dev/logo-prompt.json` to create logo variants.
It updates the documentation to:
- Reference the new PNG logo files instead of the old SVG.
- Include `logo-variant-*.png` in the `.gitignore`.
- Update the favicon to use the new logo's style.
- Adjust CSS for logo display and hero image.
- Reduce top and bottom margin on H2, H3 headings.
- Reduce top and bottom margin on code blocks, blockquotes, and tables.
- Add specific CSS to reduce space between paragraphs and code blocks.
Move configuration for project hooks to a new dedicated page. This improves organization and expands on hook details and examples.
The existing Configuration page now links to the new Hooks page.
Weight values for several documentation pages are adjusted to maintain order.
- The `intro` page provides a high-level overview of Worktrunk.
- The homepage now displays the content of the `intro` page.
- Renames `quickstart` to `intro` in the navigation.
- Updates page weights to accommodate the new `intro` page.
- Updates snapshot sync for doc files.
The default Juice header includes the full navigation menu in the
header, which is already present in the sidebar. This commit
customizes the header to only include a logo and a simplified
menu with "Get Started", "Tips", and "GitHub" links.
Also removes `juice_exclude_menu` since we are manually defining
the header.
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>
Renames `wt config status` to `wt config var`, allowing the management
of various runtime variables stored in git config.
This change:
- Renames `worktrunk.status.<branch>` to `worktrunk.marker.<branch>` for consistency.
- Extends the command to support `get` operations for `default-branch`, `marker`, and `ci-status`.
- Updates all references in documentation, plugin hooks, and internal code.
This commit introduces:
- A new `ansi-to-html` dependency to convert ANSI escape codes in terminal output to HTML.
- A `terminal` shortcode for the documentation, which wraps the converted HTML output.
- Updates to `quickstart.md` and `configuration.md` to use this new shortcode.
- Corresponding changes in the `readme_sync.rs` test to generate and check the HTML output.
- Basic styling for the new `.terminal` class in `custom.scss`.
- Replaces static command documentation in `docs/content/commands.md` with auto-generated content from `wt <command> --help-md`.
- Moves advanced tips and patterns to a new `docs/content/tips-patterns.md` page.
- Updates navigation weights and `wt select` documentation to reflect these changes.
- Adds an integration test to ensure the generated documentation remains in sync with the CLI help output.
Maximilian Roos