FIELD MANUAL & SPECIFICATION

A Sanctuary for Unhurried Reading

Mai-Reads is engineered specifically for deep research, prolonged study, and distraction-free comprehension. Built with a local-first architecture, it turns your browser into a calm, private reading environment.

Study Notebooks: Multi-File Binders & Scratchpad

Group textbooks, research papers, syllabus PDFs, and Word documents into unified binders. Switch between files with zero friction while taking unified notes.

Multi-Document Study Workspaces

Bundle related documents together. Each notebook holds its own collection of PDFs and DOCX files safely stored in your browser's IndexedDB.

Top Tab Strip & Binder Drawer

Flip between documents with a 1-click top document tab bar or open the collapsible Binder drawer. Every document retains its individual scroll position and highlights.

Unified Scratchpad Notes

Capture cross-document insights, study questions, and summaries in a dedicated notebook notes area with auto-save and local text export.

Zero Uploads & 100% Offline

Just like single documents, notebook binders never leave your device. All files and notes are cached locally in your private IndexedDB database.

Instant Memory: Remembers Where You Left Off

When you reopen Mai-Reads after closing your laptop or shutting down your browser, your reading session is restored down to the exact millimeter.

Fractional Viewport Tracking

Rather than simply remembering a page number, Mai-Reads computes your exact scroll ratio (scrollY / totalHeight). When re-rendered at any window size, your reading view aligns precisely where your eyes last rested.

Dual-Tier Offline Storage

Document binaries are held safely in browser IndexedDB, while view states, bookmarks, and highlight arrays reside in atomic localStorage. Nothing is ever sent to an external server.

1-Click Welcome Resume

Upon launching the app, the welcome card immediately surfaces your last-opened document with page count and progress. One tap launches you straight back into your text without browsing your filesystem.

Reading History Sidebar

Press H or click the History icon to inspect recent books and papers. Each entry retains its progress percentage, last-read timestamp, and persistent annotations.

The Precision Highlighter System

Highlighting in Mai-Reads works on both digital documents and scanned PDFs without selectable text layers, with full permanent PDF export.

Highlight sample: This is an example of a highlighted passage in Mai-Reads. The color is calibrated with subtle opacity and multiply blend-modes so text remains legible and clear in both light and dark themes.

Hardware-Accelerated 60/120fps Smooth Zoom

Traditional web PDF readers lag, jitter, and drop frames when zooming because they force heavy synchronous canvas re-rasterization on every pixel of movement. Mai-Reads solves this with a modern dual-stage graphics pipeline.

Stage 1: GPU Visual Scaling

When dragging the slider or pressing + / −, scaling executes directly on your GPU via hardware-accelerated CSS transforms. Frame rates remain rock-solid at 60Hz or 120Hz ProMotion without stutter.

Stage 2: Debounced Rasterization

Once zoom interaction pauses for 250ms, a lightweight background worker rasterizes sharp, retina-grade 2x resolution canvases for visible pages, giving you crisp vector clarity without scroll interruption.

Anchor-Stabilized Viewport

During zoom adjustments, Mai-Reads locks onto the center-vertical coordinate of the viewport. This completely eliminates the disorienting "rubbery bounce" effect and prevents unexpected jumping.

Tactile Zoom Controls

Includes quick 10% step buttons (− / +), a 1-click reset to 100%, pinch-to-zoom gestures, and a fluid range slider extending up to 200%.

Paper Brightness & Sensory Calm

Modern displays output intense white light that strains the eyes during prolonged research sessions. Mai-Reads introduces independent paper attenuation.

Independent Paper Dimming (55% to 100%)

Dim the document page itself without darkening your browser interface, operating system, or secondary monitors. This provides instant relief for readers experiencing asthenopia, photophobia, or migraines.

Cognitive Design for ADHD & Dyslexia

All menus and controls fade into the background while reading, leaving only pure text on paper. Zero flashing banners, zero popups, and generous line-spacing allow uninterrupted hyper-focus.

Reading Modes & Document Formats

Customize your reading environment to suit the material at hand, from continuous papers to single-page slide decks.

Continuous vs. Single Page Mode

Toggle between smooth continuous vertical scrolling and single-page presentation snap (P). Ideal for research papers and presentation decks alike.

In-Document Full-Text Search

Press Ctrl/Cmd + F to search throughout the active document with instant jumping to match occurrences and real-time result counts.

Bookmarks & Nested TOC

Bookmark key pages with a single click and navigate multi-level PDF table of contents trees with seamless section jumping.

Native DOCX Rendering

Drop Microsoft Word .docx documents directly into Mai-Reads. The app uses mammoth.js client-side to convert Word styles into calm typographic pages.

Robust Format Handling & Edge Cases

Designed to handle real-world document variations without crashes, silent failures, or data loss.

Password-Protected Documents

Encrypted PDFs are detected automatically and present an in-memory unlock field. Passwords are used solely for ephemeral client decryption and are never persisted to storage.

Scanned PDF Detection

When a document has no text layer, in-document search and selection inform you gently. Freehand highlight drawing remains fully operational across scanned pages.

Isolated Page Recovery

If an individual page encounters rendering corruption, Mai-Reads isolates that slot with a "Try page again" retry trigger without freezing or interrupting reading across the rest of the document.

Word (.docx) Dynamic Reflow

Microsoft Word documents reflow into responsive reading typography with estimated page counters. Highlights stay preserved in your local session.

Quota-Aware Storage

If browser storage reaches system quotas, non-blocking notifications alert you while reading remains 100% functional.

Pinch Zoom Feedback

Trackpad and touchscreen pinch gestures display live visual percentage chips that fade away cleanly 600ms after release.

Keyboard Navigation Shortcuts

Keep your hands on the keyboard for an unhurried, uninterrupted reading flow.

Action Shortcut Description
Next Page / Scroll Down J or ↓ or Space Advance reading position down smoothly
Previous Page / Scroll Up K or ↑ or Shift + Space Retreat reading position up smoothly
First / Last Page Home / End Jump directly to the beginning or end of the document
Find in Document Ctrl/Cmd + F Open in-document search with keyboard pinning
Study Notebooks N Open Study Notebooks library from home screen
Toggle History H Open or close the Reading History sidebar
Zoom In / Out Ctrl + + / − Step zoom in or out in 10% increments
Reset Zoom Ctrl + 0 Reset document scale to default 100%
Toggle Draw Mode D Turn freehand draw highlighter on or off
Full Screen F Enter distraction-free immersive full screen
Presentation Mode P Toggle single-page presentation layout
Dismiss Dialogs / Panels Esc Close history sidebar, reading controls, or search dialog

100% Local-First Privacy Guarantee

Mai-Reads was built on a fundamental principle: your books, contracts, academic papers, and private notes belong exclusively to you.

Zero Server Uploads

Documents are parsed, decoded, rendered, and highlighted entirely inside your browser sandbox. No bytes are sent over the network.

Complete Offline Availability

Powered by a standalone Service Worker, Mai-Reads runs seamlessly on flights, trains, or off-grid retreats with zero internet connection.

Crafted with care by Maithil Studios

Maithil Studios is an independent design and software workshop dedicated to creating calm, humane digital tools that honor human attention and deep cognitive focus. We build software that gets out of your way and respects your privacy.