feat: initial release — Ranger Reader v1.1.0

Single-file HTML RSVP reader for academic papers and long-form text.
Released free / GPL v2+ as a replacement for subscription-based RSVP
readers (SwiftRead, etc.) that cost ~$120/year for the same core
functionality.

v1.1.0 ships with three reading modes:
- Word: classic RSVP with ORP focal-character coloring
- Sentence: chunked reading, auto-advancing on word-count timing
- Paragraph: skim mode

Other features: WPM slider 200-1500, drag-drop .txt loading,
localStorage persistence (text + WPM + mode + position), keyboard
shortcuts, dark-mode WP-tone palette, sentence splitter that
handles common academic abbreviations (Mr./Dr./e.g./i.e./et al./
Vol./Fig./decimals).

Single self-contained HTML file. No install, no dependencies,
no network calls. Runs in any modern browser, fully offline.

README.md

@@ -0,0 +1,83 @@
+# ◈ Ranger Reader
+
+A lightweight RSVP reader for academic papers and long-form text — single HTML file, no install, no subscription, no cloud, runs offline in any browser.
+
+Built to handle the volume of reading required by a research thesis without paying the $120/year for SwiftRead or similar tools. Released here so others can do the same.
+
+## What it does
+
+Three reading modes for the same text:
+
+| Mode | What it does | Best for |
+|---|---|---|
+| **Word** (key `1`) | Classic RSVP — one word at a time at a chosen WPM, with ORP (Optimal Recognition Point) focal-character colouring | Fast skim, the "I'm reading at 4× normal speed" experience |
+| **Sentence** (key `2`) | One full sentence at a time, auto-advancing based on word count | Comprehension-grade reading of methods and results sections |
+| **Paragraph** (key `3`) | One paragraph at a time, longer display | Preview / postview stages, skim for quotes |
+
+## How to use
+
+1. **Open `ranger-reader.html`** in any modern browser (double-click works)
+2. **Paste text** into the textarea at the bottom, or **drag any `.txt` file** onto the page
+3. **Press the spacebar** or click **▶ Play**
+4. **Tap `1` / `2` / `3`** to switch between Word / Sentence / Paragraph modes
+5. **Slide WPM** up or down to taste (default 500, range 200–1500)
+
+Text, WPM, mode, and reading position all auto-save in your browser — close the tab, reopen tomorrow, resume where you stopped.
+
+## Keyboard shortcuts
+
+| Key | Action |
+|---|---|
+| `Space` | Play / pause |
+| `←` / `→` | Skip back / forward (10 in Word mode, 1 in chunk modes) |
+| `1` / `2` / `3` | Switch to Word / Sentence / Paragraph mode |
+| `+` / `−` | Adjust WPM by 50 |
+| `R` | Reset to start |
+
+## Converting PDF papers
+
+The reader takes plain text. To convert academic PDFs:
+
+```bash
+# macOS / Linux — install poppler-utils first (e.g. brew install poppler)
+pdftotext input.pdf output.txt
+```
+
+Then drag the `.txt` file onto the reader page.
+
+## What it doesn't do (yet)
+
+- A built-in file library — paste or drag, one paper at a time
+- Per-paper bookmarks — single position memory
+- Background sound / brown noise — planned for v1.2
+- Browser extension packaging — planned for v2.0
+- Multi-language ORP heuristics — currently tuned for English
+
+## Why RSVP works
+
+RSVP (Rapid Serial Visual Presentation) shows words sequentially at a fixed location, eliminating the eye saccades that normal reading requires. For many readers — particularly dyslexic readers — this:
+
+- Reduces visual-tracking effort
+- Eliminates letter-reversal confusion (words don't sit next to each other)
+- Enforces consistent pacing (no getting lost in a paragraph)
+- Allows comfortable reading at speeds well above normal saccading limits
+
+Brain comprehension is the real ceiling, not eye movement. RSVP lets you read closer to that ceiling.
+
+## Caveats
+
+For academic citation work, use Sentence or Word mode in combination with the source PDF — RSVP is excellent for prose but cannot render tables, figures, or equations. The published recommended workflow:
+
+1. First pass via Sprint / RSVP at high WPM to get the paper's shape
+2. Second pass in the source PDF for the Methods, Results, tables and figures
+3. Capture exact quotes with page numbers from the PDF, not the RSVP stream
+
+The abstract is an advert — don't cite it. Read the Introduction, Methods, Results, and Discussion. The meat is in the middle.
+
+## License
+
+GPL v2 or later. See [LICENSE](./LICENSE).
+
+## Acknowledgements
+
+Built as a study tool during an MSc thesis on accessibility-focused authentication research. Released as free software because reading subscriptions are a tax on poor researchers and accessibility tools should not be paywalled.