MIT · Democratizing publishing

An open-source publishing framework.

Project Broadsheet is an Eleventy-based publishing framework with nine editorial sections, a reviews stack, a library, reader tools, search, and SEO built in. Its goal is to democratize publishing by giving independent writers and small teams the same tools major outlets use.

Nine editorial sections 27+ reader tools Pagefind search No subscriptions, ever

What's included

A newsroom's worth of tools, packaged for one person.

Most of what makes a publication feel like a publication (proper editorial sections, a reviews stack, a searchable archive, reader-focused tools) used to live only inside major news organizations or behind subscription paywalls. Project Broadsheet brings those tools out in the open.

Reader experience

A full set of reader-side controls applied to every article: font selection, size, spacing, highlights, notes, text-to-speech, reading ruler, focus mode, background presets, download, citations, and more. All on by default.

  • Text-to-speech with synced word highlighting
  • Font picker, size slider, line spacing, text width, word spacing
  • Background presets: default, sepia, cream, dark, high-contrast
  • Highlights (6 colors), notes, bookmarks, and reading list
  • Reading ruler, focus mode, paragraph numbering, auto-scroll
  • Download article as TXT or Markdown
  • Citation formatter: APA 7, MLA 9, Chicago 17
  • Aggregated notes page at /notes/
  • Reader panel with highlights, bookmarks, progress, related, and citation tabs
  • Voice search and form dictation
  • Import and export reader data as JSON

Editorial sections

Nine top-level editorial categories configured by default, each with its own index page, RSS feed, and accent color. Sections are defined in a single data file and easy to add, remove, or rename.

  • News, Opinion, Analysis, Arts & Culture
  • Science & Tech, History, Letters, Reviews
  • Per-section accent colors and RSS feeds
  • Author-specific RSS feeds
  • Editions: numbered issues, printable as PDF

Specialty content types

Dedicated templates for reviews, a public-domain library, glossary, events, games, quotes, bookshelf, and curated collections. Each has its own front-matter schema, layout, and index page.

  • Reviews: books, films, podcasts, documentaries
  • Public-domain library with chapter navigation and reading progress
  • A-to-Z glossary with hover tooltips in article text
  • Events calendar with recurrence support
  • Interactive games: trivia, word scramble, crossword, fifteen-puzzle
  • Quotes collection with pull-quote shortcode
  • Curated bookshelf with categories and filtering

Journalism tools

Features built for serious publishing: corrections log, response tracking, primary source documents, series navigation, argument maps, article profiles, revision history, and editorial workflow metadata.

  • Corrections log: dated, transparent, aggregated at /corrections/
  • Response and backlink tracking between articles
  • Primary source documents collection (FOIA, court records, filings)
  • Multi-part series navigation with auto-generated part links
  • Argument maps: structured thesis, premises, and conclusion
  • Article profiles: standard, podcast (inline audio), dataviz (iframe embed)
  • Revision history linked to GitHub commit log

Search, SEO, and APIs

Client-side full-text search via Pagefind. Structured data, Open Graph, news sitemap, and machine-readable JSON API endpoints all generated at build time.

  • Pagefind full-text search, client-side, no tracking
  • JSON-LD structured data (Article, NewsArticle, BreadcrumbList)
  • Open Graph and Twitter Cards
  • XML sitemap and Google News sitemap
  • Per-section and per-author RSS feeds
  • Machine-readable JSON API endpoints
  • Print stylesheets for articles and editions

Integrations and monetization

Optional third-party services enabled by a single configuration field. Reader tipping through Ko-fi, BMAC, and Patreon at both the publication and per-author level.

  • Buttondown newsletter (no tracking)
  • Umami analytics (cookieless)
  • Cusdis comments (privacy-first)
  • Web3Forms for contact and feedback forms
  • Pages CMS for browser-based editing
  • GTranslate across 80+ languages
  • Ko-fi, Buy Me a Coffee, Patreon tipping per publication and per author

Portability and infrastructure

Content is plain Markdown in Git. Static HTML output deploys to any host. PWA support for offline reading and home screen installation. No database, no runtime, no lock-in.

  • MIT licensed
  • No database or runtime server required
  • Static output deploys to any host
  • Service worker for offline reading and faster repeat visits
  • Web app manifest for home screen installation
  • Build times around 12 seconds for 500 pages
  • Full source available on GitHub
See every feature
Get started

Three commands to a live publication.

No sign-up, no account, no trial. Clone the repo, run a few commands, deploy wherever you want.

1
Fork

Clone jonajinga/broadsheet. Rename the folder. Make it yours.

2
Configure

Edit site.json for metadata and sections. Edit tokens.css for colors and fonts. One file each.

3
Publish

Push to GitHub. Cloudflare Pages, Netlify, or Vercel will deploy in under a minute.

Self-host it for free, or work with me.

Project Broadsheet is free to use forever. I also offer setup, migration, monthly hosting, and custom work for people who'd rather not spend a weekend on it. I take on a small number of engagements at a time, and I prefer to work with independent publishers and organizations I admire.