Local · Open Source · Zero Cloud

Drop markdown.
Get a document.

.md .bd · render · brand · export

A brand rendering engine that lives on your machine. Write in Markdown, drop the file, pick your brand — brandown handles the rest.

.bd .html .pdf .email .docx .bd [brand] THE RENDER ENGINE
4 Built-in brands
3 Output formats
0 Cloud dependencies
.bd The output extension
How it works

Three steps.
One branded document.

No config files. No CLI commands. Add frontmatter to your Markdown, open the GUI, render.

1
Write your Markdown

Create a .md file with a short YAML frontmatter block at the top. Specify your brand, format, and document type.

brand: poluga
format: pdf
doc_type: proposal
title: "Q2 Report"
2
Drop it in the GUI

Run python run.py — your browser opens at localhost:8000. Drag your file onto the drop zone. Select brand overrides or upload a custom logo.

# One command to start
$ python run.py
→ localhost:8000
3
Preview and download

The rendered document appears in a full-height browser preview. Approve it and download HTML, PDF, or both — fully self-contained, ready to send.

✓ HTMLoutput/poluga/report.html
✓ PDFoutput/poluga/report.pdf
Features

Everything a branded
document needs.

Built for solo operators and small teams who need professional output without a design team.

Multi-brand support

Unlimited brands, each with their own colors, fonts, tone, and logo. Switch brands per document via a single frontmatter line.

HTML + PDF output

Generate self-contained HTML, print-ready PDF via WeasyPrint, or both simultaneously. All images and styles are embedded inline.

Live preview

Every render opens in a browser iframe before download. See the full document exactly as it will export — no surprises.

Logo insertion

Upload a logo per render or set a brand default. Automatically resized, positioned, and embedded as base64 — email-safe output.

Auto file watcher

Drop a .md file into input/ and brandown renders it automatically in the background — no button needed.

Claude Code native

Reads CLAUDE.md automatically. Every session inherits full architecture knowledge via skill files that compound over time.

Built-in brands

Three brands ready.
Yours takes 60 seconds.

Each brand is a folder: brand.md for colors and fonts, assets/ for logos. Add new ones with python core/create_brand.py.

.bd BRANDOWN
brandown
The tool's own brand. Prism mark on navy.
POLUGA
STRATEGIC CONSULTING
POLUGA Systems
Strategic consulting for Balkan SMEs.
FarmIQ
PRECISION AGRICULTURE
FarmIQ
Precision agriculture SaaS for SEE.
Get started

Running in
three commands.

Requires Python 3.10+. Everything else is handled by the activation script on first run.

terminal
# 1. Clone or download brandown
$ cd ~/workspace/projects/brandown

# 2. Set up environment (first run only)
$ source activate.sh
→ brandown env activated

# 3. Launch
$ python run.py
→ Opening localhost:8000
requirements
Python 3.10+ — core runtime, venv, pip
macOS PDF depsbrew install pango libffi gdk-pixbuf
FastAPI, WeasyPrint, Jinja2 — installed automatically by activate.sh
Browser — any modern browser for the GUI at localhost:8000
Claude Code (optional) — reads CLAUDE.md for AI-assisted development sessions