bible270 0.19.0 → 1.0.0

data/app/views/bible270/shared/_reading_mode.html.erb

@@ -0,0 +1,62 @@
+<script nonce="<%= content_security_policy_nonce %>">
+  (() => {
+    if (window.Bible270ReadingMode) {
+      window.Bible270ReadingMode.scan();
+      return;
+    }
+
+    const storageKey = "bible270:reading-mode";
+
+    function browserStorage() {
+      try { return window.localStorage; } catch (_error) { return null; }
+    }
+
+    const storage = browserStorage();
+    let mode = "full";
+    if (storage) {
+      try { mode = storage.getItem(storageKey) === "compact" ? "compact" : "full"; } catch (_error) { /* Use full mode. */ }
+    }
+
+    function remember(nextMode) {
+      mode = nextMode;
+      if (!storage) return;
+      try { storage.setItem(storageKey, nextMode); } catch (_error) { /* Keep this page's mode. */ }
+    }
+
+    function apply(page) {
+      const compact = mode === "compact";
+      page.dataset.b270ReadingMode = mode;
+      page.querySelectorAll("[data-b270-compact-toggle]").forEach((button) => {
+        button.setAttribute("aria-pressed", String(compact));
+      });
+      page.querySelectorAll("[data-b270-compact-hide]").forEach((element) => {
+        element.hidden = compact;
+      });
+
+      const options = page.querySelector("[data-b270-reading-options]");
+      if (options) options.hidden = false;
+    }
+
+    function scan() {
+      document.querySelectorAll("[data-b270-day-page]").forEach(apply);
+    }
+
+    document.addEventListener("click", (event) => {
+      const button = event.target.closest?.("[data-b270-compact-toggle]");
+      if (!button) return;
+
+      const page = button.closest("[data-b270-day-page]");
+      if (!page) return;
+
+      remember(page.dataset.b270ReadingMode === "compact" ? "full" : "compact");
+      apply(page);
+    });
+
+    document.addEventListener("turbo:load", scan);
+    window.addEventListener("pageshow", scan);
+    new MutationObserver(scan).observe(document.documentElement, { childList: true, subtree: true });
+
+    window.Bible270ReadingMode = { scan };
+    scan();
+  })();
+</script>

data/app/views/bible270/shared/_styles.html.erb

@@ -1,8 +1,8 @@
 <style>
   .b270{
-    --paper:#ece6da; --card:#f4efe6; --ink:#231f18; --muted:#6d6558; --faint:#9a9082;
-    --line:#d7cfbf; --line-soft:#e2dbcd; --teal:#2f6a67; --oxblood:#8a2f3b; --gold:#a5812c;
-    --gold-lite:#c6a24a; --shadow:0 1px 0 rgba(35,31,24,.04),0 10px 30px -18px rgba(35,31,24,.35);
+    --paper:#ece6da; --card:#f4efe6; --ink:#231f18; --muted:#5d564c; --faint:#6e665b;
+    --line:#d7cfbf; --line-soft:#e2dbcd; --teal:#2f6a67; --oxblood:#8a2f3b; --gold:#80631d;
+    --gold-lite:#80631d; --shadow:0 1px 0 rgba(35,31,24,.04),0 10px 30px -18px rgba(35,31,24,.35);
     margin:0; background:radial-gradient(120% 80% at 100% 0%,rgba(165,129,44,.06),transparent 55%),var(--paper);
     color:var(--ink); font-family:"Inter",system-ui,sans-serif; line-height:1.2; -webkit-font-smoothing:antialiased;
   }
@@ -11,6 +11,7 @@
      colouring an <a> (.b270-btn, .b270-cell, .b270-arrow ...) must be
      qualified with .b270 to outrank it, or the link inherits body colour. */
   .b270 a{color:inherit}
+  .b270 :where(a,button,input,select,textarea,summary):focus-visible{outline:2px solid var(--gold);outline-offset:2px}
   .b270-wrap{max-width:820px;margin:0 auto;padding:clamp(14px,3.5vw,36px) clamp(14px,4vw,40px) 64px}
 
   .b270-topbar{display:flex;align-items:center;gap:16px;flex-wrap:wrap;padding-bottom:20px;border-bottom:1px solid var(--line-soft);margin-bottom:26px}
@@ -41,6 +42,29 @@
   .b270-field{display:grid;gap:5px;font-size:12.5px;color:var(--muted)}
   .b270-field input{font:inherit;font-size:15px;padding:10px 12px;border:1px solid var(--line);border-radius:9px;background:#fff;color:var(--ink);width:100%}
   .b270-field input:focus{outline:none;border-color:var(--gold);box-shadow:0 0 0 3px rgba(165,129,44,.13)}
+  .b270-reminder-row{display:flex;align-items:center;gap:12px;width:100%;flex-wrap:wrap}
+  .b270-reminder-optin,.b270-reminder-time{display:inline-flex;align-items:center;gap:7px;color:var(--muted);white-space:nowrap}
+  .b270-reminder-optin{position:relative;min-width:0}
+  .b270-reminder-time{margin-left:auto;gap:3px;font-size:12px}
+  .b270-time-control{position:relative;display:inline-grid}
+  .b270-reminder-tooltip{visibility:hidden;opacity:0;position:absolute;z-index:20;right:0;bottom:calc(100% + 7px);
+                         width:240px;max-width:calc(100vw - 28px);padding:7px 9px;border:1px solid var(--line-soft);border-radius:7px;
+                         background:var(--ink);color:var(--paper);font-size:12px;line-height:1.4;
+                         white-space:normal;box-shadow:0 3px 10px rgba(0,0,0,.14);pointer-events:none;
+                         transition:opacity .12s}
+  .b270-time-control:hover .b270-reminder-tooltip,
+  .b270-time-control:focus-within .b270-reminder-tooltip,
+  .b270-reminder-optin:hover .b270-reminder-tooltip,
+  .b270-reminder-optin:focus-within .b270-reminder-tooltip,
+  .b270-reminder-optin:active .b270-reminder-tooltip,
+  .b270-time-control:active .b270-reminder-tooltip{visibility:visible;opacity:1}
+  .b270-field .b270-reminder-optin input[type=checkbox]{width:auto;margin:0;flex:none}
+  .b270-time-control{grid-template-columns:48px 5px 48px;align-items:center;gap:2px}
+  .b270-field .b270-time-select{width:48px;height:30px;margin:0;padding:4px 2px;border:1px solid var(--line);
+                                border-radius:7px;background:#fff;color:var(--ink);font:12px/16px system-ui,sans-serif;
+                                font-variant-numeric:tabular-nums;text-align:center}
+  .b270-time-select:focus{outline:none;border-color:var(--gold);box-shadow:0 0 0 3px rgba(165,129,44,.13)}
+  .b270-time-separator{display:grid;place-items:center;height:30px;font:12px/30px system-ui,sans-serif;color:var(--muted)}
   .b270-emailform input[type=submit]{justify-self:start}
   .b270-or{display:flex;align-items:center;gap:12px;margin:22px 0 18px;color:var(--faint);font-size:12px;letter-spacing:.1em;text-transform:uppercase}
   .b270-or::before,.b270-or::after{content:"";flex:1;height:1px;background:var(--line-soft)}
@@ -54,6 +78,11 @@
   .b270-flash{border-radius:10px;padding:11px 15px;margin-bottom:18px;font-size:14px}
   .b270-flash.alert{background:#f6e4e2;color:#7a2b28;border:1px solid #e6c3bf}
   .b270-flash.notice{background:#e7efe6;color:#2f5d34;border:1px solid #c6dcc6}
+  .b270-interaction-status{margin:8px 0 12px;padding:8px 11px;border-radius:8px;background:rgba(47,106,103,.08);color:var(--teal);font-size:12.5px}
+  .b270-interaction-status:empty{display:none}
+  .b270-interaction-status[data-state="pending"]{color:var(--muted)}
+  .b270-interaction-status[data-state="error"]{background:#f6e4e2;color:#7a2b28}
+  .b270 form[aria-busy="true"] [data-b270-disabled-by-submit]{cursor:wait;opacity:.55}
 
   .b270-eyebrow{font-size:12px;letter-spacing:.18em;text-transform:uppercase;color:var(--gold);font-weight:600;margin:0 0 10px}
   .b270 h1{font-family:"Spectral",serif;font-weight:600;font-size:clamp(22px,6vw,33px);line-height:1.03;letter-spacing:-.01em;margin:0 0 6px}
@@ -68,6 +97,32 @@
   .b270-progress-actions{display:flex;flex-direction:column;align-items:flex-start;gap:7px;margin:16px 0 0}
   .b270-todaylink{margin-left:16px;font-size:12px;color:var(--muted);text-decoration:none}
   .b270-todaylink:hover{color:var(--gold);text-decoration:underline}
+  .b270-recovery{margin-top:16px;padding:14px 16px;border:1px solid var(--line-soft);border-radius:10px;background:rgba(165,129,44,.06)}
+  .b270-recovery-heading{margin:0;font-family:"Spectral",serif;font-size:17px;font-weight:600}
+  .b270-recovery-copy{margin:4px 0 0;color:var(--muted);font-size:13px;line-height:1.45}
+  .b270-recovery-actions{margin-top:12px}
+  .b270-recovery-actions .b270-todaylink{margin-left:0}
+  .b270-restart-form{margin:0}
+  .b270-recovery-actions .b270-linkbtn{margin:2px 0 0;color:var(--muted)}
+  .b270-next-steps>.b270-subhead{margin-bottom:2px}
+  .b270-next-section{padding-top:15px;margin-top:15px;border-top:1px solid var(--line-soft)}
+  .b270-next-section h3{margin:0 0 9px;font-size:13px;letter-spacing:.08em;text-transform:uppercase;color:var(--muted)}
+  .b270-task-list{list-style:none;margin:0;padding:0;display:grid;gap:8px}
+  .b270-task{display:flex;align-items:center;justify-content:space-between;gap:14px;padding:10px 12px;border:1px solid var(--line-soft);border-radius:9px;background:rgba(255,255,255,.35)}
+  .b270-task-body{display:grid;gap:3px;min-width:0}
+  .b270-task-body strong{font-size:14px}
+  .b270-task-body span{color:var(--muted);font-size:12px;line-height:1.4}
+  .b270-task-body span a{color:var(--muted);text-decoration:underline;text-decoration-color:var(--line)}
+  .b270-task-body span a:hover{color:var(--gold);text-decoration-color:var(--gold)}
+  .b270 .b270-task-link{flex:none;color:var(--gold);font-size:12.5px;font-weight:600;text-decoration:none;white-space:nowrap}
+  .b270-task-link:hover{text-decoration:underline}
+  .b270-next-note{margin:0;color:var(--faint);font-size:12.5px;line-height:1.45}
+  .b270-task-list+.b270-next-note{margin-top:8px}
+  .b270-week-count{margin:0 0 7px;color:var(--muted);font-size:13px}
+  .b270-week-count strong{color:var(--ink)}
+  .b270-week-progress{display:block;width:100%;height:8px;accent-color:var(--teal)}
+  .b270-milestone{margin:0 0 3px;color:var(--muted);font-size:13px}
+  .b270-milestone strong{color:var(--ink);font-family:"Spectral",serif;font-size:17px}
   .b270-signedout{color:var(--muted);font-size:14px;margin:4px 0 0}
 
   .b270-startdate{margin-top:18px;padding-top:16px;border-top:1px solid var(--line-soft)}
@@ -91,16 +146,29 @@
   .b270-tm .val{color:var(--faint);font-variant-numeric:tabular-nums;min-width:56px;text-align:right}
 
   /* day nav */
+  .b270-day-page [hidden]{display:none!important}
+  .b270-reading-options{display:flex;justify-content:flex-end;margin:-4px 0 10px}
+  .b270-reading-options .b270-linkbtn{margin:0;color:var(--muted)}
+  .b270-reading-mode-toggle[aria-pressed="true"]{color:var(--gold);font-weight:600}
+  .b270-day-page[data-b270-reading-mode="compact"] [data-b270-compact-hide]{display:none!important}
+  .b270-day-page[data-b270-reading-mode="compact"] .b270-day-complete{justify-content:flex-end;padding:0;border:0;background:transparent;box-shadow:none}
   .b270-daynav{display:flex;align-items:center;gap:10px;margin-bottom:12px}
-  .b270 .b270-arrow{width:38px;height:38px;border-radius:10px;border:1px solid var(--line);background:var(--card);cursor:pointer;font-size:17px;color:var(--muted);display:grid;place-items:center;text-decoration:none}
+  .b270 .b270-arrow{width:38px;height:38px;padding:0;border-radius:10px;border:1px solid var(--line);background:var(--card);cursor:pointer;font:inherit;font-size:17px;line-height:1;color:var(--muted);display:grid;place-items:center;text-decoration:none}
   .b270-arrow:hover{border-color:var(--gold);color:var(--gold)}
-  .b270-arrow.disabled{opacity:.35;pointer-events:none}
+  .b270-arrow.disabled{opacity:.45;cursor:not-allowed}
   .b270-dayhead{flex:1}
   .b270-dayhead .k{display:flex;align-items:center;flex-wrap:wrap;gap:9px;font-family:"Spectral",serif;font-size:24px;font-weight:600;line-height:1}
   .b270-dayhead .date{display:flex;align-items:center;flex-wrap:wrap;gap:9px;color:var(--faint);font-size:13px;margin-top:4px}
   .b270-dayhead .b270-badge{margin-left:0}
   .b270-badge{display:inline-block;vertical-align:middle;line-height:1;font-size:10.5px;font-weight:600;letter-spacing:.1em;text-transform:uppercase;color:#fff;background:var(--gold-lite);padding:5px 8px 4px;border-radius:20px;margin-left:9px}
 
+  .b270-day-complete{display:flex;align-items:center;gap:14px;margin:0 0 14px;padding:11px 13px;
+                     border:1px solid var(--line);border-radius:10px;background:var(--card);box-shadow:var(--shadow)}
+  .b270-day-complete div{display:flex;flex-direction:column;gap:2px;min-width:0}
+  .b270-day-complete strong{font-family:"Spectral",serif;font-size:16px}
+  .b270-day-complete span{font-size:12px;color:var(--muted)}
+  .b270 .b270-day-complete .b270-btn{flex:none;margin:0 0 0 auto}
+
   /* readings */
   .b270-readings{background:var(--card);border:1px solid var(--line);border-radius:14px;box-shadow:var(--shadow);overflow:hidden}
   .b270-reading{display:flex;gap:15px;align-items:center;padding:16px 20px;border-left:4px solid transparent}
@@ -186,10 +254,11 @@
   .b270-likebtn.liked{filter:none;opacity:1}
   .b270-likecount{font-size:11.5px;color:var(--faint)}
   .b270-liketooltip{display:none;position:absolute;z-index:10;top:calc(100% + 6px);left:0;
-                    min-width:max-content;padding:6px 9px;border:1px solid var(--line-soft);
+                    min-width:max-content;max-width:calc(100vw - 28px);padding:6px 9px;border:1px solid var(--line-soft);
                     border-radius:7px;background:var(--ink);color:var(--paper);font-size:12px;
                     line-height:1.45;box-shadow:0 3px 10px rgba(0,0,0,.14)}
-  .b270-likes:hover .b270-liketooltip,.b270-likes:focus-within .b270-liketooltip{display:block}
+  .b270-likes:hover .b270-liketooltip,.b270-likes:focus-within .b270-liketooltip,
+  .b270-likes:active .b270-liketooltip{display:block}
   .b270-liker{display:block;white-space:nowrap}
   .b270-creply{margin-top:6px}
   .b270-cbody{margin:3px 0 0;white-space:pre-wrap}
@@ -204,7 +273,9 @@
   .b270-cdel{font-size:12px;color:var(--oxblood);background:none;border:none;cursor:pointer;padding:0;margin-left:8px}
   .b270-input{width:100%;padding:9px 11px;border:1px solid var(--line);border-radius:9px;background:#fff;font:inherit;font-size:14px;margin-bottom:8px}
   .b270-form textarea{width:100%;font:inherit;font-size:15px;border:1px solid var(--line);border-radius:10px;padding:11px 13px;background:#fff;resize:vertical;min-height:76px}
+  .b270-draft-status{min-height:16px;margin:4px 0 -4px;font-size:11.5px;color:var(--faint)}
   .b270-form .row{display:flex;align-items:center;gap:10px;margin-top:10px}
+  .b270-form .row select{max-width:100%}
   .b270 .b270-btn{border:none;border-radius:10px;padding:8px 16px;margin-top:4px;font:inherit;font-weight:600;font-size:14px;cursor:pointer;background:var(--ink);color:var(--paper);text-decoration:none;display:inline-block}
   .b270-btn:hover{background:#3a352b}
 
@@ -216,7 +287,7 @@
   .b270-li .sub{font-size:12.5px;color:var(--faint)}
   .b270-li .stat{margin-left:auto;text-align:right}
   .b270-li .stat .big{font-family:"Spectral",serif;font-size:20px;font-weight:600}
-  .b270-li .rank{width:26px;color:var(--faint);font-variant-numeric:tabular-nums;text-align:center}
+  .b270-community-intro{margin:-8px 0 12px;color:var(--muted);font-size:13px}
 
   /* calendar grid */
   .b270-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(30px,1fr));gap:6px;margin-top:16px}
@@ -234,8 +305,18 @@
 
   /* On the Reflections page each thread carries the day it belongs to, since
      there is no day heading above it. */
+  .b270-reflection-tools{display:flex;align-items:flex-end;justify-content:space-between;gap:18px;margin:30px 0 14px}
+  .b270-reflection-tools .b270-section-h{margin:0}
+  .b270-reflection-count{margin:3px 0 0;font-size:12px;color:var(--faint)}
+  .b270-reflection-filters{display:flex;align-items:flex-end;justify-content:flex-end;gap:8px;flex-wrap:wrap}
+  .b270-reflection-filters label{display:grid;gap:3px;font-size:11.5px;color:var(--muted)}
+  .b270-reflection-filters select{min-width:112px;max-width:180px;padding:7px 25px 7px 9px;border:1px solid var(--line);border-radius:8px;background:#fff;color:var(--ink);font:inherit;font-size:12.5px}
+  .b270 .b270-reflection-filters .b270-btn{margin:0;padding:8px 13px;font-size:12.5px}
+  .b270 .b270-filter-clear{align-self:center;font-size:12px;color:var(--muted)}
   .b270-thread{margin-bottom:8px}
+  .b270-thread-new{border-left:3px solid var(--gold);padding-left:10px}
   .b270-threadday{margin:0;font-size:12px;letter-spacing:.04em;color:var(--faint)}
+  .b270-new-reflection{display:inline-block;margin-left:7px;padding:3px 6px 2px;border-radius:10px;background:rgba(128,99,29,.12);color:var(--gold);font-size:10px;font-weight:600;letter-spacing:.04em;text-transform:uppercase}
   .b270-threadday a{color:var(--gold);font-weight:600;text-decoration:none}
   .b270-threadday a:hover{text-decoration:underline}
   /* Scripture references stay undecorated, hover included, so a line of three of
@@ -244,6 +325,12 @@
   .b270-threadday .b270-reflink:hover{color:var(--muted);font-weight:400;text-decoration:none}
   .b270-threadday .b270-reflink:hover{color:var(--ink)}
   .b270-gridnote{margin:10px 0 0;font-size:11.5px;color:var(--faint)}
+  .b270-pagination{display:grid;grid-template-columns:1fr auto 1fr;align-items:center;gap:12px;margin:20px 0;color:var(--faint);font-size:12.5px}
+  .b270-pagination a{color:var(--gold);font-weight:600;text-decoration:none}
+  .b270-pagination a:last-child{justify-self:end}
+  .b270-pagination span{grid-column:2;text-align:center}
+  .b270-filter-empty{margin-top:12px}
+  .b270-filter-empty p{margin:0 0 8px;color:var(--muted)}
 
   .b270-footer{margin-top:20px;padding-top:11px;border-top:1px solid var(--line-soft);color:var(--faint);font-size:13px}
   .b270-footer p{margin:0;line-height:1.5}
@@ -275,5 +362,24 @@
     .b270-navlinks a:hover,.b270-nav .b270-linkbtn:hover{background:var(--paper)}
     .b270-nav form{display:block;width:100%}
   }
-  @media (max-width:480px){ .b270-tm{grid-template-columns:104px 1fr auto} .b270-reading{padding:14px 15px;gap:12px} .b270-reading.multi .b270-cat,.b270-reading.multi .b270-parts-meta{margin-left:38px} .b270-part{gap:12px} }
+  @media (max-width:480px){
+    .b270-tm{grid-template-columns:104px 1fr auto}
+    .b270-avatarrow{align-items:flex-start;flex-wrap:wrap}
+    .b270-form .row{align-items:stretch;flex-direction:column}
+    .b270-form .row select{width:100%}
+    .b270-form .row .b270-btn{align-self:flex-start}
+    .b270-reading{padding:14px 15px;gap:12px}
+    .b270-reading.multi .b270-cat,.b270-reading.multi .b270-parts-meta{margin-left:38px}
+    .b270-part{gap:12px}
+    .b270-task{align-items:flex-start;flex-direction:column;gap:7px}
+    .b270-day-complete{align-items:flex-start;flex-direction:column}
+    .b270-reflection-tools{align-items:stretch;flex-direction:column;gap:10px}
+    .b270-reflection-filters{align-items:stretch;justify-content:flex-start}
+    .b270-reflection-filters label{flex:1;min-width:120px}
+    .b270-reflection-filters select{width:100%;max-width:none}
+    .b270 .b270-day-complete .b270-btn{margin:3px 0 0}
+  }
+  @media (prefers-reduced-motion:reduce){
+    .b270 *,.b270 *::before,.b270 *::after{scroll-behavior:auto!important;transition-duration:.01ms!important;animation-duration:.01ms!important;animation-iteration-count:1!important}
+  }
 </style>

data/config/routes.rb

@@ -45,12 +45,13 @@ Bible270::Engine.routes.draw do
   get 'community', to: 'readers#index', as: :community
   get 'readers/:id', to: 'readers#show', as: :reader
 
-  patch  'start-date', to: 'readers#update_start_date', as: :start_date
-  delete 'start-date', to: 'readers#clear_start_date',  as: :clear_start_date
+  patch  'start-date',       to: 'readers#update_start_date', as: :start_date
+  delete 'start-date',       to: 'readers#clear_start_date',  as: :clear_start_date
+  patch  'schedule/restart', to: 'readers#restart_schedule',  as: :restart_schedule
 
   # Built-in OmniAuth sign-in. The request phase (POST <mount>/auth/:provider)
   # is handled by the OmniAuth middleware in the host app, not by these routes.
-  get    'sign_in',                 to: 'sessions#new',     as: :sign_in
+  get    'sign_in',                 to: 'sessions#new', as: :sign_in
 
   # Email (magic link) sign-in, for readers without a social account.
   post   'sign_in/email',           to: 'sessions#email_link',     as: :email_sign_in_link

data/db/migrate/20260101000016_add_daily_reminders_to_bible270_readers.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+class AddDailyRemindersToBible270Readers < ActiveRecord::Migration[7.0]
+  def change
+    add_column :bible270_readers, :daily_reminders, :boolean, default: false, null: false
+    add_column :bible270_readers, :daily_reminder_time, :string, default: '08:00', null: false
+    add_column :bible270_readers, :last_daily_reminder_sent_on, :date
+  end
+end

data/db/migrate/20260101000017_add_reflections_seen_at_to_bible270_readers.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+class AddReflectionsSeenAtToBible270Readers < ActiveRecord::Migration[7.0]
+  def change
+    add_column :bible270_readers, :reflections_seen_at, :datetime
+  end
+end

data/lib/bible270/configuration.rb

@@ -234,6 +234,7 @@ module Bible270
     attr_accessor :email_sign_in_deliver_later
 
     def email_sign_in? = !!@email_sign_in
+    def daily_reminders? = !!@daily_reminders
 
     # Reserved domains from RFC 2606 — a From: address at one of these will fail
     # SPF for your real domain, and receiving servers routinely drop it without
@@ -241,9 +242,9 @@ module Bible270
     # changed, but nothing was checking that it had been.
     PLACEHOLDER_DOMAINS = %w[example.com example.org example.net example.edu invalid localhost].freeze
 
-    # Why the sign-in mail is likely to vanish, or nil if it looks fine.
+    # Why reader-facing mail is likely to vanish, or nil if it looks fine.
     def mailer_from_problem
-      return nil unless email_sign_in?
+      return nil unless email_sign_in? || daily_reminders?
 
       address = mailer_from.to_s.strip
       return 'config.mailer_from is blank' if address.empty?
@@ -292,6 +293,10 @@ module Bible270
     # from, so without this the notice names the reader but cannot link to them.
     attr_accessor :mailer_host
 
+    # Allow readers to opt in to a daily email with that date's readings. The host
+    # application owns scheduling the bible270:reminders:send task.
+    attr_accessor :daily_reminders
+
     attr_accessor :after_sign_out_path, :email_sign_in_max_per_window, :passage_url_builder, :tagline, :footer_html, :footer, :favicon, :avatar_max_bytes, :chapter_breaks, :admin_emails, :admin_resolver, :bible_version, :header_mark, :remember_for, :require_sign_in_to_participate, :mention_notifications
 
     # Public labels.
@@ -331,8 +336,8 @@ module Bible270
 
     # Email a reader when someone writes "@them" in a reflection. Readers can opt
     # out individually on their profile; this switches the whole feature off.
-    # How many recent threads the Reflections page shows. A thread resurfaces when
-    # someone replies to it, so this is a count of conversations, not of messages.
+    # How many threads each Reflections page shows. A thread resurfaces when someone
+    # replies to it, so this is a count of conversations, not of messages.
     attr_accessor :reflections_page_size
 
     def remember_signed_in?
@@ -381,6 +386,7 @@ module Bible270
       @registration_notice_emails = []
       @registration_notice_deliver_later = false
       @mailer_host = nil
+      @daily_reminders = false
       @admin_emails = []
       @admin_resolver = nil
       @email_sign_in_deliver_later = false

data/lib/bible270/daily_reminders.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'date'
+require 'bible270/plan'
+
+module Bible270
+  # Delivers one reminder for each reader whose dated plan has an unfinished
+  # reading and whose chosen local reminder time has arrived. Scheduling belongs
+  # to the host application; repeated runs on the same local date are safe.
+  module DailyReminders
+  module_function
+
+    def deliver(at: Time.now)
+      return 0 unless Bible270.config.daily_reminders?
+
+      unless Reader.daily_reminder_columns?
+        Rails.logger.error(
+          '[bible270] daily reminders unavailable: run bible270:install:migrations and db:migrate'
+        )
+        return 0
+      end
+
+      local_time = local_time_for(at)
+      return 0 unless local_time.respond_to?(:to_date)
+
+      date = local_time.to_date
+      sent = 0
+      Reader.daily_reminder_recipients(on: date).find_each do |reader|
+        next unless reader.daily_reminder_due_at?(local_time)
+
+        day = Plan.day_for(date, reader.effective_start_date, clamp: false)
+        next unless Plan.valid_day?(day)
+        next if reader.day_complete?(day)
+
+        delivery = NoticeMailer.daily_reminder(reader_id: reader.id, day: day, on: date)
+        next unless delivery.message.perform_deliveries
+
+        delivery.deliver_now
+        reader.update_column(:last_daily_reminder_sent_on, date)
+        sent += 1
+      rescue StandardError => e
+        Rails.logger.error(
+          "[bible270] daily reminder for reader #{reader.id} failed: #{e.class}: #{e.message}"
+        )
+      end
+      sent
+    end
+
+    def local_time_for(at)
+      return nil if at.nil?
+
+      Bible270.local_time(at)
+    rescue StandardError
+      nil
+    end
+  end
+end

data/lib/bible270/migration_reconciler.rb

@@ -25,6 +25,8 @@ module Bible270
       'CreateBible270Likes' => :check_likes,
       'AddBlueLetterBibleToBible270Readers' => :check_blue_letter_bible,
       'AddPassageSourceToBible270Readers' => :check_passage_source,
+      'AddDailyRemindersToBible270Readers' => :check_daily_reminders,
+      'AddReflectionsSeenAtToBible270Readers' => :check_reflections_seen_at,
       'CreateActiveStorageTables' => :check_active_storage
     }.freeze
 
@@ -177,6 +179,17 @@ module Bible270
       table_missing(:bible270_readers, columns: %i[passage_source])
     end
 
+    def check_daily_reminders
+      table_missing(
+        :bible270_readers,
+        columns: %i[daily_reminders daily_reminder_time last_daily_reminder_sent_on]
+      )
+    end
+
+    def check_reflections_seen_at
+      table_missing(:bible270_readers, columns: %i[reflections_seen_at])
+    end
+
     # The Bible270 installer can install Active Storage for reader avatars. A
     # copied database can therefore have the same timestamp mismatch for Rails'
     # generated Active Storage migration as it has for the engine migrations.

data/lib/bible270/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Bible270
-  VERSION = '0.19.0'
+  VERSION = '1.0.0'
 end

data/lib/bible270.rb

@@ -11,6 +11,7 @@ require 'bible270/avatars'
 require 'bible270/translations'
 require 'bible270/favicon'
 require 'bible270/configuration'
+require 'bible270/daily_reminders'
 require 'bible270/engine' if defined?(Rails::Engine)
 
 module Bible270

data/lib/generators/bible270/install/install_generator.rb

@@ -512,6 +512,12 @@ module Bible270
             # config.start_date = Date.new(#{Date.today.year}, 1, 1)
             config.allow_reader_start_date = true
 
+            # --- Daily reading reminders -----------------------------------------------
+            # Readers choose an opt-in time only when enabled. This application owns
+            # scheduling: run `bin/rails bible270:reminders:send` every 15 minutes.
+            config.daily_reminders = false
+            # config.mailer_host = 'example.com' # links back to the day and profile
+
             # --- Reading links --------------------------------------------------------
             config.bible_version = 'NKJV'
           end

data/lib/generators/bible270/install/templates/bible270.rb.tt

@@ -55,6 +55,12 @@ Bible270.configure do |config|
   # config.start_date = Date.new(2026, 9, 6)
   config.allow_reader_start_date = true
 
+  # --- Daily reading reminders -----------------------------------------------
+  # Readers choose an opt-in time on their profile only when this is enabled.
+  # The host app owns scheduling: run `bin/rails bible270:reminders:send` every 15 minutes.
+  config.daily_reminders = false
+  # config.mailer_host = "example.com"       # required for day/profile links in email
+
   # --- Reading links ---------------------------------------------------------
   config.bible_version = "NKJV"
 

data/lib/tasks/bible270_reminders.rake

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'bible270/daily_reminders'
+
+namespace :bible270 do
+  namespace :reminders do
+    desc 'Send Bible270 reminders now due at each opted-in reader time'
+    task send: :environment do
+      count = Bible270::DailyReminders.deliver
+      puts "Sent #{count} daily reading #{'reminder'.pluralize(count)}."
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bible270
 version: !ruby/object:Gem::Version
-  version: 0.19.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Andrew vonderLuft
@@ -115,6 +115,8 @@ files:
 - app/views/bible270/comments/edit.turbo_stream.erb
 - app/views/bible270/comments/index.html.erb
 - app/views/bible270/comments/update.turbo_stream.erb
+- app/views/bible270/days/_completers.html.erb
+- app/views/bible270/days/_day_progress.html.erb
 - app/views/bible270/days/_reading.html.erb
 - app/views/bible270/days/_start_date.html.erb
 - app/views/bible270/days/index.html.erb
@@ -123,22 +125,29 @@ files:
 - app/views/bible270/likes/toggle.turbo_stream.erb
 - app/views/bible270/notice_mailer/broadcast.html.erb
 - app/views/bible270/notice_mailer/broadcast.text.erb
+- app/views/bible270/notice_mailer/daily_reminder.html.erb
+- app/views/bible270/notice_mailer/daily_reminder.text.erb
 - app/views/bible270/notice_mailer/mentioned.html.erb
 - app/views/bible270/notice_mailer/mentioned.text.erb
 - app/views/bible270/notice_mailer/new_reader.html.erb
 - app/views/bible270/notice_mailer/new_reader.text.erb
 - app/views/bible270/profiles/edit.html.erb
+- app/views/bible270/readers/_next_steps.html.erb
 - app/views/bible270/readers/index.html.erb
 - app/views/bible270/readers/progress.html.erb
 - app/views/bible270/readers/show.html.erb
 - app/views/bible270/sessions/new.html.erb
+- app/views/bible270/shared/_comment_drafts.html.erb
 - app/views/bible270/shared/_day_index.html.erb
 - app/views/bible270/shared/_footer.html.erb
 - app/views/bible270/shared/_grid_legend.html.erb
 - app/views/bible270/shared/_header.html.erb
+- app/views/bible270/shared/_interaction_status.html.erb
+- app/views/bible270/shared/_interaction_ui.html.erb
 - app/views/bible270/shared/_nav_links.html.erb
 - app/views/bible270/shared/_passage_source.html.erb
 - app/views/bible270/shared/_progress.html.erb
+- app/views/bible270/shared/_reading_mode.html.erb
 - app/views/bible270/shared/_reflections.html.erb
 - app/views/bible270/shared/_styles.html.erb
 - app/views/bible270/shared/_track_bars.html.erb
@@ -161,9 +170,12 @@ files:
 - db/migrate/20260101000013_create_bible270_likes.rb
 - db/migrate/20260101000014_add_blue_letter_bible_to_bible270_readers.rb
 - db/migrate/20260101000015_add_passage_source_to_bible270_readers.rb
+- db/migrate/20260101000016_add_daily_reminders_to_bible270_readers.rb
+- db/migrate/20260101000017_add_reflections_seen_at_to_bible270_readers.rb
 - lib/bible270.rb
 - lib/bible270/avatars.rb
 - lib/bible270/configuration.rb
+- lib/bible270/daily_reminders.rb
 - lib/bible270/email_sign_in.rb
 - lib/bible270/engine.rb
 - lib/bible270/favicon.rb
@@ -178,6 +190,7 @@ files:
 - lib/generators/bible270/install/templates/bible270.rb.tt
 - lib/generators/bible270/install/templates/omniauth.rb.tt
 - lib/tasks/bible270_migrations.rake
+- lib/tasks/bible270_reminders.rake
 homepage: https://github.com/avonderluft/bible270
 licenses:
 - MIT