Skip to content
HugoBlox Docs

Project File Structure

Understanding the folder structure is key to mastering HugoBlox.

Project Root

Section titled “Project Root”
  • Directory.github/ # GitHub’s workflow to automatically deploy your site
    • …
  • Directoryassets/
    • Directorymedia/ # Images, icons, and videos
      • Directoryauthors/ # Author avatar images (e.g., jane-doe.jpg)
        • …
    • Directorycss/ # Any custom styles
      • …
  • Directoryconfig/
    • Directory_default/ # Configuration files (hugo.yaml, params.yaml)
      • …
  • Directorycontent/ # Your markdown content
    • …
  • Directorydata/
    • Directoryauthors/ # Author profiles (YAML files, e.g., jane-doe.yaml)
      • …
  • Directorylayouts/ # Any custom HTML overrides
    • …
  • Directorystatic/ # Static files served as-is (CNAME)
    • Directoryuploads/ # Uploads (resume.pdf)
      • …
  • hugoblox.yaml # HugoBlox template metadata
  • go.mod # List of installed Hugo modules
  • netlify.toml # If you host your site with Netlify

Key Directories

Section titled “Key Directories”
DirectoryDescription
content/Where you write your posts, pages, and publications. This mirrors your site’s URL structure.
assets/Assets processed by Hugo (Images, Videos, Custom Styles).
static/Files copied directly to the public/ folder without processing. Useful for SEO verification files.
config/Site settings. Split into multiple files for better organization (params.yaml, menus.yaml).
layouts/Used to override built-in layouts or create custom blocks/hooks.