Awakening to Reality · Behind the website (Luminous Library Theme & Ava Backend: 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: theme and backend
Theme v20.21-candidate3 (live 17 November 2026; iPhone playback confirmed by Soh): Repairs an article-specific Listen mismatch in “Introducing John Tan’s New Website”. Five section-navigation links were being counted as spoken passages by the browser player but excluded from Ava’s article text. The browser collector now excludes navigation and other explicitly non-narrated controls consistently, so the introduction’s 54 content passages align without skipping its prose. The saved update is publicly verified on the introduction and Seven Stages, and Soh confirmed that Listen works on his iPhone. Seven Stages has no elements affected by the added exclusions. Existing voice choices, native fallback and strict passage checks are preserved; Ava Backend V5.8 and existing audio-cache keys are unchanged. This confirms the reported iPhone playback result, not universal device coverage or a diagnosis of the earlier separate discovery timeout.
Theme v20.20 (prepared 16 November 2026; local regression tests passed, live verification pending): Makes the Day/Night reveal dependable. The dark (or light) circle now spreads from the button every time: a second tap during a reveal no longer turns the next one into a washed-out fade, and a reveal interrupted by the screen changing size (a phone's address bar sliding in or out, rotation, resizing a desktop window) restarts from where it stopped. The reveal no longer depends on the site's Animations switch, which still stops the ambient sky, glow and stars; a device's Reduce Motion setting still switches instantly. Must Reads gains “索引:John Tan 简体中文文章”. Continue reading keeps a title saved on the article page when the title check cannot reach the site. No live-site or iPhone validation is claimed.
Theme v20.19 (prepared 16 November 2026; local regression tests passed, live verification pending): Repairs Night mode on the homepage. Since v20.10 the embedded Start Here article has sat outside the two Blogger widgets that the theme's post rules were written for, so in Night mode its card stayed white while its text turned pale, and the dark Day/Night reveal appeared to do nothing over it. Every post rule now also covers the embedded article: the reveal spreads over a dark page again, Text size applies to the article, and its Chinese titles are language-marked. The homepage is also lighter: the article no longer carries its own render-blocking font link, its images load lazily, and the background refresh asks Blogger's feed for the single post before falling back to the full page, after the page has loaded and never on Data Saver. The sidebar is now a named landmark and the unused v20.9 rescue markup is removed. No live-site or iPhone validation is claimed.
Theme v20.18 (prepared; local regression tests passed, live verification pending): Fixes a confirmed v20.11–v20.17 toolbar CSS conflict that caused the unfinished-reading count badge (9+ when there are more than nine eligible articles) to float above Focus instead of sitting on Library. The older toolbar CSS required position:static!important on all links; the Library control's newer position:relative was therefore ignored. The Library positioning is now explicitly restored without changing other toolbar cells or the underlying reading data. Tested locally at mobile, tablet and desktop widths, including the exact 1116-pixel screenshot width. This small maintenance release retains the complete Start Here article and John Tan introduction, v20.15 scrollbar correction, v20.17 real-article-title resolver, Ava/Listen and accessibility features. No live-site or iPhone validation is claimed.
Theme v20.17 (root-cause repair; locally tested, live verification pending): Corrects Continue Reading at the system level for all saved articles, not a list of handpicked titles. An old Blogger permalink often survives an article rename. Previous themes displayed an invented title derived from that URL for older saved reading entries, which made the long-renamed Seven Stages article appear as “Thusnesss six stages of experience.” The homepage and Library now retrieve the genuine published article title from each saved post's own HTML, stop reading once the page title is received when browser streaming is supported, and cache that verified title within the same device's reading-history entry. Only five visible entries are resolved as needed, with at most two requests in flight; titles are checked again after 14 days or when an article is opened. A failed lookup shows an honest unavailable-title label and retains the article link and saved place instead of guessing from an obsolete slug. Existing completion percentages, headings and reading-history dates remain intact. The full Start Here article, John Tan invitation, all images and guides, stabilized scrollbar, Ava backend integration, Library, and violet-to-rose history design are unchanged. This is a local validation, not a claim of live deployment success.
Theme v20.16 (prepared; live verification pending): Restores the prominent John Tan / Thusness / PasserBy website introduction to the full Start Here welcome article. A previous full-content failsafe (v20.10) embedded an older archived HTML edition, which predated this introduction; that archived edition persisted in v20.11–v20.15 when the canonical article could not be refreshed. The welcome now again introduces John Tan's website, links his books and Soh's introduction, and encourages beginners to visit while recommending Seven Stages followed by On Anatta as useful companions rather than prerequisites. The new introduction is present in the static fallback, and the existing conditional refresh preserves it if the fetched article omits it. All three free guides, illustrations, the v20.15 scrollbar stabilization, Continue Reading, and Ava features are otherwise preserved. Live Blogger verification pending.
Theme v20.15 (prepared; live verification pending): Repairs a newly reported scrollbar problem on long homepage, label and archive listings. A legacy optimization had given off-screen Blogger posts an artificial 1,400-pixel height until they became visible. Some AtR articles are far longer, so the document could suddenly grow while scrolling: the scrollbar became much smaller and appeared to jump upward before the reader reached the actual end. v20.15 removes that inaccurate virtual-sizing rule so the browser can calculate the full article lengths normally. The complete Start Here guide, illustrations, Library and Continue Reading tools, Ava/Listen routing, reading order and design are untouched. In a local Chromium reproduction, the previous rule caused scroll height to grow dramatically; with the fix it remained constant throughout the scrolling test. Real production and device verification remains pending.
Theme v20.14 (prepared; live verification pending): A focused maintenance review of v20.13 found that its privacy-safe Listen voice-routing report and iPhone speech trace still labelled themselves v20.12. Both now identify v20.14 without changing any audio routing, speech synthesis behaviour, backend configuration, or costs. The homepage also contains a complete Start Here article independent of Blogger FeaturedPost, but its duplicate-gadget suppression used :has() and was applied only to screens. v20.14 uses an ordinary homepage selector, hiding the redundant Featured Post even in print and older browsers without :has(). The complete Start Here article is byte-for-byte unchanged, as are the three images, guides, Continue Reading and the visual design. All repairs are source-verified and locally tested, not live-deployment or device certification.
Theme v20.11 (historical): Continue Reading is accessible from the existing Library button in the reading toolbar, without adding another button or row. A small badge shows how many unfinished long articles are saved in the current browser (9+ when more than nine). At the top of the Library panel, readers can resume their five most recent unfinished articles, see the recorded section and approximate position, or remove individual entries. The homepage Continue Reading card is retained and both views use the same on-device reading history. The badge refreshes when the Library opens and when browser storage changes; this does not use a new server or synchronise across devices. The complete Start Here guide and Ava narration/routing code are preserved. Tested locally with mocked browser interactions; not yet verified after publication on the live Blogger site.
Theme v20.10: This release addresses the missing homepage Start Here article by embedding an entire preserved edition directly in the theme, including the article-owned styling, three free-guide sections, links and illustrations. It remains visible even when Blogger provides only a Featured Post snippet or the current article cannot be fetched. Where the current article is retrieved in full, the theme can update the displayed article body without introducing global styles. The preserved copy is from an earlier article edition, not a verified export of the November 2026 update, so a direct link to the current post remains available. The theme continues from v20.9 rather than reverting the whole interface to v20.2. All non-welcome JavaScript behavior, the Library history link, Ava and reading tools remain preserved; live Blogger rendering has not yet been verified.
Ava backend: V5.8 was deployed on 15 November 2026, followed by a SQL-read optimization deployed on 17 November 2026. This separate server-side audio service now uses targeted database lookups and maintained storage totals to avoid repeatedly scanning the full narration records. The deployment and migration were checked against the existing stored totals. Actual database-read savings under normal traffic, uninterrupted iPhone playback and automatic continuation still need verification. Existing quota and provider settings were not changed.
The earlier v19.47 theme release continued 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.
Two separate version histories
These numbers belong to two different parts of the website, not one sequence. Theme v20.21-candidate3 is the current live Luminous Library design, which includes the browser-side reading tools and Listen controls. Ava Backend V5.8 is the separate server-side service that prepares, stores and reuses online narration. They work together and are updated independently: Backend V5.8 is not an older edition of Theme v20.21-candidate3.
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.
1. Ava Backend history · the online narration service
Ava backend · Server-side audio releasesSeparate version numbers from the Blogger theme · newest first
- Less repeated database scanning. Adds targeted indexes and maintains reserved-storage and stored-audio totals as records change, instead of repeatedly summing the full tables. Migration checks validate existing values before installing the totals and their update rules together. The deployed source was checked against the reviewed candidate; the rollout reached 100%, and live checks confirmed the new totals matched the source records. Existing audio, bandwidth liabilities, quota limits and provider settings were preserved. Offline regression tests included successful mocked generation, interrupted work, accounting consistency and migration rollback. These tests and the live migration check do not establish real-world read savings or physical-device playback. No deliberate speech generation or new provider spend was used for this deployment verification. The source retains its V5.8 label; this dated maintenance entry does not invent a new release number.
- Improved reuse of previously prepared audio. A matching reusable audio source is protected from eviction during recovery; the service can look beyond a damaged cached source within bounded limits. Additional safeguards handle overlapping requests and make cache/reuse outcomes easier to diagnose. If bounded reuse fails, the affected article is marked failed or deferred rather than placing a global hold or silently generating fresh audio. Device speech remains a fallback, and some failures may still require explicit recovery. Existing quota and provider settings were not changed.
- Cache-correctness candidate. Protected matching reusable audio against eviction, skipped damaged sources to look for valid alternatives, bounded the search, and rechecked state after asynchronous work. Its bounded-reuse deferrals could still place a persistent global hold, so it was superseded by V5.8 before deployment. Historical local evidence: 36 cache checks, 7 quota checks and 8 local-runtime groups; not production or audible-playback proof.
- Logging-only candidate with allowlisted diagnostics for audio reuse, cache decisions and the provider boundary. No verified standalone production deployment was recovered. This does not certify the privacy of pre-existing logs.
- Corrected quota handling: a provider response mentioning quota is not proof that the monthly free allowance has been exhausted. Unverified refusals keep their reservations and require reconciliation, rather than refunding them or replaying automatically next month. Preserved existing holds; disabled the old recovery manifest by default. Stored audio remains usable and ordinary monthly bandwidth rollover remains separate. Deployment receipt verifies V5.5, no hold and no unresolved attempts at the check; 7 offline checks, no speech requests or device-audio tests.
- Added a read-only fast path: when an article’s stored audio is complete and the article text is unchanged (same content fingerprint), Listen can start from the stored audio without re-fetching the article first; any change in the article triggers a fresh check. Added a monthly-quota pause and a read-only status report showing the worker version, outstanding attempts and allowance mode. Paired with theme v19.47. Deployment log verifies V5.4 live, not held, with no unresolved attempts at the check. Its broad quota-text classification and automatic next-month release were subsequently corrected in V5.5; they should not be read as current behaviour.
- Corrected status reporting so an in-flight speech-provider request appears as pending rather than unavailable. Before this fix an iPhone could give up on Ava while audio was still being prepared and fall back to the device voice. A regression test now covers it. The deployment log verifies V5.3 live, not held, with no unresolved attempts and automatic monthly bandwidth allowance. After this release the owner confirmed on an iPhone that Ava narration was working, and full narration of a long article (the Seven Stages) was generated.
- Applied the owner-approved, narrowly targeted recovery of an earlier never-sent attempt and added automatic monthly bandwidth allowance rollover. Deployed at about 13:41 UTC (21:41 SGT). The successful deployment log confirms the hold cleared, the reserved bandwidth of the never-sent attempt was refunded, no unresolved attempts remained and Worker V5.2 was live. The recovery released exactly one recorded attempt, within a fixed time window, and could be applied only once. An earlier stopped attempt is not counted as a deployment.
- A targeted recovery candidate and deployment script survive. The retained V5.1 deployment attempts stopped because the command-line session was not authenticated; those logs explicitly say nothing was deployed. The command-line tool was then signed in again by the owner, and the next attempt became V5.2. Successful recovery is evidenced under V5.2, not V5.1.
- Replaced the withdrawn V4 approach with conservative recovery controls: preserve outstanding provider-attempt records, require an exact approved recovery manifest, verify reused audio by hash and a more complete voice/format/plan identity, limit copying per invocation, and keep status reads from dispatching generation. Retained the supported manual-redirect transport fix. Deployed at about 13:20 UTC (21:20 SGT). The default retry policy was kept unchanged: an uncertain outcome still places a hold, and there is no automatic retry to the speech provider. The successful V5 deployment log still showed the earlier hold; V5 alone did not clear it.
- Identified the unsupported request redirect mode that prevented the earlier worker from sending speech requests, and introduced cache reuse and failure-handling changes. The owner asked for an independent review of V4, and it was withdrawn because its blanket startup recovery lacked adequate evidence, it changed retry policy and its reuse key had a defect. Preserved as history only; no deployment is asserted here. V5 superseded it.
- Prepared after an iPhone test showed Listen falling back with “Ava not used: NARRATION_UNAVAILABLE:UNKNOWN_PROVIDER_OUTCOME”. Proposed article-specific handling of definitive failures, a reader-tap retry cooldown, boot reclassification of earlier holds, reuse of a recently discovered source and a lower local admission limit. The preserved changelog explicitly labels the backend not deployed. Browser diagnostics and iPhone fallback work in the same package are theme/client changes, not proof that this backend went live.
- The preserved package identifies V2 as the previous delivery. Later source analysis reproduced a request redirect-mode failure before sending to the speech provider, followed by an uncertain-outcome record and global hold. The Cloudflare runtime rejected the request before any connection was made, so the speech provider was never reached. In practice the service could never produce Ava audio until V5.2 cleared that record. On iPhone this showed up as a silent Listen, then a Resume button and the Safari device voice reading only the opening passage. Early hybrid/discovery and provider-disabled artifacts survive, but their exact public release-number mapping and complete deployment chronology have not yet been reconciled. No separate V1 release is invented here.
Verification: V5.8 deployment metadata confirmed a 100% rollout on 15 November 2026. Local checks covered 42 cache cases, 7 quota cases and 10 local-runtime test groups; the local runtime was older than production. These checks are not physical iPhone playback or auto-advance proof. No paid narration test was run for this release. The prior V5.5 rollback was retained.
Earlier-history evidence and gaps: reconstructed from the preserved V2–V5 changelog, successful V5/V5.2/V5.3/V5.4 deployment logs, the V5.5 deployment receipt and source comparison, and V5.6/V5.7 candidate/review records. Stopped deployment attempts are not counted as releases. Approximate deployment times for V5 and V5.2 come from the deployment logs of the editing session that carried out those deployments. The exact pre-V2 chronology, any separately named V1 release, and a fuller early feature history remain open. Historical status checks describe that moment, not a guarantee of present playback.
How this log is maintained: theme and backend updates are recorded separately. Prepared files, deployed releases and tests actually completed are distinguished; missing intermediate release records are not reconstructed or presented as deployments.
2. Luminous Library Theme history · the website and reading controls
The entries below now switch to theme versions. Theme v20.21-candidate3 describes the current live website interface and browser-side reading controls, not a new Ava backend release. Earlier entries retain their original release dates and testing status.
Theme version 20 · Start Here, reading access and DawnNewest first · website interface updates, not backend releases
- Listen source-mapping correction. Based on the current v20.20 theme, this narrow update aligns the browser passage collector’s explicit navigation/form exclusions with Ava’s canonical article collector. The John Tan website introduction previously supplied 59 browser passages against 54 canonical passages because five quicklinks were included only by the browser. Removing those navigation labels yields the same 54 content passages in the same order. Six offline regression fixtures passed; the live Seven Stages control contains none of the newly excluded elements. The complete published Listen script on both articles matches the reviewed update, and Soh reported successful iPhone playback. Existing approved voice selection, fallback, strict source checks and audio-cache identity remain unchanged. This is not a new backend release. The earlier 20.1-second discovery timeout has not been assigned a proven root cause, and broader device coverage is not claimed. Other unmatched article structures still fail closed rather than risk speaking the wrong passage.
- Reliable Day/Night reveal. Three causes made the reveal appear only some of the time, all present since its introduction rather than new in v20.18–v20.19. (1) Animations: Off. A saved Off setting in a browser silently replaced the reveal with an instant switch. The reveal answers the reader's own tap, so it now follows only the device's Reduce Motion setting; the Animations switch continues to stop the ambient sky, dawn glow, stars and page cross-fades. (2) A second tap during a reveal. The first reveal's end removed
atr-night-switchingwhile the second was still playing, so the second fell back to the browser's blended cross-fade. Each reveal now owns that class only while it is the latest; a new tap finishes the running reveal at once and starts its own. (3) A screen-size change mid-reveal (phone address bar, rotation, desktop window resize) makes the browser cancel the transition. An interrupted reveal now restores the previous mode and plays the remainder once, from the radius it had reached. The page cross-fade's 0.26-second timing no longer applies to the Day/Night switch.atrLogrecords each reveal's start, end, supersession and restart, andwindow.atrNightReveal.state()reports counts for diagnostics. Must Reads: “索引:John Tan 简体中文文章” added after the traditional-Chinese No-Self article and before item 3 (the list is now 45 links; later entries renumbered in the widget settings). Continue reading: when the v20.17 title check cannot run or fails, an older entry's title that was saved on the article page itself is shown instead of “Article title unavailable”; a title is still never derived from a URL. Controlled Chromium tests: the reveal under fifteen conditions (open panels, keyboard activation, smooth scrolling, a minimised toolbar, an early tap, a double tap and a mid-reveal resize) with frame-by-frame checks for a growing circle and no blended frames; Night contrast inside every toolbar panel at phone and desktop widths; Escape and focus return for each panel; the v20.19, v20.1 and v20.2 feature suites (86 checks); and a computed-style comparison with v20.2 across homepage and article, day and night. Production and iPhone behaviour remain unverified. - Night mode and the Day/Night reveal restored on the homepage; lighter Start Here. Root cause: v20.10 moved the complete Start Here article out of
#FeaturedPost1into#atr-welcome-static, but 89 post rules were scoped to:is(#Blog1, #FeaturedPost1), and only the inner guide's Night rules were copied across. The article card therefore kept a white background in Night mode with pale text on it (contrast as low as 1.3:1), the dark circle of the Day/Night reveal spread over an area that stayed white, the Text size control did not reach the article, and its Chinese titles were announced as English. v20.19 adds#atr-welcome-staticto those 89 selectors, removes the now-duplicate v20.10 copy, and extends the two scripts that mark languages and repair light fills at night. The reveal code itself was unchanged from v20.2 and is untouched. Performance: the embedded article's three Google Fonts links are removed (a stylesheet link in the page body blocks rendering, and the theme already loads Spectral); its images are lazy and asynchronous, with reserved dimensions for the first; the current-article refresh first requests Blogger's JSON feed for that one post and uses the previous full-page request only as a fallback, remembers a feed miss for a week, starts after the page has loaded and the browser is idle, and is skipped on Data Saver or 2G. The embedded article is still never cleared or hidden. Accessibility: the sidebar is a named complementary landmark; the two Continue reading regions have distinct names; the article's own title is announced one level below the site title. Clean-up: the hidden v20.9 rescue section and its styles, which no script used, are removed. Controlled Chromium tests cover the three refresh outcomes with a mocked network, Night contrast of every paragraph in the article, the reveal at phone and desktop widths, layout parity with v20.18, and a style comparison with v20.2 across homepage and article, day and night. The feed request could not be exercised against the live site from the test environment; opening the homepage with?atrWelcomeDebug=1shows whether the feed or the page was used. Production and iPhone behaviour remain unverified. - Library count badge correctly anchored to Library. The badge introduced in v20.11 showed a correct number but floated above the Focus control on desktop. The pre-existing dock stylesheet used
position:static!importanton all dock links, overriding the badge'sposition:relativeLibrary anchor; thus its absolute position was relative to the whole fixed toolbar. v20.18 changes that exact rule toposition:relative!importantfor Library only. Controlled Chromium tests verified the placement at 320, 390, 768 and 1116 pixels and confirmed the badge disappears at zero. The homepage welcome article, its original images and guide sections, the John Tan invitation, the long-page scrollbar fix, title resolver, current reading data, and Ava/Listen scripts are unchanged. Updated version metadata and the audit report. This is a source and local-browser repair; production and iPhone behavior remain unverified. - Resolve real article titles for every saved reading entry. Replaces the legacy URL-slug fallback with a generic same-origin metadata lookup of the post's published title. Handles old or renamed Blogger permalinks across hundreds of articles and languages without hand-maintained mappings. Caches verified titles within saved entries, refreshes on visits and periodically, limits concurrent requests, and preserves reading positions, completion percentages, section names and history timestamps. Failed or unavailable title checks never fabricate a headline. Preserves the v20.16 John Tan invitation and full Start Here article, the v20.15 stable scrollbar and all other theme features. Previous entry-specific hardcoding was discarded before release.
- John Tan introduction returned to Start Here. An embedded 2026 archived welcome HTML snapshot was missing the newer John Tan website invitation, leaving only a navigation link. Restores a prominent introduction with direct links, a beginner-friendly explanation of the site's focus on anatta, emptiness and dependent arising, and the suggested Seven Stages → On Anatta companion reading order. The canonical-post refresh now preserves this introduction when the published article response lacks one, while preferring any genuine introduction in a newer published post. Preserves all guide sections, images, navigation, Continue Reading, Ava, and the stabilized v20.15 scrollbar.
- Stable scrollbar through long articles. Fixes the report that the scrollbar could reach the bottom of its track before the actual end of the page, then shrink and jump back toward the middle. Long homepage, label and archive listings had applied
content-visibility: autowithcontain-intrinsic-size: auto 1400pxto later post wrappers. That placeholder was much shorter than actual long articles and changed page height as they rendered. Removes the variable-height placeholder optimization; the page can now determine its real length before the reader scrolls. A representative Chromium test reproduced growing scroll heights with v20.14 CSS and stable heights after this correction at desktop and phone widths. No article HTML, image, Library/Continue Reading, voice routing or theme presentation rules were changed. Production confirmation still needed. - Maintenance and reporting accuracy. Corrects the privacy-safe Listen routing report and iPhone speech diagnostics, which were still reporting v20.12 in the v20.13 release. Suppresses the redundant FeaturedPost gadget on the homepage without CSS
:has(), including when printing, while keeping the complete embedded Start Here article visible. Reuses all v20.13 reading-history, Ava routing, Library and visual functionality without altering the welcome guide content, imagery or reading order. Source and local fixture tested; real-device testing remains outstanding. - Continue Reading consistency and reliability. Fills the next eligible saved article into the five-entry homepage card after one is removed, refreshes that card when a page is restored through browser Back/Forward caching, and immediately updates the Library badge when on-page reading progress is successfully saved or cleared. A refused Library history deletion now gives a visible explanation instead of silently doing nothing. The full embedded Start Here article, its images and reading order, Library links, visual styling and Ava routing remain unchanged. This is source-tested work, not confirmation of a live-site or physical-device test.
- Repair Start Here navigation and polish Continue Reading. The homepage’s New here? Start Here and Library Start Here buttons had pointed to the
#atr-welcome-titlefragment after the entire embedded welcome article. Their scroll target is now moved above the full article and its images, retaining the unchanged Start Here content and both buttons. The Library badge now counts all eligible saved articles instead of stopping at 40; a cross-tab refresh preserves keyboard focus in the open Library when possible; and a failed on-device storage write no longer falsely removes an entry from the homepage card. The complete v20.11 theme is retained, including all 3 guide sections, Library version-history link, and unchanged Ava routing. Local XML parsing, script checks, static navigation and mocked interaction tests were carried out; full production/mobile verification is still required. - Continue Reading in the Library panel. Reuses the existing on-device
atr-resume-v2progress records, adding a compact number badge to the existing reading-toolbar Library button and a Continue Reading section at the top of its popup. Shows the five most recent unfinished long articles with names, saved headings and approximate scroll-position bars. Readers can remove entries without leaving the panel; changes also update the homepage card and badge, including across tabs through browser storage events. When there are no unfinished articles, the badge disappears and the panel explains how saved articles appear. No new bottom-bar button, backend request, cloud storage or cross-device sync. Based on the version-label-corrected v20.10 theme, retaining its complete embedded Start Here article, custom designs, Ava routing, Library version-history link, and foundational reading order. Local XML, JavaScript and mocked Chromium interaction tests pass; production validation remains pending. - Make the full Start Here guide resilient. Unlike the unsuccessful v20.3–v20.9 variations, the homepage includes a complete archived copy of the article directly in the theme, including its original styling, all three free guides and images. It does not depend on Blogger FeaturedPost returning the article body, on a recent-post list, or on a successful fetch. If the current canonical post can be retrieved and validated, its complete body replaces the preserved copy. If not, the full archived article remains visible and links to the current original post. The available archived HTML predates the latest November update, so it is labelled as a preserved copy rather than falsely described as the latest source. This change is based on v20.9, retaining the Library history link and the independent Ava backend. Live Blogger verification has not been performed.
- Restore the pre-v20 complete Start Here mechanism. Compared the actual preserved v19.47 code with v20.2–v20.8. The earlier version’s Featured Post inserted the selected post body and included a conditional canonical-page retrieval when Blogger returned a shortened body. The later v20.6–v20.8 iterations removed that retrieval and attempted to use data from the homepage’s recent-post listing instead, so they could not reliably recover the original pinned 2022 post. Rebuilt on the v20.2 base: the Featured Post retains the selected Start Here widget configuration; an unconditional host is available even when Blogger supplies no featured post, and a separate homepage host survives if the entire gadget is absent. The restored loader selects the complete original article with its existing guide IDs, inline stylesheet, images, guides, downloads and links, and never substitutes a hand-written summary. A second same-origin document-loading path is available if the primary fetch fails. Failure messages give a direct original-post link and an optional diagnostic via
?atrWelcomeDebug=1. Preserves existing theme features, the new version-history Library entry, unchanged foundational reading order and Ava controls. Strict XML parsing, standalone JavaScript syntax checks and five mocked browser scenarios passed; neither production Blogger rendering nor real-device performance has yet been verified. - Attempted to show the full Start Here article again. Removes the exact leftover v20.6 CSS rule
#FeaturedPost1 { display: none !important; }that was still present in v20.7 and hid the entire pinned article, despite Blogger Layout correctly showing the selected Start Here post. The article is served directly by Blogger through its post-body data, with its complete original HTML and images; no shortened substitute or separate page-fetch mechanism. Preserves the previous theme features, version-history link in Library, and the unchanged Seven Stages then On Anatta reading order. The leftover CSS defect was confirmed and removed, but the owner subsequently uploaded v20.8 and reported that the full article was still missing. Restoration of the older canonical recovery became necessary in v20.9. - Native Featured Post, without staging. The owner confirmed that the Welcome guide gadget was still present in the correct Blogger Layout position, but v20.6 nevertheless failed to show the full article. Inspection identified a numeric-versus-quoted-string post-ID comparison and an unnecessary hidden content-transfer step. This version restores a visible Featured Post containing
data:post.bodydirectly, checks against the known Start Here post title, numeric ID and permanent URL, and fixes the corresponding comparisons in Blog Posts. It retains a server-side Blog Posts backup where that data is supplied; CSS prevents duplicate full articles. No handcrafted preview or client-side canonical-page fetch is used. Preserves images, styling, all guides, reading order, Ava controls, Library version-history link and existing site design. This is a locally checked candidate, not yet proof of success on the public site. Separately, the version-history article's hero loses its artificial circles and uses a restrained violet-to-rose gradient. Confirmed v20.7 regression: its stylesheet still concealed#FeaturedPost1withdisplay:none!important. The owner’s Blogger Layout screenshots show the correct post selection; the problem was the theme CSS, not the widget configuration. Superseded by v20.8. - Return to server-rendered full Start Here. The v20.5 canonical-page fetch failed on the public homepage (the site displayed an error instead of the original article). This release restores a direct Blogger
data:post.bodyrender for the exact pinned Start Here post ID within the homepage Blog widget. Its original HTML, images, styles, free guides and reading order are not rewritten or abridged. The normal latest-post list excludes the already-pinned article to avoid displaying it twice. The original Blogger Featured Post widget is restored only as a hidden secondary server-side source and is accepted only if it identifies the same correct post. A small local script can move that existing server-provided content into the top welcome position, without additional network requests. If Blogger supplies neither source, a direct link remains; the theme cannot fabricate missing post content. Keeps v20.5’s version-history link under Library → Follow Awakening to Reality, and corrects footer, metadata and Listen diagnostic labels. Although local XML/JS checks passed, the owner subsequently uploaded v20.6 and reported that Start Here was absent; v20.7 corrects the ID comparison and removes staged transfer. - Restore the full original Start Here article and link this history. Corrects an overly strict source check that blocked the genuine published Start Here article: the real source uses the “The Awakening to Reality Guide — Original Version” heading, not the exact phrase the v20.4 loader demanded. Now requires the original guide container, its known section IDs and image content, and inserts the complete original post body, including its embedded CSS, images, three guides, translations and every link. Eliminates the misleading abbreviated welcome substitute; while loading, visitors see only a loading notice and a link to the original full article. If loading fails, the notice provides a direct way to read the complete source. Retains the original Start Here reading order, pinned homepage position and prior visual styling. Adds “Behind the website: version history” under Library → Follow Awakening to Reality; corrects theme version metadata, footer fallback label and Listen diagnostics. The user uploaded the theme, and a public-homepage screenshot showed the full article was not loaded; its error/fallback message was displayed. The exact cause of the browser fetch failure was not established from the screenshot. Local XML/JS checks had not proved live success. Superseded by the server-rendered v20.6 candidate.
- Stopped relying on the Featured Post widget to select the Start Here article and introduced loading from its canonical URL. However, its identity check wrongly demanded “Original Awakening to Reality Guide” as a contiguous phrase, whereas the published article labels it “The Awakening to Reality Guide — Original Version”. Consequently the full HTML was rejected and a short fallback remained. Superseded by v20.5 and v20.6; success was not claimed.
- Attempted Featured Post recovery with an independent fallback. On the actual homepage the original guide did not return, and the unrelated John Tan introduction appeared in the content stream. The user reported the original post remained absent. Superseded by later versions.
- Adds a clear footer link “Behind the website: version history”, keeping the theme version itself as plain text. The credit links directly to this page; the other v20.1 reading and mobile changes remain in place.
- A shorter path to the reading. On the phone homepage, moves Start Here directly below the strapline and removes its duplicate menu link. The six-link Library strip becomes one swipeable row. On article pages, removes search examples and the extra Google-help sentence, keeping the search field, its label, Try Google, the description and Facebook invitation. A homepage Continue reading card can show up to five unfinished long articles saved in this browser, newest first, with progress, last heading and individual remove controls; it ignores non-post paths and uses a URL-derived title for older saved entries. This feature uses local browser storage, not cross-device syncing. When full-text search finds matches, the Blogger list is labelled “More from Blogger’s own search”. Decorative stars are confined to the right side above 1100 pixels, and the shooting star moves below the Languages row. Theme labels advance to 20.1; voice routing remains revision 19.52 and Ava Backend remains V5.8.
- A calmer dawn header. Replaces the orbiting dashed ring and dot with a slow, breathing glow, fine twinkling stars and a less frequent shooting star placed away from the title. Phones use the faint points only. On the homepage, the title and strapline enter once and Start Here receives a single light sweep. Supporting browsers gain a short page-to-page cross-fade; other browsers retain normal navigation. Day/Night transition styles are scoped so they do not override that cross-fade. Also refines the blockquote opening mark, gives the Latest posts Retry button a themed 44-pixel target, and colours the scrollbar to match. New motion respects Animations: Off and the device’s Reduce Motion setting. Version labels advance to 20.0, while voice routing remains at revision 19.52 and Ava Backend remains V5.8. Older development-comment entries were moved out of the theme file, not deleted from this public history.
v20.5 evidence and remaining verification: The source of the correct welcome article was examined in the connected Blogger editor: its original container and section IDs (including the Welcome, Practice Guide, Web Abridged and Original Guide sections) and image markup are present. v20.4’s rejected heading phrase is absent. v20.5 corrects that test, retaining full post HTML rather than selecting an excerpt. The new XML passed local structural parsing and isolated JavaScript checks. No live Blogger compilation, cross-browser fetch/image-rendering pass or theme deployment is claimed for v20.5. The reported v20.3/v20.4 failures are recorded above, not hidden.
v20.1 evidence: the supplied XML parses, its version markers read 20.1 and its routing revision remains 19.52; the supplied preview CSS and Continue reading module match the XML. Independently, the public page shows 20.1 in its metadata and footer, with the article search-help text hidden. The preview ZIP contains scripts and CSS, not saved test results, logs or screenshots. Reported gains of about 124 pixels on a 390-pixel phone preview and 49 pixels on desktop are the supplied local-preview measurements, not measurements independently repeated on the live site. No physical-phone, cross-device storage or audio-playback pass is claimed.
Evidence: the supplied full-theme XML and v20.0 changelog identify this Dawn release; the public page independently shows version 20.0 in its metadata and footer and includes the new header-star element. The supplied preview-check ZIP contains test and build scripts, not saved results, logs or screenshots; its preview uses mocked Blogger content and a substitute background, so the archive alone is not a live-site test pass. This history update did not upload the theme or run speech generation. Browser support and real-device behaviour still vary; no new iPhone playback or automatic-continuation pass is claimed.
Theme version 19 · Audio and Listen improvements (v19.30–v19.52)Latest changes first · Ava narration, iPhone fixes, playback controls
- Refined automatic voice selection: use an approved named browser voice where one is available, otherwise Ava. Readers can still choose a browser voice by hand and play a sample. On 15 November 2026 the live footer showed this version; it has not yet been tested for playback on a physical device.
- Intermediate releases prepared between v19.47 and v19.52, alongside the Worker V5.5–V5.8 work. Their individual release notes were not in the records used for this log, so they are listed together rather than reconstructed.
- 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. The early check only reads status and never creates new narration; it is skipped on data-saver or very slow connections. The device-voice option appears after about three seconds of preparing. If the article has changed since the check, Listen rechecks once instead of playing outdated audio. Paired with Worker V5.4 (client Listen V6).
- 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, because iPhone Safari only allows speech to start straight after a tap. Added a short diagnostic status line for troubleshooting (client Listen V3).
- 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.
Theme 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.
Theme 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.
Theme 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.
Theme 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.
Theme 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 prior theme history in order, adds v20.2–v20.14 and v19.52 and a combined note for v19.48–v19.51, alongside newly verified backend notes and current theme-status information 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.