Seed

Seed is a Python framework that compiles .seed files into static HTML.

It includes:

• A lexer/parser/renderer pipeline for .seed
• YAML + .design component system
• Layouts and includes
• CLI commands for init, dev server, and build

Install

python -m pip install seed

CLI

seed init my-site
seed dev my-site
seed build my-site

Python API

from seed import Seed

engine = Seed()
html = engine.render_string("@h1\n  Hello", full_page=True)

Social previews

Set the production URL and fallback image in seed.yaml:

url: https://example.com
image: /static/images/social-default.jpg

A page can override the image in its front matter:

---
title: Page title
description: Page description
image: /static/images/page.jpg
---

Seed generates Open Graph and Twitter Card metadata. Relative social image paths become absolute using url. When image is omitted, Seed uses the first image in the page content before falling back to the global image. Collection items expose that inferred image to list layouts, and each collection listing page uses the first image from the items displayed on that page. Set image: false on a page to disable automatic extraction and the global fallback.

Development

python -m pip install -e ".[dev]"
python -m pytest tests -v

License

MIT. See LICENSE.