StPageFlip vs zinejs

Side by side

StPageFlip wins on price, size, and content flexibility. zinejs wins on reading features, so the choice follows from what the pages are.

Where StPageFlip is the better choice

StPageFlip flips real DOM, so a page can hold a form, a link, a video, or any React component. Its hard and soft page modes give a stiff cover with flexible inner pages in one book. The MIT license means no fee and no license check for commercial work, and the core is about 10 KB with no dependencies.

Popularity also counts. About 3.25 million downloads over the past year mean most layout problems already have a GitHub thread or a blog post. zinejs is too new to offer that.

The gaps in StPageFlip

Both packages were last released on 18 April 2021. An open issue from May 2024 (#54) asks the author to mark the project as abandoned, and pull requests from 2024 remain unmerged.

The missing features are the ones users ask for most. Right-to-left reading has been requested since 2020 (#13), and the RTL pull request #45 has been open since January 2024. There is no zoom (#15). The page-flip package ships no TypeScript declarations (#19, #67), so TypeScript projects rely on the community @types/page-flip.

react-pageflip adds its own issues. Pages cannot be added or removed after mount (#2), all optional props are typed as required (#32), and PDF users wire react-pdf in by hand and report pages that render without the flip animation (#54). Forks such as react-pageflip-enhanced now exist because the original no longer takes changes.

Where zinejs is the better choice

zinejs is built for documents. PdfSource renders pages on demand through pdf.js, and the toolbar adds text search, an outline from the PDF bookmarks, thumbnails, print, and download. Zoom works with pinch, wheel, and double-click, and the reader can pan while zoomed.

It also covers the requests that StPageFlip leaves open: right-to-left reading with mirrored controls, shipped TypeScript types, and keyboard navigation with page changes announced through an aria-live region. Page turns use a WebGL2 curl and fall back to CSS when WebGL2 is not available.

The trade-offs are real. zinejs cannot flip HTML or JSX pages, commercial use costs $20 per site, and there are no React or Vue component wrappers; it mounts on a DOM element, as shown in the React guide.

Switching from react-pageflip

A react-pageflip book with image pages maps to a useEffect that mounts zinejs on a ref:

import { useEffect, useRef } from 'react'
import { Zine, ImageSource } from '@zinejs/core'

export function Book({ pages }) {
  const ref = useRef(null)

  useEffect(() => {
    const book = new Zine(ref.current, { source: new ImageSource(pages) })
    return () => book.destroy()
  }, [pages])

  return <div ref={ref} style={{ height: 600 }} />
}

For a PDF, swap ImageSource for PdfSource from @zinejs/pdf and pass the file URL. The pdf.js setup that react-pdf needed is handled inside the package.

Which to pick

• HTML or JSX pages, or no budget for a license: StPageFlip or react-pageflip.
• PDFs, zoom, right-to-left, or accessibility requirements: zinejs.
• A maintained library with an MIT license and PDF support: none exists among the popular options as of October 2026.

StPageFlip remains the right default for a free flip effect on HTML pages. For a document reader, zinejs does the work that StPageFlip leaves to the developer.

Questions

Related comparisons

• turn.js alternatives
• JavaScript flipbook libraries compared

Sources

• StPageFlip repository
• react-pageflip repository
• page-flip on npm
• react-pageflip on npm
• StPageFlip issue #54: mark as abandoned
• react-pageflip-enhanced on npm
• npm download counts API