Skip to content

The modern alternative to LaTeX. Create PDF documents templates using React, JSX, and Tailwind

License

Notifications You must be signed in to change notification settings

htmldocs-js/htmldocs

Repository files navigation

htmldocs

PDF document creation is stuck in the past, from clunky Word docs to complex LaTeX to outdated tools. htmldocs brings document generation into 2025 with a modern developer experience using the tools you already love: React, TypeScript, and Tailwind.

What is htmldocs?

htmldocs is a local document editor and preview server to help you create PDFs with React. It provides all the structural benefits of LaTeX with the familiarity of HTML and CSS. With htmldocs, you can use JSX to build document templates (invoices, reports, contracts, etc.) and generate PDFs just by passing data as props. htmldocs has:

  • πŸ“Œ Support for the latest CSS features like margin boxes and flexbox
  • 🧩 A collection of unstyled components to help you layout your documents
  • πŸ“„ JSX templating system for building dynamic documents
  • πŸ”— Full TypeScript support for type safety
  • ⚑ Dynamic data integration through props and APIs
  • πŸ“Š Real-time preview server with hot reloading

Example

To see the full power of htmldocs, here is how you might build a dynamic invoice document template with JSX template variables:

Invoice template with htmldocs

To change the customer details, all you need to do is render the Invoice component with different props:

<Invoice 
  customer={{
    name: "John Doe",
    address: "456 Main St",
    city: "Anytown",
    state: "CA",
    zip: "12345",
    phone: "123-456-7890",
  }}
  items={items}
/>

Screenshots

Resume example

Variables editor

Install

To create your first htmldocs project, run the following command:

npx htmldocs@latest init

For further instructions or to integrate htmldocs into your existing project, refer to the Getting Started guide.

Components

htmldocs comes with a standard set of components to help you layout and style your documents.

How it works

htmldocs is built upon Chromium's rendering engine, which means it can render any HTML, CSS, and JavaScript. This is different from other tools like wkhtmltopdf, WeasyPrint, and Prince, which only support a subset of HTML and CSS.

htmldocs also uses the Paged.js library under the hood. Paged.js is used for layout and chunking, as well as more modern features like margin boxes that aren't fully supported by the W3C's CSS standard.

Comparison

Feature Traditional Documents
(Word, Google Docs)
LaTeX Documents
(Overleaf, TeXStudio)
Freeform Documents
(Figma, Sketch)
Web Documents
(htmldocs)
Content Structure Semi-Structured Structured Freeform Structured
Learning Curve βœ… Simple ❌ Complex βœ… Simple βœ… Simple
Template Variables ❌ Limited ❌ Limited ❌ Limited βœ… Supported
Styling βœ… Basic ❌ Complex βœ… Advanced βœ… Advanced
Version Control ❌ Limited βœ… Supported ❌ Limited βœ… Supported
External Libraries ❌ Limited βœ… Supported ❌ Limited βœ… Supported
Automation / API ❌ Limited ❌ Limited ❌ Limited βœ… Supported
Live Preview βœ… Supported ❌ Limited βœ… Supported βœ… Supported
CI/CD Integration ❌ Limited ⚠️ Partial ❌ Limited βœ… Supported
Type Safety ❌ Limited ❌ Limited ❌ Limited βœ… Supported
AI ❌ Limited ❌ Limited ❌ Limited βœ… Supported

Tech Stack

Next.js TypeScript Turborepo pnpm
Next.js TypeScript Turborepo pnpm

License

MIT License