johnfercher

maroto: Create PDFs with Go and a Bootstrap-Like Grid

Maroto is a Go library for building PDFs from rows, columns, and reusable components instead of positioning every element manually. It suits developers creating reports, invoices, and other structured documents who want automatic page flow and a familiar grid layout.

ActiveGoMITGolangLibraryPDF
View on GitHub Compare
Stars
2.8k
Forks
258
Stars, last 30 days
+16
Last commit
4 days ago
Contributors
42

Our take

Activeregular commits and releases

Health score

45/100

How it is scored
Activity
56
Community
47
Issues
43
Pull requests
32

+16 stars in the last 30 days

  • Slower to merge pull requests than 93% of the projects we track

Maroto is an actively maintained Go PDF-layout library with recent releases, but adoption should account for its single-contributor-heavy development and the time reported for resolving issues.

Good fit if

  • Your application is written in Go and needs structured PDF generation with grid-based layout and automatic page flow.
  • You value current maintenance: the project has recent commits and regular releases, and pull requests have typically been merged faster than issues are closed.
  • Your team can work with a library where most code comes from one contributor, under the MIT license.

Look elsewhere if

  • You need PDF generation outside Go or do not want to use a library built on Gofpdf.
  • Your layout needs do not fit a row-and-column component model.
  • Your adoption policy requires development to be distributed across contributors, since contributions are concentrated in one person.
All health signals
Last commit2026-10-06 (4 days ago)
Commits, last 90 days17
Releases, last 12 months7 (latest v2.4.3, 2026-10-04)
Contributors42 (top contributor: 86% of commits)
Issues closed, last 90 days5 (typically closed in 38 days)
Pull requests merged, last 90 days10 (typically merged in 8 days)
Project age7 years

Checked on 2026-10-11 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

2,785

Forks

262

Change since Nov 16, 2026: 0 stars·0 forks

Overview

Maroto is a Go library for generating PDFs with a row-and-column layout inspired by Bootstrap. It builds on Gofpdf and lets developers arrange components in columns rather than manually placing every item on a page.

It is aimed at Go applications that need structured PDFs, with content flowing onto additional pages when it exceeds the available area. Headers can be configured to recur on new pages.

Key Features

  • Organizes PDF layouts into rows and columns.
  • Supports placing multiple components within a column.
  • Adds pages when content exceeds the usable page area.
  • Supports headers that repeat on new pages, including rows, lines, or table lists.
  • Provides agent skill files with instructions for AI coding agents generating PDFs with Maroto.
  • Includes project commands for building, testing, formatting, linting, and running examples.

Use Cases

  • Go developers generating invoices or statements can arrange document sections in a grid rather than managing coordinates individually.
  • Teams producing multi-page reports can let content flow to subsequent pages and repeat a header.
  • Applications assembling PDFs from reusable components can compose different content within columns.
  • Developers using AI coding agents to create PDF layouts can provide the repository’s agent skills as project instructions.

What you need

Detected in the repository

  • Go 1.26.1 or newer (from go.mod)
  • A test suite and automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install the current v2 release:

go get github.com/johnfercher/maroto/v2@v2.4.3

See the README and v2 documentation for setup and usage details.

Considerations

Maroto is active, with regular commits and releases, but its code contributions are highly concentrated in one person. Recent pull requests have generally been merged in days, while issues have taken longer to close, so teams should assess whether that issue-resolution pace works for their support needs. The project requires Go; the repository’s module specifies Go 1.26.1. Maroto is MIT-licensed, so review and preserve the license notice when redistributing it.

Found this useful?

Share it with someone who would like maroto.

Comparisons