scrolly

Scrolly is a command-line interface tool designed to compile JSON5-based decks into self-contained, scrollable HTML presentations rendered on a 2D canvas. Unlike traditional linear slide decks, it arranges slides on an integer grid, allowing users to navigate by scrolling, zooming out to view a deck map, or zooming in to focus on individual slides. This approach enables a non-linear, interactive experience where readers can fly around the canvas and animate slides through scrolling.

The tool supports scroll-driven keyframe animation, with element properties such as position, size, opacity, scale, and angle interpolating as the user scrolls. There is no timeline or autoplay; all transitions are controlled by the reader's interaction. Scrolly produces a single HTML file in which every asset is inlined, resulting in a presentation that requires no external resources and can be opened directly, hosted anywhere, or shared by email. The CLI provides features such as full help, input schema documentation, deck introspection, and numbered error codes to facilitate authoring and debugging, making it accessible to both humans and agentic coding tools.

Installation can be performed via Python's package manager pip or with the uv tool, and presentations are built by running the CLI with a JSON5 deck file as input. The tool is MIT-licensed, allowing for flexible use and modification. Scrolly is suitable for users who want to create interactive, agent-friendly presentations that leverage a 2D canvas format rather than a linear slide progression.