typstify 0.1.0

data/templates/invoice/sample_data.json

@@ -0,0 +1,21 @@
+{
+  "number": "INV-2043",
+  "subtitle": "Thanks for your business",
+  "issued_on": "12 March 2026",
+  "due_on": "11 April 2026",
+  "total": "$4,860.00",
+  "bill_to": ["Northwind Trading Ltd.", "48 Harbour Road", "Bristol BS1 5TY", "United Kingdom"],
+  "bill_from": ["Your Company", "12 Example Street", "London EC1A 1AA", "VAT GB123456789"],
+  "line_items": [
+    { "name": "Platform subscription — March", "qty": "1", "unit_price": "$2,400.00", "amount": "$2,400.00" },
+    { "name": "Additional seats", "qty": "12", "unit_price": "$95.00", "amount": "$1,140.00" },
+    { "name": "Onboarding workshop", "qty": "4", "unit_price": "$210.00", "amount": "$840.00" },
+    { "name": "Priority support", "qty": "1", "unit_price": "$480.00", "amount": "$480.00" }
+  ],
+  "summary": [
+    { "label": "Subtotal", "value": "$4,860.00" },
+    { "label": "VAT (0%)", "value": "$0.00" },
+    { "label": "Paid to date", "value": "$0.00" }
+  ],
+  "notes": "Payment by bank transfer within 30 days. Quote invoice number INV-2043 as the reference."
+}

data/templates/receipt/receipt.typ

@@ -0,0 +1,69 @@
+// Receipt — Typstify starter template.
+//
+// A payment confirmation: narrower page, no billing terms, a paid stamp.
+// Data mode; see templates/invoice for the fuller commentary.
+
+#import "shared/branding.typ": *
+
+#let data = json("data.json")
+
+#show: brand-page
+
+#set page(paper: "a5", margin: (x: 14mm, y: 16mm))
+
+#brand-header(
+  title: "Receipt",
+  subtitle: data.at("subtitle", default: none),
+  meta: (
+    ("Receipt no.", data.number),
+    ("Paid on", data.paid_on),
+  ),
+)
+
+#block(
+  width: 100%,
+  fill: rgb("#ecfdf5"),
+  stroke: 0.5pt + rgb("#a7f3d0"),
+  radius: 3pt,
+  inset: 10pt,
+)[
+  #grid(
+    columns: (1fr, auto),
+    align: (left + horizon, right + horizon),
+    [
+      #text(size: 8pt, fill: rgb("#047857"))[#upper("Paid in full")]
+      #linebreak()
+      #text(size: 9pt, fill: brand.muted)[#data.method]
+    ],
+    text(size: 16pt, weight: "semibold", fill: rgb("#047857"))[#data.total],
+  )
+]
+
+#v(12pt)
+
+#brand-address(label: "Received from", lines: data.received_from)
+
+#v(12pt)
+
+#brand-table(
+  columns: (1fr, auto, auto),
+  aligns: (left, right, right),
+  header: ("Description", "Qty", "Amount"),
+  rows: data.line_items.map(item => (
+    [#item.name],
+    [#item.qty],
+    [#item.amount],
+  )),
+)
+
+#v(10pt)
+
+#brand-totals(
+  rows: data.at("summary", default: ()).map(row => (row.label, row.value)),
+  emphasis: ("Total paid", data.total),
+)
+
+#if data.at("notes", default: none) != none [
+  #v(12pt)
+  #brand-note[#data.notes]
+]

data/templates/receipt/sample_data.json

@@ -0,0 +1,17 @@
+{
+  "number": "RCP-8871",
+  "subtitle": "No payment is due",
+  "paid_on": "3 February 2026",
+  "method": "Visa ending 4242",
+  "total": "$1,290.00",
+  "received_from": ["Ada Okonkwo", "Harbour Analytics", "Dublin, Ireland"],
+  "line_items": [
+    { "name": "Annual plan", "qty": "1", "amount": "$1,200.00" },
+    { "name": "Extra storage (50 GB)", "qty": "1", "amount": "$90.00" }
+  ],
+  "summary": [
+    { "label": "Subtotal", "value": "$1,290.00" },
+    { "label": "Tax", "value": "$0.00" }
+  ],
+  "notes": "Keep this receipt for your records. Questions? Reply to your confirmation email."
+}

data/templates/report/report.typ

@@ -0,0 +1,103 @@
+// Report — Typstify starter template.
+//
+// A multi-page document: cover block, headline metrics, a data table and
+// free-form sections. This is the one that shows why Typst beats a coordinate
+// DSL — pagination, running headers and a table of contents come for free.
+//
+// Data mode; see templates/invoice for the fuller commentary.
+
+#import "shared/branding.typ": *
+
+#let data = json("data.json")
+
+#show: brand-page
+
+#brand-header(
+  title: data.title,
+  subtitle: data.at("subtitle", default: none),
+  meta: (
+    ("Period", data.period),
+    ("Prepared for", data.prepared_for),
+    ("Generated", data.generated_on),
+  ),
+)
+
+// Headline metrics.
+#grid(
+  columns: data.metrics.len(),
+  gutter: 10pt,
+  ..data.metrics.map(metric => block(
+    width: 100%,
+    fill: rgb("#f9fafb"),
+    stroke: 0.5pt + brand.rule,
+    radius: 3pt,
+    inset: 10pt,
+  )[
+    #text(size: 8pt, fill: brand.muted)[#upper(metric.label)]
+    #linebreak()
+    #text(size: 18pt, weight: "semibold")[#metric.value]
+    #linebreak()
+    // Always a third line, present or not, so the cards line up. `height: 100%`
+    // is the obvious alternative and the wrong one: inside a grid it resolves
+    // against the page, not the row, and pushes the whole report onto page two.
+    #if metric.at("change", default: none) == none [
+      #text(size: 9pt)[ ]
+    ] else [
+      #text(size: 9pt, fill: if metric.at("positive", default: true) {
+        rgb("#047857")
+      } else {
+        rgb("#b91c1c")
+      })[#metric.change]
+    ]
+  ]),
+)
+
+#v(16pt)
+
+#heading(level: 1, outlined: false)[#data.table.heading]
+#v(2pt)
+
+#brand-table(
+  columns: (1fr,) + data.table.columns.slice(1).map(_ => auto),
+  aligns: (left,) + data.table.columns.slice(1).map(_ => right),
+  header: data.table.columns,
+  rows: data.table.rows.map(row => row.map(cell => [#cell])),
+)
+
+// A simple bar chart, drawn with rectangles. No plotting library, no browser.
+#if data.at("bars", default: none) != none [
+  #v(16pt)
+  #heading(level: 1, outlined: false)[#data.bars.heading]
+  #v(6pt)
+  #let peak = calc.max(..data.bars.series.map(bar => bar.value))
+  #for bar in data.bars.series [
+    #grid(
+      columns: (28mm, 1fr, 18mm),
+      gutter: 8pt,
+      align: (left + horizon, left + horizon, right + horizon),
+      text(size: 9pt)[#bar.label],
+      box(width: 100%)[
+        #rect(
+          width: 100% * (bar.value / peak),
+          height: 8pt,
+          radius: 2pt,
+          fill: brand.accent,
+          stroke: none,
+        )
+      ],
+      text(size: 9pt, fill: brand.muted)[#bar.display],
+    )
+    #v(4pt)
+  ]
+]
+
+#for section in data.sections [
+  #v(14pt)
+  #heading(level: 1, outlined: false)[#section.heading]
+  #v(2pt)
+  #set par(justify: true)
+  #for paragraph in section.body [
+    #paragraph
+    #parbreak()
+  ]
+]

data/templates/report/sample_data.json

@@ -0,0 +1,49 @@
+{
+  "title": "Monthly Operations Report",
+  "subtitle": "Platform reliability and usage",
+  "period": "February 2026",
+  "prepared_for": "Northwind Trading Ltd.",
+  "generated_on": "1 March 2026",
+  "metrics": [
+    { "label": "Requests", "value": "48.2M", "change": "+12%", "positive": true },
+    { "label": "p95 latency", "value": "184 ms", "change": "-9%", "positive": true },
+    { "label": "Error rate", "value": "0.043%", "change": "+0.01pp", "positive": false },
+    { "label": "Uptime", "value": "99.98%" }
+  ],
+  "table": {
+    "heading": "Traffic by service",
+    "columns": ["Service", "Requests", "p95", "Errors"],
+    "rows": [
+      ["Checkout API", "18,402,113", "142 ms", "0.02%"],
+      ["Catalogue", "14,880,204", "96 ms", "0.01%"],
+      ["Search", "9,113,776", "311 ms", "0.11%"],
+      ["Webhooks", "4,204,882", "204 ms", "0.06%"],
+      ["Reporting", "1,610,442", "884 ms", "0.09%"]
+    ]
+  },
+  "bars": {
+    "heading": "Requests by week",
+    "series": [
+      { "label": "Week 1", "value": 10.8, "display": "10.8M" },
+      { "label": "Week 2", "value": 11.9, "display": "11.9M" },
+      { "label": "Week 3", "value": 12.4, "display": "12.4M" },
+      { "label": "Week 4", "value": 13.1, "display": "13.1M" }
+    ]
+  },
+  "sections": [
+    {
+      "heading": "Summary",
+      "body": [
+        "Traffic grew 12% month on month, driven almost entirely by the checkout API following the February pricing launch. Latency improved despite the extra load, thanks to the connection-pool change shipped on the 8th.",
+        "One incident affected search for 41 minutes on 19 February. Root cause was an unbounded query introduced by a third-party integration; a query timeout has since been added."
+      ]
+    },
+    {
+      "heading": "Actions for next month",
+      "body": [
+        "Reporting remains the slowest service at a p95 of 884 ms. The team will move its aggregate queries onto the read replica and revisit the index on the events table.",
+        "Error rate rose slightly, entirely within the webhooks service. The retry policy will be changed from fixed to exponential backoff."
+      ]
+    }
+  ]
+}

data/templates/shared/branding.typ

@@ -0,0 +1,140 @@
+// Shared branding for every Typstify document.
+//
+// Change it once here and every invoice, receipt, report and certificate
+// follows. Nothing in this file reads data.json — it is pure presentation, so
+// it can be imported by any template.
+
+#let brand = (
+  name: "Your Company",
+  tagline: "",
+  accent: rgb("#1f5eff"),
+  ink: rgb("#111827"),
+  muted: rgb("#6b7280"),
+  rule: rgb("#e5e7eb"),
+  font: "Inter",
+)
+
+// Base page setup. Wrap a document with:  #show: brand-page
+#let brand-page(body) = {
+  set page(
+    paper: "a4",
+    margin: (x: 18mm, y: 20mm),
+    footer: context [
+      #set text(size: 8pt, fill: brand.muted)
+      #line(length: 100%, stroke: 0.5pt + brand.rule)
+      #v(2pt)
+      #grid(
+        columns: (1fr, auto),
+        align: (left, right),
+        [#brand.name],
+        [Page #counter(page).display() of #context counter(page).final().first()],
+      )
+    ],
+  )
+  set text(font: brand.font, size: 10pt, fill: brand.ink)
+  set par(justify: false, leading: 0.65em)
+  show heading: set text(weight: "semibold")
+  body
+}
+
+// Document header: a title on the left, the company block on the right.
+#let brand-header(title: "", subtitle: none, meta: ()) = {
+  grid(
+    columns: (1fr, auto),
+    align: (left + bottom, right + bottom),
+    [
+      #text(size: 22pt, weight: "semibold", fill: brand.accent)[#title]
+      #if subtitle != none [
+        #linebreak()
+        #text(size: 10pt, fill: brand.muted)[#subtitle]
+      ]
+    ],
+    [
+      #text(size: 11pt, weight: "semibold")[#brand.name]
+      #if brand.tagline != "" [
+        #linebreak()
+        #text(size: 9pt, fill: brand.muted)[#brand.tagline]
+      ]
+    ],
+  )
+  v(4pt)
+  line(length: 100%, stroke: 1pt + brand.accent)
+  if meta.len() > 0 {
+    v(6pt)
+    grid(
+      columns: meta.len(),
+      gutter: 16pt,
+      ..meta.map(pair => [
+        #text(size: 8pt, fill: brand.muted, upper(pair.at(0)))
+        #linebreak()
+        #text(size: 10pt)[#pair.at(1)]
+      ]),
+    )
+  }
+  v(10pt)
+}
+
+// A labelled block of lines, e.g. an address.
+#let brand-address(label: "", lines: ()) = [
+  #text(size: 8pt, fill: brand.muted)[#upper(label)]
+  #linebreak()
+  #for line in lines [
+    #line
+    #linebreak()
+  ]
+]
+
+// The standard table styling used by the invoice and receipt templates.
+#let brand-table(columns: (), header: (), rows: (), aligns: none) = {
+  set text(size: 9.5pt)
+  table(
+    columns: columns,
+    align: if aligns == none { left } else { (col, _) => aligns.at(col) },
+    stroke: (x, y) => (
+      bottom: if y == 0 { 1pt + brand.rule } else { 0.5pt + brand.rule },
+    ),
+    inset: (x: 6pt, y: 7pt),
+    table.header(..header.map(cell => text(
+      size: 8pt,
+      weight: "semibold",
+      fill: brand.muted,
+    )[#upper(cell)])),
+    ..rows.flatten(),
+  )
+}
+
+// Right-aligned totals block.
+#let brand-totals(rows: (), emphasis: none) = align(right)[
+  #block(width: 62mm)[
+    #for row in rows [
+      #grid(
+        columns: (1fr, auto),
+        gutter: 12pt,
+        align: (left, right),
+        text(fill: brand.muted)[#row.at(0)],
+        [#row.at(1)],
+      )
+      #v(2pt)
+    ]
+    #if emphasis != none [
+      #line(length: 100%, stroke: 0.5pt + brand.rule)
+      #v(4pt)
+      #grid(
+        columns: (1fr, auto),
+        gutter: 12pt,
+        align: (left, right),
+        text(weight: "semibold")[#emphasis.at(0)],
+        text(weight: "semibold", size: 12pt, fill: brand.accent)[#emphasis.at(1)],
+      )
+    ]
+  ]
+]
+
+#let brand-note(body) = block(
+  width: 100%,
+  fill: rgb("#f9fafb"),
+  stroke: 0.5pt + brand.rule,
+  radius: 3pt,
+  inset: 10pt,
+  text(size: 9pt, fill: brand.muted)[#body],
+)

metadata

@@ -0,0 +1,164 @@
+--- !ruby/object:Gem::Specification
+name: typstify
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nikhil Nelson
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-08-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: typst
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.2'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.2'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.2'
+description: Typstify gives Rails first-class PDF generation on Typst, the Rust typesetting
+  engine. Controllers get `render pdf:`, templates live in app/views like every other
+  view, and your data arrives as JSON so user content can never change the document
+  — injection-safe by construction, compiled in an isolated sandbox directory. Ships
+  professionally designed invoice, receipt, report and certificate templates, and
+  can emit accessible PDF/UA-1 output for EAA and ADA compliance. No headless Chrome,
+  no archived wkhtmltopdf binary.
+email:
+- thesolohacker47@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- SECURITY.md
+- fonts/inter/Inter-Regular.ttf
+- fonts/inter/Inter-SemiBold.ttf
+- fonts/inter/OFL.txt
+- lib/generators/typstify/install/install_generator.rb
+- lib/generators/typstify/install/templates/typstify.rb
+- lib/generators/typstify/template/template_generator.rb
+- lib/tasks/typstify.rake
+- lib/typstify.rb
+- lib/typstify/adapter.rb
+- lib/typstify/config.rb
+- lib/typstify/data.rb
+- lib/typstify/document.rb
+- lib/typstify/engine.rb
+- lib/typstify/erb_pipeline.rb
+- lib/typstify/errors.rb
+- lib/typstify/escaping.rb
+- lib/typstify/fonts.rb
+- lib/typstify/renderer.rb
+- lib/typstify/resolver.rb
+- lib/typstify/version.rb
+- lib/typstify/warnings.rb
+- lib/typstify/workspace.rb
+- templates/certificate/certificate.typ
+- templates/certificate/sample_data.json
+- templates/invoice/invoice.typ
+- templates/invoice/sample_data.json
+- templates/receipt/receipt.typ
+- templates/receipt/sample_data.json
+- templates/report/report.typ
+- templates/report/sample_data.json
+- templates/shared/branding.typ
+homepage: https://github.com/TheSoloHacker47/typstify
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/TheSoloHacker47/typstify
+  source_code_uri: https://github.com/TheSoloHacker47/typstify
+  changelog_uri: https://github.com/TheSoloHacker47/typstify/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/TheSoloHacker47/typstify/issues
+  documentation_uri: https://github.com/TheSoloHacker47/typstify#readme
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: PDF generation for Rails on the Typst engine — the wkhtmltopdf replacement.
+test_files: []