Skip to content

decaporg/one-click-hugo-cms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

3d69207 · Aug 5, 2024
Sep 4, 2019
Jul 26, 2023
Jun 30, 2023
Feb 2, 2024
Aug 5, 2024
Jul 16, 2019
Jun 30, 2023
Feb 2, 2024
Jul 7, 2022
Dec 22, 2016
Jul 26, 2023
Sep 21, 2016
Jan 26, 2024
Aug 16, 2022
Aug 16, 2022
Aug 23, 2023
Jul 7, 2022
Sep 4, 2019
Apr 11, 2023
Jul 7, 2022
Jul 7, 2022
Aug 23, 2023

Repository files navigation

Hugo template for Decap CMS with Netlify Identity

This is a small business template built with Hugo and Decap CMS, designed and developed by Darin Dimitroff, spacefarm.digital.

Getting started

Use our deploy button to get your own copy of the repository.

Deploy to Netlify

This will setup everything needed for running the CMS:

  • A new repository in your GitHub account with the code
  • Full Continuous Deployment to Netlify's global CDN network
  • Control users and access with Netlify Identity
  • Manage content with Decap CMS

Once the initial build finishes, you can invite yourself as a user. Go to the Identity tab in your new site, click "Invite" and send yourself an invite.

Now you're all set, and you can start editing content!

Local Development

Clone this repository, and run yarn or npm install from the new folder to install all required dependencies.

Then start the development server with yarn start or npm start.

Testing

With the development server running, run the tests locally with yarn cypress:run or npm run cypress:run. Or use yarn cypress:open or npm run cypress:open to run interactively.

Cypress tests also run on deploy with the Cypress Netlify integration.

Layouts

The template is based on small, content-agnostic partials that can be mixed and matched. The pre-built pages showcase just a few of the possible combinations. Refer to the site/layouts/partials folder for all available partials.

Use Hugo’s dict functionality to feed content into partials and avoid repeating yourself and creating discrepancies.

CSS

The template uses a custom fork of Tachyons and PostCSS with cssnext and cssnano. To customize the template for your brand, refer to src/css/imports/_variables.css where most of the important global variables like colors and spacing are stored.

SVG Social Icons

The social media icons are in site/assets/img. Make sure you use consistent icons in terms of viewport and art direction for optimal results. For an icon named icons-facebook.svg, refer to the SVG social-icon partial like so:

{{ partial "social-icon" (dict "link" "#" "svg" "icons-facebook" "alt" "Kaldi on Facebook") }}