Saffron Documentation
COMPLETE, DOWNLOADABLE EXAMPLES

Start with
something real.

Two files to inspect, adapt, and open in Saffron. Both validate against the published version 1 schema.

The minimal structure.

Overnight oats: two ingredients, one step, and a yield of one. A useful starting point for a generator or a handwritten JSON file.

Download overnight-oats.saffron ↘
minimal-example.saffron
{
  "format": "saffron",
  "version": 1,
  "recipes": [
    {
      "title": "Overnight oats",
      "servings": 1,
      "ingredients": [
        {
          "name": "Rolled oats",
          "quantity": "0.5",
          "unit": "cup"
        },
        {
          "name": "Milk",
          "quantity": "0.5",
          "unit": "cup"
        }
      ],
      "steps": [
        {
          "text": "Combine the oats and milk in a covered container. Refrigerate overnight."
        }
      ]
    }
  ]
}

A counted yield, with the details.

Vanilla cookies: 24 cookies, ingredient preparation, notes, and a 720-second timer. Source and image URLs can be added when you have appropriate HTTPS links.

Download vanilla-cookies.saffron ↘
cookie-example.saffron
{
  "format": "saffron",
  "version": 1,
  "recipes": [
    {
      "title": "Vanilla cookies",
      "description": "Soft vanilla cookies with crisp edges.",
      "servings": 24,
      "yieldUnit": "cookies",
      "prepMinutes": 15,
      "cookMinutes": 12,
      "ingredients": [
        {
          "name": "All-purpose flour",
          "quantity": "2",
          "unit": "cup"
        },
        {
          "name": "Butter",
          "quantity": "0.5",
          "unit": "cup",
          "preparation": "Softened"
        },
        {
          "name": "Sugar",
          "quantity": "0.75",
          "unit": "cup"
        },
        {
          "name": "Egg",
          "quantity": "1",
          "unit": "piece"
        },
        {
          "name": "Vanilla extract",
          "quantity": "1",
          "unit": "teaspoon"
        }
      ],
      "steps": [
        {
          "text": "Beat the butter and sugar together. Add the egg and vanilla."
        },
        {
          "text": "Stir in the flour and portion into 24 cookies."
        },
        {
          "text": "Bake at 350°F for 12 minutes, until the edges are lightly golden.",
          "timerSeconds": 720
        }
      ],
      "notes": "Let the cookies cool on the tray before moving them."
    }
  ]
}