Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


NOTE: I don't actively work on this theme now. Pull requests for bug fixes or new features are welcome however. Before working on a substantial change, please discuss it in an issue. Thanks. :)

A consistent and responsive Hugo theme with clean typography. The primary typefaces are Open Sans, Raleway, and Ubuntu Mono.

Demo / Screenshots


  • Responsive
  • Suited for blogging and personal webpages
  • Disqus support
  • Built-in 404 page
  • Syntax highlighting with highlightjs (by @andy4thehuynh)
  • Gravatar/static profile image (by @remeh)
  • RSS feed and icon (by @mvrilo)
  • Optimized SVG icons (by @robinst) for Instagram, 500px, and more
  • Cache busting
  • Google Analytics
  • Piwik and Gitalk support

Most features are optional and can be individually enabled/disabled in your config.toml.

Table of Contents

Quick Start

From the root of your Hugo site, clone the theme into themes/cocoa by running:

# Clone theme into the themes/cocoa directory
$ git clone themes/cocoa

# Generate site files into the public directory
$ hugo -t cocoa

# Or, serve your site and visit localhost:1313 in your browser
$ hugo -t cocoa --watch serve



Please see the sample config.toml. Note that if you already use cocoa but have updated to Hugo 0.18, you must lowercase every params of your existing config.toml (like in the sample).

Creating Posts

Posts should generally go under a content/blog directory. Typically you would run:

hugo new blog/

For posts to appear on your site, you may need draft = false in the post's front matter or use the --buildDrafts option when building.

Creating Fixed Pages

Fixed pages such as an About page should preferably go under content/fixed or be present at the root of the content directory.

hugo new fixed/


This theme is built and improved upon by open source contributions. Pull requests, bug fixes, and new features are welcome!


Licensed under the MIT License. See the LICENSE file for more details.