Speeedy

Open-source RSVP speed reading app for focus, comfort, and measurable progress.

Speeedy is a local-first reading product that helps users read faster with RSVP (Rapid Serial Visual Presentation) and ORP (Optimal Recognition Point) alignment, while also supporting accessibility, benchmarking, analytics, profile sharing, and offline use.

The best free open-source alternative to Spreeder and Outread. A private, local-first speed reader for PDFs and EPUBs — no account, no ads, no data collection. Built-in ADHD and dyslexia support.

→ speeedy.pages.dev

Support the project: If Speeedy saves you time, consider supporting development ❤️

Why Speeedy exists

Traditional reading is slowed down by constant eye movement across lines of text. Speeedy reduces that overhead by presenting words in a fixed focal area so the eyes stay still and the brain can process text faster.

It is not just a basic word flasher. It is a full reading system with:

• a custom RSVP engine with adaptive timing
• deep reading personalization
• accessibility-focused modes — Dyslexia (OpenDyslexic), Bionic Reading, Irlen overlays
• ADHD support — Pomodoro timer, focus/immersion mode, ambient noise, 20-20-20 reminders
• reading benchmarks and progress tracking
• local-first persistence with no account required
• profile sharing and installable PWA support

What is RSVP and ORP?

RSVP (Rapid Serial Visual Presentation) displays words one at a time in the same place on screen, reducing saccadic eye movement.

ORP (Optimal Recognition Point) is the letter position within a word where recognition is fastest. Speeedy aligns words to that pivot so the eye does not have to search for the word's center every time.

Key Features

Core reading engine

• RSVP playback with one-word
• ORP alignment for every displayed word
• Smart speed that adapts timing based on word complexity
• Sentence, paragraph, and contextual pause weighting
• Speed ramp to ease readers into faster sessions
• Resume from saved progress with lookback context
• Keyboard-first controls — Space, F (toggle focus mode), Arrows, R, Escape, ?

Reading customization

• 100–1600 WPM control
• Font size, font family, letter spacing, and font weight controls
• Pivot offset adjustment
• Pause view modes (focus / context / full-text)
• Punctuation handling options
• Peripheral context ghost words
• ORP guide markers
• Bionic reading mode
• Quote and aside colorization
• Seekable progress bar — click or drag to jump to any position
• Focus mode (optional, off by default) — enable in settings or press F; while playback (or the pre-roll countdown) runs, the reader hides the header, progress bar, bottom toolbar, and settings so only the word area shows. Pausing (tap the reading area or Space) brings controls back; focus mode stays enabled until you turn it off in settings or press F again

Accessibility and focus

• Dyslexia mode with OpenDyslexic-style presentation, adjusted spacing, and font weight control
• Irlen-style tinted overlays (peach, mint, parchment) with adjustable opacity
• RTL-aware reading support for Arabic, Hebrew, and other RTL scripts
• Ambient white, pink, and brown noise with crossfade loop
• Click-synchronized reading sounds with pitch control
• Countdown before playback
• Pomodoro timer with focus/break/long-break phases, progress ring, session tracking, and auto pause/resume integration

Content ingestion

• Paste text directly
• Import documents: PDF, DOCX, DOC, TXT, Markdown, RTF, HTML, CSV, ODT, EPUB
• Shared reading links for hash-based text sharing
• Local document library with resume support and deduplication

Progress, tracking, and growth

• Reading baseline benchmark with 10-question comprehension quiz
• Average WPM tracking and improvement measurement
• Session history with source title, WPM, words read, duration
• Daily word counts and 14-day activity chart
• Current streak and best streak
• Reading goals and daily progress bar
• WPM trend sparkline chart

Profile and sharing

• Local profile system with name, emoji, and avatar image
• Profile export/import as .speeedy backup files
• Shareable public reading profile links with privacy opt-in
• Share cards for stats and self-promotion

Product and platform features

• Installable PWA with offline-friendly caching
• Local-first architecture — reading data stays in IndexedDB, no account required
• Open-source codebase
• Learn page explaining RSVP, ORP, and reading science with interactive demos
• Donation/support page with crypto wallets, QR codes, and supporters wall
• In-app changelog and project support routes

Product Surfaces

Speeedy is more than a single reader screen. The app includes:

• Marketing / landing page with animated feature storytelling
• Main app intake page with file upload and text paste
• Reader screen with full settings panel
• Stats dashboard with charts and session history
• Profile page with library management and data portability
• Benchmark test for baseline WPM + comprehension measurement
• Learn / science page with educational content
• Share view for public stat cards
• Donate/support page
• Changelog page
• Privacy and terms pages

Tech Stack

Frontend

• Lit — web components (light DOM)
• TypeScript — strict mode throughout
• Vite — dev server and production bundling
• Tailwind CSS v4 — utility-first styling
• DaisyUI v5 — theme and UI component primitives
• Motion — landing-page and learn-page animations
• Lucide — icon set

Parsing and document support

• pdfjs-dist — PDF parsing
• mammoth — DOCX/DOC parsing
• JSZip — EPUB and ODT archive parsing

Browser platform and utilities

• idb — IndexedDB wrapper
• html-to-image — share card export
• qrcode — donation QR generation

Quality and developer tooling

• Biome — linting and formatting
• Vitest — unit testing
• jsdom — browser-like test environment
• Husky — Git hooks
• lint-staged — pre-commit file checks

Architecture Overview

src/
├── components/     Lit pages, UI elements, overlays, and product surfaces
├── config.ts       Project-level constants and public links
├── data/           Benchmark passages and other static content
├── models/         Shared TypeScript interfaces and types
├── services/       Engine, parsing, storage, profile, stats, theme, audio
└── utils/          Events, icons, and text helpers

Key implementation files:

• src/services/rsvp-engine.ts — custom RSVP playback, token timing, pause logic, ORP flow
• src/services/text-parser.ts — document parsing across multiple formats
• src/services/storage-service.ts — IndexedDB persistence, deduplication, import/export
• src/services/audio-service.ts — procedural click sounds and ambient noise generation
• src/components/rsvp-reader.ts — main reader experience
• src/components/settings-panel.ts — deep reader personalization
• src/components/benchmark-test.ts — baseline WPM + comprehension flow
• src/components/profile-page.ts — profile, library, and data management

Getting Started

Prerequisites: Node.js 20+ and pnpm

# Clone and install
git clone https://github.com/sami-29/speeedy.git
cd speeedy
pnpm install
Start dev server
pnpm dev
Run tests
pnpm test
Lint
pnpm lint
Build for production
pnpm build
Preview production build
pnpm preview

Scripts

• pnpm dev — start local development server
• pnpm build — type-check and build production bundle
• pnpm preview — preview the production build locally
• pnpm lint — run Biome checks on source files
• pnpm lint:fix — auto-fix Biome issues where possible
• pnpm test — run unit tests once
• pnpm test:watch — run Vitest in watch mode

Testing

Unit tests (Vitest):

• src/services/rsvp-engine.test.ts — RSVP engine behavior
• src/services/stats-service.test.ts — stats calculations
• src/services/text-parser.test.ts — text parsing behavior
• src/utils/text-utils.test.ts — shared text utility logic

• e2e/landing.spec.ts — marketing page loads and CTAs are visible
• e2e/app-page.spec.ts — text paste and begin reading flow
• e2e/reader.spec.ts — RSVP reader playback and controls
• e2e/benchmark.spec.ts — full benchmark quiz flow
• e2e/settings.spec.ts — settings persistence across reload
• e2e/keyboard.spec.ts — keyboard shortcut smoke test

PWA and Deployment

Speeedy is configured as an installable PWA with cached static assets and auto-updating service worker behavior.

• vite.config.ts — PWA plugin, chunk splitting, runtime caching
• public/manifest.webmanifest — web app manifest
• wrangler.toml — Cloudflare-oriented asset deployment config

Analytics

Speeedy uses Umami (cookieless, privacy-first) for anonymous usage analytics. The tracking script in index.html points to the official Speeedy Umami instance.

If you self-host or fork this project, remove or replace the analytics script tag in index.html:

<!-- Remove or replace this with your own Umami instance -->

To remove analytics entirely, delete that <script> tag. Speeedy functions identically without it — no features depend on Umami being present.

Versioning

This project follows Semantic Versioning:

• MAJOR (1.x.x) — breaking changes to data or public behavior
• MINOR (x.1.x) — new backwards-compatible features
• PATCH (x.x.1) — fixes and polish

Contributing

See CONTRIBUTING.md for setup instructions, code style, and PR guidelines.

License

MIT — free to use, modify, and distribute.