Skip to content

Repository files navigation

Module Q — the QR Code Generator mark

QR Code Generator

Design a QR code you'd actually print.
Live preview, gradients, dot styles, logo overlays, and shareable links — running entirely in your browser. No backend, no accounts, no tracking. Your designs never leave your machine.

▶ Try it live · CI

The QR Code Generator workspace — history rail, live preview canvas, and style inspector

Features

  • Five content types: URL, Email, Phone, Text, vCard
  • Live preview: the code redraws as you type, with a capacity guard instead of silent failures
  • Styling: solid or gradient foregrounds (linear/radial), background colors (or none, for a transparent export), 6 dot styles, corner styles, and logo overlays with a scannability warning
  • History: every download is saved locally with a live thumbnail — restore, share, or delete any past design
  • Sharing: designs encode into self-sufficient URLs; the recipient's browser rebuilds the design with nothing stored server-side
  • Export: PNG at 2× resolution or SVG
  • Workspace UI: three-pane desktop layout on an engineering-grid canvas; mobile gets a history drawer and a sticky export bar

Tech stack

  • React 19 + TypeScript
  • Vite+ (dev server, build, lint, format, type checks)
  • Bun (package manager)
  • Tailwind CSS v4
  • Playwright (E2E testing)
  • qr-code-styling

Getting started

Prerequisites

  • Vite+ (vp CLI; manages Node.js and the package manager)
  • Bun 1.3+
  • just (optional, for convenience commands)

Installation

vp install

Development

vp dev

Open http://localhost:5173 in your browser.

Production build

vp build

The built files will be in the dist/ directory. Preview with vp preview.

Development workflow

This project uses just as a command runner. See available commands:

just --list

Linting, formatting & type checks

just lint        # Format, lint, and type-check with auto-fix
just lint-ci     # Check-only mode (what CI runs)

Testing

just test              # Full Playwright suite
bun run test:ui        # Playwright UI mode
bun run test:headed    # Visible browser

CI

GitHub Actions runs on every push/PR to master/main: install, lint & type-check, test, build.

About

Developed and maintained by FrontSail AI.

License

MIT

About

Design QR codes in your browser — live preview, gradient and dot styling, logo overlays, and shareable links. No backend, no accounts.

Topics

Resources

Stars

Watchers

Forks

Used by

Contributors

Languages