Paperwork.CLI 1.2.0

dotnet tool install --global Paperwork.CLI --version 1.2.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local Paperwork.CLI --version 1.2.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Paperwork.CLI&version=1.2.0
                    
nuke :add-package Paperwork.CLI --version 1.2.0
                    

Paperwork CLI

Command-line tool for generating PDF documents using the Paperwork / Scryber engine.

Installation

dotnet tool install -g Paperwork.CLI

Commands

Command Description
generate Generate a PDF document
validate <config> Validate a TemplateConfigV1 JSON config file
info Display version and environment information

Quick Start

From an HTML file

paperwork generate --layout invoice.html --output invoice.pdf

With data and parameters

paperwork generate \
  --layout invoice.html \
  --data order=order.json \
  --field date=2026-03-26 \
  --field title="March Invoice" \
  --output invoice.pdf

From a config file

paperwork generate --config invoice-config.json --output invoice.pdf

Override a config data source at runtime

paperwork generate --config invoice-config.json \
  --data customer=local-customer.json \
  --output invoice.pdf

Pipe output to stdout

paperwork generate --layout report.html | aws s3 cp - s3://my-bucket/report.pdf

generate options

Option Description
--config <file> TemplateConfigV1 JSON config file (mutually exclusive with --layout)
--layout <file> HTML layout file
--style <file> CSS file — repeatable
--data name=path JSON data file — repeatable; overrides config data by name in --config mode
--field key=value Field override — repeatable; accessible as fields["key"] in templates
--output <file> Output PDF path; omit to write bytes to stdout
--async Use Scryber's async render path

Validate

paperwork validate report.json
# Valid. Layouts: 1, Styles: 2, Data: 3, Fields: 1

License

MIT

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.2.0 98 3/27/2026
1.1.0 88 3/27/2026
1.0.0 74 3/26/2026