Describe an event, get an on-brand flyer.

blockflyer takes a plain-English event description, has a model choose from ten blocks across four looks and write the copy, and draws a PNG and a one-page US Letter PDF from your brand kit with a deterministic renderer. A flyer is fitted to the page in height and width, or refused.

The model never styles

It chooses blocks, their order and the words. It never writes HTML, CSS, colours or sizes, so the worst it can do is pick the wrong blocks or write weak copy, and both are visible in a JSON file you can edit and re-render.

Ten blocks, four looks

Logo, hero, photo, chips, date, details, event, checklist, call to action and footer with a scannable QR code, drawn in one of four looks that ship with the package: poster, notice, big-date or ticket.

Fitted or refused

Height and width are measured in a real browser once the fonts load: footer items wrap, then shrink to 60% of the size asked for, then the render is refused with a plain message and no file left behind.

Your brand kit in a folder

brand.json, facts.json, a logo, photos and optional fonts. A kit whose own colours are unreadable together is refused.

Repair loop and checked sources

When a spec cannot be drawn, the reason goes back to the model, up to three tries. A location or event the model names is checked against your kit's facts.

Deterministic output

The same spec and kit give the same HTML and PNG bytes on the same machine and browser. The PDF matches apart from its creation time.

Any model, or none

OpenAI-compatible and Anthropic adapters, standard library only, or write the spec JSON yourself and render without a model.

blockflyer 1.0.1: the Python package and the blockflyer command, a demo kit and four demo specs, and the full test suite. The Barlow font ships under the SIL Open Font License with its notice., with 286 automated tests.

A commercial license. Use it and change it in your own projects and your clients' projects. Don't share or resell the source. Read the license.

Every update. New versions land in the same repository; git pull to get them.

Python 3.10 or newer. Python 3.10 or newer (segno installs with it), and Chrome or Chromium to draw the PNG and PDF; without one the demo still writes the HTML. A model key only for the compose step.