Commit Graph

1003 Commits

Author SHA1 Message Date
Maximilian Roos 54d0ccd616 Remove Juice theme dependency, build standalone custom theme
Custom "warm workbench" theme now self-contained without Juice inheritance. Eliminates theme extension complexity and provides complete control over documentation site design.

Key changes:
- Removed docs/themes/juice submodule and all Juice template inheritance
- Rewrote base.html as standalone template with full HTML structure
- Migrated all Juice CSS variables and utilities into custom.scss
- Updated config.toml to remove theme reference and rename juice_* config keys
- Consolidated template structure: page.html and index.html now extend base.html directly
- Removed lychee exclusion for Juice theme README (no longer applicable)
- Moved normalize.css from theme to docs/static for direct control

The theme is now fully self-hosted with no external dependencies, making it easier to maintain and extend.
2025-12-05 19:08:20 -08:00
Maximilian Roos 22a734bc00 Increase demo font size and height for better readability
FontSize 19→24, Height 720→900

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-05 19:05:54 -08:00
Maximilian Roos a5471d3ed7 Remove heading anchor reveal on hover
The anchor symbol animation for h2 and h3 elements is no longer needed and adds unnecessary complexity to the stylesheet.
2025-12-05 15:10:12 -08:00
Maximilian Roos 85684ef892 Add display: block to .content for proper text selection
Overrides Juice's display: flex which causes text selection to
break across blocks.
2025-12-05 15:03:29 -08:00
Maximilian Roos cc3f201792 Clarify config documentation for command flags
Rename "Command defaults" section to "Command settings" and rephrase
descriptions to better explain that these are persistent flag values.
Update code examples to clarify default behavior and simplify comments
for better readability.
2025-12-05 15:01:58 -08:00
Maximilian Roos 67892cd4c2 Consolidate h1 padding to shorthand property
h1 and .heading-text elements previously used padding-left: 0
while other padding directions remained unset. Changed to use the
padding shorthand with value 0 to explicitly define all padding
sides and improve consistency with the spacing refactor.
2025-12-05 14:11:22 -08:00
Maximilian Roos 206ee6eafc Add minimal top margin to demo figures for visual separation
.content figure.demo now includes a small top margin to create breathing room between introductory text and demo GIFs.
2025-12-05 13:51:13 -08:00
Maximilian Roos 2aed7bf406 Rephrase demo section heading for consistency
Change "## Quick demo" to "Here's a quick demo:" in docs
to match the phrasing used in README and improve flow.
2025-12-05 13:26:53 -08:00
Maximilian Roos 30924046f8 Improve messaging about Worktrunk benefits and features
Add clarifying language about Worktrunk's value proposition in the
introductory quote, and include a teaser line indicating additional
capabilities beyond the three main workflow automation features listed.
2025-12-05 12:32:41 -08:00
Maximilian Roos 31b2eb2473 Document post-start hook for large asset downloads
Update example config and hooks documentation to clarify that
post-start hooks support downloading large assets (images, ML models,
binaries) that are too large for git. Add concrete example of asset
fetching script in post-start configuration.
2025-12-05 08:31:46 -08:00
Maximilian Roos 8d5a3b3db4 Render markdown tables in help text with proper alignment
Add table parsing and rendering to md_help.rs with column width
calculation using Unicode display width. Tables now render with visual
separators and proper alignment instead of raw pipe syntax.

Update CI indicator documentation to use "(blank)" instead of "blank"
for consistency with other formatted table cells.

Colorize CI status bullets in table format (e.g., `●` green becomes
colored ● with semantic color). Strip ANSI codes when measuring column
widths to handle styled content correctly.
2025-12-05 03:29:47 -08:00
Maximilian Roos 1160f313e5 Refactor status symbols table with improved category names
Reorganize the status symbols documentation to use clearer category
names that better describe their purpose: "Main divergence" instead of
"Divergence", "Remote divergence" instead of "Remote", and "Worktree state"
instead of "Other". Add new indicators for main branch (`^`) and remote
sync status (`|`), plus path mismatch detection (`⚑`). Update JSON output
examples and status field references accordingly.
2025-12-05 03:20:34 -08:00
Maximilian Roos 3f1adc9ea4 Wrap demo GIFs in styled figures for mobile responsiveness
Demo images now use `<figure class="demo">` instead of plain markdown to enable horizontal scrolling on small screens while maintaining readability.

Updates both manual demo markup in select.md and why-worktrunk.md, plus the code generation for demo placeholders in expand_demo_placeholders().

Adds .content figure.demo styling with min-width: 800px to shrink until readable, then scroll. Also reduces code block hover transition from 100ms to 50ms for snappier feedback.
2025-12-05 03:01:29 -08:00
Maximilian Roos adf7e0fe54 docs: document CI indicators as clickable PR links
Update documentation to clarify that CI indicators are clickable links
to the PR page. Remove qualifier about "supported terminals" since this
is now universal behavior.
2025-12-05 02:49:45 -08:00
Maximilian Roos 31a78c0843 Reorganize why-worktrunk content with clearer section hierarchy
Add subheadings to distinguish core commands from workflow automation
features, and restructure sections for better readability. This makes
it easier for users to understand Worktrunk's primary capabilities
versus advanced features at a glance.
2025-12-05 02:47:52 -08:00
Maximilian Roos 1a47bbe152 Document CI indicators as clickable PR links and remove redundant flag mention
CI indicators in the list output are now clickable links to PR pages in supported terminals. This replaces the previous mention of the `--full` flag adding CI status, which is now integrated into the standard list output.
2025-12-05 02:44:12 -08:00
Maximilian Roos e0d41f1b85 Simplify select demo image markup to use markdown syntax
Replace HTML figure element with markdown image syntax for consistency
with documentation style and easier maintenance.
2025-12-05 02:22:08 -08:00
Maximilian Roos aa1a6a2e6c Enhance image styling with accent border and improve figure semantics
Add visual distinction to images with left accent border and refined
shadow. Convert demo images to semantic figure elements with captions.
Simplify figure styling to inherit image rules consistently across all
content.
2025-12-05 02:19:45 -08:00
Maximilian Roos 8bf15b0ce6 Display keystrokes in wt select demo for better visibility
The demo recording now shows keyboard input as it's being typed,
making it easier for viewers to follow the navigation and interactions
within the wt select interface.
2025-12-05 01:59:40 -08:00
Maximilian Roos ea6563c763 Add social card image and enable OpenGraph/Twitter sharing
Add social-card.png (1200x630) to support OpenGraph and Twitter Card
previews. Uncomment and activate the og:image, og:image:width,
og:image:height, and twitter:image meta tags. Change Twitter Card type
from "summary" to "summary_large_image" to display the social card.
2025-12-05 01:58:43 -08:00
Maximilian Roos c2185e9edf docs: replace demo image with semantic figure element
Use HTML5 `<figure>` and `<figcaption>` instead of markdown image syntax
for better semantic markup and accessibility. Add descriptive alt text and
caption explaining the demo workflow (create, work, merge).

Also add corresponding SCSS styles for figure and figcaption elements with
centered alignment and muted text color for captions.
2025-12-05 01:57:46 -08:00
Maximilian Roos bd610f219d Move demos to docs/demos/ and fix gitignore for generated output
- Move demo scripts to docs/demos/ (wt/, wt-select/, lib.py)
- Add docs/demos/wt/out/ and docs/demos/wt-select/out/ to gitignore
- Update all path references
- Theme changes: "GitHub Light Custom" → "Warm Gold Light" for improved visuals

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-05 01:50:57 -08:00
Maximilian Roos 5d35e156ea Scale images to fit container without upscaling
Changed max-width from none to 100% so images scale down to fit
their container while maintaining aspect ratio. Added box-sizing
to ensure borders are included in width calculations for more
predictable layout behavior.
2025-12-05 01:47:44 -08:00
Maximilian Roos 0588c56eb0 Use dynamic port selection for dev server to avoid conflicts
Replace hardcoded port 0 with random port range to better handle
multiple concurrent development sessions and reduce port binding issues.
2025-12-05 01:42:37 -08:00
Maximilian Roos 82f7937bdf Improve table alignment in wt list example output
The table formatting in the documentation example now uses consistent spacing
across columns to make the output more readable and visually aligned.
2025-12-05 01:25:11 -08:00
Maximilian Roos e11df33077 Simplify README and docs wording for clarity
Remove redundant explanations and tighten language throughout both
README and why-worktrunk documentation. Consolidates repetitive points
about worktree features and removes unnecessary implementation details.
2025-12-05 01:22:14 -08:00
Maximilian Roos e7cfc81498 Add 404 error page template for missing worktrees
Provides custom error page when a worktree has been pruned or doesn't exist, with styled error messaging and navigation links back to docs and GitHub.
2025-12-05 00:50:03 -08:00
Maximilian Roos aca05577ee docs: wrap command text in cmd span for styling
Update terminal output examples to wrap command text in `<span class="cmd">` tags, enabling distinct styling for user input versus output. Adjust snapshot test to apply this formatting automatically when syncing docs with test outputs.
2025-12-05 00:22:41 -08:00
Maximilian Roos 1c320dc9fa docs: improve table formatting and clarify hook lifecycle
Align table columns with consistent spacing for readability. Refine hook descriptions to specify pre-merge and post-merge events, and clarify merge workflow steps.
2025-12-05 00:17:35 -08:00
Maximilian Roos 46e539890c Clarify branch cleanup conditions and rename has_marginal_contribution
Replace "Branch is ancestor" with "No added changes" to better describe the three-dot diff check. Rename has_marginal_contribution to has_added_changes for clarity about what the method actually checks. Update documentation and integration reason enum to reflect the actual behavior: detecting file changes beyond the merge-base rather than testing ancestry.
2025-12-05 00:14:19 -08:00
Maximilian Roos d078f796c9 docs: refine why-worktrunk messaging for clarity
Changes wording in the "What Worktrunk adds" section to better emphasize
the dual value proposition: branch-based navigation & status combined with
workflow automation. Replaces "Branch names replace paths" with more direct
phrasing and restructures the automation intro for improved flow.
2025-12-05 00:10:13 -08:00
Maximilian Roos b203be8de1 docs: clarify configuration, hooks, branch cleanup, and LLM usage
Configuration section now distinguishes between command behavior and defaults, with clearer explanations of what each setting controls. Hooks documentation expanded to explain the three branch cleanup conditions checked before safe deletion, with examples using `{{ repo_root }}` variable.

LLM commits section clarified to show squash-merge workflow as the primary use case. Claude Code statusline explanation expanded on network latency and async suitability. Branch state symbol `_` redefined as "no commits ahead" rather than "empty branch" to better reflect actual behavior.

Updated `wt remove` documentation to cross-reference FAQ instead of switch.md, and simplified tips section by linking to switch.md shortcuts instead of duplicating the list.
2025-12-04 23:13:15 -08:00
Maximilian Roos 33647913b1 feat: make images horizontally scrollable and improve remove docs
- Add horizontal scrolling and consistent styling to images in documentation
- Update remove command help text to clarify argument resolution and shortcuts
2025-12-04 23:04:30 -08:00
Maximilian Roos df3383db42 Make tables horizontally scrollable on small screens
Remove overflow-x: hidden from html to allow table scrolling. Add display: block and overflow-x: auto to tables with touch-friendly scrolling. Add white-space: nowrap to cells to keep content on single lines during horizontal scroll.
2025-12-04 22:34:19 -08:00
Maximilian Roos 81f46093d1 docs: consolidate configuration into config command help
Move all configuration documentation from the separate configuration.md
file into the wt config command's help text. This ensures configuration
guidance is always accessible via `wt config --help` and eliminates
duplication between documentation and help output.

Includes detailed sections on user config (worktree paths, command
defaults, LLM settings, approvals), project config (lifecycle hooks),
shell integration, and environment variable overrides.
2025-12-04 22:22:13 -08:00
Maximilian Roos c3eaebde25 Replace branch-without-worktree symbol from ⎇ to /
Updates documentation, code comments, and test snapshots to reflect
the simpler slash symbol for branches without worktrees. This improves
readability while maintaining the same semantic meaning across all
components: CLI help text, completion hints, model documentation, and
integration test outputs.
2025-12-04 22:18:18 -08:00
Maximilian Roos 722fc29516 docs: update dev server command to use dynamic port selection
The zola serve command now uses `-p 0` to automatically pick an available
port instead of hardcoding 1111. Updated documentation to reflect that the
port is dynamic and should be checked when the server starts.
2025-12-04 22:11:53 -08:00
Maximilian Roos c7856ee38b docs: clarify hooks, Claude Code, configuration, and merge operations
Improve documentation accuracy and consistency across multiple areas:

- Claude Code: Expand intro to explain automatic status tracking for parallel agents
- Hooks: Clarify post-create (blocking) vs post-start (background) execution
- Configuration: Add shell integration section, command approvals details, and LLM template options
- Merge: Reorganize pipeline steps with clearer numbering and descriptions
- Switch: Move path-first lookup explanation to FAQ, simplify shortcuts table
- Select: Clarify preview tabs show diffs, not just change indicators
- FAQ: Add section on branch name resolution, improve agent comparison explanation
- General: Consistent capitalization, improved example formatting
2025-12-04 21:59:53 -08:00
Maximilian Roos ad63696bd6 Clarify merge pipeline and simplify --no-commit behavior
Update documentation to reflect actual merge flow: squash (not commit)
as first step, merge (not push) to target, and removal of the
--no-remove requirement for --no-commit. Remove redundant validation
logic and add example for merging to different branches.
2025-12-04 21:55:27 -08:00
Maximilian Roos fc033d44fb Clarify squash command description and behavior
Squash commits down to target instead of mentioning LLM. Add extended
documentation explaining that it combines all commits since diverging
from the target branch, stages working tree changes, generates commit
message via LLM, and runs pre-commit hooks unless skipped.
2025-12-04 20:10:16 -08:00
Maximilian Roos d58b944247 Prevent horizontal scroll on mobile touch devices
Add overflow-x: hidden to html element to eliminate unwanted page-level
horizontal scrolling on mobile. Internal content with overflow-x: auto
can still scroll horizontally as intended. This complements the existing
scrollbar-gutter: stable rule for layout stability.
2025-12-04 19:56:38 -08:00
Maximilian Roos 85262dd335 Remove table row hover background effect
The hover styling was creating visual noise without providing meaningful interaction feedback for table rows that already have clear row dividers.
2025-12-04 19:43:23 -08:00
Maximilian Roos 41de27a152 Clarify example config reference as Worktrunk's own
The link text now specifies that the `.config/wt.toml` example belongs to Worktrunk itself, making the reference more explicit and contextual.
2025-12-04 19:42:05 -08:00
Maximilian Roos 05c86bd270 Fix formatting of status markers and statusline example
Remove backticks from inline emoji markers and wrap statusline
output in code tags for proper syntax highlighting.
2025-12-04 19:36:09 -08:00
Maximilian Roos f0333ce297 Simplify git worktrees explanation for clarity
Consolidate description of worktree file and index sharing into single phrase, removing redundant details about creation speed and deletion behavior.
2025-12-04 19:34:10 -08:00
Maximilian Roos 5948aa1a1e Simplify problem framing by removing comparison table
README and docs now explain git worktrees directly rather than through
a comparison of approaches. This makes the section more concise and
focused on what worktrees are, with the path management limitation
introduced afterward as the motivation for Worktrunk.
2025-12-04 19:13:13 -08:00
Maximilian Roos afb9162d8b Add overflow-x auto to content for horizontal table scrolling
Allows wide content like tables to scroll horizontally without causing
page-level overflow, improving readability on smaller viewports.
2025-12-04 18:18:15 -08:00
Maximilian Roos 8d830ebdde Move iOS jank documentation to code comments
Details now live in base.html next to the JS fix.
CLAUDE.md just references it. Fixed outdated comments
that incorrectly claimed lvh was stable on Firefox iOS.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-04 18:17:32 -08:00
Maximilian Roos 278a2f854e Document iOS viewport jank issue and current workaround
Adds a detailed section explaining:
- The root cause (missing WebKit APIs in Firefox/Chrome iOS)
- Our current JS workaround
- What we tried that didn't work
- Our preference for a simpler solution

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-04 18:09:13 -08:00
Maximilian Roos 2da14c166e Revert "Remove iOS viewport polyfill and use 100lvh directly"
This reverts commit 831d587964.
2025-12-04 18:01:44 -08:00