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:

• [email protected]
• [email protected]
• 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.

Campaign toolkit release

The QR toolkit is available from workspace navigation at /app/toolkit.

1. Wi-Fi QR codes — personal network credentials, hidden networks, and open networks.
2. Contact QR codes — vCard 4.0 with name, company, phone, email, and website.
3. Email QR codes — recipient, subject, and prefilled message.
4. SMS QR codes — international number and prefilled message.
5. Phone QR codes — dialer links using international numbers.
6. Map QR codes — validated latitude and longitude, including zero coordinates.
7. Text QR codes — multiline and Unicode content.
8. WhatsApp QR codes — click-to-chat links with prefilled messages.
9. Campaign URL builder — source, medium, campaign, term, and content parameters.
10. Tracking cleanup — remove UTM and common advertising identifiers while retaining other query parameters and anchors.
11. Printable QR cards — custom heading and caption, with PNG/SVG downloads and a print layout.
12. Bulk pause — stop redirects for selected codes in one operation.
13. Bulk resume — reactivate codes with atomic plan-limit checks.
14. Bulk visibility — enable or disable public preview pages.
15. Bulk tagging — add or remove a tag, respecting the 12-tag limit.
16. Bulk link copying — copy selected tracked URLs, one per line.
17. Visibility filtering — find codes with public pages enabled or disabled.
18. Routing filtering — distinguish single destinations from weighted routing.
19. Scan-activity filtering — find codes that have never been scanned or already have scans.
20. Library pagination — 10, 25, or 50 codes per page with selection across pages.

Toolkit codes embed their content directly: they are not stored as managed codes, are not editable after printing, and do not produce scan analytics. Network passwords are included in Wi-Fi codes; share the resulting card appropriately. Scanner support for contact and action formats depends on the scanning device. Payload conventions follow ZXing's barcode content documentation and vCard 4.0 (RFC 6350).

Batch writes affect at most 100 selected codes in the current organization. A missing or unauthorized code, tag overflow, or activation-limit failure rolls back the whole batch. Changing filters clears selection. Individual and batch activation writes share an organization lock to protect plan limits under concurrent requests. This release requires no database schema migration.

Campaign workspace additions

Twenty additions extend the toolkit and managed library:

1. Website QR codes with HTTP/HTTPS validation.
2. Calendar event QR codes with validated UTC start/end times and escaped event text.
3. Place/address QR codes using Google Maps search links.
4. Social profile QR codes for Instagram, TikTok, X, GitHub, and LinkedIn.
5. Campaign source/medium presets for posters, packaging, events, and newsletters.
6. Import UTM parameters from an existing campaign URL.
7. Normalize campaign values to lowercase with hyphenated spaces.
8. Generate up to 100 campaign source variants and export them as CSV.
9. Open the managed QR builder with a completed campaign destination and name.
10. Save, load, and delete up to 30 toolkit drafts in the current browser.
11. Export/import validated, versioned JSON draft files.
12. Classic, Teal, and Ink QR design presets.
13. Custom foreground/background colors for toolkit QR codes and print cards.
14. Contrast checks that block low-contrast or inverted QR exports.
15. Raster export resolutions of 600, 1200, or 2400 pixels.
16. JPEG and WebP toolkit downloads, alongside existing PNG/SVG exports.
17. Custom, sanitized export filenames.
18. Persistent QR library favorites and a favorites-only filter.
19. Destination domain filtering, including secondary weighted destinations.
20. Save, apply, and delete up to 20 library views with search, filters, and sorting.

Drafts, favorites, and saved views use versioned browser storage scoped by both user ID and organization ID. They stay on this browser; portable draft files can be explicitly moved between browsers. Wi-Fi passwords are omitted from saved, exported, and imported drafts. A contrast check is a design guard, not a guarantee of scanner compatibility: test the final code on the intended scanning devices. Calendar event scanner support varies by device; the payload uses the ZXing VEVENT convention.

This release adds no database migration, changes no API responses, and preserves existing managed short links. Campaign handoff only prefills the existing create screen; the code is saved when the user submits that screen. Toolkit image exports contain the QR, while printing includes the card heading and caption.

The style review used Mobbin screen references retrieved by the coordinating session and visually inspected here: Braintrust library and Claude utility. The cleanup unifies shared/workspace light and dark color tokens, removes legacy border/shadow overrides, aligns labeled controls, groups related actions, and keeps the existing responsive navigation and library layout.