pdfn 0.4.6 → 0.6.0

package/README.md

@@ -1,14 +1,6 @@
 # pdfn
 
-CLI and PDF server for pdfn. Dev server with live preview, production server for PDF generation.
-
-> Requires headless Chromium. For serverless, use [@sparticuz/chromium](https://github.com/Sparticuz/chromium) or a hosted browser service.
-
-## See It in Action
-
-**[pdfn.dev](https://pdfn.dev/#preview)** — Interactive preview with example templates.
-
-Or run locally: `npx pdfn dev --open`
+CLI for pdfn. Dev server with live preview and template scaffolding.
 
 ## Installation
 
@@ -20,108 +12,77 @@ npm install -D pdfn
 
 ### `pdfn dev`
 
-Development server with live preview and hot reload. Intended for local development and template iteration only.
+Development server with live preview and hot reload.
 
 ```bash
-npx pdfn dev                    # Start on port 3456
-npx pdfn dev --open             # Start and open browser
-npx pdfn dev --port 4000        # Custom port
+npx pdfn dev           # Start on port 3456
+npx pdfn dev --open    # Start and open browser
 ```
 
 | Option | Default | Description |
 |--------|---------|-------------|
 | `--port` | `3456` | Server port |
-| `--open` | `false` | Open browser automatically |
-
-Templates are loaded from `./pdfn-templates` by convention.
+| `--templates` | `./pdfn-templates` | Templates directory |
+| `--open` | `false` | Open browser on start |
+| `--no-open` | - | Don't open browser |
 
-Features:
-- Auto-discovers templates in your templates directory
-- Live preview UI with hot reload
-- Performance metrics and debug overlays
-- Exposes a local `/generate` endpoint for PDF generation
-
-### `pdfn serve`
+### `pdfn add`
 
-Production server (headless, no UI). Intended for production use behind an API or worker.
+Add starter templates to your project.
 
 ```bash
-npx pdfn serve                          # Start server
-npx pdfn serve --port 3456              # Custom port
-npx pdfn serve --max-concurrent 10      # Concurrency limit
+npx pdfn add invoice            # Add invoice template
+npx pdfn add invoice --tailwind # With Tailwind classes
+npx pdfn add --list             # Show all templates
 ```
 
-| Option | Env Variable | Default | Description |
-|--------|--------------|---------|-------------|
-| `--port` | `PDFN_PORT` | `3456` | Server port |
-| `--max-concurrent` | `PDFN_MAX_CONCURRENT` | `5` | Max concurrent PDF generations |
-| `--timeout` | `PDFN_TIMEOUT` | `30000` | Request timeout in ms |
+| Template | Description |
+|----------|-------------|
+| `invoice` | Professional invoice with itemized billing |
+| `letter` | US business correspondence |
+| `contract` | Legal service agreement |
+| `ticket` | Event admission ticket |
+| `poster` | Event poster (landscape) |
+| `report` | Sales report with charts (requires recharts) |
 
-### `pdfn add`
+## Production PDFs
 
-Add starter templates to your project.
+For production PDF generation, choose based on your infrastructure:
 
-```bash
-npx pdfn add invoice            # Add invoice template (inline styles)
-npx pdfn add invoice --tailwind # Add with Tailwind classes
-npx pdfn add letter             # Add business letter
-npx pdfn add contract           # Add contract template
-npx pdfn add ticket             # Add event ticket
-npx pdfn add poster             # Add poster template
-npx pdfn add --list             # Show all templates
-```
+**Option 1: Self-host with Puppeteer/Playwright**
 
-| Option | Default | Description |
-|--------|---------|-------------|
-| `--inline` | ✓ | Use inline styles (default, no extra dependencies) |
-| `--tailwind` | | Use Tailwind CSS classes (requires `@pdfn/tailwind`) |
-| `--force` | | Overwrite existing files |
+Use `render()` to get print-ready HTML, then convert with your own browser:
 
-| Template | Description | Page Size |
-|----------|-------------|-----------|
-| `invoice` | Professional invoice with itemized billing | A4 |
-| `letter` | US business correspondence | Letter |
-| `contract` | Legal service agreement | Legal |
-| `ticket` | Event admission ticket | A5 |
-| `poster` | Event poster (landscape) | Tabloid |
+```tsx
+import { render } from '@pdfn/react';
+import puppeteer from 'puppeteer';
 
-## Server API
+const html = await render(<Invoice />);
 
-```bash
-# Generate PDF from HTML
-POST /generate
-Content-Type: application/json
-{ "html": "<html>...</html>" }
-# HTML must be print-ready and fully self-contained (fonts/images embedded)
-# Returns: application/pdf
-
-# Health check
-GET /health
-# Returns: { "status": "ok", "browser": "connected", ... }
+const browser = await puppeteer.launch();
+const page = await browser.newPage();
+await page.setContent(html, { waitUntil: 'networkidle0' });
+await page.waitForFunction(() => window.PDFN?.ready === true);
+const pdf = await page.pdf({ preferCSSPageSize: true, printBackground: true });
+await browser.close();
 ```
 
-## Embedding in Your Server
+Works with Puppeteer, Playwright, Browserless, @sparticuz/chromium, or any Chromium setup.
+
+**Option 2: pdfn Cloud**
 
-```ts
-import { createServer } from 'pdfn/server';
+Let pdfn manage the browser infrastructure:
 
-const server = createServer({
-  port: 3456,
-  maxConcurrent: 10,
-  timeout: 30000
-});
+```tsx
+import { generate } from '@pdfn/react';
 
-await server.start();
+// Set PDFN_API_KEY environment variable
+const pdf = await generate(<Invoice />);
 ```
 
-## Environment Variables
+Get your API key at [console.pdfn.dev](https://console.pdfn.dev).
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `PDFN_PORT` | `3456` | Server port |
-| `PDFN_MAX_CONCURRENT` | `5` | Max concurrent PDF generations |
-| `PDFN_TIMEOUT` | `30000` | Request timeout in ms |
-| `DEBUG` | - | Set to `pdfn:cli` or `pdfn:*` to enable logging |
+**Both produce identical PDFs** — same templates, same output.
 
 ## License