Project Setup Checklist
foxynet
Here’s a quick checklist to replicate the current setup for foxy.net.au.
Repository and theme
- Install Hugo extended (latest).
- Configure
config/_default/hugo.tomlwith the Ananke theme (gohugo-theme-ananke), robots.txt, sitemap, and blog permalinks like/blog/2024/05/my-post/. - Fill
config/_default/params.tomlwith site metadata, socials, SEO defaults, and analytics IDs when ready. - Keep navigation in
config/_default/menus.toml(Home, Blog, About for now).
Content structure
- Use the default archetype (
archetypes/default.md) so posts include title, date, draft, description, summary, tags, and categories. - Store content under
content/with_index.mdfor the homepage andcontent/blog/for posts.
Build and deploy
- Local:
hugo server -Dto preview drafts. - CI:
.github/workflows/hugo.ymlbuilds on pushes/PRs tomainwithhugo --gc --minify. - Hosting:
amplify.ymlinstalls Hugo 0.152.2, caches.hugo_cache, builds, and publishespublic/; alternatively use GitHub Pages via the workflow.
Guardrails
- Follow
CODING_STANDARDS.mdfor front matter completeness, semantic HTML, and tidy formatting. - Update
PLAN.mdas tasks evolve and keepAGENTS.mdownership notes in mind. - Before deploys, run
hugo --gc --minifyand ensurehugo serveris clean locally.