high contrast palettes (#211)

* Palette wcag review (#154)

* Add new palettes

* change palette review href's to main page links

---------

Co-authored-by: ntno <ntno@users.noreply.github.com>

* include proposed palettes in test suite

* increased contrast

* increase contrast

* increase contrast

* remove wip palettes

* update footnotes and footnote links

* regenerate updated palettes on demo site

* note new palettes and plan for failing palettes

* rename markdown for consistency, update links

* minor version bump

* add 4.8.0 to releases

---------

Co-authored-by: Chandler Cowell <64285308+cowellbunga@users.noreply.github.com>

Author: ntno

documentation/docs/accessibility.md

@@ -1,25 +1,39 @@
 # Accessibility
 
+The [dark], [sans_dark], [blueberry], [lightyear], and [red_drum] color palettes meet WCAG 2.1 AA color contrast standards.  
+
+The [default], [sans], [pink], and [gruvbox_dark] color palettes currently have the contrast issues noted below.  These palettes will be updated in the next major release and their current settings moved to a legacy version.
+
+[default]: ../configuration/palettes/default/
+[sans]: ../configuration/palettes/sans/
+[pink]: ../configuration/palettes/pink/
+[gruvbox_dark]: ../configuration/palettes/gruvbox-dark/
+[dark]: ../configuration/palettes/dark/
+[sans_dark]: ../configuration/palettes/sans-dark/
+[blueberry]: ../configuration/palettes/blueberry/
+[lightyear]: ../configuration/palettes/lightyear/
+[red_drum]: ../configuration/palettes/red-drum/
+
 ## Known Issues
 
 ### Color Contrast
 
-| Palette      | Primary Links | Buttons | Code Blocks |
-| ------------ | ------------- | ------- | ----------- |
-| [default](../configuration/palettes/default/) | x | x |  |
-| [sans](../configuration/palettes/sans/) | x | x |  |
-| [pink](../configuration/palettes/pink/) | x | x |  |
-| [gruvbox_dark](../configuration/palettes/gruvbox-dark/) |  | x |  |
-| [dark](../configuration/palettes/dark/) |  |  |  |
-| [sans_dark](../configuration/palettes/sans-dark/) |  |  |  |
+| Palette        | Primary Links | Buttons | Code Blocks |
+| -------------- | ------------- | ------- | ----------- |
+| [default]      | x             | x       |             |
+| [sans]         | x             | x       |             |
+| [pink]         | x             | x       |             |
+| [gruvbox_dark] |               | x       |             |
+| [dark]         |               |         |             |
+| [sans_dark]    |               |         |             |
+| [blueberry]    |               |         |             |
+| [lightyear]    |               |         |             |
+| [red_drum]     |               |         |             |
 
-'x' indicates an open WCAG 2.1 AA contrast failure detected by the [test_color_contrast.py] integration test.  
+'x' indicates an open WCAG 2.1 AA contrast failure detected by the [test_color_contrast.py] integration test.
 
 See [Color Contrast Failures](#color-contrast-failures) for the measured ratios and affected components.
 
-Future releases of the Terminal for MkDocs theme will include palettes which meet WCAG 2.1 AA contrast standards.  To track progress, see issue [#119](https://github.com/ntno/mkdocs-terminal/issues/119).
-
-
 [test_color_contrast.py]: https://github.com/ntno/mkdocs-terminal/blob/main/tests/accessibility/test_color_contrast.py
 
 #### Color Contrast Failures
@@ -29,27 +43,33 @@ Ratios and RGB hex pairs come from the January 25 2026 run of [tests/accessibi
 Expected contrast for all combinations is `4.5 : 1`
 
 ##### default
-- Primary links (#1a95e0 on #ffffff) measure `3.27 : 1` 
-- Primary buttons (#ffffff text on #1a95e0 background) also measure `3.27 : 1` 
+
+- Primary links (#1a95e0 on #ffffff) measure `3.27 : 1`
+- Primary buttons (#ffffff text on #1a95e0 background) also measure `3.27 : 1`
 
 ##### dark
+
 - No open contrast failures as of January 25 2026.
 
 ##### gruvbox_dark
+
 - Alert message accents (#fb4934 on #282828) measure `4.29 : 1`
-- Ghost error buttons (#fb4934 text on #282828 background) also measure `4.29 : 1` 
+- Ghost error buttons (#fb4934 text on #282828 background) also measure `4.29 : 1`
 
 ##### pink
-- Primary links (#f90d7a on #ffffff) measure `3.91 : 1` 
-- Primary buttons (#f7f7f7 on #f90d7a) measure `3.65 : 1` 
+
+- Primary links (#f90d7a on #ffffff) measure `3.91 : 1`
+- Primary buttons (#f7f7f7 on #f90d7a) measure `3.65 : 1`
 
 ##### sans
+
 - Primary links (#1a95e0 on #ffffff) measure `3.27 : 1 `
-- Primary buttons (#ffffff on #1a95e0) measure `3.27 : 1` 
+- Primary buttons (#ffffff on #1a95e0) measure `3.27 : 1`
 
 ##### sans_dark
+
 - No open contrast failures as of January 25 2026.
 
 ## Report An Issue
 
-To report an issue, please create a new issue in the GitHub repository: [mkdocs-terminal > Create new issue](https://github.com/ntno/mkdocs-terminal/issues/new/choose)
+To report an issue, please create a new issue in the GitHub repository: [mkdocs-terminal > Create new issue](https://github.com/ntno/mkdocs-terminal/issues/new/choose)

documentation/docs/configuration/palettes/blueberry.md

@@ -0,0 +1,44 @@
+---
+show_tiles_inline: true
+tiles:
+  - caption: '@petradr'
+    img_src: ../../../img/picsum/167_200x200.jpeg
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
+    link_href: https://picsum.photos/ 
+  - caption: 'Marcin Czerwinski'
+    img_src: ../../../img/picsum/127_200x200.jpeg
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
+    link_href: https://picsum.photos/ 
+  - caption: "Steve Richey"
+    img_src: ../../../img/picsum/143_200x200.jpeg
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
+    link_href: https://picsum.photos/
+---
+
+--8<--
+configuration/palettes/links.md
+--8<--
+
+# Blueberry Palette
+
+To use the blueberry palette, add the `palette` attribute to your theme configuration in `mkdocs.yml`:
+
+```yaml
+theme:
+  name: terminal
+  palette: blueberry
+```
+
+<link href="../../../css/palettes/blueberry.css" rel="stylesheet">
+
+--8<--
+elements/examples/index.md
+--8<--
+
+## Tile Grid Example
+{{ tile_grid(page.meta) }}
+
+<br>

documentation/docs/configuration/palettes/index.md

@@ -6,40 +6,58 @@ tiles:
     tooltip: to Default Demo Page 
     alt_text: Default Demo Page
     link_href: ./default/
-  - caption: <a id="fnref:2" class="footnote-ref" title="to image description" alt="to Gruvbox Dark palette description." href="#fn:2">Gruvbox Dark</a>
+  - caption: <a id="fnref:2" class="footnote-ref" title="to image description" alt="to Blueberry palette description." href="#fn:2">Blueberry</a>
+    img_src: ../../img/palettes/blueberry.png
+    tooltip: to Blueberry Demo Page
+    alt_text: Blueberry Demo Page
+    link_href: ./blueberry/
+  - caption: <a id="fnref:3" class="footnote-ref" title="to image description" alt="to Gruvbox Dark palette description." href="#fn:3">Gruvbox Dark</a>
     img_src: ../../img/palettes/gruvbox_dark.png
     tooltip: to Gruvbox Dark Demo Page
     alt_text: Gruvbox Dark Demo Page
     link_href: ./gruvbox-dark/
-  - caption: <a id="fnref:3" class="footnote-ref" title="to image description" alt="to Dark palette description." href="#fn:3">Dark</a>
+  - caption: <a id="fnref:4" class="footnote-ref" title="to image description" alt="to Dark palette description." href="#fn:4">Dark</a>
     img_src: ../../img/palettes/dark.png
     tooltip: to Dark Demo Page 
     alt_text: Dark Demo Page
-    link_href: ./dark/    
-  - caption: <a id="fnref:4" class="footnote-ref" title="to image description" alt="to Pink palette description." href="#fn:4">Pink</a>
+    link_href: ./dark/
+  - caption: <a id="fnref:5" class="footnote-ref" title="to image description" alt="to Lightyear palette description." href="#fn:5">Lightyear</a>
+    img_src: ../../img/palettes/lightyear.png
+    tooltip: to Lightyear Demo Page
+    alt_text: Lightyear Demo Page
+    link_href: ./lightyear/
+  - caption: <a id="fnref:6" class="footnote-ref" title="to image description" alt="to Pink palette description." href="#fn:6">Pink</a>
     img_src: ../../img/palettes/pink.png
     tooltip: to Pink Demo Page
     alt_text: Pink Demo Page
     link_href: ./pink/        
-  - caption: <a id="fnref:5" class="footnote-ref" title="to image description" alt="to Sans palette description." href="#fn:5">Sans</a>
+  - caption: <a id="fnref:7" class="footnote-ref" title="to image description" alt="to Red Drum palette description." href="#fn:7">Red Drum</a>
+    img_src: ../../img/palettes/red_drum.png
+    tooltip: to Red Drum Demo Page
+    alt_text: Red Drum Demo Page
+    link_href: ./red-drum/
+  - caption: <a id="fnref:8" class="footnote-ref" title="to image description" alt="to Sans palette description." href="#fn:8">Sans</a>
     img_src: ../../img/palettes/sans.png
     tooltip: to Sans Demo Page
     alt_text: Sans Demo Page
     link_href: ./sans/    
-  - caption: <a id="fnref:6" class="footnote-ref" title="to image description" alt="to Sans Dark palette description." href="#fn:6">Sans Dark</a>
+  - caption: <a id="fnref:9" class="footnote-ref" title="to image description" alt="to Sans Dark palette description." href="#fn:9">Sans Dark</a>
     img_src: ../../img/palettes/sans_dark.png
     tooltip: to Sans Dark Demo Page 
     alt_text: Sans Dark Demo Page
-    link_href: ./sans-dark/            
+    link_href: ./sans-dark/ 
 ---
 
 # Theme Color Palettes
 Terminal for MkDocs supports the following color palettes by default:
 
   - [default](default.md)
+  - [blueberry](blueberry.md)
   - [gruvbox_dark](gruvbox-dark.md)
   - [dark](dark.md)
+  - [lightyear](lightyear.md)
   - [pink](pink.md)
+  - [red_drum](red-drum.md)
   - [sans](sans.md)
   - [sans_dark](sans-dark.md)
 
@@ -52,8 +70,11 @@ theme:
 ```
 
 [^1]: white background and light blue hyperlinks.
-[^2]: dark grey background, orange hyperlinks, and light yellow text.
-[^3]: black background, light blue hyperlinks, and white text.
-[^4]: white background and pink hyperlinks.
-[^5]: white background, light blue hyperlinks, and sans font.
-[^6]: black background, light blue hyperlinks, and white text in sans font.
+[^2]: cream background and navy blue hyperlinks
+[^3]: dark grey background, orange hyperlinks, and light yellow text.
+[^4]: black background, light blue hyperlinks, and white text.
+[^5]: light green background and indigo hyperlinks
+[^6]: white background and pink hyperlinks.
+[^7]: beige background and brown hyperlinks.
+[^8]: white background, light blue hyperlinks, and sans font.
+[^9]: black background, light blue hyperlinks, and white text in sans font.

documentation/docs/configuration/palettes/lightyear.md

@@ -0,0 +1,44 @@
+---
+show_tiles_inline: true
+tiles:
+  - caption: '@petradr'
+    img_src: ../../../img/picsum/167_200x200.jpeg
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
+    link_href: https://picsum.photos/ 
+  - caption: 'Marcin Czerwinski'
+    img_src: ../../../img/picsum/127_200x200.jpeg
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
+    link_href: https://picsum.photos/ 
+  - caption: "Steve Richey"
+    img_src: ../../../img/picsum/143_200x200.jpeg
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
+    link_href: https://picsum.photos/
+---
+
+--8<--
+configuration/palettes/links.md
+--8<--
+
+# Lightyear Palette
+
+To use the lightyear color palette, add the `palette` attribute to your theme configuration in `mkdocs.yml`:
+
+```yaml
+theme:
+  name: terminal
+  palette: lightyear
+```
+
+<link href="../../../css/palettes/lightyear.css" rel="stylesheet">
+
+--8<--
+elements/examples/index.md
+--8<--
+
+## Tile Grid Example
+{{ tile_grid(page.meta) }}
+
+<br>

documentation/docs/configuration/palettes/links.md

@@ -1,8 +1,11 @@
 <nav class="terminal-mkdocs-pad-to-match-side-nav" markdown>
 [Default](default.md) |
+[Blueberry](blueberry.md) |
 [Gruvbox Dark](gruvbox-dark.md) |
 [Dark](dark.md) |
+[Lightyear](lightyear.md) |
 [Pink](pink.md) |
+[Red Drum](red-drum.md) |
 [Sans](sans.md) |
 [Sans Dark](sans-dark.md)
 </nav>

documentation/docs/configuration/palettes/red-drum.md

@@ -0,0 +1,44 @@
+---
+show_tiles_inline: true
+tiles:
+  - caption: '@petradr'
+    img_src: ../../../img/picsum/167_200x200.jpeg
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
+    link_href: https://picsum.photos/ 
+  - caption: 'Marcin Czerwinski'
+    img_src: ../../../img/picsum/127_200x200.jpeg
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
+    link_href: https://picsum.photos/ 
+  - caption: "Steve Richey"
+    img_src: ../../../img/picsum/143_200x200.jpeg
+    tooltip: 'to Picsum homepage'
+    alt_text: 'Picsum Photo API.'
+    link_href: https://picsum.photos/
+---
+
+--8<--
+configuration/palettes/links.md
+--8<--
+
+# Red Drum Palette
+
+To use the red_drum color palette, add the `palette` attribute to your theme configuration in `mkdocs.yml`:
+
+```yaml
+theme:
+  name: terminal
+  palette: red_drum
+```
+
+<link href="../../../css/palettes/red_drum.css" rel="stylesheet">
+
+--8<--
+elements/examples/index.md
+--8<--
+
+## Tile Grid Example
+{{ tile_grid(page.meta) }}
+
+<br>

documentation/docs/img/palettes/blueberry.png

@@ -24,6 +24,7 @@ See [Version Identification and Dependency Specification] for additional constra
 
 | Release | Theme Status | Supported? |
 | :-----: | :----------: | :--------: |
+| [4.8.0] |     Beta     |    yes     |
 | [4.7.0] |     Beta     |    yes     |
 | [4.3.0] |     Beta     |    yes     |
 | [4.1.0] |     Beta     |    yes     |
@@ -34,6 +35,7 @@ See [Version Identification and Dependency Specification] for additional constra
 
 
 <br>
+[4.8.0]: https://github.com/ntno/mkdocs-terminal/releases/tag/4.8.0
 [4.7.0]: https://github.com/ntno/mkdocs-terminal/releases/tag/4.7.0
 [4.3.0]: https://github.com/ntno/mkdocs-terminal/releases/tag/4.3.0
 [4.1.0]: https://github.com/ntno/mkdocs-terminal/releases/tag/4.1.0