Easy Access QR

Easy Access QR is an organization-first QR code platform for creating branded QR codes, routing traffic with weighted destinations, and tracking view analytics.

Features

• Organization-scoped QR code management
• Dynamic short links (/r/:organizationSlug/:qrSlug) with scan/view tracking
• Weighted destination routing (A/B and multi-destination splits)
• QR design studio (styles, colors, logo support, export to PNG/SVG/JPEG)
• iPhone-safe QR constraints enforced in the builder
• Public QR pages for shareable, non-auth QR previews
• Analytics dashboards:
  • Total views, views today, active codes
  • Daily trend charts
  • Top codes and destination hit breakdowns
• Onboarding flow for new organizations
• People management and billing settings

Current product status

• API keys is intentionally disabled in the app UI for now.
  • /app/settings/api-keys redirects to /app/settings
  • API key screens can be re-enabled later

Tech stack

• TanStack Start + TanStack Router
• tRPC
• Drizzle ORM + PostgreSQL
• Better Auth
• Tailwind CSS + Radix UI primitives
• Bun runtime + toolchain

Core data models

• qr_code
  • organizationId, createdByUserId
  • name, slug, destinationUrl
  • destinations (weighted routing rules)
  • isActive, isPublic
  • scanCount, lastScannedAt, timestamps
• qr_scan_event
  • qrCodeId, organizationId, scannedAt
  • destination attribution (selectedDestinationId, selectedDestinationUrl)
  • request metadata (referrer, userAgent, ipHash, country, city, deviceType)

Local development

1. Install dependencies

bun install

2. Create env file

cp .env.example .env.local

3. Set required environment values in .env.local

• DATABASE_URL (for this app, typically .../easyaccessqr)
• BETTER_AUTH_URL
• BETTER_AUTH_SECRET (32+ chars recommended)

4. Prepare the database

bun run db:push

5. Seed development data (resets all public tables first)

bun run db:seed

Default seed users:

• owner@easyaccessqr.com
• analyst@easyaccessqr.com
• Password: EasyAccessQR!123 (override with SEED_PASSWORD)

6. Start the app

bun run dev

Scripts

• bun run dev - start local dev server
• bun run build - production build
• bun run start - run built server output
• bun run lint - Biome lint checks
• bun run typecheck - TypeScript type check
• bun run test / bun run test:unit - Vitest suite
• bun run test:e2e - Playwright suite
• bun run db:generate - generate Drizzle migrations
• bun run db:migrate - apply migrations
• bun run db:push - push schema to database
• bun run db:seed - reset and seed development data

Public link behavior

• Hitting a short link (/r/:org/:slug) records a view and redirects to the selected destination.
• If a code is paused, a styled status page is shown.
• If a code is public, ?view=1 renders a public QR preview page without auth.