# BatchCanvas

> Design once. Generate hundreds. A bulk template personalization platform. BatchCanvas lets users create a template once, connect structured data, and automatically generate hundreds of personalized images, PDFs, cards, certificates, badges, IDs, and other printable or digital assets. Generates thousands of high-DPI PDFs and personalized image packages from spreadsheet rows (CSV, XLSX, JSON, TSV) directly inside the browser using HTML5 Canvas 2D, Web Workers, pdf-lib, and Dexie.js (IndexedDB). Zero cloud servers, zero subscription fees, zero data egress.

## Core Capabilities & Performance Benchmarks
- **100% Offline & Private:** Client-side compute architecture ensures zero participant names, emails, photos, or corporate credentials ever touch an external server (GDPR, FERPA, and HIPAA privacy-compliant).
- **High-Throughput Parallelization:** Offloads rendering across multi-core Web Worker threads with `OffscreenCanvas` and transferable array buffers for 60fps responsive generation.
- **Batch Participant Photo Linking:** Matches local attendee headshots to CSV data rows by filename automatically with circular and rounded rectangle corner clipping.
- **Print-Ready Dual-Mode PDF Generation:**
  - *Single-Mode:* Generates 1-per-page A4/Letter landscape/portrait certificates.
  - *Multi-Up Grid Mode:* Generates tiled sheets (2x3, 2x4) with alignment crop marks for badges and ID cards.
- **Standalone Individual Single-PDF Archiving:** Packages hundreds of single-page PDFs into a single `.zip` file formatted as `{name}_{id}.pdf` for instant mail-merge distribution.
- **Dynamic Text Fit Engine:** Automatically handles overflowing names with auto-shrink, horizontal condensing, or multi-line wrap algorithms.
- **Barcode & QR Code Synthesis:** Generates dynamic offline QR codes and Code-128 barcodes directly onto cards based on record values.

## Key Links & Navigation
- [Master Studio Application](studio.html): The interactive visual editor with live canvas, spreadsheet editor, and PDF export.
- [Certificate Generator](certificates.html): Dedicated workflow for diplomas, awards, and course completion certificates.
- [Event Badge Maker](badges.html): Dedicated workflow for conference badges, photo ID passes, and lanyards.
- [Custom Card Deck Creator](cards.html): Dedicated workflow for flashcards, game cards, and story prompt decks.
- [Comprehensive User Guide](guide.html): Step-by-step tutorial covering CSV mapping, font uploads, and print calibration.

## Technology Stack
- **Frontend Architecture:** Vanilla HTML5, CSS3 (Neo-brutalist tactile design tokens), Vanilla JavaScript (Modular ES6).
- **Offline Engines:** `pdf-lib.min.js` (Vector PDF document creation), `papaparse.min.js` (CSV parsing), `jszip.min.js` (In-memory ZIP bundling), `dexie.min.js` (IndexedDB persistence), `qrcode.min.js` (Client-side QR generation).