Awakening to Reality · Behind the website (Luminous Library Theme: Version History and Updates)
A quieter, clearer home for a growing Dharma library
How the Awakening to Reality website has evolved: from its visual atmosphere and reading tools to better search, a growing collection of free books, and the new Ava narration experience.
First, what is a website “theme”?
A theme is the look and reading experience of a website. Think of it as the arrangement of a library: its shelves and signs, the lighting around the reading desk, the pathways that help you find a book, and the tools that make it comfortable to stay and read.
For this blog, the theme shapes the colours, menus, article layout, search, reading controls, mobile experience and Listen features. It is not a new teaching, and changing the theme does not mean changing the meaning of the articles. The purpose is to make the existing Dharma material easier to discover, read, revisit and share.
Why the redesign keeps evolving
Awakening to Reality contains many years of articles, discussions, translations, practice guides and free books. Some are short reflections; others are long, detailed explorations of insight, anatta, dependent origination and emptiness. A beautiful homepage is useful, but it is more important that readers can actually find the teachings, stay with a long passage and return to it later.
The “Luminous Library” design brings together a deep violet-and-gold visual language with practical reading improvements. Versions are numbered so changes can be traced, tested and refined. Many updates are small: a more legible button, a less crowded phone screen, a repaired link or a more dependable way to continue listening. Those details matter when people read for a long time.
Search and discover
Explore the archive, search across article text, browse Must Reads, open the latest posts and follow reading pathways.
A more comfortable page
Adjust text size, switch to Night or Focus reading, follow section links and resume where you left off.
Text made audible
Use a suitable device voice—or Ava neural narration for eligible English articles when it helps. Control speed, pause and passages.
Free books and key teachings
Navigate the growing Free Books collection, Start Here and curated readings, including works by and about important Dharma teachers.
Find the exact passage
Use headings and passage links to share the part of a long text that matters instead of only the page’s beginning.
Built for phones too
Responsive controls, keyboard-friendly navigation, readable colours and optional decorative animation support different ways of reading.
Where we are now: Version 19.47
The newest recorded release continues the work on Listen. The Ava narration backend is enabled and working, alongside the browser's own voice option. Ava is not used for everyone: a recognised good-quality device voice or an explicit reader choice can take priority. In v19.47, the site can check for already-prepared audio before the reader taps Listen, show a clear Preparing… state when needed, and offer Start now with device voice rather than making someone wait.
New Ava narration is subject to a limited free monthly allowance. Previously prepared audio can be reused; when the allowance is exhausted, new Ava generation pauses and readers see an explanation. The device voice remains available, and the Dharma library remains free to read.
Why did we add Ava if phones already have voices?
Many browsers can read text aloud using a voice built into your phone or computer. That is called device speech. On some devices it sounds excellent; on others it can sound mechanical. There is also a practical problem: certain browsers, especially in some iPhone/Safari situations, can fall silent, stall or stop unexpectedly when asked to read a very long article. We spent several releases investigating those differences rather than assuming the same voice would work for everyone.
Ava is an additional option, not a replacement for every reader's voice. It is a more natural-sounding neural voice produced through an online audio service. Instead of asking the browser to pronounce each passage locally, the site can play prepared audio. That can help in browsers whose built-in long-form speech is unreliable, while retaining familiar playback and passage navigation.
Use your device's voice
Often the best choice if your browser already has a pleasant, dependable voice. It works without spending Ava's monthly generation allowance.
Use online Ava narration
Useful when a suitable device voice is missing, sounds poor, or has trouble with lengthy readings. Available for eligible English articles, subject to the free allowance.
How the site chooses between them
- A good device voice is available: in automatic mode, recognised higher-quality English voices—such as certain Google or Microsoft voices—can remain in use. A voice you explicitly choose is respected.
- A suitable voice is absent or unreliable: for eligible English articles, automatic mode can use Ava instead. Ava is particularly helpful on browsers that struggle with long passages.
- You prefer a different source: the Listen panel gives a choice between automatic selection, Ava and browser/device speech where supported. You are not forced to use Ava.
- The article or language is not eligible: other languages and content without suitable Ava narration continue to use supported device voices or an independent recording where available.
What about cost? The Ava service is operating, but new audio generation is restricted to a free monthly allowance. Already prepared narration can be reused. Once the free allowance is exhausted, the site explains that new Ava narration is paused until the allowance renews; device speech remains an option. Readers do not need a paid subscription to use the free Dharma materials.
Behind the scenes, the theme can check whether an article's audio is already prepared before you press Listen. This avoids unnecessary waiting; creating new narration is not the same as checking for an existing recording. Ava does not automatically narrate every page, and some article/voice combinations will continue to use device speech.
A few turning points
If you do not want to read dozens of release notes, these milestones tell the story:
The reading-focused redesign
Fresh emblem, permanent reading toolbar and a more distinctive visual character.
Better browsing, sharing and control
Compact archive listings, section links, easier settings and more dependable layouts.
Night, search and Listen
Full-text discovery, speech features, improved mobile reading and optional living-sky effects.
Integrated discovery and narration
Must Reads, Explore and Free Books work together; the newer releases concentrate on audio and iPhone reliability.
Explore the version history
Each version number marks a set of changes to the website. Tap a section below to expand its entries; you can close it again when you are done. The newest section is open by default. The descriptions use everyday language while keeping the recorded version numbers intact; audio and mobile fixes span many small experiments, not one single switch.
Version 19 · Audio and Listen improvements (v19.30–v19.47)Latest changes first · Ava narration, iPhone fixes, playback controls
- Added an early check for existing Ava audio, a visible Preparing state, a Start now with device voice option, and a plain-language message when the monthly free allowance has run out. This reduces waiting without making Ava compulsory.
- Coordinated Listen with the revised Ava narration backend (Worker V5) and corrected the theme version shown in the footer. This was backend integration work, not a change to the teachings.
- Improved iPhone playback recovery. If Ava cannot start, Listen explains what happened and preserves a clear one-tap Resume path, rather than silently appearing to play. Added a short diagnostic status line for troubleshooting.
- Introduced optional Ava-first neural narration for eligible articles through an Azure-connected service. Automatic mode can continue to use a recognised good English device voice or a reader-selected voice instead; content without usable hosted narration retains browser speech and the usual passage controls.
- Used Safari’s own default English voice without forcing a named voice or language override, following the isolated iPhone test where that arrangement behaved more reliably. The earlier Daniel preference is not imposed automatically.
- Added raw speech-event diagnostics and a separate short iPhone speech test to distinguish the browser’s speech behaviour from the site’s listening controls.
- Removed timer-based guesses about when iPhone speech had finished: the native reader now advances on completion events instead of skipping text. Added support for continuous hosted recordings with measured passage cues where a matching recording exists.
- Detected a Safari queue that appears active but produces no sound, offered explicit recovery, and prevented late callbacks from older speech attempts from corrupting the current position.
- Continued iPhone speech from completion events when Safari omits other callbacks; made No sound? assistance available without waiting for the reader to discover it.
- Pinned the current speed and passage position to the top of Listen, supplied understandable speed choices from 0.5× to 2×, tucked technical diagnostics behind a disclosure, and improved small-screen layout.
- Stopped cancelling iPhone speech merely because Safari had not fired a start event. Listen now shows the submitted passage even when the browser is late to confirm playback.
- Made Resume targets more precise, clarified that the progress percentage refers to passage position, and provided alternative iPhone speech methods when native synthesis cannot be heard.
- Added one-tap Listen access from the reading dock and optional tests for how a selected voice handles changes in speed.
- Moved full Listen controls into an accessible panel reachable from the dock. Speech can continue when the panel closes; prerecorded audio can be navigated by playback position.
- Guarded against stale iPhone callback events during transitions between speech passages, so previous attempts are less likely to interfere with the current reading.
- Added obvious speed increase/decrease buttons, remembered playback speed for both browser and recorded audio, and made Android’s delayed voice fallback safer.
- Remembered Android voice selection even if browser storage is blocked, while aligning the no-script footer label with the actual installed theme version.
Version 19 · Books, mobile and reading layout (v19.20–v19.29)A bigger free library, improved mobile panels and article layout protection
- Repaired Android speech voice selection and recovery, fixed Blogger search paging so requesting 20 results actually fetches them, and repaired two outdated resource links.
- Improved language filters and search explanations, made the Library easier to reach, and kept the site’s full description visible rather than accidentally hiding it.
- Removed compounded toolbar offsets that could leave controls adrift after the phone keyboard changed the viewport; reading panels now settle back into place.
- Added Yuan Yin Lao Ren to the shared Free Books collection, keeping links to substantial Dharma resources together.
- Added the second-edition Bodhidharma and Huangbo translations to Free Books; improved navigation to the full collection and corrected speech-recovery behaviour.
- Kept reading panels above the on-screen keyboard, made panel switching cleaner, cleared the New indicator when opened, followed the site’s Night setting inside styled articles, improved panel animations, and added / as a search shortcut.
- Aligned the four reading panels and strengthened the protection that prevents an individual article’s custom layout from accidentally altering the broader page.
- Repaired Library scrolling, section jumps, touch targets and diagnostics; improved containment for standalone article CSS and added the Bahiya/Kalaka reading to the available pathways.
- Made Start Here prominent in Library without changing the established toolbar order; strengthened styling containment for article designs using root selectors.
- Isolated imported standalone article styles so their own backgrounds, cards or spacing would not accidentally change the website’s header and surrounding layout.
Version 19 · Discovery and toolbar (v19.0–v19.19)Explore, New, Latest, search and the refined reading dock
- Grouped browsing actions together, preserved a direct Top button, and arranged all phone toolbar buttons into balanced rows without an empty final slot.
- Introduced Explore navigation using the existing sidebar links, while keeping the toolbar compact and leaving Top directly accessible.
- Made toolbar entrance smoother and guarded layouts when users return to background tabs or navigate back and forward in the browser.
- Kept a readable, gentle toolbar entrance while following the device Reduce Motion preference: no unnecessary sweeping animation for users who request less movement.
- Introduced a more compact phone toolbar, simpler badges and aligned dark-panel colours, plus focused refinements to titles and search.
- Removed older shell offsets, aligned desktop dialogs, improved the reading-toolbar geometry and made dark-panel labels more consistent.
- Improved spacing for Chinese reading titles, made search examples clearer, and extended overflow checks to the toolbar and dialogs.
- Centred the expanded desktop toolbar, kept its minimise control accessible, reserved space above the footer and refreshed the content of the New panel.
- Enlarged the new-publication indicator and made recent-post listings refresh when returning to the tab, while limiting retries and sharing cached requests.
- Adjusted the phone toolbar’s clearance as Safari and other browser controls move in and out of view, keeping notices from covering the buttons.
- Added a persistent New indicator backed by the site feed so visitors can see that fresh articles have appeared since their last visit.
- Replaced the old New asterisk with a more distinctive paired-sparkle icon shared by the header and reading toolbar.
- Labelled recent-post shortcuts New and improved keyboard focus while loading or retrying lists.
- Added a keyboard-accessible toolbar search pop-up, shared query text with the main search box, and offered Google as a fallback when useful.
- Corrected unwanted header scrolling during keyboard/search interactions, kept search-result links in predictable keyboard order, and supported unusually short phone screens.
- Introduced site-wide Latest posts, toolbar search and a remembered Minimise setting; shared a bounded recent-feed request and gave mobile tools a two-row layout.
- Simplified the Facebook invitation and prevented the panel close action from unexpectedly taking keyboard focus back after navigating away.
- Standardised John Tan/Thusness/PasserBy author labels and added timeouts so full-text search would not remain stuck indefinitely on a slow connection.
- Restored full homepage posts instead of general excerpts, retained a lightweight phone preview for the exceptionally heavy media post, and improved Must Reads plus full-text paging and retry behaviour.
- Brought Must Reads, John Tan’s website, Free Books and discovery paths together. Searchable Must Reads and clearer reading shortcuts were added while keeping the full site description available.
Version 18 · Listening and deep readingSelected releases · Search, Night mode, the Listen foundation, accessibility
- Readable gold buttons and headings in Night mode; broken images hidden; Chinese passage links fixed.
- Chinese passage links and Restart speech timing on iPhone fixed; exact full-text counts.
- Restart speech button inside the help notice; current page and section highlighted in menus.
- Better keyboard focus and high-contrast mode support.
- Six-button reading toolbar with clear pressed states.
- “No sound?” help became a clear callout.
- Notice when an old backup page is hidden from Google.
- Old backup Pages kept out of listings.
- Introduced a still-or-animated atmospheric sky choice, with motion controls for a calmer reading experience when wanted.
- Added deeper full-text searching, updated-date presentation, and ways to link to a selected passage for easier sharing of precise quotations.
- Light phone preview for the heavy John Tan media post.
- Help text updated for iOS 26 (Read & Speak).
- Library links as a tidy grid on phones; help when a phone plays nothing.
- Tablets use the phone reading bar; every language script handled by Listen.
- Listen: language picker and word highlighting.
- Screen stays awake while listening.
- Introduced the in-page Listen control, the foundation of the later audio improvements.
- Focus reading kept in step across open AtR tabs.
- Lighter pages: listing scripts only where needed.
- Accessibility improvements for headings and live announcements.
- Readable highlights at night.
- More stable reading position while images load.
- Browser bar colour matches the theme.
- Text size changes leave images and video at their natural size.
- Better printing: embeds print as references; article language marking.
- Dark background from the first moment in Night mode.
- Better error handling for slow or failed loading.
Version 17 · A smoother, more navigable siteSelected releases · Archive, animations, sharing and reading controls
- Compact search results respect your reading size.
- Made browsing through past posts faster by prioritising compact title lists instead of loading long article bodies in the archive.
- Audio card polished for Night mode.
- Free Books 2 and 3 always discoverable.
- Welcome guide keeps the original article's design.
- Kept embedded YouTube videos from loading before readers choose to play them, helping reduce unnecessary page work.
- Settings separated from destinations; compact recent-post index.
- Animations setting remembered across tabs and following your device.
- Text size kept in step across open AtR tabs.
- Copy-link control for section headings.
- Section links with clear copy feedback; layout stays stable when text size changes.
- Footer shows the theme version automatically.
- Fixed sky background that works on iPhone.
- Follows your device's light/dark setting until you choose.
- Topic labels enhanced without extra loading.
Version 15 · Luminous Library foundationsSelected releases · The toolbar, design identity and compact browsing
- Fast title lists on label pages.
- Your reading preferences apply before the page appears (no light flash); Top and Must Reads in the permanent reading dock.
- Established a permanent reading toolbar and updated the emblem, giving the redesign its recognisable reading-oriented direction.
About the archive: This is a curated public history based on the preserved release notes. It preserves the same 92 version entries in their original order and expands the descriptions where supporting theme release notes provide useful detail. Not every intermediate version is available in those records; versions 16 and earlier than v15.22 are not reconstructed here. A website theme version is separate from the publication or revision date of any individual Dharma article.
May these improvements make the Dharma easier to encounter, study and return to.
Comments