Juicer
English

Configuration

site.toml keys juicercook reads, recipe frontmatter, the [juicercook] palette table, and the categories strip.

juicercook reads its configuration from three places:

  • A small set of top-level site keys (the same ones every juicer theme uses).
  • A namespaced [juicercook] table for palette overrides and the home-page category strip.
  • Per-recipe frontmatter — structured fields that drive both the rendered card and the Recipe JSON-LD.

Quick example

title    = "Elder & Ash"
tagline  = "A small home cooking website"
author   = "Hanna Petrescu"
baseURL  = "https://elderandash.example"
theme    = "juicercook"

# Image variants — responsive <picture> markup on every recipe hero# Image variants — responsive <picture> markup on every recipe hero
# and card.# and card.
[images]
enabled = true
widths  = [480, 960, 1600]
formats = ["webp", "original"]
quality = 78

[[topnav]]
label = "Recipes"
url   = "/"

[[juicercook.categories]]
label = "All"
url   = "/"

[[juicercook.categories]]
label = "Breads"
url   = "/breads/"

[[juicercook.categories]]
label = "Desserts"
url   = "/desserts/"

A recipe (content/breads/sourdough.md):

---
title: Sourdough loaf
date: 2024-03-12
servings: 1 loaf
prepTime: PT30M
cookTime: PT45M
image: /img/sourdough.jpg
imageAlt: Crusty boule with an open crumb
summary: A reliable everyday loaf — 25 % whole wheat, 70 % hydration.
ingredients:
  - 500 g bread flour
  - 350 g water
  - 100 g active starter
  - 10 g sea salt
instructions:
  - Mix flour and water; rest 30 minutes (autolyse).
  - Add starter and salt; mix.
  - Bulk ferment 4–6 hours.
tags: [bread, sourdough]
---

Optional body content goes here.

Top-level keys

KeyTypeDefaultNotes
titleStringrequiredBrand text in topbar + footer; <title> element.
taglineStringunsetItalic subtitle in the topbar.
descriptionStringunsetDefault <meta name="description">.
authorStringunsetFooter + JSON-LD author.
baseURLStringrequiredStandard juicer key.
themeStringrequiredSet to "juicercook".
faviconStringunsetPath to a favicon.
hideJuicerCreditBooleanfalseSet true to remove the “Built with juicer” line.
topnav[[topnav]]unsetTopbar nav entries.
links[[links]]unsetFooter link entries.
[images]TableunsetImage-variants pipeline. Strongly recommended — the hero and recipe-card images use it.

Per-recipe frontmatter

KeyTypeWhat
titleStringRequired.
dateStringHome-page recency ordering. Also datePublished in JSON-LD.
servingsString“1 loaf”, “4–6”, etc. Maps to recipeYield.
prepTimeStringISO 8601 durationPT30M, PT2H, P1D.
cookTimeStringISO 8601 duration.
totalTimeStringISO 8601 duration. Optional.
imageStringHero photo path.
imageAltStringAlt text. Falls back to the title.
summaryStringCard summary, <meta name="description">, JSON-LD description.
categoryStringrecipeCategoryDessert, Main, Side, etc.
cuisineStringrecipeCuisineItalian, Indian, etc.
ingredientsListOne string per ingredient line.
instructionsListOne string per numbered step.
photosListOptional process photos. Each entry is a string (path) or {src, alt, caption} map. Renders below the recipe card.
tagsListDrives /tags/<slug>/ archives.

[juicercook] palette overrides

[juicercook]
brand        = "#7a2e10"   # terracotta# terracotta
brandStrong  = "#4a1908"
accent       = "#c0571d"   # paprika# paprika
fontSans     = "'Inter', system-ui, sans-serif"
fontSerif    = "'Playfair Display', Georgia, serif"

# Home-page category chips# Home-page category chips
[[juicercook.categories]]
label = "All"
url   = "/"

[[juicercook.categories]]
label = "Breads"
url   = "/breads/"

Search

Esc
to navigate to open Esc to close