Skip to main content

    Documentation

    Simple, yet powerful. Learn how to use Congo and its features.

    Screenshots of Congo on an iPhone, iPad and MacBook

    This section contains everything you need to know about Congo. If you’re new, check out the Installation guide to begin or visit the Samples section to see what Congo can do.

    Special thanks to Katerina Limpitsouni for the excellent illustrations that are used throughout these docs!


    What's New in 2.0 ✨

    4 mins
    Version 2 takes Congo to new heights, making the theme even more powerful while still maintaining its lightweight footprint.

    Installation

    5 mins
    Learn how to get up and running using Hugo and Congo from a completely blank state. It’s the best place to start if you’re a new user.

    Getting Started

    7 mins
    This section assumes you have already installed the Congo theme and are ready to start with basic configuration tasks like selecting a colour scheme, menu and content structure.

    Configuration

    12 mins
    Discover all the site, language and theme configurations that are available in Congo and how they can be used to customise your project.

    Homepage Layout

    3 mins
    Congo provides a fully flexible homepage layout with built-in templates and the ability to provide your own.

    Front Matter

    3 mins
    While supporting most Hugo defaults, Congo adds a number of front matter parameters to customise the presentation of individual articles.

    Shortcodes

    6 mins
    Congo includes several shortcodes for adding rich content to articles including images, charts, diagrams, buttons and more.

    Partials

    5 mins
    Partials are used to add special functionality to the theme including analytics, comments, favicons, custom scripts and more.

    Content Examples

    10 mins
    It’s time to bring everything together with some examples that demonstrate how content should be created and structured.

    Advanced Customisation

    8 mins
    Congo supports advanced customisations that include modifying the underlying Tailwind configuration, building the theme manually and providing custom CSS.

    Hosting & Deployment

    4 mins
    Congo is designed to be flexible in almost any deployment scenario. Learn more about how to deploy your project to some common hosting platforms.