The repo

The Umami Post is a complete, production-grade static publication built on Eleventy. The whole codebase -- every layout, every partial, every line of CSS, every utility filter -- is in the repository. No private dependencies, no closed-source plugin, nothing waiting for a license fee.

jonajinga/the-umami-post on GitHub

What you get

Not a starter template with placeholder divs. A complete, production-grade food publication with every feature already built and tested:

  • Recipe content type with structured ingredient + instruction front-matter, Schema.org Recipe markup, prep/cook/total time, dietary tags, cuisine, course, difficulty, and seasonality fields
  • Serving scaler with 0.5x / 1x / 2x buttons that recompute every amount in place, including unicode and mixed-number fractions
  • Ingredient checklist with localStorage persistence (one per recipe)
  • Cooking mode -- bigger type, hidden chrome, screen wake-lock, activated by ?cook=1
  • Technique guides with their own layout, Schema.org HowTo markup, and "recipes that use this technique" cross-links
  • Reviews with star ratings, pros/cons, verdict block, and Schema.org Review markup
  • Food stories / journalism across news, opinion, deep dives, food culture, food science, food history, and cook's letters
  • Submission forms for every content type, plus a contact form and corrections reporter
  • Multi-author with rich cook profiles (specialties, kitchen story, favourite tools, where to find them in real life)
  • Full-text search via Pagefind with cuisine / diet / course / season / difficulty filters
  • Dark mode with system preference detection and no flash
  • Reader tools including a saved reading list, highlights and annotations, cook's notes, print basket, and reading calendar
  • Public-domain cookbook library (Mrs. Beeton, Escoffier pre-1929, USDA bulletins) with chapter navigation and reading progress
  • Webmentions for inbound replies and republications
  • Public JSON API -- every content collection at /api/* with CORS enabled
  • Scheduled publishing -- future-dated content goes live automatically
  • Editorial tools -- dashboard, Kanban board, content templates, editorial calendar
  • SPA-style navigation -- pages swap without a full reload
  • Newsletter integration via Buttondown
  • SEO -- JSON-LD structured data (Recipe, HowTo, Review), Open Graph, sitemaps, per-author RSS
  • Privacy-first analytics via Umami
  • Comments via Cusdis
  • Print CSS for recipes and articles
  • Progressive Web App with offline support

See the full list at /features/.

Stack

  • Eleventy v3 (static site generator)
  • Nunjucks templates with Markdown content
  • Vanilla CSS with custom properties (no frameworks, no bundler)
  • Vanilla JavaScript (no frameworks, no build step)
  • Bunny Fonts (privacy-friendly font CDN)
  • Cloudflare Pages for hosting
  • Pagefind for search, Web3Forms for submissions, Buttondown for newsletter, Cusdis for comments, Umami for analytics

No bundler. No React. No Tailwind. No closed-source CMS. Just HTML, CSS, and JavaScript that renders fast and works everywhere.

How to use it

Site-wide configuration lives in two files: src/_data/site-settings.json (editor-facing: title, tagline, tipping URLs, newsletter config, social links) and src/_data/site.js (secrets and environment overrides: API keys, analytics IDs, loaded from .env or CI). Change the values and the entire site updates on the next build.

The visual design is controlled by CSS custom properties in src/assets/css/tokens.css. Swap the colours and fonts to retheme the entire site.

Content lives in src/content/ as Markdown files with YAML front matter. Recipes go in src/content/recipes/, techniques in src/content/techniques/, and so on. Add a new piece by creating a new .md file with the right front matter.

License

The code is released under the MIT License. Use it for personal projects, commercial publications, or anything else. No attribution required, though it is appreciated.

Recipes and technique guides published on The Umami Post are licensed CC BY-SA 4.0. Editorial articles, reviews, and photography are copyright the individual authors -- see the license page for the details.