OpenPageFlip
Maintained successors to StPageFlip and react-pageflip: the same page-turn effect, rebuilt for 2026 browsers, strict TypeScript and React 19.
Docs, live demos, the API reference and changelogs: openpageflip.shittylittleapps.com (built from apps/docs).
Both packages are pre-1.0 and under active construction. SPEC.md has the plan, the decisions behind it, and what is still open.
Features
The page turn itself is StPageFlip's, right down to the fold geometry, and the test suite holds ours to the original pixel for pixel. Most of what's new comes straight out of the issues people filed on the original repos over the years.
| StPageFlip / react-pageflip | OpenPageFlip |
|---|
| Soft pages that curl, hard pages that swing stiff | ✓ | ✓ |
| Turn by drag, click or swipe | ✓ | ✓ |
| Shadows that move with the fold | ✓ | ✓ |
| Spread that drops to one page when narrow | ✓ | ✓ |
| Fixed size, or stretch to the container | ✓ | ✓ |
| Covers that stand alone | ✓ | ✓ |
| Pages are plain HTML | ✓ | ✓ |
| Swap pages in place | ✓ | ✓ |
| React component | ✓ | ✓ React 19 |
| Canvas mode for image books | ✓ | - (an <img> on each page) |
| Hover cue | Corner lifts | Whole edge furls, leaning toward the pointer |
| Click and drag only from the edge, so text selects and links click | - | ✓ |
| Right-to-left, top and bottom bindings | - | ✓ |
One page at a time at any width (layout: "single") | - | ✓ |
flipProgress event on every frame | - | ✓ |
| Flip methods return a promise that resolves on landing | - | ✓ |
| React props and children change without a remount | - | ✓ |
| Safe to server-render | - | ✓ |
| Page around the book still scrolls on touch |
A handful of things behave differently from the original on purpose. SPEC.md lists them with the reasons, and the migration guide on the docs site maps every old option and method to its new name.
Working on it
Requires Bun 1.4+ and Task. task --list shows every command; task install then task check runs what CI runs. CONTRIBUTING.md has the rest.
License
MIT. The page-fold geometry derives from Oleg Litovski's StPageFlip, also MIT.
