jekyll-theme-zer0 1.9.3 → 1.9.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b051281ebe1b6e661a6ce5792ba471aac968cd7fed4e16f3a9e1b7580e38a2b0
-  data.tar.gz: 4879cab429f2756354ae26011d263e1e7b62b872f18a1f37d8686c6f7d277125
+  metadata.gz: 1393f79966cd18f435a03bb2b52e11b11a9d7aed8bc11fe5b267fc6b4183a4f2
+  data.tar.gz: 0f8df28e75d33053a2ba59f6de950f0dc45453cddc7d44dd369e4d242152d5d2
 SHA512:
-  metadata.gz: 4c60a06c24d84d69999acbe005325e24567670388bafb84e12c0b32ee5c5c7653ba9f4c4823faeafadbd3ce27f476938b365962496bfc3ae914180f1efb0e550
-  data.tar.gz: f27e32fc5257b0077fec453d1c2b9539899750b3ae76b12579b0f5e58a8b5fb32d3d5db1902ec664c3a4366dc082a93f1bd6d61ad8c98c8fb0e99914ec242260
+  metadata.gz: 788340523ae1912166d7f0c14e48ad2c4c1d3b67a8084a6b1ee3db97c9aab416149883454c893542ebf03553b921b0018ed7bdef34835e36dd1f0f9be119834f
+  data.tar.gz: d7b5b172d42d0c80d40498427e97b2b209fd3f4fc02adb42daaa8f017b3a2251de0fb552709f673be502e5e296b43c409e279f7c73b5ccb1324feab98ca66774

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [1.9.6] - 2026-05-30
+
+### Changed
+- **Quickstart**: Comprehensive rewrite of all quickstart docs (`pages/_quickstart/`) with improved structure, Mermaid decision flowchart, and step-by-step screenshots
+- **Quickstart**: `index.md` published from draft — now live at `/quickstart/`
+- **Quickstart**: Removed `homebrew.md` and `winget.md` (content consolidated into `machine-setup.md`)
+- **Quickstart**: 18 new screenshots added to `assets/images/quickstart/` for visual walkthroughs
+
+## [1.9.5] - 2026-05-30
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- d4e1a789 fix(skins): remove contrast/dark skins, set air as default, improve link contrast
+
+
+## [1.9.4] - 2026-05-30
+
+### Changed
+- **Skins**: Removed `contrast` and `dark` skins; `air` is now the default skin
+- **Accessibility**: Rewrote per-skin link and hover colors to meet WCAG AA (≥4.5:1) contrast in both light and dark mode — all 7 remaining skins now use a darker brand tone for light-mode links and a lighter accent tone for dark-mode links
+- `_config.yml`: `theme_skin` default changed from `"dark"` to `"air"`
+
 ## [1.9.3] - 2026-05-30
 
 ### Changed

data/README.md

@@ -2,7 +2,7 @@
 title: zer0-mistakes
 sub-title: AI-Native Jekyll Theme
 description: AI-native Jekyll theme for GitHub Pages — Docker-first development, AI-powered installation, multi-agent integration (Copilot, Codex, Cursor, Claude), AI preview-image generation, and AIEO content optimization with Bootstrap 5.3.
-version: 1.9.3
+version: 1.9.5
 layout: landing
 tags:
   - jekyll
@@ -20,7 +20,7 @@ categories:
   - bootstrap
   - ai-tooling
 created: 2024-02-10T23:51:11.480Z
-lastmod: 2026-05-30T19:01:55.000Z
+lastmod: 2026-05-30T19:57:46.000Z
 draft: false
 permalink: /
 slug: zer0
@@ -862,7 +862,7 @@ git push origin feature/awesome-feature
 
 | Metric | Value |
 |--------|-------|
-| **Current Version** | 1.9.3 ([RubyGems](https://rubygems.org/gems/jekyll-theme-zer0), [CHANGELOG](/CHANGELOG)) |
+| **Current Version** | 1.9.5 ([RubyGems](https://rubygems.org/gems/jekyll-theme-zer0), [CHANGELOG](/CHANGELOG)) |
 | **Documented Features** | 43 ([Feature Registry](https://github.com/bamr87/zer0-mistakes/blob/main/_data/features.yml)) |
 | **Setup Time** | 2-5 minutes ([install.sh benchmarks](https://github.com/bamr87/zer0-mistakes/blob/main/install.sh)) |
 | **Documentation Pages** | 70+ ([browse docs](/pages/)) |
@@ -917,6 +917,6 @@ And these AI partners that make zer0-mistakes truly AI-native:
 
 **Built with ❤️ — and a little help from our AI partners — for the Jekyll community**
 
-**v1.9.3** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md) • [AI Agent Guide](AGENTS.md)
+**v1.9.5** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md) • [AI Agent Guide](AGENTS.md)
 
 

data/_data/content_statistics.yml

@@ -1,5 +1,5 @@
 ---
-generated_at: '2026-05-29 00:59:17'
+generated_at: '2026-05-30 19:26:05'
 overview:
   total_posts: 25
   total_pages: 148
@@ -7,8 +7,8 @@ overview:
   total_categories: 55
   total_tags: 254
   total_authors: 5
-  total_words: 106994
-  average_words_per_post: 618.5
+  total_words: 106650
+  average_words_per_post: 616.5
   published: 173
   drafts: 14
 categories:
@@ -750,7 +750,7 @@ word_statistics:
     type: post
     title: 'Urban Resilience: How Cities Prepare for Extreme Heat'
   README.md:
-    words: 6370
+    words: 5978
     type: page
     title: zer0-mistakes
   STATS_ENHANCEMENT_SUMMARY.md:
@@ -1226,7 +1226,7 @@ word_statistics:
     type: page
     title: AGENTS
   CHANGELOG.md:
-    words: 16978
+    words: 17026
     type: page
     title: CHANGELOG
   CODE_OF_CONDUCT.md:

data/_data/theme_backgrounds.yml

@@ -50,26 +50,6 @@ skins:
     pattern: "assets/backgrounds/patterns/aqua.svg"
     noise: "assets/backgrounds/noise/aqua.svg"
 
-  contrast:
-    label: "Contrast"
-    colors:
-      primary: "#000000"
-      secondary: "#ffffff"
-      accent: "#ffcc00"
-    gradient: "assets/backgrounds/gradients/contrast.svg"
-    pattern: "assets/backgrounds/patterns/contrast.svg"
-    noise: "assets/backgrounds/noise/contrast.svg"
-
-  dark:
-    label: "Dark"
-    colors:
-      primary: "#1a1a2e"
-      secondary: "#16213e"
-      accent: "#0f3460"
-    gradient: "assets/backgrounds/gradients/dark.svg"
-    pattern: "assets/backgrounds/patterns/dark.svg"
-    noise: "assets/backgrounds/noise/dark.svg"
-
   dirt:
     label: "Dirt"
     colors:

data/_data/theme_skins.yml

@@ -5,12 +5,10 @@
 order:
   - air
   - aqua
-  - contrast
-  - dark
   - dirt
   - neon
   - mint
   - plum
   - sunrise
 
-default: dark
+default: air

data/_sass/theme/_skins.scss

@@ -6,25 +6,39 @@
 // SVG backgrounds. Color values mirror _data/theme_backgrounds.yml.
 // ==========================================================================
 
-@mixin zer0-skin-palette($brand, $brand-rgb, $accent, $accent-rgb: null) {
+// $link-light / $link-light-hover — link colors for light mode; should reach
+//   WCAG AA (≥4.5:1) against a white/near-white body background.
+// $link-dark  / $link-dark-hover  — link colors for dark mode; should reach
+//   WCAG AA (≥4.5:1) against Bootstrap's dark body background (#212529).
+// Falls back to $brand (light) / $accent (dark) when not supplied.
+@mixin zer0-skin-palette(
+  $brand, $brand-rgb, $accent, $accent-rgb: null,
+  $link-light: null,       // WCAG-AA color on white (light mode)
+  $link-light-hover: null, // Hover variant in light mode
+  $link-dark: null,        // WCAG-AA color on dark bg (dark mode)
+  $link-dark-hover: null   // Hover variant in dark mode
+) {
+  // Resolve: fall back to $brand / $accent when params are omitted
+  $_ll:  if($link-light       != null, $link-light,       $brand);
+  $_llh: if($link-light-hover != null, $link-light-hover, $_ll);
+  $_ld:  if($link-dark        != null, $link-dark,        $accent);
+  $_ldh: if($link-dark-hover  != null, $link-dark-hover,  $_ld);
+
   --zer0-color-primary: #{$brand};
   --zer0-color-primary-rgb: #{$brand-rgb};
   --zer0-color-accent: #{$accent};
   --bs-primary: #{$brand};
   --bs-primary-rgb: #{$brand-rgb};
-  --bs-link-color: #{$accent};
-  --zer0-color-link: #{$accent};
+
+  // Light-mode link colors (default); dark-mode overrides live in &[data-bs-theme="dark"]
+  --bs-link-color: #{$_ll};
+  --zer0-color-link: #{$_ll};
+  --bs-link-hover-color: #{$_llh};
+  --zer0-color-link-hover: #{$_llh};
+
   --zer0-color-border: rgba(#{$brand-rgb}, 0.28);
   --zer0-shadow-focus: 0 0 0 0.2rem rgba(#{$brand-rgb}, 0.25);
 
-  @if $accent-rgb {
-    --bs-link-hover-color: rgba(#{$accent-rgb}, 0.85);
-    --zer0-color-link-hover: rgba(#{$accent-rgb}, 0.85);
-  } @else {
-    --bs-link-hover-color: #{$accent};
-    --zer0-color-link-hover: #{$accent};
-  }
-
   // Subtle brand tint on elevated surfaces (cards, admin header bar)
   --zer0-color-bg-elevated: color-mix(in srgb, #{$brand} 10%, var(--bs-body-bg));
   --zer0-color-bg-muted: color-mix(in srgb, #{$brand} 6%, var(--bs-secondary-bg, var(--bs-body-bg)));
@@ -147,49 +161,96 @@
   .link-primary {
     color: #{$brand} !important;
   }
+
+  // Dark-mode link overrides — switch to lighter tones for contrast on dark bg
+  &[data-bs-theme="dark"] {
+    --bs-link-color: #{$_ld};
+    --zer0-color-link: #{$_ld};
+    --bs-link-hover-color: #{$_ldh};
+    --zer0-color-link-hover: #{$_ldh};
+  }
 }
 
+// air — steel blue
+// Light: #1e5fa8 (≈6.5:1 on white) / Dark: #b8d4e3 (≈8.5:1 on #212529)
 [data-theme-skin="air"] {
-  @include zer0-skin-palette(#6fa8dc, "111, 168, 220", #b8d4e3);
+  @include zer0-skin-palette(
+    #6fa8dc, "111, 168, 220", #b8d4e3,
+    $link-light:       #1e5fa8,
+    $link-light-hover: #154a87,
+    $link-dark:        #b8d4e3,
+    $link-dark-hover:  #d6eaf4
+  );
 }
 
+// aqua — cyan/teal
+// Light: #006d99 (≈5.5:1 on white) / Dark: #67d7ec (≈8.0:1 on #212529)
 [data-theme-skin="aqua"] {
-  @include zer0-skin-palette(#00b4d8, "0, 180, 216", #90e0ef);
-}
-
-[data-theme-skin="contrast"] {
-  @include zer0-skin-palette(#ffcc00, "255, 204, 0", #ffffff, "255, 255, 255");
-}
-
-// Light-mode override: white accent is invisible on the white/light body bg.
-// Apply near-black for links and nav so contrast skin stays readable in light mode.
-[data-theme-skin="contrast"]:not([data-bs-theme="dark"]) {
-  --bs-link-color: #111111;
-  --zer0-color-link: #111111;
-  --bs-link-hover-color: rgba(17, 17, 17, 0.7);
-  --zer0-color-link-hover: rgba(17, 17, 17, 0.7);
-}
-
-[data-theme-skin="dark"] {
-  @include zer0-skin-palette(#4a90d9, "74, 144, 217", #0f3460);
+  @include zer0-skin-palette(
+    #00b4d8, "0, 180, 216", #90e0ef,
+    $link-light:       #006d99,
+    $link-light-hover: #005577,
+    $link-dark:        #67d7ec,
+    $link-dark-hover:  #9ae8f5
+  );
 }
 
+// dirt — earthy gold/brown
+// Light: #7a5a10 (≈5.0:1 on white) / Dark: #e0b882 (≈7.0:1 on #212529)
 [data-theme-skin="dirt"] {
-  @include zer0-skin-palette(#8b6914, "139, 105, 20", #d4a574);
+  @include zer0-skin-palette(
+    #8b6914, "139, 105, 20", #d4a574,
+    $link-light:       #7a5a10,
+    $link-light-hover: #5c430c,
+    $link-dark:        #e0b882,
+    $link-dark-hover:  #f0cea0
+  );
 }
 
+// neon — electric purple/blue
+// Light: #5e22cc (≈5.5:1 on white) / Dark: #8ab4ff (≈6.0:1 on #212529)
 [data-theme-skin="neon"] {
-  @include zer0-skin-palette(#8338ec, "131, 56, 236", #3a86ff, "58, 134, 255");
+  @include zer0-skin-palette(
+    #8338ec, "131, 56, 236", #3a86ff, "58, 134, 255",
+    $link-light:       #5e22cc,
+    $link-light-hover: #4a1aa3,
+    $link-dark:        #8ab4ff,
+    $link-dark-hover:  #b0ccff
+  );
 }
 
+// mint — forest green
+// Light: #2d8059 (≈5.5:1 on white) / Dark: #80cfa8 (≈7.5:1 on #212529)
 [data-theme-skin="mint"] {
-  @include zer0-skin-palette(#52b788, "82, 183, 136", #95d5b2);
+  @include zer0-skin-palette(
+    #52b788, "82, 183, 136", #95d5b2,
+    $link-light:       #2d8059,
+    $link-light-hover: #1f5a3b,
+    $link-dark:        #80cfa8,
+    $link-dark-hover:  #a8e6c4
+  );
 }
 
+// plum — deep violet
+// Light: #6b2477 (≈8.0:1 on white) / Dark: #d4a0f5 (≈7.0:1 on #212529)
 [data-theme-skin="plum"] {
-  @include zer0-skin-palette(#c77dff, "199, 125, 255", #812f85);
+  @include zer0-skin-palette(
+    #c77dff, "199, 125, 255", #812f85,
+    $link-light:       #6b2477,
+    $link-light-hover: #4e1958,
+    $link-dark:        #d4a0f5,
+    $link-dark-hover:  #e8c8ff
+  );
 }
 
+// sunrise — warm terracotta/orange
+// Light: #b54418 (≈5.5:1 on white) / Dark: #ffa87a (≈7.0:1 on #212529)
 [data-theme-skin="sunrise"] {
-  @include zer0-skin-palette(#ff6b35, "255, 107, 53", #f7c59f);
+  @include zer0-skin-palette(
+    #ff6b35, "255, 107, 53", #f7c59f,
+    $link-light:       #b54418,
+    $link-light-hover: #8f3512,
+    $link-dark:        #ffa87a,
+    $link-dark-hover:  #ffd0b0
+  );
 }

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 1.9.3
+  version: 1.9.6
 platform: ruby
 authors:
 - Amr Abdel
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
 date: 2026-05-30 00:00:00.000000000 Z
@@ -492,7 +492,7 @@ metadata:
   changelog_uri: https://github.com/bamr87/zer0-mistakes/blob/main/CHANGELOG.md
   documentation_uri: https://github.com/bamr87/zer0-mistakes#readme
   allowed_push_host: https://rubygems.org
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -507,8 +507,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.0.3.1
+signing_key: 
 specification_version: 4
 summary: Jekyll theme based on bootstrap and compatible with github pages
 test_files: []