Speed Reading WebApp

Mobile-first RSVP (Rapid Serial Visual Presentation) speed-reading web application.

Version: 1.0.0

A distraction-free, gesture-controlled speed reading app optimized for mobile devices. Features RSVP word-by-word display, customizable reading speed, haptic feedback, and local-first data storage.

Getting Started

1. Install dependencies:

npm install

2. Run the development server:

npm run dev

3. Open http://localhost:3000 in your browser.

Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run lint - Run ESLint
• npm run typecheck - Run TypeScript type checking
• npm run test - Run unit tests with Vitest
• npm run test:ui - Run tests with UI
• npm run test:e2e - Run E2E tests with Playwright

Project Structure

src/
app/ # Next.js App Router pages
components/ # React components
hooks/ # Custom React hooks
worker/ # Web Workers
lib/ # Shared utilities and constants
styles/ # Global styles
test/ # Test setup files
e2e/ # Playwright E2E tests
specs/ # Application specifications

Features

• RSVP Reading - Word-by-word rapid serial visual presentation
• Gesture Controls - Press-and-hold playback, scrubbing, and navigation
• Customizable Speed - Adjustable WPM (100-1000) with punctuation-aware timing
• Text Management - History, bookmarks, and auto-resume functionality
• Local Stats - Track reading time, words read, and average WPM
• Mobile-First - Thumb-zone controls optimized for one-handed use
• Privacy-First - All data stored locally, no tracking or analytics

Changelog

See CHANGELOG.md for version history and release notes.

Implementation Status

See IMPLEMENTATION_PLAN.md for detailed implementation status and tasks.