Files
HugoBlox-kit/templates/documentation/config/_default/params.yaml
T
George Cushen 51efdcd098 feat(themes): new color theme engine & packs 🎨
- **New Hybrid Engine:** Fully data-driven theming using YAML (`modules/blox-tailwind/data/themes/`). Supports:
  - **Palette Mode:** `primary: "indigo"` loads exact Tailwind 50-950 scales (OKLCH) for perfect utility matching.
  - **Hex Mode:** `primary: "#brand"` auto-generates accessible 50-950 tint/shade scales.
  - **Semantic Overrides:** `ui.header.background` accepts gradients, transparency, and images.
  - **Neutral Mapping:** Themes can retarget the gray scale (e.g. `neutral: "stone"` warms up the entire UI).

- **New Theme Packs:**
  - `default` (Blue/Sky + Dark)
  - `contrast` (High Contrast Light)
  - `latte` (Warm Coffee/Stone)
  - `dracula` (Dark Purple/Pink)
  - `americano` (Dark Espresso)
  - `marine` (Deep Ocean/Teal)
  - `retro` (Vintage Paper)
  - `synthwave` (Neon/Purple)
  - `cupcake` (Light Pink/Fuchsia)

- **Architecture:**
  - Standardized on `appearance.theme.light` / `appearance.theme.dark` config.
  - Legacy `appearance.color` remains as a primary color override.

This overhaul enables colored backgrounds/navbars, enables mix-and-match themes, and future-proofs the styling system for Tailwind v4.
2025-11-30 04:45:38 +00:00

87 lines
2.0 KiB
YAML

# SITE SETUP
# Guide: https://docs.hugoblox.com/tutorial/
# Documentation: https://docs.hugoblox.com/
# This file is formatted using YAML syntax - learn more at https://learnxinyminutes.com/docs/yaml/
# Appearance
appearance:
mode: light
theme:
light: "default"
dark: "default"
# SEO
marketing:
seo:
site_type: Project
local_business_type: ''
org_name: ''
description: 'A highly-customizable Hugo documentation theme powered by Hugo Blox website builder.'
twitter: 'BuildLore'
analytics:
google_analytics: ''
google_tag_manager: ''
microsoft_clarity: ''
baidu_tongji: ''
plausible: ''
fathom: ''
pirsch: ''
verification:
google: ''
baidu: ''
# Site header
header:
navbar:
enable: true
blox: "navbar"
align: "center"
fixed_to_top: true
logo:
text: ""
# Logo filename in `assets/media/` folder
filename: "logo.svg"
button:
enable: true
text: "Get Started"
url: "https://hugoblox.com/templates/details/docs/"
show_search: true
show_theme_chooser: true
# Site footer
footer:
copyright:
notice: '© {year} My Company. This work is licensed under {license}'
license:
enable: true
allow_derivatives: false
share_alike: true
allow_commercial: false
# Localization
locale:
date_format: 'Jan 2, 2006'
time_format: '3:04 PM'
# Site features
features:
math:
enable: false
privacy_pack:
enable: false
repository:
url: 'https://github.com/HugoBlox/hugo-blox-builder/'
content_dir: 'templates/documentation/content'
branch: 'main'
feedback:
responses:
positive: 'Glad to hear it! [Any ideas for improvements?](https://github.com/<USERNAME>/<REPO>/issues/new).'
negative: 'Sorry to hear that. [Please tell us how we can improve](https://github.com/<USERNAME>/<REPO>/issues/new).'
comment:
provider: ''
giscus:
repo: ''
repo_id: ''
category: ''
category_id: ''