Clarify git capsule state meanings

.context.json

@@ -22,7 +22,35 @@
     "global_installer_wrapper": "dotfiles/install/install-global-ps1.sh",
     "readme": "README.md",
     "library": "libary.md",
-    "palette_image": "images/bash-pallete.png"
+    "palette_image": "images/bash-pallete.png",
+    "theme_images_dir": "images/themes",
+    "theme_images": {
+      "season_winter": "images/themes/season-winter.png",
+      "season_spring": "images/themes/season-spring.png",
+      "season_summer": "images/themes/season-summer.png",
+      "season_autumn": "images/themes/season-autumn.png",
+      "aurora": "images/themes/aurora.png",
+      "neon": "images/themes/neon.png",
+      "forge": "images/themes/forge.png",
+      "circuit": "images/themes/circuit.png",
+      "mono": "images/themes/mono.png",
+      "git": "images/themes/git.png",
+      "hawolex": "images/themes/hawolex.png",
+      "hawolexv2": "images/themes/hawolexv2.png",
+      "christmas": "images/themes/christmas.png",
+      "easter": "images/themes/easter.png",
+      "halloween": "images/themes/halloween.png",
+      "valentine": "images/themes/valentine.png",
+      "thanksgiving": "images/themes/thanksgiving.png",
+      "newyear": "images/themes/newyear.png",
+      "radar": "images/themes/radar.png",
+      "synthwave": "images/themes/synthwave.png",
+      "noir": "images/themes/noir.png",
+      "topo": "images/themes/topo.png",
+      "glitch": "images/themes/glitch.png",
+      "arcticfire": "images/themes/arcticfire.png",
+      "acidlime": "images/themes/acidlime.png"
+    }
   },
   "install_behavior": {
     "linux": {
@@ -196,6 +224,13 @@
         "layout": "two-line, segmented gradient",
         "preview": "[date time user] @host - /path"
       },
+      {
+        "id": "demo",
+        "name": "Demo",
+        "description": "Cycles through all styles each prompt.",
+        "layout": "two-line, auto-rotate",
+        "preview": "(auto-rotate)"
+      },
       {
         "id": "radar",
         "name": "Radar",
@@ -247,7 +282,7 @@
       }
     ],
     "config": {
-      "env": "PS1_STYLE=aurora|neon|forge|circuit|mono|git|hawolex|hawolexv2|radar|synthwave|noir|topo|glitch|arcticfire|acidlime; PS1_STYLE_PACK=standard|contest|holiday|custom; PS1_CONTEST_LAYOUT=day-time-user|user-time|time-user|day-time; PS1_HOLIDAY=christmas|easter|halloween|valentine|thanksgiving|newyear; PS1_GIT=0|1",
+      "env": "PS1_STYLE=aurora|neon|forge|circuit|mono|git|hawolex|hawolexv2|radar|synthwave|noir|topo|glitch|arcticfire|acidlime|demo; PS1_STYLE_PACK=standard|contest|holiday|custom; PS1_CONTEST_LAYOUT=day-time-user|user-time|time-user|day-time; PS1_HOLIDAY=christmas|easter|halloween|valentine|thanksgiving|newyear; PS1_GIT=0|1",
       "config_file_keys": [
         "PS1_STYLE",
         "PS1_STYLE_PACK",
@@ -503,6 +538,7 @@
     "README uses images/bash-pallete.png.",
     "Git capsule prefers __git_ps1 and falls back to git symbolic-ref/short hash when git-prompt is unavailable or returns empty.",
     "Hawolex git capsule enables when PS1_GIT resolves to a truthy value (1/yes/true/on).",
-    "Custom pack adds bold styles (radar, synthwave, noir, topo, glitch, arcticfire, acidlime)."
+    "Custom pack adds bold styles (radar, synthwave, noir, topo, glitch, arcticfire, acidlime).",
+    "Library includes emoji usage blocks per theme (sets, fixed times, time slots, rotation)."
   ]
 }

README.md

@@ -4,6 +4,13 @@ Elegant, portable, and easy-to-install Bash prompt with seasonal palettes, time-
 
 ---
 
+## ⚡ Quick Look
+
+- Theme gallery + full specs: [Theme Library](libary.md)
+- Packs: Seasonal (auto), Contest, Holidays, Custom, Git
+- Layout order option: day-time-user, user-time, time-user, day-time
+- Optional git capsule across themes
+
 ## ✅ Requirements (Nerd Fonts)
 
 This prompt relies on Nerd Font glyphs for the rounded separators.
@@ -71,6 +78,34 @@ bash dotfiles/install/install-macos-user.sh
 source ~/.bashrc
 ```
 
+<details>
+<summary><strong>Installer menu (structure)</strong></summary>
+
+```text
+Install options
+├─ 1) PS1 only
+├─ 2) Banner only
+└─ 3) Both (PS1 + banner)
+   └─ PS1 mode
+      ├─ 1) Single season (static)
+      │  ├─ Pick season (Winter/Spring/Summer/Autumn)
+      │  └─ Layout order (day-time-user / user-time / time-user / day-time)
+      ├─ 2) Dynamic season (auto)
+      │  └─ Layout order (day-time-user / user-time / time-user / day-time)
+      ├─ 3) Contest pack (static)
+      │  ├─ Layout order
+      │  └─ Style preset (Aurora/Neon/Forge/Circuit/Mono/Git/Hawolex/HawolexV2)
+      ├─ 4) Holidays pack (static)
+      │  ├─ Pick holiday (Christmas/Easter/Halloween/Valentine/Thanksgiving/NewYear)
+      │  └─ Layout order
+      └─ 5) Custom pack (static)
+         └─ Style (Radar/Synthwave/Noir/Topo/Glitch/ArcticFire/AcidLime)
+
+Final prompt:
+└─ Enable git capsule for all themes? [y/N]
+```
+</details>
+
 <details>
 <summary><strong>Installer choices</strong></summary>
 
@@ -181,6 +216,8 @@ Seven extra styles, built to be loud and expressive:
 - AcidLime: black + electric green
 
 Custom styles add a small context badge when relevant (`ssh`, `ctr`, `git`).
+
+Demo mode (screenshots): choose "Demo" to auto-cycle through all themes on each prompt.
 </details>
 
 ---
@@ -264,6 +301,7 @@ Meaning:
 ├── images/
 │   ├── bash-pallete.png
 │   └── contest.png
+│   └── themes/
 ├── dotfiles/
 │   ├── banner/
 │   │   └── banner.sh
@@ -358,16 +396,46 @@ If you see squares or missing glyphs, your terminal is likely using a non-Nerd f
 
 ---
 
-## 📸 Seasonal Previews
+## 📸 Theme Gallery
 
-Placeholders for the four seasonal prompts (screenshots will be added here):
+Seasonal (Aurora):
 
-- Winter: `images/season-winter.png` (placeholder)
+![Winter](images/themes/season-winter.png)
-- Spring: `images/season-spring.png` (placeholder)
+![Spring](images/themes/season-spring.png)
-- Summer: `images/season-summer.png` (placeholder)
+![Summer](images/themes/season-summer.png)
-- Autumn: `images/season-autumn.png` (placeholder)
+![Autumn](images/themes/season-autumn.png)
 
-Current combined palette reference:
+Contest pack:
+
+![Aurora (contest)](images/themes/aurora.png)
+![Neon](images/themes/neon.png)
+![Forge](images/themes/forge.png)
+![Circuit](images/themes/circuit.png)
+![Mono](images/themes/mono.png)
+![Git](images/themes/git.png)
+![Hawolex](images/themes/hawolex.png)
+![HawolexV2](images/themes/hawolexv2.png)
+
+Holidays pack:
+
+![Christmas](images/themes/christmas.png)
+![Easter](images/themes/easter.png)
+![Halloween](images/themes/halloween.png)
+![Valentine](images/themes/valentine.png)
+![Thanksgiving](images/themes/thanksgiving.png)
+![NewYear](images/themes/newyear.png)
+
+Custom pack:
+
+![Radar](images/themes/radar.png)
+![Synthwave](images/themes/synthwave.png)
+![Noir](images/themes/noir.png)
+![Topo](images/themes/topo.png)
+![Glitch](images/themes/glitch.png)
+![ArcticFire](images/themes/arcticfire.png)
+![AcidLime](images/themes/acidlime.png)
+
+Palette reference:
 
 <p align="center">
   <img src="images/bash-pallete.png" width="900">

contest-styles.json

@@ -33,6 +33,20 @@
     "emoji_padding": 2,
     "note": "Two spaces after the emoji before the cursor"
   },
+  "emoji_rules": {
+    "fixed_times": [
+      "11:00-11:29 => 🥪",
+      "16:00-16:59 => 🍲"
+    ],
+    "time_slots": {
+      "sunrise": "05:00-08:59",
+      "coffee": "09:00-10:59",
+      "work": "11:30-15:59",
+      "evening": "17:00-22:59",
+      "night": "23:00-04:59"
+    },
+    "rotation": "Daily rotation by day-of-year with season offsets."
+  },
   "holiday_pack": {
     "layout_options": [
       "day-time-user",
@@ -266,27 +280,41 @@
         "frame": 24
       },
       "preview": "[date time user] @host - /path"
+    },
+      {
+        "id": "hawolexv2",
+        "name": "HawolexV2",
+        "tagline": "Winter neon gradient",
+        "description": "Multi-segment winter neon gradient with stronger separation.",
+        "layout": {
+          "line1": "date time user | @host | /path",
+          "line2": "status arrow + emoji"
+        },
+        "colors": {
+          "zone1_bg": 54,
+          "zone2_bg": 55,
+          "zone3_bg": 56,
+          "zone4_bg": 31,
+          "zone5_bg": 30,
+          "zone_fg": 255,
+          "path_fg": 230,
+          "frame": 24
+        },
+        "preview": "[date time user] @host - /path"
     },
     {
-      "id": "hawolexv2",
+      "id": "demo",
-      "name": "HawolexV2",
+      "name": "Demo",
-      "tagline": "Winter neon gradient",
+      "tagline": "Auto-rotate all themes",
-      "description": "Multi-segment winter neon gradient with stronger separation.",
+      "description": "Cycles through all themes each prompt for rapid screenshots.",
       "layout": {
-        "line1": "date time user | @host | /path",
+        "line1": "auto",
-        "line2": "status arrow + emoji"
+        "line2": "auto"
       },
       "colors": {
-        "zone1_bg": 54,
+        "note": "Uses each theme's native palette"
-        "zone2_bg": 55,
-        "zone3_bg": 56,
-        "zone4_bg": 31,
-        "zone5_bg": 30,
-        "zone_fg": 255,
-        "path_fg": 230,
-        "frame": 24
       },
-      "preview": "[date time user] @host - /path"
+      "preview": "(auto-rotate)"
     },
     {
       "id": "radar",

dotfiles/install/install-linux-global.sh

@@ -171,33 +171,36 @@ if [[ -t 0 ]]; then
     if [[ "$style_pack" == "contest" ]]; then
       echo
       echo "Style presets:"
-      echo "  1) Aurora  - Powerline blocks, seasonal palette, two-line"
+      echo "  1) Demo     - Cycles all themes every prompt"
+      echo "     Preview: (auto-rotate)"
+      echo "  2) Aurora  - Powerline blocks, seasonal palette, two-line"
       echo "     Preview: [date time user] > [@host /path]"
-      echo "  2) Neon    - Magenta/cyan cyber blocks, high contrast"
+      echo "  3) Neon    - Magenta/cyan cyber blocks, high contrast"
       echo "     Preview: [user time] > [@host /path]"
-      echo "  3) Forge   - Warm copper blocks, heavy frame"
+      echo "  4) Forge   - Warm copper blocks, heavy frame"
       echo "     Preview: [date time user] > [@host /path]"
-      echo "  4) Circuit - Green scanline, minimal rails"
+      echo "  5) Circuit - Green scanline, minimal rails"
       echo "     Preview: [user time] - @host /path"
-      echo "  5) Mono    - Clean monochrome, fast read"
+      echo "  6) Mono    - Clean monochrome, fast read"
       echo "     Preview: [date time user] @host /path"
-      echo "  6) Git     - Minimal with git capsule"
+      echo "  7) Git     - Minimal with git capsule"
       echo "     Preview: [date time user] @host - /path (git)"
-      echo "  7) Hawolex - Winter neon, tech icons"
+      echo "  8) Hawolex - Winter neon, tech icons"
       echo "     Preview: [date time user] @host - /path"
-      echo "  8) HawolexV2 - Winter neon gradient"
+      echo "  9) HawolexV2 - Winter neon gradient"
       echo "     Preview: [date time user] @host - /path"
       read -r -p "Choose style [1]: " style_pick
       case "${style_pick}" in
-        2) style_choice="neon" ;;
+        2) style_choice="aurora" ;;
-        3) style_choice="forge" ;;
+        3) style_choice="neon" ;;
-        4) style_choice="circuit" ;;
+        4) style_choice="forge" ;;
-        5) style_choice="mono" ;;
+        5) style_choice="circuit" ;;
-        6) style_choice="git" ;;
+        6) style_choice="mono" ;;
-        7) style_choice="hawolex" ;;
+        7) style_choice="git" ;;
-        8) style_choice="hawolexv2" ;;
+        8) style_choice="hawolex" ;;
-        ""|1) style_choice="aurora" ;;
+        9) style_choice="hawolexv2" ;;
-        *) echo "Invalid choice, using aurora."; style_choice="aurora" ;;
+        ""|1) style_choice="demo" ;;
+        *) echo "Invalid choice, using demo."; style_choice="demo" ;;
       esac
 
     elif [[ "$style_pack" == "custom" ]]; then

dotfiles/install/install-macos-user.sh

@@ -147,33 +147,36 @@ if [[ -t 0 ]]; then
   if [[ "$style_pack" == "contest" ]]; then
     echo
     echo "Style presets:"
-    echo "  1) Aurora  - Powerline blocks, seasonal palette, two-line"
+    echo "  1) Demo     - Cycles all themes every prompt"
+    echo "     Preview: (auto-rotate)"
+    echo "  2) Aurora  - Powerline blocks, seasonal palette, two-line"
     echo "     Preview: [date time user] > [@host /path]"
-    echo "  2) Neon    - Magenta/cyan cyber blocks, high contrast"
+    echo "  3) Neon    - Magenta/cyan cyber blocks, high contrast"
     echo "     Preview: [user time] > [@host /path]"
-    echo "  3) Forge   - Warm copper blocks, heavy frame"
+    echo "  4) Forge   - Warm copper blocks, heavy frame"
     echo "     Preview: [date time user] > [@host /path]"
-    echo "  4) Circuit - Green scanline, minimal rails"
+    echo "  5) Circuit - Green scanline, minimal rails"
     echo "     Preview: [user time] - @host /path"
-    echo "  5) Mono    - Clean monochrome, fast read"
+    echo "  6) Mono    - Clean monochrome, fast read"
     echo "     Preview: [date time user] @host /path"
-    echo "  6) Git     - Minimal with git capsule"
+    echo "  7) Git     - Minimal with git capsule"
     echo "     Preview: [date time user] @host - /path (git)"
-    echo "  7) Hawolex - Winter neon, tech icons"
+    echo "  8) Hawolex - Winter neon, tech icons"
     echo "     Preview: [date time user] @host - /path"
-    echo "  8) HawolexV2 - Winter neon gradient"
+    echo "  9) HawolexV2 - Winter neon gradient"
     echo "     Preview: [date time user] @host - /path"
     read -r -p "Choose style [1]: " style_pick
     case "${style_pick}" in
-      2) style_choice="neon" ;;
+      2) style_choice="aurora" ;;
-      3) style_choice="forge" ;;
+      3) style_choice="neon" ;;
-      4) style_choice="circuit" ;;
+      4) style_choice="forge" ;;
-      5) style_choice="mono" ;;
+      5) style_choice="circuit" ;;
-      6) style_choice="git" ;;
+      6) style_choice="mono" ;;
-      7) style_choice="hawolex" ;;
+      7) style_choice="git" ;;
-      8) style_choice="hawolexv2" ;;
+      8) style_choice="hawolex" ;;
-      ""|1) style_choice="aurora" ;;
+      9) style_choice="hawolexv2" ;;
-      *) echo "Invalid choice, using aurora."; style_choice="aurora" ;;
+      ""|1) style_choice="demo" ;;
+      *) echo "Invalid choice, using demo."; style_choice="demo" ;;
     esac
 
   elif [[ "$style_pack" == "custom" ]]; then

dotfiles/ps1/ps1.sh

@@ -90,7 +90,7 @@ _ps1_season() {
 }
 
 # Style selection (aurora/neon/forge/circuit/mono/git/hawolex + custom pack)
-#   PS1_STYLE=aurora|neon|forge|circuit|mono|git|hawolex|hawolexv2|radar|synthwave|noir|topo|glitch|arcticfire|acidlime
+#   PS1_STYLE=aurora|neon|forge|circuit|mono|git|hawolex|hawolexv2|radar|synthwave|noir|topo|glitch|arcticfire|acidlime|demo
 #   PS1_STYLE_PACK=standard|contest|holiday|custom
 #   PS1_CONTEST_LAYOUT=day-time-user|user-time|time-user|day-time
 #   PS1_HOLIDAY=christmas|easter|halloween|valentine|thanksgiving|newyear
@@ -211,6 +211,32 @@ _ps1_path_topo() {
   printf "%s" "$out"
 }
 
+_ps1_demo_next() {
+  local styles=(
+    "aurora" "neon" "forge" "circuit" "mono" "git" "hawolex" "hawolexv2"
+    "aurora" "aurora" "aurora" "aurora" "aurora" "aurora"
+    "radar" "synthwave" "noir" "topo" "glitch" "arcticfire" "acidlime"
+  )
+  local packs=(
+    "standard" "contest" "contest" "contest" "contest" "contest" "contest" "contest"
+    "holiday" "holiday" "holiday" "holiday" "holiday" "holiday"
+    "custom" "custom" "custom" "custom" "custom" "custom" "custom"
+  )
+  local holidays=(
+    "" "" "" "" "" "" "" ""
+    "christmas" "easter" "halloween" "valentine" "thanksgiving" "newyear"
+    "" "" "" "" "" "" ""
+  )
+  local count=${#styles[@]}
+  local idx="${PS1_DEMO_INDEX:--1}"
+  idx=$(( (idx + 1) % count ))
+  PS1_DEMO_INDEX="$idx"
+  export PS1_DEMO_INDEX
+  __PS1_DEMO_STYLE="${styles[$idx]}"
+  __PS1_DEMO_PACK="${packs[$idx]}"
+  __PS1_DEMO_HOLIDAY="${holidays[$idx]}"
+}
+
 # ---- Load Git prompt helper (best effort) ----
 __try_source_git_prompt() {
   local candidates=(
@@ -946,6 +972,14 @@ _ps1_update() {
   __PS1_HOLIDAY="$(_ps1_holiday)"
   __PS1_STYLE="$(_ps1_style)"
   __PS1_GIT="${PS1_GIT:-0}"
+  if [[ "$__PS1_STYLE" == "demo" ]]; then
+    _ps1_demo_next
+    __PS1_STYLE="$__PS1_DEMO_STYLE"
+    __PS1_STYLE_PACK="$__PS1_DEMO_PACK"
+    if [[ "$__PS1_STYLE_PACK" == "holiday" && -n "$__PS1_DEMO_HOLIDAY" ]]; then
+      __PS1_HOLIDAY="$__PS1_DEMO_HOLIDAY"
+    fi
+  fi
   __PS1_SYM="$(_ps1_symbol)"
   __PS1_PATH="$(_ps1_path)"
   if _ps1_has_nf; then __PS1_USE_NF=1; else __PS1_USE_NF=0; fi

libary.md

@@ -2,6 +2,28 @@
 
 This file lists every prompt theme, color codes, design intent, and configuration options.
 
+## Git Capsule (optional, all themes)
+
+What it is: a compact git status block shown on line 2 when you're inside a git repo.
+It uses `__git_ps1` when available, with a safe fallback to `git rev-parse` for the branch.
+
+States + emojis (plain language):
+- Clean repo: ✨ no local changes; your files match the last commit
+- Dirty working tree: 🔨 you edited tracked files but haven’t staged them yet
+- Staged changes: 📌 changes are staged and ready to commit
+- Untracked files: 🧷 new files git hasn’t started tracking
+- Stashed changes: 📦 work saved with `git stash` (not in your working tree)
+
+How it works:
+- The capsule only renders when a repo is detected (no extra noise outside git).
+- If `__git_ps1` is available, it reads git state flags and maps them to emojis.
+- If not, it falls back to the current branch/short SHA (still useful, but fewer states).
+
+Best practices:
+- Keep the capsule on during active work; it surfaces risk at a glance.
+- If you want faster prompts in very large repos, leave untracked detection off.
+- Use the Git theme for a minimal, work-safe look with the capsule always enabled.
+
 ## Seasonal (Aurora, Standard Pack)
 
 Design intent: calm, readable, long-session comfort with a subtle five-step gradient
@@ -10,6 +32,14 @@ Design intent: calm, readable, long-session comfort with a subtle five-step grad
 Layout: two-line powerline, host+path on line 1, status + emoji on line 2.
 
 Winter:
+
+![Winter](./images/themes/season-winter.png)
+
+Emoji:
+- Set: sunrise 🏔️ 🌨️ ❄️ 🌌; work 🎿 ⛷️ 🏂 🧊; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=59  Z2_BG=61  Z3_BG=63  Z4_BG=38  Z5_BG=37
 Z1_FG=255 Z2_FG=255
@@ -18,6 +48,14 @@ FRAME=60
 ```
 
 Spring:
+
+![Spring](./images/themes/season-spring.png)
+
+Emoji:
+- Set: sunrise 🌷 🌱 🐣 🌤; work 🌿 🪴 🐝 🌼; coffee ☕; evening 🌤; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=68  Z2_BG=70  Z3_BG=72  Z4_BG=121 Z5_BG=120
 Z1_FG=255 Z2_FG=22
@@ -26,6 +64,14 @@ FRAME=65
 ```
 
 Summer:
+
+![Summer](./images/themes/season-summer.png)
+
+Emoji:
+- Set: sunrise 🌞 🏖️ 🌅 🌤; work 🏄 🏖️ 🚤 🌴; coffee 🧃; evening 🌇; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=141 Z2_BG=142 Z3_BG=143 Z4_BG=214 Z5_BG=208
 Z1_FG=255 Z2_FG=0
@@ -34,6 +80,14 @@ FRAME=130
 ```
 
 Autumn:
+
+![Autumn](./images/themes/season-autumn.png)
+
+Emoji:
+- Set: sunrise 🍁 🍂 🌫️ 🌦️; work 🍂 🍄 🎃 🪵; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=93  Z2_BG=95  Z3_BG=97  Z4_BG=166 Z5_BG=136
 Z1_FG=255 Z2_FG=255
@@ -48,6 +102,14 @@ Design intent: high-contrast silhouettes, fast scanning, stage-ready presence.
 Layout: configurable order for the left segment, always ends with "@host - /path".
 
 Aurora (contest palette):
+
+![Aurora (contest)](./images/themes/aurora.png)
+
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=24 Z2_BG=31
 Z1_FG=255 Z2_FG=255
@@ -56,6 +118,14 @@ FRAME=23
 ```
 
 Neon:
+
+![Neon](./images/themes/neon.png)
+
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=201 Z1_FG=255
 Z2_BG=45  Z2_FG=16
@@ -64,6 +134,14 @@ FRAME=199
 ```
 
 Forge:
+
+![Forge](./images/themes/forge.png)
+
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=94  Z1_FG=230
 Z2_BG=166 Z2_FG=231
@@ -72,6 +150,14 @@ FRAME=130
 ```
 
 Circuit:
+
+![Circuit](./images/themes/circuit.png)
+
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FG_MAIN=46
 FG_DIM=22
@@ -79,12 +165,28 @@ PATH_FG=120
 ```
 
 Mono:
+
+![Mono](./images/themes/mono.png)
+
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FG_MAIN=250
 FG_DIM=240
 ```
 
 Git:
+
+![Git](./images/themes/git.png)
+
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=61 Z1_FG=255
 Z2_BG=37 Z2_FG=255
@@ -93,6 +195,14 @@ FRAME=60
 ```
 
 Hawolex:
+
+![Hawolex](./images/themes/hawolex.png)
+
+Emoji:
+- Set: sunrise 💻 🚗 🔊 🎮; work 🎧 🕹️ 📟 🧩; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=54 Z1_FG=255
 Z2_BG=31 Z2_FG=255
@@ -101,6 +211,14 @@ FRAME=24
 ```
 
 HawolexV2 (gradient):
+
+![HawolexV2](./images/themes/hawolexv2.png)
+
+Emoji:
+- Set: sunrise ⚡️ 🛰️ 🧬 🧠; work 🛠️ 💾 🧪 🧩; coffee ☕; evening 🎛️; night 🕶️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=54 Z2_BG=55 Z3_BG=56 Z4_BG=31 Z5_BG=30
 Z_FG=255
@@ -108,12 +226,25 @@ PATH_FG=230
 FRAME=24
 ```
 
+Demo:
+```
+Cycles all themes on each prompt (screenshots mode).
+```
+
 ## Holidays Pack (style_pack=holiday)
 
 Design intent: themed color + emoji without sacrificing readability.
 Layout uses contest order and ends with "@host - /path".
 
 Christmas:
+
+![Christmas](./images/themes/christmas.png)
+
+Emoji:
+- Set: sunrise 🎄 🎅 ❄️ ⛄; work 🎁 🧤 🧣 🦌; coffee ☕; evening 🌟; night 🕯️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=52 Z2_BG=28
 Z1_FG=255 Z2_FG=255
@@ -122,6 +253,14 @@ FRAME=88
 ```
 
 Easter:
+
+![Easter](./images/themes/easter.png)
+
+Emoji:
+- Set: sunrise 🐣 🥚 🌷 🌤; work 🐰 🌼 🧺 🍫; coffee ☕; evening 🌅; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=186 Z2_BG=150
 Z1_FG=16  Z2_FG=16
@@ -130,6 +269,14 @@ FRAME=143
 ```
 
 Halloween:
+
+![Halloween](./images/themes/halloween.png)
+
+Emoji:
+- Set: sunrise 🎃 🦇 🌕 🕸️; work 👻 💀 🕯️ 🧪; coffee ☕; evening 🌆; night 🕷️
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=53 Z2_BG=166
 Z1_FG=255 Z2_FG=16
@@ -138,6 +285,14 @@ FRAME=89
 ```
 
 Valentine:
+
+![Valentine](./images/themes/valentine.png)
+
+Emoji:
+- Set: sunrise 💖 🌹 💘 💕; work 💌 🍫 🕊️ 💗; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=198 Z2_BG=205
 Z1_FG=255 Z2_FG=255
@@ -146,6 +301,14 @@ FRAME=162
 ```
 
 Thanksgiving:
+
+![Thanksgiving](./images/themes/thanksgiving.png)
+
+Emoji:
+- Set: sunrise 🦃 🍁 🥧 🍂; work 🍽️ 🌾 🧺 🥖; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=94  Z2_BG=136
 Z1_FG=230 Z2_FG=231
@@ -154,6 +317,14 @@ FRAME=130
 ```
 
 NewYear:
+
+![NewYear](./images/themes/newyear.png)
+
+Emoji:
+- Set: sunrise 🎆 🥂 🎇 ✨; work 🗓️ ⏳ 🚀 ✨; coffee ☕; evening 🌆; night 🌙
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=17 Z2_BG=20
 Z1_FG=255 Z2_FG=255
@@ -167,6 +338,14 @@ Design intent: experimental, high-signal styles with bold contrast and distinct
 Custom styles include a context badge when relevant (ssh, ctr, git).
 
 Radar:
+
+![Radar](./images/themes/radar.png)
+
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FRAME=22
 FG_MAIN=46
@@ -175,6 +354,14 @@ PATH_FG=120
 ```
 
 Synthwave:
+
+![Synthwave](./images/themes/synthwave.png)
+
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=198 Z1_FG=255
 Z2_BG=45  Z2_FG=16
@@ -183,6 +370,14 @@ FRAME=201
 ```
 
 Noir:
+
+![Noir](./images/themes/noir.png)
+
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FG_MAIN=250
 FG_DIM=242
@@ -191,12 +386,28 @@ FRAME=236
 ```
 
 Topo:
+
+![Topo](./images/themes/topo.png)
+
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 PATH_FG_LIST=109,110,111,110
 FRAME=24
 ```
 
 Glitch:
+
+![Glitch](./images/themes/glitch.png)
+
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FG_MAIN=118
 FG_DIM=60
@@ -204,6 +415,14 @@ FRAME=129
 ```
 
 ArcticFire:
+
+![ArcticFire](./images/themes/arcticfire.png)
+
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 Z1_BG=24 Z1_FG=255
 Z2_BG=31 Z2_FG=255
@@ -212,6 +431,14 @@ FRAME=25
 ```
 
 AcidLime:
+
+![AcidLime](./images/themes/acidlime.png)
+
+Emoji:
+- Set: seasonal (Spring/Summer/Autumn/Winter sets, same as Seasonal section)
+- Fixed times: 🥪 11:00–11:29, 🍲 16:00–16:59
+- Interval: time slots (Sunrise 05:00–08:59, Coffee 09:00–10:59, Work 11:30–15:59, Evening 17:00–22:59, Night 23:00–04:59), daily rotation
+
 ```
 FG_MAIN=46
 FG_DIM=40