From 34da76607ff326856c314db801af2720cc727eb8 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 11:23:41 +0300
Subject: [PATCH 01/11] add app.css with reset and design tokens

introduce a single shared stylesheet under public/css. this first
section covers a minimal reset, warm/readable design tokens (color,
typography, spacing, radii, shadows), and base element styling for
headings, links, lists, forms, and buttons. layout primitives and
component classes follow in subsequent commits.
---
 public/css/app.css | 218 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 218 insertions(+)
 create mode 100644 public/css/app.css

diff --git a/public/css/app.css b/public/css/app.css
new file mode 100644
index 0000000..bc9ec31
--- /dev/null
+++ b/public/css/app.css
@@ -0,0 +1,218 @@
+/* =========================================================================
+   Daily Goals - app.css
+   Single shared stylesheet. Sectioned for readability.
+   ========================================================================= */
+
+/* -------------------------------------------------------------------------
+   1. Reset
+   ------------------------------------------------------------------------- */
+
+*,
+*::before,
+*::after {
+    box-sizing: border-box;
+}
+
+html,
+body {
+    margin: 0;
+    padding: 0;
+}
+
+img,
+svg {
+    display: block;
+    max-width: 100%;
+}
+
+button {
+    font: inherit;
+    color: inherit;
+    cursor: pointer;
+}
+
+input,
+textarea,
+select {
+    font: inherit;
+    color: inherit;
+}
+
+/* -------------------------------------------------------------------------
+   2. Design tokens
+   ------------------------------------------------------------------------- */
+
+:root {
+    /* Color: warm, readable palette */
+    --color-bg: #faf7f2;
+    --color-surface: #ffffff;
+    --color-surface-alt: #f3ede2;
+    --color-text: #2b2622;
+    --color-text-muted: #6b5d52;
+    --color-primary: #5a7a4f;
+    --color-primary-hover: #486340;
+    --color-accent: #8a5a3b;
+    --color-accent-hover: #6f4730;
+    --color-border: #e3dccf;
+    --color-border-strong: #c9bfae;
+    --color-danger: #a94442;
+    --color-success: #4f7a5a;
+
+    /* Typography */
+    --font-serif: Georgia, "Iowan Old Style", "Source Serif Pro", serif;
+    --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui,
+        sans-serif;
+    --font-size-base: 1rem;
+    --font-size-sm: 0.875rem;
+    --font-size-lg: 1.125rem;
+    --font-size-h1: 2rem;
+    --font-size-h2: 1.5rem;
+    --font-size-h3: 1.25rem;
+    --line-height-base: 1.6;
+    --line-height-tight: 1.25;
+
+    /* Spacing scale */
+    --space-1: 0.25rem;
+    --space-2: 0.5rem;
+    --space-3: 0.75rem;
+    --space-4: 1rem;
+    --space-5: 1.5rem;
+    --space-6: 2rem;
+    --space-7: 3rem;
+
+    /* Layout */
+    --max-width: 42rem;
+    --max-width-wide: 60rem;
+
+    /* Radii */
+    --radius-sm: 4px;
+    --radius-md: 8px;
+    --radius-lg: 12px;
+
+    /* Shadows */
+    --shadow-sm: 0 1px 2px rgba(43, 38, 34, 0.06);
+    --shadow-md: 0 4px 12px rgba(43, 38, 34, 0.1);
+    --shadow-lg: 0 12px 32px rgba(43, 38, 34, 0.18);
+
+    /* Transitions */
+    --transition-fast: 120ms ease;
+    --transition-base: 200ms ease;
+}
+
+/* -------------------------------------------------------------------------
+   3. Base elements
+   ------------------------------------------------------------------------- */
+
+body {
+    background-color: var(--color-bg);
+    color: var(--color-text);
+    font-family: var(--font-sans);
+    font-size: var(--font-size-base);
+    line-height: var(--line-height-base);
+    -webkit-font-smoothing: antialiased;
+    text-rendering: optimizeLegibility;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+    font-family: var(--font-serif);
+    font-weight: 600;
+    line-height: var(--line-height-tight);
+    margin: 0;
+    color: var(--color-text);
+}
+
+h1 {
+    font-size: var(--font-size-h1);
+}
+
+h2 {
+    font-size: var(--font-size-h2);
+}
+
+h3 {
+    font-size: var(--font-size-h3);
+}
+
+p {
+    margin: 0;
+}
+
+a {
+    color: var(--color-accent);
+    text-decoration: none;
+    transition: color var(--transition-fast);
+}
+
+a:hover,
+a:focus {
+    color: var(--color-accent-hover);
+    text-decoration: underline;
+}
+
+ul,
+ol {
+    margin: 0;
+    padding: 0;
+    list-style: none;
+}
+
+label {
+    display: block;
+    font-size: var(--font-size-sm);
+    color: var(--color-text-muted);
+    font-weight: 500;
+}
+
+input[type="text"],
+input[type="email"],
+input[type="password"],
+input[type="date"],
+input[type="number"],
+textarea,
+select {
+    display: block;
+    width: 100%;
+    margin-top: var(--space-1);
+    padding: var(--space-2) var(--space-3);
+    background-color: var(--color-surface);
+    color: var(--color-text);
+    border: 1px solid var(--color-border-strong);
+    border-radius: var(--radius-sm);
+    transition: border-color var(--transition-fast),
+        box-shadow var(--transition-fast);
+}
+
+input:focus,
+textarea:focus,
+select:focus {
+    outline: none;
+    border-color: var(--color-primary);
+    box-shadow: 0 0 0 3px rgba(90, 122, 79, 0.15);
+}
+
+button {
+    display: inline-block;
+    padding: var(--space-2) var(--space-4);
+    background-color: var(--color-surface);
+    color: var(--color-text);
+    border: 1px solid var(--color-border-strong);
+    border-radius: var(--radius-sm);
+    font-weight: 500;
+    transition: background-color var(--transition-fast),
+        border-color var(--transition-fast), color var(--transition-fast);
+}
+
+button:hover,
+button:focus {
+    background-color: var(--color-surface-alt);
+    border-color: var(--color-text-muted);
+}
+
+form {
+    margin: 0;
+}

From d4a8adc4a4411ca8e659be0dee9f9833a236369b Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 11:24:30 +0300
Subject: [PATCH 02/11] link app.css and add viewport meta in templates

add a stylesheet link and the standard responsive viewport meta tag
to every page template. purely additive - no markup or selector
changes - so existing cypress assertions and page js id hooks remain
intact. with this commit every page picks up the base styling from
app.css.
---
 views/templates/admin.php     | 3 +++
 views/templates/forbidden.php | 3 +++
 views/templates/home.php      | 3 +++
 views/templates/login.php     | 3 +++
 views/templates/register.php  | 3 +++
 views/templates/text.php      | 3 +++
 views/templates/texts.php     | 3 +++
 views/templates/today.php     | 3 +++
 8 files changed, 24 insertions(+)

diff --git a/views/templates/admin.php b/views/templates/admin.php
index f1fc83d..59be004 100644
--- a/views/templates/admin.php
+++ b/views/templates/admin.php
@@ -1,7 +1,10 @@
 <!DOCTYPE html>
 <html>
 <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Daily Goals - Admin</title>
+    <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
     <button id="logout">Logout</button>
diff --git a/views/templates/forbidden.php b/views/templates/forbidden.php
index 43cd644..334edac 100644
--- a/views/templates/forbidden.php
+++ b/views/templates/forbidden.php
@@ -1,7 +1,10 @@
 <!DOCTYPE html>
 <html>
 <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Daily Goals - Forbidden</title>
+    <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
     <h1>403 Forbidden</h1>
diff --git a/views/templates/home.php b/views/templates/home.php
index 258a404..837e0a6 100644
--- a/views/templates/home.php
+++ b/views/templates/home.php
@@ -1,7 +1,10 @@
 <!DOCTYPE html>
 <html>
 <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Daily Goals - Home</title>
+    <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
     <h1>Home</h1>
diff --git a/views/templates/login.php b/views/templates/login.php
index 93f4b56..7fa70fc 100644
--- a/views/templates/login.php
+++ b/views/templates/login.php
@@ -1,7 +1,10 @@
 <!DOCTYPE html>
 <html>
 <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Daily Goals - Login</title>
+    <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
     <h1>Login</h1>
diff --git a/views/templates/register.php b/views/templates/register.php
index 223247c..47cea7a 100644
--- a/views/templates/register.php
+++ b/views/templates/register.php
@@ -1,7 +1,10 @@
 <!DOCTYPE html>
 <html>
 <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Daily Goals - Register</title>
+    <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
     <h1>Register</h1>
diff --git a/views/templates/text.php b/views/templates/text.php
index 8f68729..477ec12 100644
--- a/views/templates/text.php
+++ b/views/templates/text.php
@@ -1,7 +1,10 @@
 <!DOCTYPE html>
 <html>
 <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Daily Goals - Text</title>
+    <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
     <a href="/admin/texts" id="back">Back to Texts</a>
diff --git a/views/templates/texts.php b/views/templates/texts.php
index f8e8d7d..a56b5d2 100644
--- a/views/templates/texts.php
+++ b/views/templates/texts.php
@@ -1,7 +1,10 @@
 <!DOCTYPE html>
 <html>
 <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Daily Goals - Texts</title>
+    <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
     <h1>Texts</h1>
diff --git a/views/templates/today.php b/views/templates/today.php
index 6edba97..e76d875 100644
--- a/views/templates/today.php
+++ b/views/templates/today.php
@@ -1,7 +1,10 @@
 <!DOCTYPE html>
 <html>
 <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Daily Goals - Today</title>
+    <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
     <h1>Today</h1>

From b259a1243e8e05d36e81e78b1ed15eac52db8d3c Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 11:24:58 +0300
Subject: [PATCH 03/11] add layout primitives and components to app.css

extend app.css with the every-layout style primitives (container,
stack, cluster, center) used to compose page shells, plus a small
component layer: site-header, btn (primary/secondary/danger), card
and card-link, list-cards, modal, error and a few utility classes.
no template changes here - templates start adopting these classes
in the per-page styling commits that follow.
---
 public/css/app.css | 200 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 200 insertions(+)

diff --git a/public/css/app.css b/public/css/app.css
index bc9ec31..519c7ec 100644
--- a/public/css/app.css
+++ b/public/css/app.css
@@ -216,3 +216,203 @@ button:focus {
 form {
     margin: 0;
 }
+
+/* -------------------------------------------------------------------------
+   4. Layout primitives
+   ------------------------------------------------------------------------- */
+
+.container {
+    width: 100%;
+    max-width: var(--max-width);
+    margin-inline: auto;
+    padding: var(--space-5) var(--space-4);
+}
+
+.container-wide {
+    max-width: var(--max-width-wide);
+}
+
+.stack > * + * {
+    margin-top: var(--space-4);
+}
+
+.stack-sm > * + * {
+    margin-top: var(--space-2);
+}
+
+.stack-lg > * + * {
+    margin-top: var(--space-6);
+}
+
+.cluster {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--space-3);
+}
+
+.cluster-end {
+    justify-content: flex-end;
+}
+
+.cluster-between {
+    justify-content: space-between;
+}
+
+.center {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+}
+
+/* -------------------------------------------------------------------------
+   5. Components
+   ------------------------------------------------------------------------- */
+
+.site-header {
+    border-bottom: 1px solid var(--color-border);
+    padding: var(--space-3) var(--space-4);
+    background-color: var(--color-surface);
+}
+
+.site-header .site-header-inner {
+    width: 100%;
+    max-width: var(--max-width);
+    margin-inline: auto;
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--space-3);
+}
+
+.btn {
+    display: inline-block;
+    padding: var(--space-2) var(--space-4);
+    border-radius: var(--radius-sm);
+    border: 1px solid var(--color-border-strong);
+    background-color: var(--color-surface);
+    color: var(--color-text);
+    font-weight: 500;
+    text-decoration: none;
+    transition: background-color var(--transition-fast),
+        border-color var(--transition-fast), color var(--transition-fast);
+}
+
+.btn:hover,
+.btn:focus {
+    background-color: var(--color-surface-alt);
+    border-color: var(--color-text-muted);
+    text-decoration: none;
+}
+
+.btn-primary {
+    background-color: var(--color-primary);
+    border-color: var(--color-primary);
+    color: #ffffff;
+}
+
+.btn-primary:hover,
+.btn-primary:focus {
+    background-color: var(--color-primary-hover);
+    border-color: var(--color-primary-hover);
+    color: #ffffff;
+}
+
+.btn-secondary {
+    background-color: transparent;
+    border-color: var(--color-border-strong);
+    color: var(--color-text);
+}
+
+.btn-danger {
+    background-color: transparent;
+    border-color: var(--color-danger);
+    color: var(--color-danger);
+}
+
+.btn-danger:hover,
+.btn-danger:focus {
+    background-color: var(--color-danger);
+    color: #ffffff;
+}
+
+.card {
+    background-color: var(--color-surface);
+    border: 1px solid var(--color-border);
+    border-radius: var(--radius-md);
+    padding: var(--space-4);
+    box-shadow: var(--shadow-sm);
+}
+
+.card-link {
+    display: block;
+    color: inherit;
+    text-decoration: none;
+    transition: border-color var(--transition-fast),
+        box-shadow var(--transition-fast),
+        transform var(--transition-fast);
+}
+
+.card-link:hover,
+.card-link:focus {
+    border-color: var(--color-border-strong);
+    box-shadow: var(--shadow-md);
+    text-decoration: none;
+}
+
+.list-cards {
+    display: flex;
+    flex-direction: column;
+    gap: var(--space-3);
+}
+
+.modal {
+    position: fixed;
+    inset: 0;
+    z-index: 50;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    padding: var(--space-4);
+    background-color: rgba(43, 38, 34, 0.45);
+}
+
+.modal[hidden] {
+    display: none;
+}
+
+.modal-content {
+    width: 100%;
+    max-width: 28rem;
+    background-color: var(--color-surface);
+    border: 1px solid var(--color-border);
+    border-radius: var(--radius-md);
+    box-shadow: var(--shadow-lg);
+    padding: var(--space-5);
+}
+
+.error {
+    color: var(--color-danger);
+    font-size: var(--font-size-sm);
+}
+
+.muted {
+    color: var(--color-text-muted);
+}
+
+/* -------------------------------------------------------------------------
+   6. Utilities
+   ------------------------------------------------------------------------- */
+
+.full-width {
+    width: 100%;
+}
+
+.text-center {
+    text-align: center;
+}
+
+[hidden] {
+    display: none !important;
+}

From 807458ebe8a1e848f953fb37974a17ebc378fd8e Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 11:25:45 +0300
Subject: [PATCH 04/11] style home page with shell and card list

apply the new design system to the home page: wrap content in a
container/stack shell with a site-header for the logout and today
links, render the texts list as a vertical stack of cards via the
list-cards primitive, and dress the create plan modal with the new
modal/btn classes. js renders each text as an li.card with the
create-plan button preserved so existing cypress hooks (li,
.create-plan, .plan-name, .save-plan, .cancel-plan, ids) keep
matching.
---
 public/js/home.js        |  8 ++++---
 views/templates/home.php | 49 +++++++++++++++++++++++++---------------
 2 files changed, 36 insertions(+), 21 deletions(-)

diff --git a/public/js/home.js b/public/js/home.js
index e7abc7c..ecf8268 100644
--- a/public/js/home.js
+++ b/public/js/home.js
@@ -9,9 +9,11 @@ document.addEventListener('DOMContentLoaded', () => {
         const texts = await response.json();
         textsList.innerHTML = texts
             .map(text =>
-                '<li>' + text.name +
-                ' <button class="create-plan" data-text-id="' +
-                text.id + '">Create plan</button></li>'
+                '<li class="card cluster cluster-between">' +
+                '<span class="text-name">' + text.name + '</span>' +
+                '<button class="create-plan btn btn-primary"' +
+                ' data-text-id="' + text.id + '">Create plan</button>' +
+                '</li>'
             )
             .join('');
     }
diff --git a/views/templates/home.php b/views/templates/home.php
index 837e0a6..97d3aa7 100644
--- a/views/templates/home.php
+++ b/views/templates/home.php
@@ -7,24 +7,37 @@
     <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
-    <h1>Home</h1>
-    <button id="logout">Logout</button>
-    <a href="/today">Today's schedule</a>
-    <ul id="texts-list">
-    </ul>
-    <div id="create-plan-modal" hidden>
-        <h2>Create plan</h2>
-        <label>Name
-            <input class="plan-name" type="text" />
-        </label>
-        <label>Start date
-            <input class="plan-date-start" type="date" />
-        </label>
-        <label>End date
-            <input class="plan-date-end" type="date" />
-        </label>
-        <button class="save-plan">Save</button>
-        <button class="cancel-plan">Cancel</button>
+    <header class="site-header">
+        <div class="site-header-inner">
+            <h1>Home</h1>
+            <div class="cluster">
+                <a class="btn btn-secondary" href="/today">
+                    Today's schedule
+                </a>
+                <button id="logout" class="btn btn-danger">Logout</button>
+            </div>
+        </div>
+    </header>
+    <main class="container stack-lg">
+        <ul id="texts-list" class="list-cards"></ul>
+    </main>
+    <div id="create-plan-modal" class="modal" hidden>
+        <div class="modal-content stack">
+            <h2>Create plan</h2>
+            <label>Name
+                <input class="plan-name" type="text" />
+            </label>
+            <label>Start date
+                <input class="plan-date-start" type="date" />
+            </label>
+            <label>End date
+                <input class="plan-date-end" type="date" />
+            </label>
+            <div class="cluster cluster-end">
+                <button class="cancel-plan btn btn-secondary">Cancel</button>
+                <button class="save-plan btn btn-primary">Save</button>
+            </div>
+        </div>
     </div>
     <script src="/js/auth.js"></script>
     <script src="/js/home.js"></script>

From 2349e69c4fb55fab330ec5d794a35f6423152023 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 11:31:55 +0300
Subject: [PATCH 05/11] style today page with shell and card list

wrap the today page in the shared header + container/stack shell,
render scheduled nodes as cards via list-cards, and add a muted
empty-state message that toggles when no nodes are scheduled.
existing #scheduled-nodes-list and li selectors used by cypress
tests are preserved (the empty message lives in its own element).
---
 public/js/today.js        | 12 ++++++++++--
 views/templates/today.php | 17 ++++++++++++++---
 2 files changed, 24 insertions(+), 5 deletions(-)

diff --git a/public/js/today.js b/public/js/today.js
index 6f14627..a9bbda8 100644
--- a/public/js/today.js
+++ b/public/js/today.js
@@ -2,6 +2,7 @@ document.addEventListener('DOMContentLoaded', () => {
     const scheduledNodesList = document.getElementById(
         'scheduled-nodes-list'
     );
+    const emptyMessage = document.getElementById('scheduled-nodes-empty');
 
     function todayDateString() {
         const today = new Date();
@@ -23,10 +24,17 @@ document.addEventListener('DOMContentLoaded', () => {
         const scheduledNodes = await response.json();
         scheduledNodesList.innerHTML = scheduledNodes
             .map((scheduledNode) =>
-                '<li>' + scheduledNode.planName + ': ' +
-                scheduledNode.nodeTitle + '</li>'
+                '<li class="card">' +
+                '<span class="muted">' + scheduledNode.planName +
+                '</span>: ' +
+                '<span class="node-title">' + scheduledNode.nodeTitle +
+                '</span>' +
+                '</li>'
             )
             .join('');
+        if (emptyMessage !== null) {
+            emptyMessage.hidden = scheduledNodes.length > 0;
+        }
     }
 
     loadScheduledNodes();
diff --git a/views/templates/today.php b/views/templates/today.php
index e76d875..4a5ed8a 100644
--- a/views/templates/today.php
+++ b/views/templates/today.php
@@ -7,9 +7,20 @@
     <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
-    <h1>Today</h1>
-    <ul id="scheduled-nodes-list">
-    </ul>
+    <header class="site-header">
+        <div class="site-header-inner">
+            <h1>Today</h1>
+            <div class="cluster">
+                <a class="btn btn-secondary" href="/home">Home</a>
+            </div>
+        </div>
+    </header>
+    <main class="container stack">
+        <ul id="scheduled-nodes-list" class="list-cards"></ul>
+        <p id="scheduled-nodes-empty" class="muted" hidden>
+            Nothing scheduled for today.
+        </p>
+    </main>
     <script src="/js/auth.js"></script>
     <script src="/js/today.js"></script>
 </body>

From 5be645f4e5ea68e7ed327a386806b8c200d10296 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 11:32:21 +0300
Subject: [PATCH 06/11] style admin texts page with card list and form

apply the page shell to the admin texts page and present each
existing text as a card-link plus the new-text form as a card with
a primary submit button. ids (#texts-list, #newTextName, #submit,
#back) and the name attribute on the input are preserved so the
existing cypress flows continue to work.
---
 public/js/texts.js        |  5 ++++-
 views/templates/texts.php | 34 +++++++++++++++++++++++++---------
 2 files changed, 29 insertions(+), 10 deletions(-)

diff --git a/public/js/texts.js b/public/js/texts.js
index 029196d..a0b69e1 100644
--- a/public/js/texts.js
+++ b/public/js/texts.js
@@ -8,7 +8,8 @@ document.addEventListener('DOMContentLoaded', () => {
         });
         const texts = await res.json();
         textsList.innerHTML = texts.map(text =>
-            '<li><a href=/admin/texts/'
+            '<li class="card"><a class="card-link"'
+                + ' href=/admin/texts/'
                 + text.id
                 + '>'
                 + text.name
@@ -26,7 +27,9 @@ document.addEventListener('DOMContentLoaded', () => {
         if (res.ok) {
             const text = await res.json();
             const li = document.createElement('li');
+            li.className = 'card';
             const a = document.createElement('a');
+            a.className = 'card-link';
             a.href = '/admin/texts/' + text.id;
             a.textContent = text.name;
             li.appendChild(a);
diff --git a/views/templates/texts.php b/views/templates/texts.php
index a56b5d2..a37bd1e 100644
--- a/views/templates/texts.php
+++ b/views/templates/texts.php
@@ -7,14 +7,30 @@
     <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
-    <h1>Texts</h1>
-    <a href="/admin" id="back">Back to Admin</a>
-    <ul id="texts-list">
-    </ul>
-    <form id="texts-form" action="/api/texts" method="POST">
-        <input id="newTextName" name="name"/>
-        <button id="submit">submit</button>
-    </form>
+    <header class="site-header">
+        <div class="site-header-inner">
+            <h1>Texts</h1>
+            <div class="cluster">
+                <a class="btn btn-secondary" href="/admin" id="back">
+                    Back to Admin
+                </a>
+            </div>
+        </div>
+    </header>
+    <main class="container stack-lg">
+        <ul id="texts-list" class="list-cards"></ul>
+        <form id="texts-form" action="/api/texts" method="POST"
+              class="card stack">
+            <label>New text name
+                <input id="newTextName" name="name" type="text" />
+            </label>
+            <div class="cluster cluster-end">
+                <button id="submit" class="btn btn-primary" type="submit">
+                    Add text
+                </button>
+            </div>
+        </form>
+    </main>
     <script src="/js/texts.js"></script>
 </body>
-</html>
\ No newline at end of file
+</html>

From 59ec2e19e8ae5cc69688ecda1de16b3ecf062e61 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 11:32:49 +0300
Subject: [PATCH 07/11] style admin text detail page with node tree

apply the page shell to the text detail page and add a scoped
.node-tree style block to app.css. the tree dom rendered by text.js
must keep ul/li with buttons and inputs as direct children of each
li (cypress relies on > selectors), so styling is applied entirely
via descendant selectors without wrapping the rendered nodes.
---
 public/css/app.css       | 91 ++++++++++++++++++++++++++++++++++++++++
 views/templates/text.php | 12 +++++-
 2 files changed, 101 insertions(+), 2 deletions(-)

diff --git a/public/css/app.css b/public/css/app.css
index 519c7ec..f7d3003 100644
--- a/public/css/app.css
+++ b/public/css/app.css
@@ -416,3 +416,94 @@ form {
 [hidden] {
     display: none !important;
 }
+
+/* -------------------------------------------------------------------------
+   7. Page-specific: node tree (text detail)
+   -------------------------------------------------------------------------
+   The tree DOM is rendered as plain ul/li with buttons and inputs as
+   direct children of each li. Cypress assertions rely on this exact
+   structure, so we style it via descendant selectors only - no wrapper
+   elements added.
+*/
+
+.node-tree > ul {
+    border-left: 2px solid var(--color-border);
+    padding-left: var(--space-4);
+}
+
+.node-tree ul ul {
+    border-left: 1px solid var(--color-border);
+    margin-top: var(--space-2);
+    margin-left: var(--space-2);
+    padding-left: var(--space-4);
+}
+
+.node-tree li {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--space-2);
+    padding: var(--space-2) 0;
+}
+
+.node-tree li > ul {
+    flex-basis: 100%;
+    margin-top: var(--space-2);
+}
+
+.node-tree li > span {
+    font-weight: 500;
+}
+
+.node-tree li > button {
+    padding: var(--space-1) var(--space-3);
+    font-size: var(--font-size-sm);
+    background-color: var(--color-surface);
+    border: 1px solid var(--color-border-strong);
+    border-radius: var(--radius-sm);
+}
+
+.node-tree li > button.toggle-children {
+    padding: var(--space-1) var(--space-2);
+    background-color: transparent;
+    border-color: transparent;
+    color: var(--color-text-muted);
+    font-size: var(--font-size-base);
+}
+
+.node-tree li > button.toggle-children:hover,
+.node-tree li > button.toggle-children:focus {
+    color: var(--color-text);
+    background-color: var(--color-surface-alt);
+}
+
+.node-tree li > button.add-child {
+    color: var(--color-primary);
+    border-color: var(--color-primary);
+}
+
+.node-tree li > button.add-child:hover,
+.node-tree li > button.add-child:focus {
+    background-color: var(--color-primary);
+    color: #ffffff;
+}
+
+.node-tree li > button.bulk-add-children {
+    color: var(--color-accent);
+    border-color: var(--color-accent);
+}
+
+.node-tree li > button.bulk-add-children:hover,
+.node-tree li > button.bulk-add-children:focus {
+    background-color: var(--color-accent);
+    color: #ffffff;
+}
+
+.node-tree li > input {
+    width: auto;
+    margin-top: 0;
+}
+
+.node-tree li > input.bulk-count {
+    max-width: 6rem;
+}
diff --git a/views/templates/text.php b/views/templates/text.php
index 477ec12..6d41421 100644
--- a/views/templates/text.php
+++ b/views/templates/text.php
@@ -7,8 +7,16 @@
     <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
-    <a href="/admin/texts" id="back">Back to Texts</a>
-    <div id="text-detail"></div>
+    <header class="site-header">
+        <div class="site-header-inner">
+            <a class="btn btn-secondary" href="/admin/texts" id="back">
+                Back to Texts
+            </a>
+        </div>
+    </header>
+    <main class="container container-wide stack">
+        <div id="text-detail" class="node-tree stack"></div>
+    </main>
     <script src="/js/text.js"></script>
 </body>
 </html>

From e51378b8c72333935bd903a0affd262259b0a376 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 11:33:05 +0300
Subject: [PATCH 08/11] style admin landing page with shell and card nav

wrap the admin page in the shared header (with the logout button)
and present the texts entry-point as a card-link in a list-cards
list. the #texts and #logout id hooks used by cypress are
preserved.
---
 views/templates/admin.php | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/views/templates/admin.php b/views/templates/admin.php
index 59be004..d69f685 100644
--- a/views/templates/admin.php
+++ b/views/templates/admin.php
@@ -7,8 +7,23 @@
     <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
-    <button id="logout">Logout</button>
-    <a href="/admin/texts" id="texts">Texts</a>
+    <header class="site-header">
+        <div class="site-header-inner">
+            <h1>Admin</h1>
+            <div class="cluster">
+                <button id="logout" class="btn btn-danger">Logout</button>
+            </div>
+        </div>
+    </header>
+    <main class="container stack">
+        <ul class="list-cards">
+            <li class="card">
+                <a id="texts" class="card-link" href="/admin/texts">
+                    Texts
+                </a>
+            </li>
+        </ul>
+    </main>
     <script src="/js/auth.js"></script>
 </body>
 </html>

From a20d12177e17ea784edf5adcd0e50d6121589c91 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 11:33:24 +0300
Subject: [PATCH 09/11] style login page with auth-card layout

introduce .auth-shell and .auth-card classes for the centered,
narrow-card layout shared by login and register, then apply them
to the login template. form ids and the #login-error element are
preserved so the existing cypress auth flows still target them.
---
 public/css/app.css        | 18 +++++++++++++++++
 views/templates/login.php | 42 +++++++++++++++++++++++----------------
 2 files changed, 43 insertions(+), 17 deletions(-)

diff --git a/public/css/app.css b/public/css/app.css
index f7d3003..767dddd 100644
--- a/public/css/app.css
+++ b/public/css/app.css
@@ -397,6 +397,24 @@ form {
     font-size: var(--font-size-sm);
 }
 
+.auth-shell {
+    min-height: 100vh;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    padding: var(--space-5) var(--space-4);
+}
+
+.auth-card {
+    width: 100%;
+    max-width: 24rem;
+    background-color: var(--color-surface);
+    border: 1px solid var(--color-border);
+    border-radius: var(--radius-md);
+    box-shadow: var(--shadow-md);
+    padding: var(--space-6);
+}
+
 .muted {
     color: var(--color-text-muted);
 }
diff --git a/views/templates/login.php b/views/templates/login.php
index 7fa70fc..282f96d 100644
--- a/views/templates/login.php
+++ b/views/templates/login.php
@@ -7,23 +7,31 @@
     <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
-    <h1>Login</h1>
-    <form id="login-form">
-        <label>Email
-            <input type="email" id="email" name="email" required />
-        </label>
-        <label>Password
-            <input
-                type="password"
-                id="password"
-                name="password"
-                required
-            />
-        </label>
-        <button type="submit">Login</button>
-    </form>
-    <p id="login-error" hidden></p>
-    <p><a href="/register">Register</a></p>
+    <main class="auth-shell">
+        <div class="auth-card stack">
+            <h1>Login</h1>
+            <form id="login-form" class="stack">
+                <label>Email
+                    <input type="email" id="email" name="email" required />
+                </label>
+                <label>Password
+                    <input
+                        type="password"
+                        id="password"
+                        name="password"
+                        required
+                    />
+                </label>
+                <button type="submit" class="btn btn-primary full-width">
+                    Login
+                </button>
+            </form>
+            <p id="login-error" class="error" hidden></p>
+            <p class="muted">
+                <a href="/register">Need an account? Register</a>
+            </p>
+        </div>
+    </main>
     <script src="/js/auth.js"></script>
 </body>
 </html>

From 8d38a092d83a97c44c690155c4158fd8fc818753 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 11:33:37 +0300
Subject: [PATCH 10/11] style register page with auth-card layout

apply the shared auth-shell + auth-card layout to the register
template, mirroring the login page. ids and the #register-error
element are preserved for the existing cypress auth tests.
---
 views/templates/register.php | 44 +++++++++++++++++++++---------------
 1 file changed, 26 insertions(+), 18 deletions(-)

diff --git a/views/templates/register.php b/views/templates/register.php
index 47cea7a..ba7f577 100644
--- a/views/templates/register.php
+++ b/views/templates/register.php
@@ -7,24 +7,32 @@
     <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
-    <h1>Register</h1>
-    <form id="register-form">
-        <label>Email
-            <input type="email" id="email" name="email" required />
-        </label>
-        <label>Password (min 8 characters)
-            <input
-                type="password"
-                id="password"
-                name="password"
-                minlength="8"
-                required
-            />
-        </label>
-        <button type="submit">Register</button>
-    </form>
-    <p id="register-error" hidden></p>
-    <p><a href="/login">Already have an account? Login</a></p>
+    <main class="auth-shell">
+        <div class="auth-card stack">
+            <h1>Register</h1>
+            <form id="register-form" class="stack">
+                <label>Email
+                    <input type="email" id="email" name="email" required />
+                </label>
+                <label>Password (min 8 characters)
+                    <input
+                        type="password"
+                        id="password"
+                        name="password"
+                        minlength="8"
+                        required
+                    />
+                </label>
+                <button type="submit" class="btn btn-primary full-width">
+                    Register
+                </button>
+            </form>
+            <p id="register-error" class="error" hidden></p>
+            <p class="muted">
+                <a href="/login">Already have an account? Login</a>
+            </p>
+        </div>
+    </main>
     <script src="/js/auth.js"></script>
 </body>
 </html>

From 9979178fd5a0902c2140380a867dfca0074f0334 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 11:33:49 +0300
Subject: [PATCH 11/11] style forbidden page with auth-card layout

reuse the centered auth-card shell for the 403 page so the error
state matches the visual language of the rest of the app, with a
primary back-to-home action.
---
 views/templates/forbidden.php | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/views/templates/forbidden.php b/views/templates/forbidden.php
index 334edac..ef7f0e4 100644
--- a/views/templates/forbidden.php
+++ b/views/templates/forbidden.php
@@ -7,8 +7,14 @@
     <link rel="stylesheet" href="/css/app.css">
 </head>
 <body>
-    <h1>403 Forbidden</h1>
-    <p>You do not have permission to access this page.</p>
-    <a href="/home">Back to Home</a>
+    <main class="auth-shell">
+        <div class="auth-card stack text-center">
+            <h1>403 Forbidden</h1>
+            <p class="muted">
+                You do not have permission to access this page.
+            </p>
+            <a class="btn btn-primary" href="/home">Back to Home</a>
+        </div>
+    </main>
 </body>
 </html>