Google Review Card Generator
Overview & Architecture
Google Review Card Generator & Physical QR Platform is an end-to-end web engineering solution and print-ready card design system built to bridge offline customer foot traffic with Google Maps business profiles. Engineered for both on-demand custom card generation and mass retail pre-printing, the platform produces millimeter-precise, 300+ DPI physical cards (PVC CR80 cards, A6/A7 acrylic table standees, and cashier counter stickers) with high-fidelity vector PDF and PNG export.
Architectural Overview
Developed with Next.js 15 App Router and TypeScript, the system adopts Vercel Geist design principles paired with official Google visual identity tokens. The dynamic QR lifecycle is powered by Prisma ORM and serverless PostgreSQL (Neon), executing sub-50ms HTTP 307 proxy redirects (/r/[id]), self-activation onboarding flows, salted SHA-256 PIN verification via native Node.js crypto, and asynchronous scan telemetry logging.
Key Capabilities & Features
- •
Millimeter-Accurate WYSIWYG Print Engine: Client-side vector rendering via jsPDF and html-to-image featuring dynamic ResizeObserver auto-scaling, bleed marks, and strict quiet zones for zero-distortion physical printing.
- •
Dual Production Workflows: Seamlessly toggles between direct branded cards and universal unbranded stock cards ready for retail pre-printing and distribution.
- •
Dynamic Proxy & Self-Activation Portal: Unactivated cards guide merchants through a mobile-first onboarding flow (/r/[id]/activate) with Google Maps link resolution and PIN-protected destination URL updates.
- •
Official Typography & Identity Harmony: Authentic Google Sans and Google Sans Text font stack, NFC wave indicators, and verified gold star rating assets.
Engineering Highlights
Database Modeling & Query Optimization
Structured schemas with relational indexing, connection pooling, and ACID transactional guarantees.
Modern Backend & API Architecture
Structured route handlers with safe input parsing, error boundaries, and scalable service boundaries.
Strict Type Safety & Contract Validation
Compile-time type verification paired with runtime schema validation eliminating edge-case runtime failures.