← Return to Creation Hub
--:--:-- --

ReadMe Library Portfolio

Architectural Specification & Technical Documentation for the Interactive Digital EPUB Catalog & Speech-Engine Reader.

EPUB Parse Specs Web Speech API Kid-Friendly Safe Filter IndexedDB Persistence Real-Time Search
⚙️ Core Engine Specs
  • Non-Blocking EPUB Unpacker: Custom async zip parser capable of client-side extraction without external server processing.
  • Real-Time Filter Pipeline: Instant title, author, category, and reading level filtering using indexed fuzzy search.
  • DOM Sanitization Engine: Built-in XHTML filter ensuring child safety and safe rendered ebook content.
🎙️ Speech Synthesizer
  • Web Speech API Integration: High-definition text-to-speech reading capability with adjustable pitch and velocity controls.
  • Sentence Sync Highlight: Real-time word tracking highlighting rendered paragraph DOM elements dynamically.
  • Auto-Bookmark State: Automatically syncs active line progress into browser local storage memory.
📜 Technical Architecture & Reader Engine Code

The code below demonstrates how the catalog initializes real-time text-to-speech sentence tracking alongside kid-friendly reading filters:

// ReadMe Library - Speech & Filter Pipeline Spec class ReadMeEngine { constructor(catalogConfig) { this.synth = window.speechSynthesis; this.catalog = catalogConfig.books || []; this.kidSafeFilter = true; } searchCatalog(query, maxAgeRating = 12) { return this.catalog.filter(book => { const matchesQuery = book.title.toLowerCase().includes(query.toLowerCase()) || book.author.toLowerCase().includes(query.toLowerCase()); const safeRating = book.ageRating <= maxAgeRating; return matchesQuery && safeRating; }); } speakPassage(textElement, rate = 1.0) { if (this.synth.speaking) this.synth.cancel(); const utterance = new SpeechSynthesisUtterance(textElement.textContent); utterance.rate = rate; utterance.onboundary = (evt) => this.highlightWord(textElement, evt.charIndex); this.synth.speak(utterance); } }
🎨 Kid-Friendly UX
  • Adaptive Font System: Built-in OpenDyslexic & Sans-Serif font toggle options for enhanced readability.
  • Color Contrast Themes: Includes Night, High-Contrast Arcade Neon, and Sepia Paper modes.
  • Kid-Safe Shields: Prevents access to unrated external links or web queries.
🔒 Storage & Security
  • Zero External Servers: Operates entirely offline inside client browser memory using IndexedDB.
  • Safe Offline Storage: Save progress, bookmarks, and local EPUB files without tracking.
  • Arcade Hub Integration: Fully integrated with system account activity tracking.
📚 Launch ReadMe Library