Tester UI

PDF Server ships an embedded tester UI — a small React app served from the server binary. It lets you pick a template, provide data, and preview the rendered PDF interactively. It is the fastest way to iterate on a template.

Open it

Browse to the server root:

http://localhost:9999/

(The root redirects to /static/.) The server logs the exact URL on startup.

What it offers

  • Template picker — every loaded template and composition.
  • Data input — paste JSON, or load one of the template’s committed examples/*.json datasets.
  • Live preview — renders the PDF and displays it inline.
  • Schema & metadata — shows the template’s JSON Schema and server metadata.

With hot reload

Run the server with --templates-reload-mode=always (the dev default) and each render re-reads the template from disk, so you can edit the template file and re-render in the tester without restarting. See the author workflow.

API spec viewers

The static assets also include OpenAPI viewers (Swagger UI, Redoc, Scalar) served alongside the tester, pointed at the live /spec/swagger.json. See the API reference.