Skip to content

docs(CLAUDE.md): three CSS / dashboard-iteration lessons from PR #358#359

Merged
silversurfer562 merged 1 commit into
mainfrom
docs/claude-md-css-tooltip-lessons
May 14, 2026
Merged

docs(CLAUDE.md): three CSS / dashboard-iteration lessons from PR #358#359
silversurfer562 merged 1 commit into
mainfrom
docs/claude-md-css-tooltip-lessons

Conversation

@silversurfer562
Copy link
Copy Markdown
Member

Summary

Three new lessons from the Specs page redesign session (#358):

  1. CSS `overflow: hidden` clips `::after` tooltip pseudo-elements — when designing a CSS-only tooltip, the parent element MUST have visible overflow; clip on an inner child instead. Generalizable to any `::after` popover / badge / annotation pattern.

  2. Worktree `.venv` lacks optional extras (e.g. `[ops]`) — pair with main checkout's venv via `PYTHONPATH=$(pwd)/src /path/to/main/.venv/bin/python -m attune.ops …`. This is the inverse of the existing "worktree-editable-install points at MAIN's source" lesson.

  3. Cache-buster query string on linked CSS unblocks UI iteration when static files lack `Cache-Control` headers. Dev-only — defeats caching in prod. Lives in `base.html`'s ``.

Each lesson includes the diagnostic that would catch it next time and the specific fix shape.

Test plan

🤖 Generated with Claude Code

From the Specs page redesign session (PR #358):

- overflow:hidden on a parent clips CSS ::after tooltip
  pseudo-elements. Move the clip to an inner child with
  min-width:0 so the outer container has visible overflow
  and the tooltip can escape above the element.

- The worktree's .venv lacks optional extras like [ops] that
  the main checkout's .venv has. PYTHONPATH-overriding via
  the main venv is the cheap preview path — pairs with the
  existing 'editable install points at MAIN's source' lesson
  as the inverse direction (venv has deps, source is elsewhere).

- Cache-buster query string on linked CSS (?v=<random> in
  base.html) unblocks UI iteration when static files lack
  Cache-Control headers. Dev-only — defeats caching in prod.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 14, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
attune-ai Error Error May 14, 2026 6:59pm
website Ready Ready Preview, Comment May 14, 2026 6:59pm

@codecov
Copy link
Copy Markdown

codecov Bot commented May 14, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@silversurfer562 silversurfer562 merged commit f0ece3c into main May 14, 2026
33 of 34 checks passed
@silversurfer562 silversurfer562 deleted the docs/claude-md-css-tooltip-lessons branch May 14, 2026 19:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant