Skip to content

armgit / pdfcn

Public Imported from GitHub
0

Beautiful pdf components, built on Takumi and Forme. 100% Free, Zero config, one command setup.

feat(registry): add work-order block for forme

Aniket-50838a110804f69
diff --git a/apps/web/components/web-mcp/pdf-tool.tsx b/apps/web/components/web-mcp/pdf-tool.tsx
index f77111f..966a7af 100644
--- a/apps/web/components/web-mcp/pdf-tool.tsx
+++ b/apps/web/components/web-mcp/pdf-tool.tsx
@@ -22,6 +22,7 @@ const BLOCK_NAMES = [
"report-operations",
"report-security",
"shipping-label",
+ "work-order",
];
export const GeneratePdfTool = () => {
diff --git a/apps/web/content/docs/blocks/forme/meta.json b/apps/web/content/docs/blocks/forme/meta.json
index fc484b0..ae5f124 100644
--- a/apps/web/content/docs/blocks/forme/meta.json
+++ b/apps/web/content/docs/blocks/forme/meta.json
@@ -18,7 +18,8 @@
"report-marketing",
"report-operations",
"report-security",
- "shipping-label"
+ "shipping-label",
+ "work-order"
],
"title": "Forme"
}
diff --git a/apps/web/content/docs/blocks/forme/work-order.mdx b/apps/web/content/docs/blocks/forme/work-order.mdx
new file mode 100644
index 0000000..f7331a2
--- /dev/null
+++ b/apps/web/content/docs/blocks/forme/work-order.mdx
@@ -0,0 +1,160 @@
+---
+title: "Work Order"
+description: "Printable service/maintenance work order with job details, parts used, labor tracking, and customer sign-off."
+---
+
+<ComponentPreview base="forme" name="work-order" hideCode />
+
+## Installation
+
+<CodeTabs>
+
+<TabsList>
+ <TabsTrigger value="cli">Command</TabsTrigger>
+ <TabsTrigger value="manual">Manual</TabsTrigger>
+</TabsList>
+
+<TabsContent value="cli">
+
+```bash
+npx shadcn@latest add @pdfcn/forme/work-order
+```
+
+</TabsContent>
+
+<TabsContent value="manual">
+
+<Steps>
+
+<Step>Install the following dependencies:</Step>
+
+```bash
+npm install @formepdf/react @formepdf/core
+```
+
+<Step>Copy and paste the following code into your project.</Step>
+
+<ComponentSource
+ src="registry/bases/forme/blocks/work-order/work-order.tsx"
+ base="forme"
+ title="components/pdf/blocks/work-order/work-order.tsx"
+/>
+
+<ComponentSource
+ src="registry/bases/forme/components/theme-provider.tsx"
+ base="forme"
+ title="components/pdf/theme-provider.tsx"
+/>
+
+<ComponentSource
+ src="registry/bases/forme/lib/resolve-color.ts"
+ base="forme"
+ title="lib/resolve-color.ts"
+/>
+
+<ComponentSource
+ src="registry/bases/forme/lib/pdf-primitives.tsx"
+ base="forme"
+ title="lib/pdf-primitives.tsx"
+/>
+
+<ComponentSource
+ src="registry/bases/forme/lib/pdf-svg.tsx"
+ base="forme"
+ title="lib/pdf-svg.tsx"
+/>
+
+<ComponentSource
+ src="registry/themes/professional.ts"
+ base="forme"
+ title="lib/pdf-themes/professional.ts"
+/>
+
+<ComponentSource
+ src="registry/themes/primitives.ts"
+ base="forme"
+ title="lib/pdf-themes/primitives.ts"
+/>
+
+<ComponentSource
+ src="registry/types/pdf-themes.ts"
+ base="forme"
+ title="types/pdf-themes.ts"
+/>
+
+<ComponentSource
+ src="registry/types/pdf-components.ts"
+ base="forme"
+ title="types/pdf-components.ts"
+/>
+
+<Step>Update the import paths to match your project setup.</Step>
+
+</Steps>
+
+</TabsContent>
+
+</CodeTabs>
+
+## Usage
+
+```tsx
+import { WorkOrderDocument } from "@/components/pdf/work-order";
+```
+
+```tsx
+<WorkOrderDocument
+ data={{
+ companyName: "FixIt Pro Services",
+ workOrderNumber: "WO-2026-0452",
+ date: "September 10, 2026",
+ priority: "High",
+ customer: {
+ name: "Riverside Apartments",
+ address: "789 Elm St, Austin, TX 78701",
+ phone: "(512) 555-0199",
+ },
+ technician: "Mike Torres",
+ jobType: "Repair",
+ equipment: {
+ description: "Commercial Dishwasher",
+ makeModel: "Bosch SHP878ZD5N",
+ serialNumber: "BSH-2024-88712",
+ },
+ parts: [
+ {
+ partNumber: "PUMP-001",
+ description: "Drain Pump Assembly",
+ qty: 1,
+ unitPrice: 89.99,
+ },
+ {
+ partNumber: "HOSE-012",
+ description: "Drain Hose Kit",
+ qty: 1,
+ unitPrice: 24.5,
+ },
+ ],
+ labor: [
+ {
+ description: "Diagnosis and repair",
+ technician: "Mike Torres",
+ hours: 2.5,
+ rate: 95.0,
+ },
+ ],
+ taxRate: 0.0825,
+ technicianNotes:
+ "Found clogged drain pump. Replaced pump and hose. Unit tested OK.",
+ warrantyInfo: "90-day warranty on parts and labor.",
+ accentColor: "#ea580c",
+ }}
+/>
+```
+
+## Props
+
+| Prop | Type | Description |
+| ------- | --------------- | ----------------------------- |
+| `data` | `WorkOrderData` | Work order content and totals |
+| `theme` | `PdfcnTheme` | Optional theme override |
diff --git a/apps/web/examples/__index__.ts b/apps/web/examples/__index__.ts
index 4a4e72c..0fe9cc1 100644
--- a/apps/web/examples/__index__.ts
+++ b/apps/web/examples/__index__.ts
@@ -42,6 +42,7 @@ import forme_stack from "@/examples/forme/stack";
import forme_table from "@/examples/forme/table";
import forme_text from "@/examples/forme/text";
import forme_watermark from "@/examples/forme/watermark";
+import forme_work_order from "@/examples/forme/work-order";
import takumi_alert from "@/examples/takumi/alert";
import takumi_badge from "@/examples/takumi/badge";
import takumi_card from "@/examples/takumi/card";
@@ -133,6 +134,7 @@ export const demos: Record<BaseName, DemoMap> = {
table: forme_table,
text: forme_text,
watermark: forme_watermark,
+ "work-order": forme_work_order,
},
takumi: {
alert: takumi_alert,
diff --git a/apps/web/examples/forme/work-order.tsx b/apps/web/examples/forme/work-order.tsx
new file mode 100644
index 0000000..09c9493
--- /dev/null
+++ b/apps/web/examples/forme/work-order.tsx
@@ -0,0 +1,4 @@
+import { WorkOrderDocument } from "@/registry/bases/forme/blocks/work-order/work-order";
+
+const Demo = () => <WorkOrderDocument />;
+export default Demo;
diff --git a/apps/web/public/r/forme/work-order.json b/apps/web/public/r/forme/work-order.json
new file mode 100644
index 0000000..cb409a3
--- /dev/null
+++ b/apps/web/public/r/forme/work-order.json
@@ -0,0 +1,37 @@
+{
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+ "name": "forme/work-order",
+ "title": "Work Order",
+ "description": "Work Order PDF block (forme)",
+ "dependencies": [
+ "@formepdf/react",
+ "@formepdf/core"
+ ],
+ "registryDependencies": [
+ "@pdfcn/forme/utils",
+ "@pdfcn/forme/badge",
+ "@pdfcn/forme/key-value",
+ "@pdfcn/forme/page-footer",
+ "@pdfcn/forme/page-header",
+ "@pdfcn/forme/pdf-image",
+ "@pdfcn/forme/section",
+ "@pdfcn/forme/signature",
+ "@pdfcn/forme/table",
+ "@pdfcn/forme/text"
+ ],
+ "files": [
+ {
+ "path": "registry/bases/forme/blocks/work-order/work-order.tsx",
+ "content": "import { Document, Page, StyleSheet, View } from \"@formepdf/react\";\n\nimport { Badge } from \"@/registry/bases/forme/components/badge/badge\";\nimport type { BadgeVariant } from \"@/registry/bases/forme/components/badge/badge\";\nimport { KeyValue } from \"@/registry/bases/forme/components/key-value/key-value\";\nimport { PageFooter } from \"@/registry/bases/forme/components/page-footer/page-footer\";\nimport { PageHeader } from \"@/registry/bases/forme/components/page-header/page-header\";\nimport { PdfImage } from \"@/registry/bases/forme/components/pdf-image/pdf-image\";\nimport { Section } from \"@/registry/bases/forme/components/section/section\";\nimport { PdfSignatureBlock } from \"@/registry/bases/forme/components/signature/signature\";\nimport {\n Table,\n TableBody,\n TableCell,\n TableHeader,\n TableRow,\n} from \"@/registry/bases/forme/components/table/table\";\nimport { Text } from \"@/registry/bases/forme/components/text/text\";\nimport {\n PdfcnThemeProvider,\n usePdfcnTheme,\n} from \"@/registry/bases/forme/components/theme-provider\";\nimport type { PdfcnTheme } from \"@/registry/types/pdf-themes\";\n\nimport type { WorkOrderData, WorkOrderPriority } from \"./work-order.types\";\n\n// Sample data — replace with your own props or data source\nconst sampleData: WorkOrderData = {\n accentColor: \"#ea580c\",\n companyName: \"FixIt Pro Services\",\n customer: {\n accountNumber: \"ACC-10234\",\n address: \"789 Elm St, Austin, TX 78701\",\n name: \"Riverside Apartments\",\n phone: \"(512) 555-0199\",\n },\n customerNotes: \"Please service before end of month lease inspection.\",\n date: \"September 10, 2026\",\n equipment: {\n description: \"Commercial Dishwasher\",\n location: \"Kitchen — Unit 4B\",\n makeModel: \"Bosch SHP878ZD5N\",\n serialNumber: \"BSH-2024-88712\",\n },\n jobType: \"Repair\",\n labor: [\n {\n description: \"Diagnosis and repair\",\n hours: 2.5,\n rate: 95,\n technician: \"Mike Torres\",\n },\n ],\n parts: [\n {\n description: \"Drain Pump Assembly\",\n partNumber: \"PUMP-001\",\n qty: 1,\n unitPrice: 89.99,\n },\n {\n description: \"Drain Hose Kit\",\n partNumber: \"HOSE-012\",\n qty: 1,\n unitPrice: 24.5,\n },\n ],\n priority: \"High\",\n taxRate: 0.0825,\n technician: \"Mike Torres\",\n technicianNotes:\n \"Found clogged drain pump. Replaced pump and hose. Unit tested OK.\",\n warrantyInfo: \"90-day warranty on parts and labor.\",\n workOrderNumber: \"WO-2026-0452\",\n};\n\nconst PRIORITY_BADGE_VARIANT: Record<WorkOrderPriority, BadgeVariant> = {\n High: \"warning\",\n Low: \"default\",\n Medium: \"info\",\n Urgent: \"destructive\",\n};\n\nconst WorkOrderContent = ({ data }: { data: WorkOrderData }) => {\n const theme = usePdfcnTheme();\n\n const styles = StyleSheet.create({\n checkbox: {\n borderColor: theme.colors.foreground,\n borderStyle: \"solid\",\n borderWidth: 1,\n height: 10,\n width: 10,\n },\n checkboxRow: {\n alignItems: \"center\",\n flexDirection: \"row\",\n gap: 6,\n marginTop: theme.spacing.componentGap,\n },\n col: {\n flex: 1,\n paddingRight: 15,\n },\n label: {\n fontSize: 9,\n fontWeight: \"bold\",\n marginBottom: 2,\n },\n page: {\n backgroundColor: theme.colors.background,\n },\n row: {\n flexDirection: \"row\",\n },\n section: {\n marginBottom: theme.spacing.componentGap,\n },\n sectionSpaced: {\n marginBottom: theme.spacing.componentGap,\n marginTop: theme.spacing.componentGap,\n },\n signature: {\n marginBottom: 0,\n marginTop: 0,\n },\n });\n\n const partsTotal = data.parts.reduce(\n (sum, part) => sum + part.qty * part.unitPrice,\n 0\n );\n const laborTotal = data.labor.reduce(\n (sum, item) => sum + item.hours * item.rate,\n 0\n );\n const taxRate = data.taxRate ?? 0;\n const tax = (partsTotal + laborTotal) * taxRate;\n const grandTotal = partsTotal + laborTotal + tax;\n\n return (\n <Document title={`Work Order ${data.workOrderNumber}`}>\n <Page\n margin={{\n bottom: theme.spacing.page.marginBottom,\n left: theme.spacing.page.marginLeft,\n right: theme.spacing.page.marginRight,\n top: theme.spacing.page.marginTop,\n }}\n size=\"A4\"\n >\n <PageFooter\n leftText={data.warrantyInfo}\n rightText=\"Page 1 of 1\"\n sticky\n pagePadding={25}\n />\n <View style={styles.page as never}>\n <PageHeader\n variant=\"logo-left\"\n logo={\n data.companyLogo ? (\n <PdfImage src={data.companyLogo} style={{ margin: 0 }} />\n ) : undefined\n }\n title={data.companyName}\n subtitle=\"Work Order\"\n rightText={`WO #${data.workOrderNumber}`}\n rightSubText={`Date: ${data.date}`}\n style={styles.section}\n />\n\n <Section\n noWrap\n spacing=\"none\"\n style={{\n ...styles.row,\n ...styles.section,\n alignItems: \"center\",\n justifyContent: \"space-between\",\n }}\n >\n <View\n style={{ alignItems: \"center\", flexDirection: \"row\", gap: 8 }}\n >\n <Text\n style={{ fontSize: 9, fontWeight: \"bold\" }}\n color=\"mutedForeground\"\n transform=\"uppercase\"\n noMargin\n >\n Priority\n </Text>\n <Badge\n label={data.priority}\n variant={PRIORITY_BADGE_VARIANT[data.priority]}\n size=\"sm\"\n />\n </View>\n <Badge label={data.jobType} variant=\"outline\" size=\"sm\" />\n </Section>\n\n <Section\n noWrap\n spacing=\"none\"\n style={{ ...styles.row, ...styles.section }}\n >\n <View style={styles.col}>\n <Text\n style={styles.label}\n color=\"mutedForeground\"\n transform=\"uppercase\"\n noMargin\n >\n Customer\n </Text>\n <Text noMargin variant=\"xs\">\n {data.customer.name}\n </Text>\n <Text noMargin variant=\"xs\">\n {data.customer.address}\n </Text>\n <Text noMargin variant=\"xs\">\n {data.customer.phone}\n </Text>\n {data.customer.email ? (\n <Text noMargin variant=\"xs\">\n {data.customer.email}\n </Text>\n ) : null}\n {data.customer.accountNumber ? (\n <Text noMargin variant=\"xs\">\n {`Acct #: ${data.customer.accountNumber}`}\n </Text>\n ) : null}\n </View>\n <View style={styles.col}>\n <Text\n style={styles.label}\n color=\"mutedForeground\"\n transform=\"uppercase\"\n noMargin\n >\n Job Info\n </Text>\n <Text noMargin variant=\"xs\">\n {`Technician: ${data.technician}`}\n </Text>\n <Text noMargin variant=\"xs\">\n {`Job Type: ${data.jobType}`}\n </Text>\n </View>\n <View style={styles.col}>\n <Text\n style={styles.label}\n color=\"mutedForeground\"\n transform=\"uppercase\"\n noMargin\n >\n Equipment\n </Text>\n <Text noMargin variant=\"xs\">\n {data.equipment.description}\n </Text>\n {data.equipment.makeModel ? (\n <Text noMargin variant=\"xs\">\n {data.equipment.makeModel}\n </Text>\n ) : null}\n {data.equipment.serialNumber ? (\n <Text noMargin variant=\"xs\">\n {`S/N: ${data.equipment.serialNumber}`}\n </Text>\n ) : null}\n {data.equipment.location ? (\n <Text noMargin variant=\"xs\">\n {`Location: ${data.equipment.location}`}\n </Text>\n ) : null}\n </View>\n </Section>\n\n <Section spacing=\"none\">\n <Text\n style={styles.label}\n color=\"mutedForeground\"\n transform=\"uppercase\"\n noMargin\n >\n Parts Used\n </Text>\n <Table variant=\"grid\" zebraStripe>\n <TableHeader>\n <TableRow header>\n <TableCell>Part #</TableCell>\n <TableCell>Description</TableCell>\n <TableCell align=\"center\">Qty</TableCell>\n <TableCell align=\"right\">Unit Price</TableCell>\n <TableCell align=\"right\">Total</TableCell>\n </TableRow>\n </TableHeader>\n <TableBody>\n {data.parts.map((part, index) => (\n // biome-ignore lint/suspicious/noArrayIndexKey: parts have no stable id\n <TableRow key={index}>\n <TableCell>{part.partNumber}</TableCell>\n <TableCell>{part.description}</TableCell>\n <TableCell align=\"center\">{`${part.qty}`}</TableCell>\n <TableCell align=\"right\">{`$${part.unitPrice.toFixed(2)}`}</TableCell>\n <TableCell align=\"right\">{`$${(part.qty * part.unitPrice).toFixed(2)}`}</TableCell>\n </TableRow>\n ))}\n </TableBody>\n </Table>\n </Section>\n\n <Section spacing=\"none\">\n <Text\n style={styles.label}\n color=\"mutedForeground\"\n transform=\"uppercase\"\n noMargin\n >\n Labor\n </Text>\n <Table variant=\"grid\" zebraStripe>\n <TableHeader>\n <TableRow header>\n <TableCell>Description</TableCell>\n <TableCell>Technician</TableCell>\n <TableCell align=\"center\">Hours</TableCell>\n <TableCell align=\"right\">Rate</TableCell>\n <TableCell align=\"right\">Total</TableCell>\n </TableRow>\n </TableHeader>\n <TableBody>\n {data.labor.map((item, index) => (\n // biome-ignore lint/suspicious/noArrayIndexKey: labor entries have no stable id\n <TableRow key={index}>\n <TableCell>{item.description}</TableCell>\n <TableCell>{item.technician}</TableCell>\n <TableCell align=\"center\">{`${item.hours}`}</TableCell>\n <TableCell align=\"right\">{`$${item.rate.toFixed(2)}`}</TableCell>\n <TableCell align=\"right\">{`$${(item.hours * item.rate).toFixed(2)}`}</TableCell>\n </TableRow>\n ))}\n </TableBody>\n </Table>\n </Section>\n\n <Section\n noWrap\n spacing=\"none\"\n style={{ ...styles.row, ...styles.section }}\n >\n <View style={{ flex: 1, paddingRight: 15 }}>\n {data.technicianNotes ? (\n <View>\n <Text\n style={styles.label}\n color=\"mutedForeground\"\n transform=\"uppercase\"\n noMargin\n >\n Technician Notes\n </Text>\n <Text noMargin variant=\"xs\">\n {data.technicianNotes}\n </Text>\n </View>\n ) : null}\n </View>\n <View style={{ marginLeft: \"auto\", width: 200 }}>\n <KeyValue\n size=\"sm\"\n dividerThickness={1}\n items={[\n { key: \"Parts Total\", value: `$${partsTotal.toFixed(2)}` },\n { key: \"Labor Total\", value: `$${laborTotal.toFixed(2)}` },\n {\n key: `Tax (${(taxRate * 100).toFixed(2)}%)`,\n value: `$${tax.toFixed(2)}`,\n },\n {\n key: \"Grand Total\",\n keyStyle: { fontSize: 12, fontWeight: \"bold\" },\n value: `$${grandTotal.toFixed(2)}`,\n valueStyle: { fontSize: 12, fontWeight: \"bold\" },\n },\n ]}\n divided\n />\n </View>\n </Section>\n\n {data.customerNotes ? (\n <Section spacing=\"none\" style={styles.sectionSpaced}>\n <Text\n style={styles.label}\n color=\"mutedForeground\"\n transform=\"uppercase\"\n noMargin\n >\n Customer Notes\n </Text>\n <Text noMargin variant=\"xs\">\n {data.customerNotes}\n </Text>\n </Section>\n ) : null}\n\n <Section spacing=\"none\">\n <PdfSignatureBlock\n variant=\"double\"\n signers={[\n { date: data.date, label: \"Customer Signature\" },\n {\n date: data.date,\n label: \"Technician Signature\",\n name: data.technician,\n },\n ]}\n style={styles.signature}\n />\n <View style={styles.checkboxRow}>\n <View style={styles.checkbox} />\n <Text noMargin variant=\"xs\">\n Customer approves work performed and charges above\n </Text>\n </View>\n </Section>\n </View>\n </Page>\n </Document>\n );\n};\n\nexport const WorkOrderDocument = ({\n theme,\n data = sampleData,\n}: {\n theme?: PdfcnTheme;\n data?: WorkOrderData;\n}) => (\n <PdfcnThemeProvider theme={theme}>\n <WorkOrderContent data={data} />\n </PdfcnThemeProvider>\n);\n",
+ "type": "registry:block",
+ "target": "components/pdf/blocks/work-order/work-order.tsx"
+ },
+ {
+ "path": "registry/bases/forme/blocks/work-order/work-order.types.ts",
+ "content": "export type WorkOrderPriority = \"Low\" | \"Medium\" | \"High\" | \"Urgent\";\n\nexport interface WorkOrderCustomer {\n name: string;\n address: string;\n phone: string;\n email?: string;\n accountNumber?: string;\n}\n\nexport type WorkOrderJobType =\n | \"Repair\"\n | \"Installation\"\n | \"Maintenance\"\n | \"Inspection\"\n | string;\n\nexport interface WorkOrderEquipment {\n description: string;\n makeModel?: string;\n serialNumber?: string;\n location?: string;\n}\n\nexport interface WorkOrderPart {\n partNumber: string;\n description: string;\n qty: number;\n unitPrice: number;\n}\n\nexport interface WorkOrderLabor {\n description: string;\n technician: string;\n hours: number;\n rate: number;\n}\n\nexport interface WorkOrderData {\n companyName: string;\n companyLogo?: string;\n workOrderNumber: string;\n date: string;\n priority: WorkOrderPriority;\n customer: WorkOrderCustomer;\n technician: string;\n jobType: WorkOrderJobType;\n equipment: WorkOrderEquipment;\n parts: WorkOrderPart[];\n labor: WorkOrderLabor[];\n taxRate?: number;\n technicianNotes?: string;\n customerNotes?: string;\n warrantyInfo?: string;\n accentColor?: string;\n renderingBase?: \"takumi\" | \"forme\";\n}\n",
+ "type": "registry:block",
+ "target": "components/pdf/blocks/work-order/work-order.types.ts"
+ }
+ ],
+ "type": "registry:block"
+}
\ No newline at end of file
diff --git a/apps/web/public/r/registry.json b/apps/web/public/r/registry.json
index 6e47a94..e2997fa 100644
--- a/apps/web/public/r/registry.json
+++ b/apps/web/public/r/registry.json
@@ -2233,6 +2233,37 @@
],
"title": "Report Security",
"type": "registry:block"
+ },
+ {
+ "dependencies": ["@formepdf/react", "@formepdf/core"],
+ "description": "Work Order PDF block (forme)",
+ "files": [
+ {
+ "path": "registry/bases/forme/blocks/work-order/work-order.tsx",
+ "type": "registry:block",
+ "target": "components/pdf/blocks/work-order/work-order.tsx"
+ },
+ {
+ "path": "registry/bases/forme/blocks/work-order/work-order.types.ts",
+ "type": "registry:block",
+ "target": "components/pdf/blocks/work-order/work-order.types.ts"
+ }
+ ],
+ "name": "forme/work-order",
+ "registryDependencies": [
+ "@pdfcn/forme/utils",
+ "@pdfcn/forme/badge",
+ "@pdfcn/forme/key-value",
+ "@pdfcn/forme/page-footer",
+ "@pdfcn/forme/page-header",
+ "@pdfcn/forme/pdf-image",
+ "@pdfcn/forme/section",
+ "@pdfcn/forme/signature",
+ "@pdfcn/forme/table",
+ "@pdfcn/forme/text"
+ ],
+ "title": "Work Order",
+ "type": "registry:block"
}
],
"name": "pdfcn"
diff --git a/apps/web/registry.json b/apps/web/registry.json
index 6e47a94..e2997fa 100644
--- a/apps/web/registry.json
+++ b/apps/web/registry.json
@@ -2233,6 +2233,37 @@
],
"title": "Report Security",
"type": "registry:block"
+ },
+ {
+ "dependencies": ["@formepdf/react", "@formepdf/core"],
+ "description": "Work Order PDF block (forme)",
+ "files": [
+ {
+ "path": "registry/bases/forme/blocks/work-order/work-order.tsx",
+ "type": "registry:block",
+ "target": "components/pdf/blocks/work-order/work-order.tsx"
+ },
+ {
+ "path": "registry/bases/forme/blocks/work-order/work-order.types.ts",
+ "type": "registry:block",
+ "target": "components/pdf/blocks/work-order/work-order.types.ts"
+ }
+ ],
+ "name": "forme/work-order",
+ "registryDependencies": [
+ "@pdfcn/forme/utils",
+ "@pdfcn/forme/badge",
+ "@pdfcn/forme/key-value",
+ "@pdfcn/forme/page-footer",
+ "@pdfcn/forme/page-header",
+ "@pdfcn/forme/pdf-image",
+ "@pdfcn/forme/section",
+ "@pdfcn/forme/signature",
+ "@pdfcn/forme/table",
+ "@pdfcn/forme/text"
+ ],
+ "title": "Work Order",
+ "type": "registry:block"
}
],
"name": "pdfcn"
diff --git a/apps/web/registry/bases/forme/blocks/work-order/work-order.tsx b/apps/web/registry/bases/forme/blocks/work-order/work-order.tsx
new file mode 100644
index 0000000..a74f6ec
--- /dev/null
+++ b/apps/web/registry/bases/forme/blocks/work-order/work-order.tsx
@@ -0,0 +1,448 @@
+import { Document, Page, StyleSheet, View } from "@formepdf/react";
+
+import { Badge } from "@/registry/bases/forme/components/badge/badge";
+import type { BadgeVariant } from "@/registry/bases/forme/components/badge/badge";
+import { KeyValue } from "@/registry/bases/forme/components/key-value/key-value";
+import { PageFooter } from "@/registry/bases/forme/components/page-footer/page-footer";
+import { PageHeader } from "@/registry/bases/forme/components/page-header/page-header";
+import { PdfImage } from "@/registry/bases/forme/components/pdf-image/pdf-image";
+import { Section } from "@/registry/bases/forme/components/section/section";
+import { PdfSignatureBlock } from "@/registry/bases/forme/components/signature/signature";
+import {
+ Table,
+ TableBody,
+ TableCell,
+ TableHeader,
+ TableRow,
+} from "@/registry/bases/forme/components/table/table";
+import { Text } from "@/registry/bases/forme/components/text/text";
+import {
+ PdfcnThemeProvider,
+ usePdfcnTheme,
+} from "@/registry/bases/forme/components/theme-provider";
+import type { PdfcnTheme } from "@/registry/types/pdf-themes";
+
+import type { WorkOrderData, WorkOrderPriority } from "./work-order.types";
+
+// Sample data — replace with your own props or data source
+const sampleData: WorkOrderData = {
+ accentColor: "#ea580c",
+ companyName: "FixIt Pro Services",
+ customer: {
+ accountNumber: "ACC-10234",
+ address: "789 Elm St, Austin, TX 78701",
+ name: "Riverside Apartments",
+ phone: "(512) 555-0199",
+ },
+ customerNotes: "Please service before end of month lease inspection.",
+ date: "September 10, 2026",
+ equipment: {
+ description: "Commercial Dishwasher",
+ location: "Kitchen — Unit 4B",
+ makeModel: "Bosch SHP878ZD5N",
+ serialNumber: "BSH-2024-88712",
+ },
+ jobType: "Repair",
+ labor: [
+ {
+ description: "Diagnosis and repair",
+ hours: 2.5,
+ rate: 95,
+ technician: "Mike Torres",
+ },
+ ],
+ parts: [
+ {
+ description: "Drain Pump Assembly",
+ partNumber: "PUMP-001",
+ qty: 1,
+ unitPrice: 89.99,
+ },
+ {
+ description: "Drain Hose Kit",
+ partNumber: "HOSE-012",
+ qty: 1,
+ unitPrice: 24.5,
+ },
+ ],
+ priority: "High",
+ taxRate: 0.0825,
+ technician: "Mike Torres",
+ technicianNotes:
+ "Found clogged drain pump. Replaced pump and hose. Unit tested OK.",
+ warrantyInfo: "90-day warranty on parts and labor.",
+ workOrderNumber: "WO-2026-0452",
+};
+
+const PRIORITY_BADGE_VARIANT: Record<WorkOrderPriority, BadgeVariant> = {
+ High: "warning",
+ Low: "default",
+ Medium: "info",
+ Urgent: "destructive",
+};
+
+const WorkOrderContent = ({ data }: { data: WorkOrderData }) => {
+ const theme = usePdfcnTheme();
+
+ const styles = StyleSheet.create({
+ checkbox: {
+ borderColor: theme.colors.foreground,
+ borderStyle: "solid",
+ borderWidth: 1,
+ height: 10,
+ width: 10,
+ },
+ checkboxRow: {
+ alignItems: "center",
+ flexDirection: "row",
+ gap: 6,
+ marginTop: theme.spacing.componentGap,
+ },
+ col: {
+ flex: 1,
+ paddingRight: 15,
+ },
+ label: {
+ fontSize: 9,
+ fontWeight: "bold",
+ marginBottom: 2,
+ },
+ page: {
+ backgroundColor: theme.colors.background,
+ },
+ row: {
+ flexDirection: "row",
+ },
+ section: {
+ marginBottom: theme.spacing.componentGap,
+ },
+ sectionSpaced: {
+ marginBottom: theme.spacing.componentGap,
+ marginTop: theme.spacing.componentGap,
+ },
+ signature: {
+ marginBottom: 0,
+ marginTop: 0,
+ },
+ });
+
+ const partsTotal = data.parts.reduce(
+ (sum, part) => sum + part.qty * part.unitPrice,
+ 0
+ );
+ const laborTotal = data.labor.reduce(
+ (sum, item) => sum + item.hours * item.rate,
+ 0
+ );
+ const taxRate = data.taxRate ?? 0;
+ const tax = (partsTotal + laborTotal) * taxRate;
+ const grandTotal = partsTotal + laborTotal + tax;
+
+ return (
+ <Document title={`Work Order ${data.workOrderNumber}`}>
+ <Page
+ margin={{
+ bottom: theme.spacing.page.marginBottom,
+ left: theme.spacing.page.marginLeft,
+ right: theme.spacing.page.marginRight,
+ top: theme.spacing.page.marginTop,
+ }}
+ size="A4"
+ >
+ <PageFooter
+ leftText={data.warrantyInfo}
+ rightText="Page 1 of 1"
+ sticky
+ pagePadding={25}
+ />
+ <View style={styles.page as never}>
+ <PageHeader
+ variant="logo-left"
+ logo={
+ data.companyLogo ? (
+ <PdfImage src={data.companyLogo} style={{ margin: 0 }} />
+ ) : undefined
+ }
+ title={data.companyName}
+ subtitle="Work Order"
+ rightText={`WO #${data.workOrderNumber}`}
+ rightSubText={`Date: ${data.date}`}
+ style={styles.section}
+ />
+
+ <Section
+ noWrap
+ spacing="none"
+ style={{
+ ...styles.row,
+ ...styles.section,
+ alignItems: "center",
+ justifyContent: "space-between",
+ }}
+ >
+ <View
+ style={{ alignItems: "center", flexDirection: "row", gap: 8 }}
+ >
+ <Text
+ style={{ fontSize: 9, fontWeight: "bold" }}
+ color="mutedForeground"
+ transform="uppercase"
+ noMargin
+ >
+ Priority
+ </Text>
+ <Badge
+ label={data.priority}
+ variant={PRIORITY_BADGE_VARIANT[data.priority]}
+ size="sm"
+ />
+ </View>
+ <Badge label={data.jobType} variant="outline" size="sm" />
+ </Section>
+
+ <Section
+ noWrap
+ spacing="none"
+ style={{ ...styles.row, ...styles.section }}
+ >
+ <View style={styles.col}>
+ <Text
+ style={styles.label}
+ color="mutedForeground"
+ transform="uppercase"
+ noMargin
+ >
+ Customer
+ </Text>
+ <Text noMargin variant="xs">
+ {data.customer.name}
+ </Text>
+ <Text noMargin variant="xs">
+ {data.customer.address}
+ </Text>
+ <Text noMargin variant="xs">
+ {data.customer.phone}
+ </Text>
+ {data.customer.email ? (
+ <Text noMargin variant="xs">
+ {data.customer.email}
+ </Text>
+ ) : null}
+ {data.customer.accountNumber ? (
+ <Text noMargin variant="xs">
+ {`Acct #: ${data.customer.accountNumber}`}
+ </Text>
+ ) : null}
+ </View>
+ <View style={styles.col}>
+ <Text
+ style={styles.label}
+ color="mutedForeground"
+ transform="uppercase"
+ noMargin
+ >
+ Job Info
+ </Text>
+ <Text noMargin variant="xs">
+ {`Technician: ${data.technician}`}
+ </Text>
+ <Text noMargin variant="xs">
+ {`Job Type: ${data.jobType}`}
+ </Text>
+ </View>
+ <View style={styles.col}>
+ <Text
+ style={styles.label}
+ color="mutedForeground"
+ transform="uppercase"
+ noMargin
+ >
+ Equipment
+ </Text>
+ <Text noMargin variant="xs">
+ {data.equipment.description}
+ </Text>
+ {data.equipment.makeModel ? (
+ <Text noMargin variant="xs">
+ {data.equipment.makeModel}
+ </Text>
+ ) : null}
+ {data.equipment.serialNumber ? (
+ <Text noMargin variant="xs">
+ {`S/N: ${data.equipment.serialNumber}`}
+ </Text>
+ ) : null}
+ {data.equipment.location ? (
+ <Text noMargin variant="xs">
+ {`Location: ${data.equipment.location}`}
+ </Text>
+ ) : null}
+ </View>
+ </Section>
+
+ <Section spacing="none">
+ <Text
+ style={styles.label}
+ color="mutedForeground"
+ transform="uppercase"
+ noMargin
+ >
+ Parts Used
+ </Text>
+ <Table variant="grid" zebraStripe>
+ <TableHeader>
+ <TableRow header>
+ <TableCell>Part #</TableCell>
+ <TableCell>Description</TableCell>
+ <TableCell align="center">Qty</TableCell>
+ <TableCell align="right">Unit Price</TableCell>
+ <TableCell align="right">Total</TableCell>
+ </TableRow>
+ </TableHeader>
+ <TableBody>
+ {data.parts.map((part, index) => (
+ // biome-ignore lint/suspicious/noArrayIndexKey: parts have no stable id
+ <TableRow key={index}>
+ <TableCell>{part.partNumber}</TableCell>
+ <TableCell>{part.description}</TableCell>
+ <TableCell align="center">{`${part.qty}`}</TableCell>
+ <TableCell align="right">{`$${part.unitPrice.toFixed(2)}`}</TableCell>
+ <TableCell align="right">{`$${(part.qty * part.unitPrice).toFixed(2)}`}</TableCell>
+ </TableRow>
+ ))}
+ </TableBody>
+ </Table>
+ </Section>
+
+ <Section spacing="none">
+ <Text
+ style={styles.label}
+ color="mutedForeground"
+ transform="uppercase"
+ noMargin
+ >
+ Labor
+ </Text>
+ <Table variant="grid" zebraStripe>
+ <TableHeader>
+ <TableRow header>
+ <TableCell>Description</TableCell>
+ <TableCell>Technician</TableCell>
+ <TableCell align="center">Hours</TableCell>
+ <TableCell align="right">Rate</TableCell>
+ <TableCell align="right">Total</TableCell>
+ </TableRow>
+ </TableHeader>
+ <TableBody>
+ {data.labor.map((item, index) => (
+ // biome-ignore lint/suspicious/noArrayIndexKey: labor entries have no stable id
+ <TableRow key={index}>
+ <TableCell>{item.description}</TableCell>
+ <TableCell>{item.technician}</TableCell>
+ <TableCell align="center">{`${item.hours}`}</TableCell>
+ <TableCell align="right">{`$${item.rate.toFixed(2)}`}</TableCell>
+ <TableCell align="right">{`$${(item.hours * item.rate).toFixed(2)}`}</TableCell>
+ </TableRow>
+ ))}
+ </TableBody>
+ </Table>
+ </Section>
+
+ <Section
+ noWrap
+ spacing="none"
+ style={{ ...styles.row, ...styles.section }}
+ >
+ <View style={{ flex: 1, paddingRight: 15 }}>
+ {data.technicianNotes ? (
+ <View>
+ <Text
+ style={styles.label}
+ color="mutedForeground"
+ transform="uppercase"
+ noMargin
+ >
+ Technician Notes
+ </Text>
+ <Text noMargin variant="xs">
+ {data.technicianNotes}
+ </Text>
+ </View>
+ ) : null}
+ </View>
+ <View style={{ marginLeft: "auto", width: 200 }}>
+ <KeyValue
+ size="sm"
+ dividerThickness={1}
+ items={[
+ { key: "Parts Total", value: `$${partsTotal.toFixed(2)}` },
+ { key: "Labor Total", value: `$${laborTotal.toFixed(2)}` },
+ {
+ key: `Tax (${(taxRate * 100).toFixed(2)}%)`,
+ value: `$${tax.toFixed(2)}`,
+ },
+ {
+ key: "Grand Total",
+ keyStyle: { fontSize: 12, fontWeight: "bold" },
+ value: `$${grandTotal.toFixed(2)}`,
+ valueStyle: { fontSize: 12, fontWeight: "bold" },
+ },
+ ]}
+ divided
+ />
+ </View>
+ </Section>
+
+ {data.customerNotes ? (
+ <Section spacing="none" style={styles.sectionSpaced}>
+ <Text
+ style={styles.label}
+ color="mutedForeground"
+ transform="uppercase"
+ noMargin
+ >
+ Customer Notes
+ </Text>
+ <Text noMargin variant="xs">
+ {data.customerNotes}
+ </Text>
+ </Section>
+ ) : null}
+
+ <Section spacing="none">
+ <PdfSignatureBlock
+ variant="double"
+ signers={[
+ { date: data.date, label: "Customer Signature" },
+ {
+ date: data.date,
+ label: "Technician Signature",
+ name: data.technician,
+ },
+ ]}
+ style={styles.signature}
+ />
+ <View style={styles.checkboxRow}>
+ <View style={styles.checkbox} />
+ <Text noMargin variant="xs">
+ Customer approves work performed and charges above
+ </Text>
+ </View>
+ </Section>
+ </View>
+ </Page>
+ </Document>
+ );
+};
+
+export const WorkOrderDocument = ({
+ theme,
+ data = sampleData,
+}: {
+ theme?: PdfcnTheme;
+ data?: WorkOrderData;
+}) => (
+ <PdfcnThemeProvider theme={theme}>
+ <WorkOrderContent data={data} />
+ </PdfcnThemeProvider>
+);
diff --git a/apps/web/registry/bases/forme/blocks/work-order/work-order.types.ts b/apps/web/registry/bases/forme/blocks/work-order/work-order.types.ts
new file mode 100644
index 0000000..8561ac2
--- /dev/null
+++ b/apps/web/registry/bases/forme/blocks/work-order/work-order.types.ts
@@ -0,0 +1,57 @@
+export type WorkOrderPriority = "Low" | "Medium" | "High" | "Urgent";
+
+export interface WorkOrderCustomer {
+ name: string;
+ address: string;
+ phone: string;
+ email?: string;
+ accountNumber?: string;
+}
+
+export type WorkOrderJobType =
+ | "Repair"
+ | "Installation"
+ | "Maintenance"
+ | "Inspection"
+ | string;
+
+export interface WorkOrderEquipment {
+ description: string;
+ makeModel?: string;
+ serialNumber?: string;
+ location?: string;
+}
+
+export interface WorkOrderPart {
+ partNumber: string;
+ description: string;
+ qty: number;
+ unitPrice: number;
+}
+
+export interface WorkOrderLabor {
+ description: string;
+ technician: string;
+ hours: number;
+ rate: number;
+}
+
+export interface WorkOrderData {
+ companyName: string;
+ companyLogo?: string;
+ workOrderNumber: string;
+ date: string;
+ priority: WorkOrderPriority;
+ customer: WorkOrderCustomer;
+ technician: string;
+ jobType: WorkOrderJobType;
+ equipment: WorkOrderEquipment;
+ parts: WorkOrderPart[];
+ labor: WorkOrderLabor[];
+ taxRate?: number;
+ technicianNotes?: string;
+ customerNotes?: string;
+ warrantyInfo?: string;
+ accentColor?: string;
+ renderingBase?: "takumi" | "forme";
+}