Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

Refactor shadows and styling to use CSS variables

Maximilian Roos15d2f7278c86
diff --git a/docs/content/select.md b/docs/content/select.md
index 718d664b4..14112508d 100644
--- a/docs/content/select.md
+++ b/docs/content/select.md
@@ -11,7 +11,7 @@ group = "Commands"
Interactive worktree picker with live preview. Navigate worktrees with keyboard shortcuts and press Enter to switch.
<figure class="demo">
-<img src="/assets/wt-select.gif" alt="wt select demo">
+<img src="/assets/wt-select.gif" alt="wt select demo" width="1600" height="800">
</figure>
## Examples
diff --git a/docs/content/worktrunk.md b/docs/content/worktrunk.md
index 0f548c208..3dcf84684 100644
--- a/docs/content/worktrunk.md
+++ b/docs/content/worktrunk.md
@@ -8,7 +8,7 @@ Worktrunk is a CLI for git worktree management, designed for parallel AI agent w
Here's a quick demo:
<figure class="demo">
-<img src="/assets/wt-demo.gif" alt="Worktrunk demo showing wt list, wt switch, and wt merge">
+<img src="/assets/wt-demo.gif" alt="Worktrunk demo showing wt list, wt switch, and wt merge" width="1600" height="900">
<figcaption>Listing worktrees, creating a worktree, working, merging back</figcaption>
</figure>
diff --git a/docs/sass/custom.scss b/docs/sass/custom.scss
index 2de854f24..da3d6f686 100644
--- a/docs/sass/custom.scss
+++ b/docs/sass/custom.scss
@@ -275,7 +275,7 @@ nav {
background: var(--wt-color-bg-elevated);
border: 1px solid var(--wt-color-border-subtle);
border-radius: 0.5rem;
- box-shadow: 0 8px 30px rgba(0, 0, 0, 0.15);
+ box-shadow: 0 8px 30px var(--wt-shadow-medium);
z-index: 1000;
}
@@ -337,7 +337,7 @@ main {
background-color: var(--wt-color-bg-elevated);
border-radius: 12px;
border: 1px solid var(--wt-color-border-subtle);
- box-shadow: 0 1px 3px rgba(0, 0, 0, 0.03);
+ box-shadow: 0 1px 3px var(--wt-shadow-soft);
// Account for sticky header when scrolling to page anchor (e.g., /#worktrunk)
scroll-margin-top: calc(var(--wt-header-height) + var(--wt-main-padding-top));
}
@@ -356,11 +356,12 @@ main {
.content img {
display: block;
max-width: 100%;
+ height: auto; // Maintain aspect ratio when width/height attrs set for CLS prevention
box-sizing: border-box;
border: 1px solid var(--wt-color-code-border);
border-left: 3px solid var(--wt-color-accent);
border-radius: 0 0.5rem 0.5rem 0;
- box-shadow: 0 2px 8px rgba(0, 0, 0, 0.04), 0 1px 2px rgba(0, 0, 0, 0.06);
+ box-shadow: 0 2px 8px var(--wt-shadow-soft), 0 1px 2px var(--wt-shadow-medium);
}
// Demo GIFs - shrink to min-width, then horizontal scroll
@@ -411,7 +412,13 @@ main {
// Code Blocks - Distinctive card style with left accent
// ============================================================================
-.content pre {
+// Override syntect's background to use our theme colors
+.z-code {
+ background-color: transparent;
+}
+
+// Shared styles for code blocks and terminal output
+%code-block-base {
position: relative;
background-color: var(--wt-color-code-bg);
border: 1px solid var(--wt-color-code-border);
@@ -420,11 +427,13 @@ main {
padding: 0.875rem 1rem;
overflow-x: auto;
margin: 1.25rem 0;
- box-shadow: 0 2px 8px rgba(0, 0, 0, 0.04), 0 1px 2px rgba(0, 0, 0, 0.06);
- transition: box-shadow 150ms, border-color 150ms;
+ box-shadow: 0 2px 8px var(--wt-shadow-soft), 0 1px 2px var(--wt-shadow-medium);
+ transition: box-shadow 50ms;
&:hover {
- box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06), 0 2px 4px rgba(0, 0, 0, 0.08);
+ box-shadow: 0 0 0 1px var(--wt-color-accent-soft),
+ 0 4px 16px var(--wt-shadow-accent),
+ 0 2px 8px var(--wt-shadow-medium);
}
code {
@@ -437,6 +446,10 @@ main {
}
}
+.content pre {
+ @extend %code-block-base;
+}
+
// Copy button for code blocks
.code-copy-btn {
position: absolute;
@@ -468,29 +481,10 @@ main {
// Terminal output styling (ANSI colors)
.terminal {
- position: relative;
- background-color: var(--wt-color-code-bg);
- border: 1px solid var(--wt-color-code-border);
- border-left: 3px solid var(--wt-color-accent);
- border-radius: 0 0.5rem 0.5rem 0;
- padding: 0.875rem 1rem;
- overflow-x: auto;
- margin: 1.25rem 0;
+ @extend %code-block-base;
font-family: var(--wt-font-mono);
font-size: 0.875rem;
line-height: 1.5;
- box-shadow: 0 2px 8px rgba(0, 0, 0, 0.04), 0 1px 2px rgba(0, 0, 0, 0.06);
- transition: box-shadow 150ms;
-
- &:hover {
- box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06), 0 2px 4px rgba(0, 0, 0, 0.08);
- }
-
- code {
- background-color: transparent;
- color: var(--wt-color-text);
- padding: 0;
- }
.prompt {
color: var(--wt-color-text-soft);
@@ -543,23 +537,39 @@ main {
// Tables - Scrollable like code blocks
// ============================================================================
-table {
- display: block;
- overflow-x: auto;
- -webkit-overflow-scrolling: touch;
- border-collapse: collapse;
- width: 100%;
+// Use border-collapse: separate + overflow: clip for border-radius to work.
+// With separate borders, we remove cell borders on table edges to avoid doubling.
+// Tables naturally expand to content width; .content handles horizontal scroll.
+.content > table {
+ display: table;
+ width: max-content;
+ min-width: 100%;
+ border-collapse: separate;
+ border-spacing: 0;
margin: 1rem 0;
border-radius: 0.5rem;
border: 1px solid var(--wt-color-border-subtle);
+ overflow: clip;
th, td {
border: 1px solid var(--wt-color-border-subtle);
+ border-top: none;
+ border-left: none;
padding: 0.6rem 0.875rem;
text-align: left;
vertical-align: top;
}
+ // Remove right border on last column (table border handles it)
+ th:last-child, td:last-child {
+ border-right: none;
+ }
+
+ // Remove bottom border on last row (table border handles it)
+ tr:last-child td {
+ border-bottom: none;
+ }
+
th {
background-color: var(--wt-color-bg-soft);
font-size: 0.8rem;
@@ -582,14 +592,6 @@ table {
font-weight: 550;
color: var(--wt-color-text);
}
-
- tbody tr {
- border-bottom: 1px solid var(--wt-color-border-subtle);
-
- &:last-child {
- border-bottom: none;
- }
- }
}
// ============================================================================
@@ -1185,7 +1187,7 @@ input:focus-visible {
// Search - subtle glow on focus
#userinput:focus {
- box-shadow: 0 0 0 3px rgba(217, 119, 6, 0.12);
+ box-shadow: 0 0 0 3px var(--wt-shadow-accent);
}
// Content links - animated underline
@@ -1214,14 +1216,14 @@ input:focus-visible {
// Button - enhanced hover
.button {
- box-shadow: 0 2px 4px rgba(217, 119, 6, 0.15);
+ box-shadow: 0 2px 4px var(--wt-shadow-accent);
&:hover {
- box-shadow: 0 4px 12px rgba(217, 119, 6, 0.25);
+ box-shadow: 0 4px 12px var(--wt-shadow-accent-strong);
}
&:active {
- box-shadow: 0 1px 2px rgba(217, 119, 6, 0.2);
+ box-shadow: 0 1px 2px var(--wt-shadow-accent);
}
}
@@ -1282,21 +1284,9 @@ header nav .nav-item {
background: var(--wt-color-bg-soft);
}
-// Code block hover glow
-.content pre {
- transition: box-shadow 50ms;
-
- &:hover {
- box-shadow: 0 0 0 1px var(--wt-color-accent-soft),
- 0 4px 16px rgba(217, 119, 6, 0.15),
- 0 2px 8px rgba(0, 0, 0, 0.06);
- }
-}
-
-
// Logo hover effect
header .logo:hover img {
- filter: drop-shadow(0 0 8px rgba(217, 119, 6, 0.3));
+ filter: drop-shadow(0 0 8px var(--wt-shadow-accent-strong));
transition: filter 200ms ease;
}
@@ -1326,3 +1316,80 @@ button.explore-more {
}
}
}
+
+// ============================================================================
+// Print Styles
+// ============================================================================
+
+@media print {
+ // Hide navigation elements
+ header,
+ footer,
+ .toc,
+ .hero,
+ .mobile-menu,
+ .mobile-menu-overlay,
+ .mobile-menu-toggle,
+ .code-copy-btn,
+ .page-nav {
+ display: none !important;
+ }
+
+ // Reset layout
+ body {
+ background: white;
+ color: black;
+ font-size: 12pt;
+ }
+
+ main {
+ display: block;
+ padding: 0;
+ }
+
+ .content {
+ max-width: 100%;
+ padding: 0;
+ border: none;
+ box-shadow: none;
+ background: transparent;
+ }
+
+ // Improve link visibility
+ .content a {
+ color: black;
+ text-decoration: underline;
+
+ &[href^="http"]::after {
+ content: " (" attr(href) ")";
+ font-size: 0.8em;
+ color: #666;
+ }
+ }
+
+ // Code blocks - keep together, remove decorative elements
+ // Use !important to override dark mode variables that might bleed through
+ .content pre,
+ .terminal {
+ border: 1px solid #ccc !important;
+ box-shadow: none !important;
+ page-break-inside: avoid;
+ background: #f5f5f5 !important;
+ }
+
+ // Tables
+ .content > table {
+ page-break-inside: avoid;
+ }
+
+ // Headings - keep with following content
+ h1, h2, h3, h4, h5, h6 {
+ page-break-after: avoid;
+ }
+
+ // Images
+ img {
+ max-width: 100%;
+ page-break-inside: avoid;
+ }
+}
diff --git a/docs/templates/_variables.html b/docs/templates/_variables.html
index e9a602d7a..d7caac838 100644
--- a/docs/templates/_variables.html
+++ b/docs/templates/_variables.html
@@ -28,6 +28,12 @@
--wt-color-code-bg: #f8f7f6;
--wt-color-code-border: #e5e3e0;
+ /* Shadows - using oklch for proper alpha blending */
+ --wt-shadow-soft: oklch(0% 0 0 / 0.03);
+ --wt-shadow-medium: oklch(0% 0 0 / 0.06);
+ --wt-shadow-accent: oklch(from var(--wt-color-accent) l c h / 0.15);
+ --wt-shadow-accent-strong: oklch(from var(--wt-color-accent) l c h / 0.25);
+
/* Terminal output colors (used by terminal shortcode) */
--cyan: #0a8080;
--green: #1b7f4b;
@@ -77,6 +83,12 @@
--wt-color-code-bg: #252321;
--wt-color-code-border: #3a3735;
+ /* Shadows - lighter in dark mode for visibility */
+ --wt-shadow-soft: oklch(0% 0 0 / 0.15);
+ --wt-shadow-medium: oklch(0% 0 0 / 0.25);
+ --wt-shadow-accent: oklch(from var(--wt-color-accent) l c h / 0.2);
+ --wt-shadow-accent-strong: oklch(from var(--wt-color-accent) l c h / 0.35);
+
/* Terminal colors - brighter for dark mode */
--cyan: #67d4d4;
--green: #4ade80;
diff --git a/src/cli.rs b/src/cli.rs
index ec2999fc5..d5eeca696 100644
--- a/src/cli.rs
+++ b/src/cli.rs
@@ -1619,7 +1619,7 @@ env = "cp {{ repo_root }}/.env.local .env"
#[command(
after_long_help = r#"Interactive worktree picker with live preview. Navigate worktrees with keyboard shortcuts and press Enter to switch.
-<!-- demo: wt-select.gif -->
+<!-- demo: wt-select.gif 1600x800 -->
## Examples
diff --git a/src/main.rs b/src/main.rs
index e3d97eb71..50d38991e 100644
--- a/src/main.rs
+++ b/src/main.rs
@@ -458,6 +458,8 @@ fn format_subcommand_section(
/// Transforms `<!-- demo: filename.gif -->` into an HTML figure with the `demo` class.
/// The HTML comment is invisible in terminal --help output, but expands to a styled figure
/// for web docs generated via --help-page.
+///
+/// Supports optional dimensions: `<!-- demo: filename.gif 1600x900 -->`
fn expand_demo_placeholders(text: &str) -> String {
const PREFIX: &str = "<!-- demo: ";
const SUFFIX: &str = " -->";
@@ -466,12 +468,24 @@ fn expand_demo_placeholders(text: &str) -> String {
while let Some(start) = result.find(PREFIX) {
let after_prefix = start + PREFIX.len();
if let Some(end_offset) = result[after_prefix..].find(SUFFIX) {
- let filename = &result[after_prefix..after_prefix + end_offset];
+ let content = &result[after_prefix..after_prefix + end_offset];
+ // Parse "filename.gif" or "filename.gif 1600x900"
+ let mut parts = content.split_whitespace();
+ let filename = parts.next().unwrap_or("");
+ let dimensions = parts.next(); // Optional "WIDTHxHEIGHT"
+
// Extract command name from filename (e.g., "wt-select.gif" -> "wt select")
let alt_text = filename.trim_end_matches(".gif").replace('-', " ");
+
+ // Build dimension attributes if provided
+ let dim_attrs = dimensions
+ .and_then(|d| d.split_once('x'))
+ .map(|(w, h)| format!(" width=\"{w}\" height=\"{h}\""))
+ .unwrap_or_default();
+
// Use figure.demo class for proper mobile styling (no shrink, horizontal scroll)
let replacement = format!(
- "<figure class=\"demo\">\n<img src=\"/assets/{filename}\" alt=\"{alt_text} demo\">\n</figure>"
+ "<figure class=\"demo\">\n<img src=\"/assets/{filename}\" alt=\"{alt_text} demo\"{dim_attrs}>\n</figure>"
);
let end = after_prefix + end_offset + SUFFIX.len();
result.replace_range(start..end, &replacement);