Skip to content

DOC: Add scroll-triggered Roakey peeks to the landing page#2099

Merged
romanlutz merged 2 commits into
microsoft:mainfrom
romanlutz:romanlutz-landing-raccoon-peek
Jun 29, 2026
Merged

DOC: Add scroll-triggered Roakey peeks to the landing page#2099
romanlutz merged 2 commits into
microsoft:mainfrom
romanlutz:romanlutz-landing-raccoon-peek

Conversation

@romanlutz

@romanlutz romanlutz commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds two decorative Roakey (the PyRIT raccoon mascot) "peeks" to the documentation landing page that slide in at predefined scroll positions:

  • 🦝 A sideways-peeking Roakey slides in flush from the left edge partway through Key Capabilities.
  • 🦝 Roakey's tail slides in from the right edge partway through Getting Started, stopping just before the wooden board so only the tail itself shows.

How it works

  • CSS-only, driven by scroll-based animation-timeline: view() in doc/css/custom.css, triggered by two {image} directives in doc/index.md.
  • The images are position: absolute (out of flow), so they never shift page content.
  • overflow-x: clip on html, body ensures the off-screen start states never add a horizontal scrollbar.
  • Both peeks only reveal on viewports ≥ 1536px wide, where the gutters beside the centered content column have room for them; on narrower screens they stay hidden off-screen so they never cover content.
  • prefers-reduced-motion and browsers without scroll-timeline support leave them hidden.

Files

  • doc/index.md — two {image} directives at the predefined spots.
  • doc/css/custom.css.roakey-peek styling + scroll-driven reveal animation.
  • doc/roakey_peek.png, doc/roakey_tail.png — transparent mascot art.
roakey-peeks.webm

Add two decorative mascot images to the documentation landing page that
slide in at predefined scroll positions:

- A sideways-peeking Roakey slides in flush from the left edge partway
  through Key Capabilities.
- Roakey's tail slides in from the right edge partway through Getting
  Started, stopping just before the wooden board so only the tail shows.

Both are CSS-only, driven by scroll-based `animation-timeline: view()`,
positioned absolutely so they never shift page content, and clipped with
`overflow-x: clip` so they never add horizontal scroll. They only reveal
on viewports >= 1536px wide, where the gutters beside the centered content
column have room for them; on narrower screens they stay hidden off-screen.
Reduced-motion and browsers without scroll-timeline support leave them
hidden.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

@jsong468 jsong468 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

so cute! :D Do you have a screen recording to see what this looks like?

@jsong468 jsong468 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This might be the tiniest NIT ever but if Roakey is perched vertically on the board, should the tail come down and then to the left (convex instead of concave) 😆 Feel free to ignore

@romanlutz

Copy link
Copy Markdown
Contributor Author

I love everything about this comment 🤣 that said, there's never just one raccoon. This may be a different one!

@romanlutz romanlutz added this pull request to the merge queue Jun 29, 2026
Merged via the queue into microsoft:main with commit ac61b79 Jun 29, 2026
53 checks passed
@romanlutz romanlutz deleted the romanlutz-landing-raccoon-peek branch June 29, 2026 23:25
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.

3 participants