Skip to content
Ownable Docs

HugoBlox Framework

HugoBlox is the open-source framework that powers every Ownable site. It extends Hugo — the world’s fastest static site generator — with a modular block system, academic content types, and zero-config defaults optimized for researchers and technical founders.

🏗️ Architecture at a Glance

Section titled “🏗️ Architecture at a Glance”
graph LR
    A["📝 Markdown + YAML"] --> B["⚙️ HugoBlox Framework"]
    B --> C["🧱 50+ Content Blocks"]
    B --> D["📄 Academic Content Types"]
    B --> E["🎨 Theme Engine"]
    C --> F["🌐 Static HTML"]
    D --> F
    E --> F
    F --> G["🚀 Deploy Anywhere"]

HugoBlox takes your Markdown content and YAML configuration, runs it through a powerful block engine and theme system, and outputs pure static HTML — no databases, no runtime, no JavaScript bloat.

🚀 Quick Start

Section titled “🚀 Quick Start”

No install required. Our AI copilot creates and deploys your site in 60 seconds.

Launch with AI Copilot → Choose a template and deploy — free, no Git knowledge needed.

📂 How a Site is Organized

Section titled “📂 How a Site is Organized”

Every HugoBlox site follows a clean, predictable structure:

  • Directoryconfig/
    • Directory_default/
      • hugoblox.yaml # Framework config
      • params.yaml # Site parameters
      • menus.yaml # Navigation menus
  • Directorycontent/
    • _index.md # Homepage (landing page)
    • Directorypost/ # Blog posts
      • …
    • Directorypublication/ # Academic papers
      • …
    • Directoryproject/ # Portfolio items
      • …
    • Directoryevent/ # Talks & conferences
      • …
  • Directoryassets/
    • Directorymedia/ # Images & media
      • …
  • Directorydata/
    • Directoryauthors/ # Author profiles
      • …
Site Structure Reference →

📦 What You Can Build

Section titled “📦 What You Can Build”

HugoBlox ships with content types purpose-built for researchers and technical teams:

📄 Landing Pages

Stack blocks to build stunning homepages: hero, features, team, CTA, and more. → Landing Pages guide

📝 Blog Posts

Date-ordered entries with categories, tags, authors, and reading time. → Blog Posts guide

📚 Publications

BibTeX import, citation files, PDF attachments — first-class academic support. → Publications guide

🧪 Projects

Showcase research tools, apps, and case studies with links and featured images. → Projects guide

🎤 Events & Talks

Conference talks with start/end times, locations, and embedded slide decks. → Events guide

🎞️ Slides

Reveal.js presentations written entirely in Markdown. → Slides guide

🎨 Customize Everything

Section titled “🎨 Customize Everything”
Theming & Style Color palettes, fonts, spacing — make it yours.
Page Builder (Blocks) 50+ drag-and-drop content blocks.
Configuration Site parameters, menus, and settings.

🔌 Integrations

Section titled “🔌 Integrations”
SEO & Open Graph Sitemaps, meta tags, and rich previews.
Analytics PostHog, Plausible, Google Analytics & more.
Comments Disqus, Giscus, and Commento.
Hosting & Deploy GitHub Pages, Netlify, Vercel, and more.

🧰 Use with Ownable CMS

Section titled “🧰 Use with Ownable CMS”

Get visual editing, an AI assistant, Fix-It Bot, and more — all inside VS Code.

Install Ownable CMS → Visual editor, AI assistant, and automation tools for your HugoBlox site.