• Stars
    star
    324
  • Rank 129,708 (Top 3 %)
  • Language
    TypeScript
  • Created over 2 years ago
  • Updated 9 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Use Tailwind CSS to style PDFs created with react-pdf

React PDF Tailwind

Use Tailwind CSS to style PDFs created with react-pdf.

Try it yourself in the react-pdf-repl interactive playground.

Example

import React from "react";
import { Document, Page, Text, View, StyleSheet } from "@react-pdf/renderer";
import { createTw } from "react-pdf-tailwind";

// The 'theme' object is your Tailwind theme config
const tw = createTw({
  theme: {
    fontFamily: {
      sans: ["Comic Sans"],
    },
    extend: {
      colors: {
        custom: "#bada55",
      },
    },
  },
});

export default function MyPdf() {
  return (
    <Document>
      <Page size="A4" style={tw("p-12 font-sans")}>
        <View style={tw("p-20 bg-gray-100")}>
          <Text style={tw("text-custom text-3xl")}>Section #1</Text>
        </View>
        <View style={tw("mt-12 px-8 rotate-2")}>
          <Text style={tw("text-amber-600 text-2xl")}>Section #2</Text>
        </View>
      </Page>
    </Document>
  );
}

More detailed examples can be found in the examples folder.

Installation

// Or pnpm, yarn...
npm install react-pdf-tailwind

Notes

  • Supports most of the CSS properties that make sense in a PDF context, and are supported by react-pdf (see this list)
  • Default font family classes are excluded, since you have to include your own fonts anyway
  • Internally uses pt as the default unit (supported units can be found here), using the convention 1rem = 12pt
  • Since react-pdf uses Yoga internally, some defaults differ from the web standard (for example, flex-direction defaults to column, which can be fixed by adding the flex-row class where needed)
  • Modifiers like breakpoints (which could technically make sense) aren't supported yet