mirror of
https://github.com/tiennm99/HugoBlox-kit.git
synced 2026-10-05 08:14:33 +00:00
George Cushen
a2aaa838c0
## Preact Block Integration
- Enable Preact component detection for data-driven pages:
- Fix init.html to resolve sections_source + per-section ref before Preact detection
- Correct resource paths: blox/* → js/hbx/blocks/* (Hugo module mounts)
- Update libraries.html to load Preact core + compiled block scripts
- Add dynamic icon rendering for Preact components:
- Create Icon.jsx component with SVG decoding
- Add get_icon_data.html partial for passing icon strings to Preact props
- Update preact-wrapper.html to fetch icon data and inject into props
- Wire hero component to render dynamic icons via <Icon svg={icon_svg} />
- Centralized logging system:
- Add functions/logger.html to wrap warnf/errorf safely
- Degrade to HTML comments in constrained contexts (content adapters)
## Reusable Landing Page Content System
- Add sections_source support:
- Page front matter: sections_source: pages/<key> loads base from data/pages/<key>.yaml
- Inline sections deep-merge over base by position; extras appended
- Add per-section ref system:
- Any section: ref: blocks/<slug> loads from data/blocks/<slug>.yaml
- Inline section properties deep-merge over ref (content/design submaps)
- Enable content reuse across multiple landing pages
- Create reusable block library:
- Add test/data/blocks/: hero_basic.yaml, features_basic.yaml
- Add test/content/linked/index.md demo using refs with overrides
- Add pragmatic deep merge for content/design override handling
## Infrastructure & Schemas
- Update base-block.json schema:
- Fix gradient structure: flat → nested (gradient.start/end/direction)
- Fix color structure: string|{light,dark} (matches parse_block_v3.html)
- Update hero schema to properly extend base via $ref
- Fix Tailwind source path generation:
- Add tailwind_sources.html with test vs starter site logic
- scripts/view-test.sh: export HUGO_BLOX_TEST_SITE=true
- Update block directory structure:
- blox/<name>/config.html (was blox/<name>--CONFIG.html)
- Apply to init.html + parse_block_v2.html
- Code quality improvements:
- Biome config: match Prettier rules
## Content Adapters (Removed)
- Investigated Hugo content adapters for landing pages
- Found execution context limitations (early build phase, limited site methods)
- Archived to backups/content-adapters-*.zip and removed from test site
- Decision: use standard pages + data linking instead of adapters
This enables dynamic Preact rendering with proper icon support while providing a flexible, reusable content system for landing pages that maintains the "single file = page" mental model with optional advanced linking.
Hugo Blox Tailwind CSS v4 Color System
Architecture Overview
This system leverages Tailwind CSS v4's automatic utility generation to provide a comprehensive color system with minimal code.
How It Works
-
Theme Configuration (
config/theme.css)- Colors defined in
@themeblock automatically generate ALL utilities - Includes standard Tailwind colors: gray, slate, zinc, neutral, stone
- Includes themeable colors: primary, secondary
- Colors defined in
-
Theme Files (
themes/*.css)- Small files that override
--color-primary-*and--color-secondary-*variables - Users switch themes by loading different theme CSS files
- No utilities redefined - just color values changed
- Small files that override
-
Custom Utilities (
color-utilities.css)- Only 42 lines vs previous 1,228 lines!
- Contains only custom colors not auto-generated (like
hb-dark)
Available Colors
Standard Colors (always available):
gray-*- Neutral graysslate-*- Cool grayszinc-*- True graysneutral-*- Pure graysstone-*- Warm grays
Themeable Colors (vary by theme):
primary-*- Main theme colorsecondary-*- Accent theme color
Custom Colors:
hb-dark- Hugo Blox brand dark color
Auto-Generated Utilities
For every color defined in @theme, Tailwind automatically creates:
- Background:
bg-{color}-{shade} - Text:
text-{color}-{shade} - Border:
border-{color}-{shade} - Hover:
hover:bg-{color}-{shade},hover:text-{color}-{shade} - Dark mode:
dark:bg-{color}-{shade},dark:text-{color}-{shade} - Gradients:
from-{color}-{shade},to-{color}-{shade} - Focus rings:
focus:ring-{color}-{shade} - All other Tailwind color variants
Shades Available
All colors include 11 shades: 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950
Usage Examples
<!-- Standard colors (always available) -->
<div class="bg-gray-100 dark:bg-gray-800">...</div>
<div class="text-slate-700 hover:text-slate-900">...</div>
<!-- Themeable colors (change with theme) -->
<div class="bg-primary-500 hover:bg-primary-600">...</div>
<div class="bg-gradient-to-r from-primary-600 to-secondary-600">...</div>
<!-- Custom colors -->
<div class="bg-hb-dark text-white">...</div>
Benefits
- Dramatically Reduced File Size: 1,228 lines → 42 lines (97% reduction!)
- Automatic Generation: No manual utility definitions needed
- Maintainable: Add new colors just by defining them in
@theme - Consistent: All Tailwind variants automatically available
- Themeable: Easy theme switching via CSS variable overrides
Adding New Colors
To add a new color scale:
-
Define in
config/theme.css:--color-brand-500: 59 130 246; --color-brand-600: 37 99 235; /* etc. */ -
Tailwind automatically generates all utilities:
bg-brand-500,text-brand-600,hover:bg-brand-500, etc.
No manual utility definitions required!