Rito

A TypeScript-first EPUB rendering library with a platform-neutral core and a Web Canvas preset.

Rito is an EPUB-focused rendering engine. It parses EPUB archives, resolves a book-oriented CSS subset, paginates chapters, builds display lists, and renders pages or spreads into Canvas through the Web preset.

The repository also includes:

• @ritojs/core — platform-neutral parser/layout/pagination/display-list primitives
• @ritojs/core/web — the default browser Canvas preset within the core package
• @ritojs/kit — a framework-agnostic controller layer with transitions and overlays
• @ritojs/react — React hooks and components on top of the core packages

Warning

Rito is still under development! We do not recommend that you use it in production environments, but of course we always welcome your PR!

Install

pnpm add @ritojs/core

Quick Start

import { createReader } from '@ritojs/core/web';

const response = await fetch('book.epub');
const canvas = document.querySelector('canvas')!;

const reader = await createReader(await response.arrayBuffer(), canvas, {
  width: 800,
  height: 600,
  margin: 40,
  spread: 'double',
});

reader.renderSpread(0);
console.log(`${reader.totalSpreads} spreads, ${reader.toc.length} TOC entries`);

reader.dispose();

Documentation

• Documentation Index
• Getting Started
• Reader API
• Stable Primitives
• Advanced Entry
• Specialized Subpaths
• Capabilities
• Limitations
• Architecture
• Release & Versioning
• Using @ritojs/kit
• Using @ritojs/react

Release Scope

Rito is optimized for EPUB book layout, not browser-equivalent web layout.

• EPUB-first rendering model
• small, stable public API on the main @ritojs/core entry
• Web-only reader helpers isolated under @ritojs/core/web
• optional higher-level integration packages for controllers and React
• deliberate CSS/layout subset focused on book pagination

See the detailed scope in Capabilities and Limitations.

Development

pnpm install
pnpm run check