https://github.com/netlify-templates/one-click-hugo-cms

Hugo template with Decap CMS
https://github.com/netlify-templates/one-click-hugo-cms

decap hugo netlify template

Last synced: 3 months ago
JSON representation

Hugo template with Decap CMS

• Host: GitHub
• URL: https://github.com/netlify-templates/one-click-hugo-cms
• Owner: decaporg
• License: mit
• Created: 2017-09-07T03:11:30.000Z (about 7 years ago)
• Default Branch: main
• Last Pushed: 2024-02-02T06:04:27.000Z (10 months ago)
• Last Synced: 2024-06-19T14:02:34.660Z (5 months ago)
• Topics: decap, hugo, netlify, template
• Language: SCSS
• Homepage: https://master-template-one-click-hugo-cms.netlify.app
• Size: 48.6 MB
• Stars: 482
• Watchers: 26
• Forks: 304
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# Hugo template for Decap CMS with Netlify Identity

This is a small business template built with [Hugo](https://gohugo.io) and [Decap CMS](https://github.com/decaporg/decap-cms), designed and developed by [Darin Dimitroff](https://twitter.com/deezel), [spacefarm.digital](https://www.spacefarm.digital).

## Getting started

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

[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/decaporg/one-click-hugo-cms&stack=cms)

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](https://www.netlify.com/integrations/cypress/).

## 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") }}

```