pdf-smith 0.1.0 → 0.2.0

package/dist/server.d.ts

@@ -3,7 +3,6 @@ interface PreviewOptions {
     root: string;
     /** Dev server port (default: 3000) */
     port?: number;
-    pages?: string;
     /** Auto-open browser (default: false) */
     open?: boolean;
 }
@@ -15,15 +14,14 @@ interface PreviewServer {
 
 interface ExportOptions {
     root: string;
+    document?: string;
     output?: string;
-    pageNumbers?: {
-        enabled: boolean;
-        template?: string;
-    };
-    pages?: string;
 }
 interface ExportResult {
-    outputPath: string;
+    outputs: Array<{
+        document: string;
+        outputPath: string;
+    }>;
 }
 
 declare function exportPDF(options: ExportOptions): Promise<ExportResult>;

package/dist/server.js

@@ -5,10 +5,39 @@ import { fileURLToPath } from "url";
 // src/export.ts
 import fs from "fs";
 import path from "path";
+function discoverDocuments(root) {
+  const pdfsDir = path.join(root, "pdfs");
+  if (!fs.existsSync(pdfsDir)) return [];
+  const entries = fs.readdirSync(pdfsDir, { withFileTypes: true });
+  const documents = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const pagesDir = path.join(pdfsDir, entry.name, "pages");
+    if (!fs.existsSync(pagesDir)) continue;
+    const configPath = path.join(pdfsDir, entry.name, "config.ts");
+    documents.push({
+      slug: entry.name,
+      configPath: fs.existsSync(configPath) ? configPath : null
+    });
+  }
+  return documents;
+}
 async function exportPDF(options) {
-  const { root, output, pageNumbers, pages } = options;
-  const outputPath = path.resolve(root, output ?? "./output.pdf");
-  fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+  const { root, document: documentSlug, output } = options;
+  const outputDir = path.resolve(root, output ?? "output");
+  let documents = discoverDocuments(root);
+  if (documentSlug) {
+    documents = documents.filter((d) => d.slug === documentSlug);
+    if (documents.length === 0) {
+      throw new Error(
+        `Document "${documentSlug}" not found. Check that pdfs/${documentSlug}/pages/ exists.`
+      );
+    }
+  }
+  if (documents.length === 0) {
+    throw new Error("No documents found. Create at least one document in pdfs/<name>/pages/.");
+  }
+  fs.mkdirSync(outputDir, { recursive: true });
   let playwright;
   try {
     playwright = await import("playwright");
@@ -18,42 +47,58 @@ async function exportPDF(options) {
     );
   }
   const { startPreview: startPreview2 } = await import("./server.js");
-  const server = await startPreview2({ root, port: 0, pages, open: false });
+  const server = await startPreview2({ root, port: 0, open: false });
+  const vite = server._vite;
   const browser = await playwright.chromium.launch({ headless: true });
+  const outputs = [];
   try {
-    const page = await browser.newPage();
-    await page.goto(server.url, { waitUntil: "networkidle" });
-    await page.waitForSelector("[data-pdf-smith-page]", { timeout: 3e4 });
-    const margin = { top: "0", bottom: "0", left: "0", right: "0" };
-    const pdfOptions = {
-      path: outputPath,
-      preferCSSPageSize: true,
-      printBackground: true,
-      margin
-    };
-    if (pageNumbers?.enabled) {
-      pdfOptions.displayHeaderFooter = true;
-      pdfOptions.headerTemplate = "<span></span>";
-      pdfOptions.footerTemplate = pageNumbers.template ?? '<div style="font-size:10px;text-align:center;width:100%;"><span class="pageNumber"></span> / <span class="totalPages"></span></div>';
-      margin.bottom = "40px";
+    for (const doc of documents) {
+      let config;
+      if (doc.configPath && vite) {
+        try {
+          const configModule = await vite.ssrLoadModule(doc.configPath);
+          config = configModule.default;
+        } catch {
+        }
+      }
+      const filename = config?.output ?? `${doc.slug}.pdf`;
+      const outputPath = path.resolve(outputDir, filename);
+      const page = await browser.newPage();
+      await page.goto(`${server.url}/${doc.slug}`, { waitUntil: "networkidle" });
+      await page.waitForSelector("[data-pdf-smith-page]", { timeout: 3e4 });
+      const margin = { top: "0", bottom: "0", left: "0", right: "0" };
+      const pdfOptions = {
+        path: outputPath,
+        preferCSSPageSize: true,
+        printBackground: true,
+        margin
+      };
+      if (config?.pageNumbers?.enabled) {
+        pdfOptions.displayHeaderFooter = true;
+        pdfOptions.headerTemplate = "<span></span>";
+        pdfOptions.footerTemplate = config.pageNumbers.template ?? '<div style="font-size:10px;text-align:center;width:100%;"><span class="pageNumber"></span> / <span class="totalPages"></span></div>';
+        margin.bottom = "40px";
+      }
+      await page.pdf(pdfOptions);
+      await page.close();
+      outputs.push({ document: doc.slug, outputPath });
     }
-    await page.pdf(pdfOptions);
   } finally {
     await browser.close().catch(() => {
     });
     await server.close().catch(() => {
     });
   }
-  return { outputPath };
+  return { outputs };
 }
 
 // src/server.ts
 async function startPreview(options) {
-  const { root, port = 3e3, pages = "/pages/**/*.tsx", open = false } = options;
+  const { root, port = 3e3, open = false } = options;
   const { createServer } = await import("vite");
   const react = (await import("@vitejs/plugin-react")).default;
   const tailwindcss = (await import("@tailwindcss/vite")).default;
-  const { pdfSmithPreviewPlugin } = await import("./preview-plugin-QWJEXDW2.js");
+  const { pdfSmithPreviewPlugin } = await import("./preview-plugin-QDLEMAEE.js");
   const currentDir = path2.dirname(fileURLToPath(import.meta.url));
   const pkgRoot = path2.resolve(currentDir, "..");
   const pkgSrcDir = path2.resolve(pkgRoot, "src");
@@ -75,7 +120,7 @@ async function startPreview(options) {
       },
       dedupe: ["react", "react-dom"]
     },
-    plugins: [react(), tailwindcss(), pdfSmithPreviewPlugin({ pkgSrcDir, pagesGlob: pages })],
+    plugins: [react(), tailwindcss(), pdfSmithPreviewPlugin({ pkgSrcDir })],
     optimizeDeps: {
       include: ["react", "react-dom", "react-dom/client", "react/jsx-runtime"]
     }
@@ -87,7 +132,7 @@ async function startPreview(options) {
   const address = server.httpServer?.address();
   const resolvedPort = address?.port ?? port;
   const url = `http://localhost:${resolvedPort}`;
-  return {
+  const previewServer = {
     close: async () => {
       const httpServer = server.httpServer;
       httpServer?.closeAllConnections?.();
@@ -96,6 +141,11 @@ async function startPreview(options) {
     port: resolvedPort,
     url
   };
+  Object.defineProperty(previewServer, "_vite", {
+    value: server,
+    enumerable: false
+  });
+  return previewServer;
 }
 export {
   exportPDF,

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts","../src/export.ts"],"sourcesContent":["import type { AddressInfo } from 'node:net';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { PreviewOptions, PreviewServer } from './preview/types';\n\nexport { exportPDF } from './export';\nexport type { ExportOptions, ExportResult } from './export-types';\nexport type { PreviewOptions, PreviewServer } from './preview/types';\n\nexport async function startPreview(options: PreviewOptions): Promise<PreviewServer> {\n  const { root, port = 3000, pages = '/pages/**/*.tsx', open = false } = options;\n\n  const { createServer } = await import('vite');\n  const react = (await import('@vitejs/plugin-react')).default;\n  const tailwindcss = (await import('@tailwindcss/vite')).default;\n  const { pdfSmithPreviewPlugin } = await import('./preview/preview-plugin');\n\n  const currentDir = path.dirname(fileURLToPath(import.meta.url));\n  const pkgRoot = path.resolve(currentDir, '..');\n  const pkgSrcDir = path.resolve(pkgRoot, 'src');\n\n  const server = await createServer({\n    configFile: false,\n    appType: 'custom',\n    root,\n    server: {\n      port,\n      strictPort: port !== 0,\n      open,\n      fs: {\n        allow: [root, pkgSrcDir, pkgRoot],\n      },\n    },\n    resolve: {\n      alias: {\n        'pdf-smith': path.resolve(pkgSrcDir, 'index.ts'),\n      },\n      dedupe: ['react', 'react-dom'],\n    },\n    plugins: [react(), tailwindcss(), pdfSmithPreviewPlugin({ pkgSrcDir, pagesGlob: pages })],\n    optimizeDeps: {\n      include: ['react', 'react-dom', 'react-dom/client', 'react/jsx-runtime'],\n    },\n  });\n\n  await server.listen();\n\n  if (port !== 0) {\n    server.printUrls();\n  }\n\n  const address = server.httpServer?.address() as AddressInfo | null;\n  const resolvedPort = address?.port ?? port;\n  const url = `http://localhost:${resolvedPort}`;\n\n  return {\n    close: async () => {\n      const httpServer = server.httpServer as { closeAllConnections?: () => void } | null;\n      httpServer?.closeAllConnections?.();\n      await server.close();\n    },\n    port: resolvedPort,\n    url,\n  };\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { ExportOptions, ExportResult } from './export-types';\n\nexport async function exportPDF(options: ExportOptions): Promise<ExportResult> {\n  const { root, output, pageNumbers, pages } = options;\n  const outputPath = path.resolve(root, output ?? './output.pdf');\n\n  fs.mkdirSync(path.dirname(outputPath), { recursive: true });\n\n  let playwright: typeof import('playwright');\n  try {\n    playwright = await import('playwright');\n  } catch {\n    throw new Error(\n      'Playwright is required for PDF export. Install it with: npm install -D playwright && npx playwright install chromium',\n    );\n  }\n\n  const { startPreview } = await import('./server');\n  const server = await startPreview({ root, port: 0, pages, open: false });\n\n  const browser = await playwright.chromium.launch({ headless: true });\n  try {\n    const page = await browser.newPage();\n    await page.goto(server.url, { waitUntil: 'networkidle' });\n    await page.waitForSelector('[data-pdf-smith-page]', { timeout: 30_000 });\n\n    const margin = { top: '0', bottom: '0', left: '0', right: '0' };\n\n    const pdfOptions: Parameters<typeof page.pdf>[0] = {\n      path: outputPath,\n      preferCSSPageSize: true,\n      printBackground: true,\n      margin,\n    };\n\n    if (pageNumbers?.enabled) {\n      pdfOptions.displayHeaderFooter = true;\n      pdfOptions.headerTemplate = '<span></span>';\n      pdfOptions.footerTemplate =\n        pageNumbers.template ??\n        '<div style=\"font-size:10px;text-align:center;width:100%;\"><span class=\"pageNumber\"></span> / <span class=\"totalPages\"></span></div>';\n      margin.bottom = '40px';\n    }\n\n    await page.pdf(pdfOptions);\n  } finally {\n    await browser.close().catch(() => {});\n    await server.close().catch(() => {});\n  }\n\n  return { outputPath };\n}\n"],"mappings":"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","names":["path","startPreview","path"]}
+{"version":3,"sources":["../src/server.ts","../src/export.ts"],"sourcesContent":["import type { AddressInfo } from 'node:net';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { PreviewOptions, PreviewServer } from './preview/types';\n\nexport { exportPDF } from './export';\nexport type { ExportOptions, ExportResult } from './export-types';\nexport type { PreviewOptions, PreviewServer } from './preview/types';\n\nexport async function startPreview(options: PreviewOptions): Promise<PreviewServer> {\n  const { root, port = 3000, open = false } = options;\n\n  const { createServer } = await import('vite');\n  const react = (await import('@vitejs/plugin-react')).default;\n  const tailwindcss = (await import('@tailwindcss/vite')).default;\n  const { pdfSmithPreviewPlugin } = await import('./preview/preview-plugin');\n\n  const currentDir = path.dirname(fileURLToPath(import.meta.url));\n  const pkgRoot = path.resolve(currentDir, '..');\n  const pkgSrcDir = path.resolve(pkgRoot, 'src');\n\n  const server = await createServer({\n    configFile: false,\n    appType: 'custom',\n    root,\n    server: {\n      port,\n      strictPort: port !== 0,\n      open,\n      fs: {\n        allow: [root, pkgSrcDir, pkgRoot],\n      },\n    },\n    resolve: {\n      alias: {\n        'pdf-smith': path.resolve(pkgSrcDir, 'index.ts'),\n      },\n      dedupe: ['react', 'react-dom'],\n    },\n    plugins: [react(), tailwindcss(), pdfSmithPreviewPlugin({ pkgSrcDir })],\n    optimizeDeps: {\n      include: ['react', 'react-dom', 'react-dom/client', 'react/jsx-runtime'],\n    },\n  });\n\n  await server.listen();\n\n  if (port !== 0) {\n    server.printUrls();\n  }\n\n  const address = server.httpServer?.address() as AddressInfo | null;\n  const resolvedPort = address?.port ?? port;\n  const url = `http://localhost:${resolvedPort}`;\n\n  const previewServer: PreviewServer = {\n    close: async () => {\n      const httpServer = server.httpServer as { closeAllConnections?: () => void } | null;\n      httpServer?.closeAllConnections?.();\n      await server.close();\n    },\n    port: resolvedPort,\n    url,\n  };\n\n  Object.defineProperty(previewServer, '_vite', {\n    value: server,\n    enumerable: false,\n  });\n\n  return previewServer;\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { DocumentConfig } from './config';\nimport type { ExportOptions, ExportResult } from './export-types';\n\ninterface DiscoveredDocument {\n  slug: string;\n  configPath: string | null;\n}\n\nfunction discoverDocuments(root: string): DiscoveredDocument[] {\n  const pdfsDir = path.join(root, 'pdfs');\n  if (!fs.existsSync(pdfsDir)) return [];\n\n  const entries = fs.readdirSync(pdfsDir, { withFileTypes: true });\n  const documents: DiscoveredDocument[] = [];\n\n  for (const entry of entries) {\n    if (!entry.isDirectory()) continue;\n    const pagesDir = path.join(pdfsDir, entry.name, 'pages');\n    if (!fs.existsSync(pagesDir)) continue;\n\n    const configPath = path.join(pdfsDir, entry.name, 'config.ts');\n    documents.push({\n      slug: entry.name,\n      configPath: fs.existsSync(configPath) ? configPath : null,\n    });\n  }\n\n  return documents;\n}\n\nexport async function exportPDF(options: ExportOptions): Promise<ExportResult> {\n  const { root, document: documentSlug, output } = options;\n  const outputDir = path.resolve(root, output ?? 'output');\n\n  let documents = discoverDocuments(root);\n\n  if (documentSlug) {\n    documents = documents.filter((d) => d.slug === documentSlug);\n    if (documents.length === 0) {\n      throw new Error(\n        `Document \"${documentSlug}\" not found. Check that pdfs/${documentSlug}/pages/ exists.`,\n      );\n    }\n  }\n\n  if (documents.length === 0) {\n    throw new Error('No documents found. Create at least one document in pdfs/<name>/pages/.');\n  }\n\n  fs.mkdirSync(outputDir, { recursive: true });\n\n  let playwright: typeof import('playwright');\n  try {\n    playwright = await import('playwright');\n  } catch {\n    throw new Error(\n      'Playwright is required for PDF export. Install it with: npm install -D playwright && npx playwright install chromium',\n    );\n  }\n\n  const { startPreview } = await import('./server');\n  const server = await startPreview({ root, port: 0, open: false });\n\n  const vite = (\n    server as unknown as {\n      _vite: { ssrLoadModule: (id: string) => Promise<{ default?: DocumentConfig }> };\n    }\n  )._vite;\n\n  const browser = await playwright.chromium.launch({ headless: true });\n  const outputs: ExportResult['outputs'] = [];\n\n  try {\n    for (const doc of documents) {\n      let config: DocumentConfig | undefined;\n      if (doc.configPath && vite) {\n        try {\n          const configModule = await vite.ssrLoadModule(doc.configPath);\n          config = configModule.default;\n        } catch {\n          // Config loading failed, proceed without it\n        }\n      }\n\n      const filename = config?.output ?? `${doc.slug}.pdf`;\n      const outputPath = path.resolve(outputDir, filename);\n\n      const page = await browser.newPage();\n      await page.goto(`${server.url}/${doc.slug}`, { waitUntil: 'networkidle' });\n      await page.waitForSelector('[data-pdf-smith-page]', { timeout: 30_000 });\n\n      const margin = { top: '0', bottom: '0', left: '0', right: '0' };\n\n      const pdfOptions: Parameters<typeof page.pdf>[0] = {\n        path: outputPath,\n        preferCSSPageSize: true,\n        printBackground: true,\n        margin,\n      };\n\n      if (config?.pageNumbers?.enabled) {\n        pdfOptions.displayHeaderFooter = true;\n        pdfOptions.headerTemplate = '<span></span>';\n        pdfOptions.footerTemplate =\n          config.pageNumbers.template ??\n          '<div style=\"font-size:10px;text-align:center;width:100%;\"><span class=\"pageNumber\"></span> / <span class=\"totalPages\"></span></div>';\n        margin.bottom = '40px';\n      }\n\n      await page.pdf(pdfOptions);\n      await page.close();\n\n      outputs.push({ document: doc.slug, outputPath });\n    }\n  } finally {\n    await browser.close().catch(() => {});\n    await server.close().catch(() => {});\n  }\n\n  return { outputs };\n}\n"],"mappings":"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","names":["path","startPreview","path"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-smith",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Build beautiful PDFs with React components and Tailwind CSS",
   "author": "Kareem Elbahrawy",
   "license": "MIT",
@@ -20,6 +20,9 @@
     "react-pdf"
   ],
   "type": "module",
+  "bin": {
+    "pdf-smith": "./dist/cli.js"
+  },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -47,13 +50,17 @@
   },
   "files": [
     "dist",
+    "README.md",
     "src/preview/",
     "src/index.ts",
     "src/page.tsx",
     "src/document.tsx",
     "src/types.ts",
     "src/constants.ts",
-    "src/styles.ts"
+    "src/styles.ts",
+    "src/config.ts",
+    "src/add.ts",
+    "src/cli.ts"
   ],
   "dependencies": {
     "vite": "^7.0.0",

package/src/add.ts

@@ -0,0 +1,72 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+const SLUG_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+
+export interface AddDocumentOptions {
+  slug: string;
+  root: string;
+}
+
+export interface AddDocumentResult {
+  paths: string[];
+}
+
+function toTitle(slug: string): string {
+  return slug
+    .split('-')
+    .map((w) => w[0].toUpperCase() + w.slice(1))
+    .join(' ');
+}
+
+export function addDocument({ slug, root }: AddDocumentOptions): AddDocumentResult {
+  if (!SLUG_REGEX.test(slug)) {
+    throw new Error(
+      `Invalid slug "${slug}". Use lowercase letters, numbers, and hyphens (e.g. "my-report").`,
+    );
+  }
+
+  const docDir = path.join(root, 'pdfs', slug);
+
+  if (fs.existsSync(docDir)) {
+    throw new Error(`Document "${slug}" already exists at ${docDir}`);
+  }
+
+  const pagesDir = path.join(docDir, 'pages');
+  fs.mkdirSync(pagesDir, { recursive: true });
+
+  const title = toTitle(slug);
+
+  const page1Content = `import '../../../styles.css';
+
+export default function Page1() {
+  return (
+    <div className="h-full flex flex-col items-center justify-center p-12 font-sans">
+      <h1 className="text-4xl font-bold tracking-tight text-gray-900">${title}</h1>
+      <p className="mt-4 text-gray-500">Start editing this page to build your document.</p>
+    </div>
+  );
+}
+`;
+
+  const configContent = `import { defineConfig } from 'pdf-smith';
+
+export default defineConfig({
+  pageNumbers: { enabled: false },
+});
+`;
+
+  const page1Path = path.join(pagesDir, 'Page1.tsx');
+  const configPath = path.join(docDir, 'config.ts');
+
+  fs.writeFileSync(page1Path, page1Content);
+  fs.writeFileSync(configPath, configContent);
+
+  return {
+    paths: [
+      path.relative(root, pagesDir),
+      path.relative(root, page1Path),
+      path.relative(root, configPath),
+    ],
+  };
+}

package/src/cli.ts

@@ -0,0 +1,24 @@
+import { addDocument } from './add';
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (command === 'add') {
+  const slug = args[1];
+
+  if (!slug || slug === '--help') {
+    console.log('Usage: pdf-smith add <slug>');
+    process.exit(slug ? 0 : 1);
+  }
+
+  try {
+    addDocument({ slug, root: process.cwd() });
+    console.log(`Created document '${slug}'. Start editing at pdfs/${slug}/pages/Page1.tsx`);
+  } catch (error) {
+    console.error((error as Error).message);
+    process.exit(1);
+  }
+} else {
+  console.log('Usage: pdf-smith add <slug>');
+  process.exit(command === '--help' || command === '-h' ? 0 : 1);
+}

package/src/config.ts

@@ -0,0 +1,8 @@
+export interface DocumentConfig {
+  pageNumbers?: { enabled: boolean; template?: string };
+  output?: string;
+}
+
+export function defineConfig(config: DocumentConfig): DocumentConfig {
+  return config;
+}

package/src/index.ts

@@ -1,3 +1,5 @@
+export type { DocumentConfig } from './config';
+export { defineConfig } from './config';
 export { DEFAULT_PADDING, DEFAULT_PAGE_SIZE, PAGE_SIZES } from './constants';
 export { Document } from './document';
 export { Page } from './page';

package/src/preview/app.tsx

@@ -1,4 +1,4 @@
-import { getPages } from 'virtual:pdf-smith-pages';
+import { getDocuments } from 'virtual:pdf-smith-documents';
 import { useState } from 'react';
 import { Document } from '../document';
 import { Page } from '../page';
@@ -26,15 +26,26 @@ const pageLabelStyle: React.CSSProperties = {
   width: 'fit-content',
 };
 
-export function PreviewApp() {
-  const pages = getPages();
+interface PreviewAppProps {
+  slug: string;
+}
+
+export function PreviewApp({ slug }: PreviewAppProps) {
+  const documents = getDocuments();
+  const doc = documents[slug];
+  const pages = doc?.pages ?? {};
   const [activePage, setActivePage] = useState<string | null>(null);
 
   const visiblePages = activePage ? { [activePage]: pages[activePage] } : pages;
 
   return (
     <>
-      <Navigation pages={pages} activePage={activePage} onSelectPage={setActivePage} />
+      <Navigation
+        pages={pages}
+        activePage={activePage}
+        onSelectPage={setActivePage}
+        documentSlug={slug}
+      />
       <div data-pdf-smith-container="" style={containerStyle}>
         <Document>
           {Object.entries(visiblePages).map(([name, PageComponent]) => (

package/src/preview/entry.tsx

@@ -1,7 +1,11 @@
 import { createRoot } from 'react-dom/client';
 import { PreviewApp } from './app';
+import { HomePage } from './home';
 
-const root = document.getElementById('root');
-if (root) {
-  createRoot(root).render(<PreviewApp />);
+const rootEl = document.getElementById('root');
+if (rootEl) {
+  const path = window.location.pathname;
+  const slug = path === '/' ? null : path.replace(/^\//, '').replace(/\/$/, '');
+
+  createRoot(rootEl).render(slug ? <PreviewApp slug={slug} /> : <HomePage />);
 }

package/src/preview/home.tsx

@@ -0,0 +1,95 @@
+import { getDocuments } from 'virtual:pdf-smith-documents';
+
+const containerStyle: React.CSSProperties = {
+  minHeight: '100vh',
+  background: '#1a1a2e',
+  color: '#e0e0e0',
+  fontFamily: 'system-ui, -apple-system, sans-serif',
+  display: 'flex',
+  flexDirection: 'column',
+  alignItems: 'center',
+  padding: '48px 24px',
+};
+
+const titleStyle: React.CSSProperties = {
+  fontSize: '28px',
+  fontWeight: 700,
+  color: '#ffffff',
+  marginBottom: '8px',
+  letterSpacing: '0.5px',
+};
+
+const subtitleStyle: React.CSSProperties = {
+  fontSize: '14px',
+  color: '#888',
+  marginBottom: '40px',
+};
+
+const gridStyle: React.CSSProperties = {
+  display: 'grid',
+  gridTemplateColumns: 'repeat(auto-fill, minmax(260px, 1fr))',
+  gap: '16px',
+  width: '100%',
+  maxWidth: '800px',
+};
+
+const cardStyle: React.CSSProperties = {
+  display: 'block',
+  background: '#16213e',
+  borderRadius: '8px',
+  padding: '24px',
+  textDecoration: 'none',
+  color: '#e0e0e0',
+  transition: 'background 0.15s',
+  border: '1px solid #2a2a4a',
+};
+
+const cardTitleStyle: React.CSSProperties = {
+  fontSize: '18px',
+  fontWeight: 600,
+  color: '#ffffff',
+  marginBottom: '8px',
+};
+
+const cardMetaStyle: React.CSSProperties = {
+  fontSize: '13px',
+  color: '#888',
+};
+
+export function HomePage() {
+  const documents = getDocuments();
+  const slugs = Object.keys(documents);
+
+  return (
+    <div style={containerStyle}>
+      <h1 style={titleStyle}>pdf-smith</h1>
+      <p style={subtitleStyle}>
+        {slugs.length} document{slugs.length !== 1 ? 's' : ''}
+      </p>
+      <div style={gridStyle}>
+        {slugs.map((slug) => {
+          const doc = documents[slug];
+          const pageCount = Object.keys(doc.pages).length;
+          return (
+            <a
+              key={slug}
+              href={`/${slug}`}
+              style={cardStyle}
+              onMouseEnter={(e) => {
+                e.currentTarget.style.background = '#1e2d50';
+              }}
+              onMouseLeave={(e) => {
+                e.currentTarget.style.background = '#16213e';
+              }}
+            >
+              <div style={cardTitleStyle}>{slug}</div>
+              <div style={cardMetaStyle}>
+                {pageCount} page{pageCount !== 1 ? 's' : ''}
+              </div>
+            </a>
+          );
+        })}
+      </div>
+    </div>
+  );
+}

package/src/preview/navigation.tsx

@@ -2,6 +2,7 @@ interface NavigationProps {
   pages: Record<string, React.ComponentType>;
   activePage: string | null;
   onSelectPage: (page: string | null) => void;
+  documentSlug: string;
 }
 
 const navStyle: React.CSSProperties = {
@@ -28,6 +29,15 @@ const titleStyle: React.CSSProperties = {
   letterSpacing: '0.5px',
 };
 
+const backLinkStyle: React.CSSProperties = {
+  display: 'block',
+  fontSize: '13px',
+  color: '#888',
+  textDecoration: 'none',
+  marginBottom: '12px',
+  transition: 'color 0.15s',
+};
+
 const buttonBaseStyle: React.CSSProperties = {
   display: 'block',
   width: '100%',
@@ -57,12 +67,24 @@ const separatorStyle: React.CSSProperties = {
   margin: '12px 0',
 };
 
-export function Navigation({ pages, activePage, onSelectPage }: NavigationProps) {
+export function Navigation({ pages, activePage, onSelectPage, documentSlug }: NavigationProps) {
   const pageNames = Object.keys(pages);
 
   return (
     <nav data-pdf-smith-nav="" style={navStyle}>
-      <div style={titleStyle}>pdf-smith Preview</div>
+      <a
+        href="/"
+        style={backLinkStyle}
+        onMouseEnter={(e) => {
+          e.currentTarget.style.color = '#e0e0e0';
+        }}
+        onMouseLeave={(e) => {
+          e.currentTarget.style.color = '#888';
+        }}
+      >
+        &larr; All Documents
+      </a>
+      <div style={titleStyle}>{documentSlug}</div>
       <button
         type="button"
         style={getButtonStyle(activePage === null)}

package/src/preview/preview-plugin.ts

@@ -1,21 +1,23 @@
 import type { Plugin } from 'vite';
 
-const VIRTUAL_PAGES_ID = 'virtual:pdf-smith-pages';
-const RESOLVED_VIRTUAL_PAGES_ID = `\0${VIRTUAL_PAGES_ID}`;
+const VIRTUAL_DOCUMENTS_ID = 'virtual:pdf-smith-documents';
+const RESOLVED_VIRTUAL_DOCUMENTS_ID = `\0${VIRTUAL_DOCUMENTS_ID}`;
 
 interface PreviewPluginOptions {
   pkgSrcDir: string;
-  pagesGlob: string;
 }
 
-export function pdfSmithPreviewPlugin({ pkgSrcDir, pagesGlob }: PreviewPluginOptions): Plugin {
+export function pdfSmithPreviewPlugin({ pkgSrcDir }: PreviewPluginOptions): Plugin {
   return {
     name: 'pdf-smith-preview',
 
     configureServer(server) {
       return () => {
         server.middlewares.use((req, res, next) => {
-          if (req.url !== '/' && req.url !== '/index.html') {
+          const url = req.url ?? '';
+
+          // Skip file requests, Vite internals, and node_modules
+          if (url.includes('.') || url.startsWith('/@') || url.startsWith('/node_modules/')) {
             next();
             return;
           }
@@ -65,25 +67,44 @@ window.__vite_plugin_react_preamble_installed__ = true
     },
 
     resolveId(id) {
-      if (id === VIRTUAL_PAGES_ID) {
-        return RESOLVED_VIRTUAL_PAGES_ID;
+      if (id === VIRTUAL_DOCUMENTS_ID) {
+        return RESOLVED_VIRTUAL_DOCUMENTS_ID;
       }
     },
 
     load(id) {
-      if (id === RESOLVED_VIRTUAL_PAGES_ID) {
+      if (id === RESOLVED_VIRTUAL_DOCUMENTS_ID) {
         return `
-const modules = import.meta.glob('${pagesGlob}', { eager: true });
+const pageModules = import.meta.glob('/pdfs/*/pages/**/*.tsx', { eager: true });
+const configModules = import.meta.glob('/pdfs/*/config.ts', { eager: true });
+
+export function getDocuments() {
+  const documents = {};
 
-export function getPages() {
-  const pages = {};
-  for (const [path, mod] of Object.entries(modules)) {
-    const name = path
-      .replace(/^\\/pages\\//, '')
-      .replace(/\\.[^.]+$/, '');
-    pages[name] = mod.default;
+  for (const [path, mod] of Object.entries(pageModules)) {
+    const match = path.match(/^\\/pdfs\\/([^/]+)\\/pages\\/(.+)\\.[^.]+$/);
+    if (!match) continue;
+    const [, slug, pageName] = match;
+    if (!documents[slug]) {
+      documents[slug] = { slug, pages: {}, config: undefined };
+    }
+    documents[slug].pages[pageName] = mod.default;
   }
-  return pages;
+
+  for (const [path, mod] of Object.entries(configModules)) {
+    const match = path.match(/^\\/pdfs\\/([^/]+)\\/config\\.ts$/);
+    if (!match) continue;
+    const slug = match[1];
+    if (documents[slug]) {
+      documents[slug].config = mod.default;
+    }
+  }
+
+  return documents;
+}
+
+export function getDocumentSlugs() {
+  return Object.keys(getDocuments());
 }
 `;
       }

package/src/preview/types.ts

@@ -3,8 +3,6 @@ export interface PreviewOptions {
   root: string;
   /** Dev server port (default: 3000) */
   port?: number;
-  // Glob pattern for page discovery (default: '/pages/**/*.tsx')
-  pages?: string;
   /** Auto-open browser (default: false) */
   open?: boolean;
 }