Skip to content

feat(visuals): animated "live trace" visual for appmap.io#2366

Draft
evlawler wants to merge 1 commit into
mainfrom
claude/sleepy-davinci-g2o62y
Draft

feat(visuals): animated "live trace" visual for appmap.io#2366
evlawler wants to merge 1 commit into
mainfrom
claude/sleepy-davinci-g2o62y

Conversation

@evlawler

Copy link
Copy Markdown
Contributor

What

A new active visual for the appmap.io website: a self-running, framework-free animated AppMap trace, packaged as a custom element <appmap-live-trace>.

A request flows through the application's call graph — nodes light up as they become active, glowing particles travel the call edges, and edges stay lit with AppMap's signature pink → purple → blue brand gradient as the trace completes, then the whole thing fades and loops.

preview

Why it fits a marketing site

  • Zero dependencies, no build step. One <script> + a custom element, sized with CSS. Embeds anywhere (including via <iframe>).
  • On-brand by construction. Palette is pulled from packages/components/src/scss/_variables.scss (near-black backgrounds, brand gradient, syntax-value accent colors), so it matches the rest of the site.
  • Three scenarios via a scenario attribute: web (a GET /orders/142 request), background (a Sidekiq billing job), and navie (Navie surfacing an N+1 from a trace).
  • Polite. Honors prefers-reduced-motion (renders a static completed trace) and pauses the animation loop when scrolled out of view.

Contents

appmap-io-visuals/
  README.md                     embedding + attribute docs
  live-trace/
    appmap-live-trace.js        the custom element (Canvas 2D)
    index.html                  demo: hero treatment + all 3 scenarios
    preview-hero.png            reference image

Lives outside packages/*, so it does not participate in the Yarn workspace and does not affect the monorepo build, lint, or typecheck.

Verification

Rendered headless via the pre-installed Chromium (Playwright) and screenshotted — no console/page errors. Demo page renders the hero plus all three scenarios.

Notes / open questions

  • This was built against a deliberately broad reading of "active visuals for appmap.io" (the website repo itself isn't in this session's scope). Happy to retarget: different visual type (interactive widget, marketing illustration), a different home (e.g. appmap-examples, or Storybook stories in packages/components), or different scenarios/copy.
  • preview-hero.png (~700KB) is included as a reference; can drop it if you'd rather not carry the binary.

🤖 Generated with Claude Code

https://claude.ai/code/session_01LXq1KwfYNSPNM7a9kqNZho


Generated by Claude Code

Add a self-contained, framework-free animated AppMap trace as a custom
element <appmap-live-trace> for the marketing site. A request flows
through the application's call graph: nodes light up as they become
active, glowing particles travel the call edges, and edges stay lit with
AppMap's pink -> purple -> blue brand gradient, then fade and loop.

- No build step or dependencies; embeds via one <script> + a custom
  element, sized with CSS.
- Three scenarios: web request, background job, and Navie analysis.
- Honors prefers-reduced-motion (static render) and pauses when
  scrolled out of view.
- Brand palette sourced from packages/components scss variables.
- Lives outside packages/* so it does not affect the monorepo build.

Includes a demo index.html (hero + all scenarios) and a preview image.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LXq1KwfYNSPNM7a9kqNZho
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.

2 participants