What is gatsby-theme-waves?

Gatsby Theme Waves is a tool for people who write blog posts or documentation using MDX (a format that mixes Markdown with interactive components). It adds "scrollytelling" to your content, meaning elements on the page, like code snippets, images, charts, or maps, animate and change as the reader scrolls down. Instead of presenting a static block of code or a single image, you can guide readers through a progression, highlighting specific lines or swapping visuals step by step. At a high level, you wrap your content in a special component, like CodeWave. Inside that wrapper, you alternate between code blocks and regular Markdown text. As the reader scrolls through the text, the code block above or beside it updates to reflect what's being discussed. By default, the tool highlights the lines that changed between consecutive code blocks, but you can also manually specify which lines or even which columns within a line to highlight. This is useful for anyone writing technical tutorials, data visualizations, or explanatory blog posts on a Gatsby site. For example, if you're teaching someone how a piece of code evolves, say, building a function step by step, you can show each iteration alongside the explanation, so the reader sees the code change in sync with your narrative. The live demo linked in the project gives a clear sense of the effect. The project is still experimental, as noted in the README. Setting it up requires an existing Gatsby site with MDX already configured, and installation involves adding the theme to your Gatsby config and merging some style settings. The README doesn't go into much detail beyond code blocks, but it mentions that more "waves" (likely other types of animated components beyond code) and better documentation are coming.