Hugo Starter

A Hugo ButterCMS Starter in Only Two Minutes

Get started using Hugo with this fully-functional Hugo starter project, fully integrated with ButterCMS, a leading headless CMS that makes collaborative content management of your app as easy as pie.

In less than two minutes, you can clone from GitHub, plug in your token, and run locally. Or, if you prefer, you can instantly deploy to Netlify with a single click, giving you an app you can share with your team.

A screenshot of the ButterCMS starter project — View Project on Github

First, create a virtual environment and install dependencies by running the below commands.

$ git clone https://github.com/ButterCMS/hugo-starter-buttercms.git $ cd hugo-starter-buttercms $ go mod download

To fetch your ButterCMS content, add your API token as an environment variable.

$ echo 'BUTTERCMS_API_TOKEN=your_token' >> .env

To fetch your ButterCMS content run:

$ go run github.com/ButterCMS/hugo-starter-buttercms/prebuild

To view the app in the browser, you'll need to run the local development server:

$ hugo server

Hugo quick start guide

This starter project will have you up and running with a rich Hugo project in minutes. It comes integrated with ButterCMS a feature-filled SaaS CMS.

Native support for user-created Pages, including reusable Page Types. Define your Page schema once by dragging and dropping desired fields with the easy-to-use graphical interface inside the Butter dashboard. Team members can then roll out as many pages of that type as needed.
Global components and Collection Items, which allow you to define content and partial schemas that can then be reused on any page.
Powerful, native media-file handling and CDN via Filestack. Make static file management a thing of the past.

How to start the Hugo project

Our Hugo + ButterCMS starter project is designed to showcase all the features of ButterCMS, including the usage of Components for content modeling and Collections to build the customizable navigation. Once you've set up your starter project, you'll be able to log into your new Butter account and make changes to your content in real-time! Follow the steps above to get running locally.