{"id":13515038,"url":"https://github.com/zerostaticthemes/hugo-hero-theme","last_synced_at":"2025-05-15T08:06:24.385Z","repository":{"id":39914193,"uuid":"160591048","full_name":"zerostaticthemes/hugo-hero-theme","owner":"zerostaticthemes","description":"A multi-page Hugo theme with fullscreen hero images and fullwidth sections.","archived":false,"fork":false,"pushed_at":"2024-11-01T23:56:56.000Z","size":28875,"stargazers_count":379,"open_issues_count":6,"forks_count":258,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-05-04T21:02:06.052Z","etag":null,"topics":["bootstrap","builtatlightspeed","hugo","hugo-theme","jamstack","theme"],"latest_commit_sha":null,"homepage":"https://hugo-hero.netlify.app","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zerostaticthemes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-12-05T23:22:47.000Z","updated_at":"2025-04-09T16:52:45.000Z","dependencies_parsed_at":"2024-11-21T09:02:16.018Z","dependency_job_id":null,"html_url":"https://github.com/zerostaticthemes/hugo-hero-theme","commit_stats":{"total_commits":105,"total_committers":14,"mean_commits":7.5,"dds":"0.17142857142857137","last_synced_commit":"7d6ff397e0f7d8b92b6b258606b3bd0802d2b99c"},"previous_names":["jugglerx/hugo-hero-theme"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerostaticthemes%2Fhugo-hero-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerostaticthemes%2Fhugo-hero-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerostaticthemes%2Fhugo-hero-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerostaticthemes%2Fhugo-hero-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zerostaticthemes","download_url":"https://codeload.github.com/zerostaticthemes/hugo-hero-theme/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254301431,"owners_count":22047904,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap","builtatlightspeed","hugo","hugo-theme","jamstack","theme"],"created_at":"2024-08-01T05:01:05.591Z","updated_at":"2025-05-15T08:06:24.336Z","avatar_url":"https://github.com/zerostaticthemes.png","language":"SCSS","funding_links":[],"categories":["Hugo Themes","SCSS","bootstrap"],"sub_categories":[],"readme":"# Hugo Hero Theme\n\nHero is a multi-page business theme with fullscreen hero images and fullwidth sections.\n\n[Live Demo](https://hugo-hero.netlify.app/) |\n[Zerostatic Themes](https://www.zerostatic.io/theme/hugo-hero/)\n\n![Hugo Hero Theme screenshot](https://www.zerostatic.io/theme/hugo-hero/hugo-hero-screenshot.png)\n\n## Features\n\n**Content Types**\n- Services (Markdown)\n- Work/Portfolio (Markdown)\n- Features (Data)\n- About (Markdown, Single Page, Shortcodes)\n- Homepage (Markdown, Single Page, multiple .md files in one layout)\n\n**Content Management**\n- This theme's content is now all editable via markdown files.\n- Includes examples where multiple .md files are sourced in a single layout to create fullwidth sections that have different locations in the HTML.\n- The \"Home\" page uses multiple markdown files for the different homepage sections. It uses **headless bundles**.\n- The \"About Us\" page uses multiple markdown files for its different sections. It uses **leaf bundles** and **shortcodes**.\n- \"Services\" \u0026 \"Work\" use markdown files with layouts for list, single and summary views.\n\n**Features**\n- Full-width responsive design\n- Full-width/full-height hero image partial\n\n**SCSS**\n- SCSS (Hugo Pipes)\n- Responsive design\n- Bootstrap 4 grid and media queries\n- The rest of the Bootstrap library is commented out by default but is ready to be @imported in the `style.scss`\n\n**Speed**\n- 100/100 Google Lighthouse speed score\n- Vanilla JS only\n- Minified CSS under 20KB\n- Minified JS under 20KB\n\n**SEO**\n- 100/100 Google Lighthouse SEO score\n- Configure Google Analytics in `config.toml`\n- Configure Google Analytics using env variable `HUGO_GOOGLE_ANALYTICS_ID` compatible with Netlify.\n- Configure meta tags and OG meta tags for the homepage in `config.toml`\n- Semantic HTML document structure\n\n**Menu**\n- Responsive menu managed in `config.toml`\n- Animated hamburger menu on mobile\n\n**Content**\n- Robust example content included\n- Royalty free illustrations included\n\n## Installation\n\n**1. Install Hugo**\n\nTo use this theme you will first need to have Hugo installed. Please follow the official [installation guide](https://gohugo.io/getting-started/installing/)\n\n⚠️ **Note:** Check your Hugo version - **Hugo Extended** is required!\n\nThis theme uses [Hugo Pipes](https://gohugo.io/hugo-pipes/scss-sass/) to compile SCSS and minify assets which means if you not using the Hugo extended version this theme will not work. To check your version of Hugo, run  `hugo version`. Make sure you see __/extended__ after the version number, for example _Hugo Static Site Generator v0.82.0/extended darwin/amd64 BuildDate: unknown_ You do not need to use version v0.82.0 specifically, it just needs to have the _/extended_ part.\n\n**2. Create a new Hugo site**\n\nThis will create a fresh Hugo site in the folder `mynewsite`.\n\n```\nhugo new site mynewsite\n```\n\n**3. Install the theme**\n\nDownload or git clone this theme into the sites themes folder `mynewsite/themes`. You should end up with the following folder structure `mynewsite/themes/hugo-hero-theme`\n\n```\ncd mynewsite\ngit clone https://github.com/zerostaticthemes/hugo-hero-theme.git themes/hugo-hero-theme\n```\n\n**4. Copy the example content**\n\nCopy the entire contents of the `mynewsite/themes/hugo-hero-theme/exampleSite/` folder to root folder of your Hugo site, ie `mynewsite/`. To copy the files using terminal, make sure you are still in the projects root, ie the `mynewsite` folder.\n\n```\ncp -a themes/hugo-hero-theme/exampleSite/. .\n```\n\n**65. Run Hugo**\n\nAfter installing the theme for the first time, generate the Hugo site.\n\nYou run this command from the root folder of your Hugo site ie `mynewsite/`\n\n```\nhugo\n```\n\nFor local development run Hugo's built-in local server.\n\n```\nhugo server\n```\n\nNow enter [`localhost:1313`](http://localhost:1313) in the address bar of your browser.\n\n## Deployment\n### Netlify\n\n[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/zerostaticthemes/hugo-hero-theme)\n\nThis theme includes a `netlify.toml` which is [configured to deploy to Netlify](https://discourse.gohugo.io/t/deploy-your-theme-to-netlify/15508) from the `exampleSite` folder. If you have installed this theme into a new Hugo site and the exampleSite folder was copied or removed, you should delete the `netlify.toml` file.\n\n## Configuring Theme\n\n### Homepage meta tags\n\nOften a homepage requires special meta tags such as a meta description or og meta data for twitter, facebook etc. You can configure these values in the `config.toml`\n\n```toml\n# config.toml\n...\n\n  [params.homepage_meta_tags]\n    meta_description = \"a description of your website.\"\n    meta_og_title = \"My Theme\"\n    meta_og_type = \"website\"\n    meta_og_url = \"https://www.mywebsite.com\"\n    meta_og_image = \"https://www.mywebsite.com/images/tn.png\"\n    meta_og_description = \"a description of your website.\"\n    meta_twitter_card = \"summary\"\n    meta_twitter_site = \"@mytwitterhandle\"\n    meta_twitter_creator = \"@mytwitterhandle\"\n\n```\n\n### Set meta tags on a per layout basis\n\nYou can set meta tags on a per template basis using a block. For example, you might want to write a custom meta description for the `/services` page. You can insert any valid HTML meta data inside the `{{ define \"meta_tags }}` block at the top of a template.\n\n```\n// layouts/services/list.html\n...\n\n{{ define \"meta_tags\" }}\n    \u003cmeta name=\"description\" content=\"We offer a variety of services in the finance industry\" /\u003e\n{{ end }}\n\n{{ define main }}\n...\n```\n\n### Google Analytics\n\nAdd your google analytics ID to the `config.toml`\n\n```toml\n# config.toml\n[params]\n  google_analytics_id=\"UA-132398315-1\"\n```\n\n### Menu\n\nYou can edit and add main menu links in the `config.toml` under `[[menu.main]]`\n\n## License\n\n- Don't create ports or new versions of this theme without asking me\n- You can't re-distribute or re-sell this theme as your own template\n\n## Credits\n\n- Beautiful royalty free Illustrations by Icons8 - https://icons8.com/illustrations/style--pixeltrue\n- Stock images by Unsplash - https://unsplash.com/\n- Feature icons by Noun Project - https://thenounproject.com/\n\n**More Hugo Themes by Zerostatic**\n\n- [Hugo Hero](https://github.com/zerostaticthemes/hugo-hero-theme) - Open-source business theme\n- [Hugo Whisper](https://github.com/zerostaticthemes/hugo-whisper-theme) - Open-source documentation theme\n- [Hugo Serif](https://github.com/zerostaticthemes/hugo-serif-theme) - Open-source business theme\n- [Hugo Winston](https://github.com/zerostaticthemes/hugo-winston-theme) - Open-source blog theme\n- [Hugo Advance](https://www.zerostatic.io/theme/hugo-advance/) - Premium advanced multi page business \u0026 marketing theme\n- [Hugo Paradigm](https://www.zerostatic.io/theme/hugo-paradigm/) - Premium landing page + site builder theme\n- [Hugo Lever](https://www.zerostatic.io/theme/hugo-lever/) - Premium personal / bio theme\n- [Hugo Shard](https://www.zerostatic.io/theme/hugo-lever/) - Premium SAAS / landing page theme\n\n**Find hundreds more Hugo themes on Built At Lightspeed**\n\n[\u003cimg alt=\"Built At Lightspeed Hugo themes directory screenshot\" width=\"400px\" src=\"https://www.zerostatic.io/images/builtatlightspeed-hugo-themes.jpg\" /\u003e](https://builtatlightspeed.com/category/hugo)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzerostaticthemes%2Fhugo-hero-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzerostaticthemes%2Fhugo-hero-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzerostaticthemes%2Fhugo-hero-theme/lists"}