{"id":17023575,"url":"https://github.com/edheltzel/flightdeck-for-hugo","last_synced_at":"2026-04-10T01:13:49.562Z","repository":{"id":40444645,"uuid":"342389990","full_name":"edheltzel/Flightdeck-for-Hugo","owner":"edheltzel","description":"WIP: 🚀 An opinionated Jamstack starter project for Huge, using Hugo's built in asset pipeline.","archived":false,"fork":false,"pushed_at":"2023-12-13T19:56:46.000Z","size":547,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-27T22:37:18.404Z","etag":null,"topics":["hugo","hugo-boilerplate","jamstack","jamstack-site","jamstack-theme","static-site"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/edheltzel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"2021-02-25T21:57:30.000Z","updated_at":"2023-08-05T17:26:10.000Z","dependencies_parsed_at":"2024-11-29T06:51:31.144Z","dependency_job_id":null,"html_url":"https://github.com/edheltzel/Flightdeck-for-Hugo","commit_stats":null,"previous_names":["edheltzel/flightdeck-for-hugo"],"tags_count":3,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edheltzel%2FFlightdeck-for-Hugo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edheltzel%2FFlightdeck-for-Hugo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edheltzel%2FFlightdeck-for-Hugo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edheltzel%2FFlightdeck-for-Hugo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/edheltzel","download_url":"https://codeload.github.com/edheltzel/Flightdeck-for-Hugo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244999598,"owners_count":20544910,"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":["hugo","hugo-boilerplate","jamstack","jamstack-site","jamstack-theme","static-site"],"created_at":"2024-10-14T07:13:35.391Z","updated_at":"2025-12-30T23:45:30.254Z","avatar_url":"https://github.com/edheltzel.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cp\u003e\u003cimg src=\"https://rdm.sfo2.digitaloceanspaces.com/flightdeck/v3-flightdeck__logo--purple-haze-600x528.png\" alt=\"Flightdeck Logo\"\u003e\u003c/p\u003e\n\n[![release](https://img.shields.io/github/release/flight-deck/flightdeck-hugo.svg?style=for-the-badge\u0026logo=github\u0026logoColor=white\u0026colorA=101119\u0026colorB=6D57FF)](https://github.com/flight-deck/flightdeck-hugo/releases/latest) [![hugo](https://img.shields.io/badge/Hugo-v0.66.0+-373277.svg?style=for-the-badge\u0026logo=hugo\u0026logoColor=white\u0026colorA=101119\u0026colorB=7273D6)](https://github.com/gohugoio/hugo/releases/latest) [![license](https://img.shields.io/badge/License-MIT-373277.svg?style=for-the-badge\u0026l\u0026logoColor=white\u0026colorA=101119\u0026colorB=42557B)](https://github.com/flight-deck/flightdeck-hugo/blob/master/LICENSE)\n\n\u003ch1\u003eFlightdeck for Hugo\u003c/h1\u003e\n\u003ch4\u003eAn opinionated starter project for \u003ca href=\"https://gohugo.io/\"\u003eHugo\u003c/a\u003e that takes advantage of Hugo's built in \u003ca href=\"https://gohugo.io/hugo-pipes/\" title=\"hugo's asset pipeline\"\u003easset pipeline\u003c/a\u003e.\u003c/h4\u003e\n\n\u003c/div\u003e\n\n## What it is\n\nFlightdeck for Hugo is an opinionated starter project for [Hugo](https://gohugo.io/) that takes advantage of Hugo's built in [asset pipeline](https://gohugo.io/hugo-pipes/).\n\nIncludes:\n\n- Base templates using HTML with partials creating components.\n- Hugo Pipes ready to compile, minify, and MD5-hash for Scss/CSS and JavaScript with environment variables.\n- Hugo Pipes for PostCSS using Autoprefixer and PurgeCSS\n- Simple Google Analytics integration.\n- Imagemin for image optimization\n  - Please note that Hugo's built in [image processing](https://gohugo.io/content-management/image-processing/) does not work on images located inside of `/static`. This is why we chose to use Gulp and Imagemin.\n- Deployment with rsync and [Flightdeck Liftoff](https://github.com/flight-deck/flightdeck-liftoff).\n\n## What it is NOT\n\nFlightdeck for Hugo **IS NOT** a Hugo theme. It **CANNOT** be dropped inside the `/themes` directory.\n\n## Prerequisites\n\nMake sure that Hugo is installed by checking out the [Quick Start Guide](https://gohugo.io/getting-started/quick-start/#step-1-install-hugo) on the Hugo docs... make sure you're running the extended version.\n\n## Usage\n\nFirst things first, clone this repo:\n\n```shell\ngit clone git@github.com:flight-deck/Flightdeck-for-Hugo.git MY-HUGO-PROJECT \u0026\u0026 cd MY-HUGO-PROJECT\n```\n\nThen run the Node commands\n\n```shell\npnpm\npnpm start\n```\n\n**OR**\n\n```shell\nnpm install\nnpm start\n```\n\n### Adding Pages\n\nTo add main site pages run the `hugo new` command and create a markdown file in the `pages/` directory. Then create a corresponding `html` template file in `layouts/pages/`\n\nExample:\n\n```\nhugo new pages/my-new-page.md\n```\n\nThe `header.html` partial is configured to generate a main site navigation by utilizing [Hugo Menu Templates](https://gohugo.io/templates/menu-templates). The `pages.md` archetype sets each page markdown file to the main menu via front matter.\n\n### Available Scripts\n\nThere are 4 available Scripts:\n\n- `pnpm start` - Runs development server with CSS sourcemaps and drafts enabled, as well as the image task with watch.\n- `pnpm build:preview` - Runs the server with `production` for the environment with asset minification and postCSS enabled, and optimized images\n- `pnpm build` - The same as `build:preview` but builds production ready site in `public` directory with minified/optimized assets\n- `pnpm build:images` - Runs gulp images task to optimize images in `./static/img/`\n- `pnpm deploy` - uses (Flightdeck Liftoff)[https://github.com/flight-deck/Flightdeck-Liftoff] for deployments, see [Liftoff for usage](https://github.com/flight-deck/Flightdeck-Liftoff#readme)\n  - Please note: Hugo's built in deployment options currently does not support DigitalOcean\n- `pnpm clean:node` - removes only Node dependencies\n- `pnpm clean:site` - removes the `public/` directory\n- `pnpm purge` - removes everything and does a fresh install using pnpm.\n\n## File Structure\n\n```\n│\n└──── /archetypes            - Hugo archetypes\n│\n└──── /assets                - Source files for scss, js, and images\n│   └─── /images             - Images INPUT directory used by Gulp\n│   └─── /js\n│   └─── /scss\n│\n└──── /content               - Hugo Content Directory\n│   └─── /pages              - Markdown files for main site pages\n│   |\n│   | _index.md              - Site homepage markdown file\n│\n└──── /layouts               - Template files\n│   └─── /_default\n│       |\n│       | baseof.html        - Base template\n│   │\n│   └─── /pages              - Template files for main site pages\n│   │\n│   └─── /partials\n│       └─── /site           - Site partials\n│       │\n│       │ footer.html        - Site primary \u003cfooter\u003e\n│       │ header.html        - Site primary \u003cheader\u003e\n│       │ meta.html          - Site \u003cmeta\u003e tags\n│       │ scripts.html       - JavaScript \u003cscript\u003e tags before closing \u003c/body\u003e\n│       │ styles.html        - Stylesheets referenced before closing \u003c/head\u003e\n│   │\n│   │ 404.html               - 404 Template\n│   │ index.html             - Home page\n│\n└──── /static                - Hugo static resources\n│   └─── /images             - Images OUTPUT directory generated by Gulp\n│\n│ config.yml                 - Hugo configuration file\n│ gulpfile.js                - Gulp js file\n│ netlify.toml               - Netlify configuration file\n│ package.json\n│ README.md                  - The README file you're reading right now\n```\n\n### Hope you enjoy the flight. 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedheltzel%2Fflightdeck-for-hugo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedheltzel%2Fflightdeck-for-hugo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedheltzel%2Fflightdeck-for-hugo/lists"}