Inicio Rapido

Instalacao

go get github.com/gpdf-dev/gpdf

gpdf tem zero dependencias externas — utiliza apenas a biblioteca padrao do Go.

Hello World

package main

import (
    "os"
    "github.com/gpdf-dev/gpdf/document"
    "github.com/gpdf-dev/gpdf/template"
)

func main() {
    doc := template.New(
        template.WithPageSize(document.A4),
        template.WithMargins(document.UniformEdges(document.Mm(20))),
    )

    page := doc.AddPage()
    page.AutoRow(func(r *template.RowBuilder) {
        r.Col(12, func(c *template.ColBuilder) {
            c.Text("Hello, World!", template.FontSize(24), template.Bold())
        })
    })

    data, _ := doc.Generate()
    os.WriteFile("hello.pdf", data, 0644)
}

┌─ A4 ──────────────────────────────────┐
│                                       │
│   Hello, World!    ← 24pt, Bold       │
│                                       │
│                                       │
└───────────────────────────────────────┘

Tres Formas de Criar PDFs

gpdf oferece tres abordagens para geracao de PDFs:

1. Builder API (Recomendado)

A abordagem mais comum — controle programatico com um padrao builder fluente:

doc := template.New(template.WithPageSize(document.A4))
page := doc.AddPage()
page.AutoRow(func(r *template.RowBuilder) {
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("Left column")
    })
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("Right column")
    })
})
data, err := doc.Generate()

2. JSON Schema

Defina documentos declarativamente em JSON — ideal para conteudo dinamico e geracao via API:

schema := []byte(`{
    "page": {"size": "A4", "margins": "20mm"},
    "body": [
        {"row": {"cols": [
            {"span": 12, "text": "Hello from JSON!", "style": {"size": 24, "bold": true}}
        ]}}
    ]
}`)

doc, err := template.FromJSON(schema, nil)
data, err := doc.Generate()

3. Componentes Reutilizaveis

Componentes pre-construidos para documentos comerciais comuns:

doc := template.Invoice(template.InvoiceData{
    Number:  "#INV-2026-001",
    Date:    "March 1, 2026",
    DueDate: "March 31, 2026",
    From:    template.InvoiceParty{Name: "ACME Corp", Address: []string{"123 Main St"}},
    To:      template.InvoiceParty{Name: "Client Inc", Address: []string{"456 Oak Ave"}},
    Items: []template.InvoiceItem{
        {Description: "Web Development", Quantity: "40 hrs", UnitPrice: 150.00, Amount: 6000.00},
    },
    TaxRate:  10,
    Currency: "$",
})
data, err := doc.Generate()

Metodos de Saida

// Generate retorna o PDF como []byte
data, err := doc.Generate()

// Render escreve o PDF em qualquer io.Writer
err := doc.Render(w)

Proximos Passos

Instalacao — Instrucoes detalhadas de configuracao
Uso Basico — Aprenda a Builder API com exemplos
Layout em Grid — Domine o sistema de layout de 12 colunas
Elementos — Todos os elementos de conteudo disponiveis
Componentes — Templates de documentos pre-construidos