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
2025-11-20 22:30:06 +00:00
2025-09-17 10:09:25 +01:00
2025-11-20 22:30:06 +00:00
2025-11-24 20:54:45 +00:00
2025-11-15 15:41:21 +00:00
2025-08-16 02:08:34 +01:00
2025-08-16 02:08:34 +01:00
2025-11-20 22:30:06 +00:00
2025-11-20 22:30:06 +00:00

中文

Build world-class sites with Hugo Blox

The Open Source Copilot for Technical & Academic Websites

Build a "Future-Proof" Brand in the AI Era.
The choice of rockstar researchers and founders at Meta, Stanford, NVIDIA, and Y Combinator.

🚀 Launch Copilot (Free)  •  Go Pro

Discord GitHub Stars Follow on X


Why Top Talent Chooses Hugo Blox

In the age of AI agents, Markdown is the new source code.

Vibe coding tools generate fragile, "black box" React/JS apps that are a nightmare to maintain once the AI disconnects. Hugo Blox is different. We combine the speed of an AI builder with the robustness of a static site generator.

  • 🔮 Future-Proof & AI Ready: Your content lives in clean Markdown—the native language of LLMs. It's readable by humans and machines forever. No vendor lock-in.
  • 🧠 The "Copilot" Workflow:
    • Online: Use our AI-assisted deployer to launch in 60 seconds.
    • VS Code (Coming Soon): Write content and visualize blocks directly in your editor with our upcoming AI extension.
  • ⚡ Performance without Debt: Get perfect 100/100 Lighthouse scores. Zero "JS bloat". We handle the heavy lifting (Tailwind 4, Hugo Modules) so you focus on your research/startup.
  • 🎓 Research-Grade Features: Native support for LaTeX math, BibTeX auto-citations, and Jupyter Notebooks. If you publish papers, this is your unfair advantage.

Template previews

Browse Templates →


Get Started

Option 1: The Online Copilot (Fastest)

Launch a professional site for your Lab, Startup, or Bio in under 2 minutes.

👉 Start Free in Browser

Option 2: The CLI (For Developers)

Prefer the terminal? Use our local copilot to scaffold your site:

npx hugoblox create

*Prerequisites: Hugo Extended & Node.

For more guides, visit our documentation at https://docs.hugoblox.com/.


Free vs. Pro

Hugo Blox is open core. You can build a world-class site for free. Pro is for those who want to move faster and support the ecosystem.

Feature Open Source Hugo Blox Pro
Core Framework ✅ ✅
Standard Blocks (Hero, Features, etc.) ✅ ✅
Premium Templates (SaaS, Course, Lab) ❌ ✅ Included
Exclusive Pro Blocks ❌ ✅ Included
Lifetime Updates ❌ ✅ Included
Support the Project ❤️ 🏆 Hero Status

👉 Upgrade to Pro


What Creators Say

"Hugo Blox saved me 40+ hours on my lab site. Bibtex integration auto-updates publications — our citations are up 3×." — Dr. Sarah Yang, AI Researcher

"We launched our documentation in 10 minutes. The block system is genius; onboarding time dropped by 60%." — Alexandre Rodrigues, Founder


Support the Project

  • 💎 Pro (one-time donation) — Get lifetime access to all premium templates, blocks, and updates.
    Go Pro →

  • ☕️ Donate a Coffee — Support open source and open research.
    Sponsor on GitHub →

  • 🤝 Corporate Sponsors — Reach thousands of developers and researchers. Get your logo and link in this README.
    Become a Partner →


Community

Join the community to ask questions, share your work, and help us improve.


License

MIT © 2016–Present George Cushen — License Details

No tracking. No lock-in. Your content stays yours.

S
Description
🧱 Describe your site, AI builds it, you own it as Markdown. Snap together Tailwind blocks like Lego — landing pages, blogs, portfolios, docs & more. No AI slop. Free to deploy anywhere 👇
Readme MIT Cite this repository
79 MiB
0 Stars 1 Watchers 0 Forks
Languages
HTML 67.1%
JavaScript 16.6%
CSS 10.4%
Python 3.3%
Jupyter Notebook 1.8%
Other 0.7%