This is a sample Hugo starter site that uses Agility CMS and aims to be a foundation for building fully static sites using Hugo and Agility CMS.
New to Agility CMS? Sign up for a FREE account
- Generates a combination of Markdown (.md) files in the content folder and JSON files in the data folder for each locale/language that you have configured.
- Connected to a sample Agility CMS Instance for sample content & pages.
- Supports full Page Management
- Provides a functional structure that dynamically routes each page based on the request, loads a Page Template dynamically, and also dynamically loads and renders appropriate Agility CMS Page Modules as short codes (see the
layouts/shortcodes/page-modulesandlayouts/shortcodes/page-templatesfolders).
This starter uses Tailwind CSS, a simple and lightweight utility-first CSS framework packed with classes that can be composed to build any design, directly in your markup.
It also comes equipped with Autoprefixer, a plugin which use the data based on current browser popularity and property support to apply CSS prefixes for you.
To start using the Agility CMS & Hugo Starter, sign up for a FREE account and create a new Instance using the Next.js Blog Template.
- Clone this repository
- Run
npm installoryarn install - Rename the
.env.examplefile to.env - Retrieve your
GUIDandAPI Keys (Preview/Fetch)from Agility CMS by going to Settings > API Keys.
How to Retrieve your GUID and API Keys from Agility
When running your site in development mode, you will see the latest content in real-time from the CMS.
yarn installyarn start
To clear your content cache locally, run yarn clean
npm installnpm run start
To clear your content cache locally, run npm run cms-clean
When running your site in production mode, you will see the published from the CMS.
yarn buildnpx http-server public
npm run buildnpx http-server public
To create a new Page Module, create a new shortcode file within the /layouts/shortcodes/page-modules directory.
To create a new Page Templates, create a new shortcode file within the /layouts/shortcodes/page-templates directory.
If you have feedback or questions about this starter, please use the Github Issues on this repo, join our Community Slack Channel or create a post on the Agility Developer Community.