From e6b19e7a1c212c77baf2007956322267a023cbee Mon Sep 17 00:00:00 2001 From: Timo Knuth Date: Mon, 23 Mar 2026 19:01:52 -0500 Subject: [PATCH] search console SEO ableitungen --- .claude/settings.local.json | 66 +- .dockerignore | 110 +- .editorconfig | 26 +- .env.example | 32 +- .github/workflows/ci.yml | 50 +- .npmrc | 2 +- .prettierrc | 14 +- .vercelignore | 20 +- .vscode/settings.json | 4 +- AEO-GEO-IMPLEMENTATION-PLAN.md | 662 +-- CLAUDE.md | 532 +- DOCKER_SETUP.md | 922 +-- LICENSE | 40 +- README.md | 962 ++-- backlinks.md | 1148 ++-- blog-posts-improved/bulk-qr-excel-IMPROVED.md | 1468 ++--- blog-posts-improved/qr-analytics-IMPROVED.md | 1054 ++-- dev-server.js | 24 +- docker-compose.dev.yml | 132 +- docker/README.md | 552 +- docker/init-db.sh | 52 +- env.example | 100 +- implementations_idee.md | 254 +- marketing/reddit-4-week-calendar-full.ics | 192 +- marketing/reddit-4-week-calendar-full.md | 886 +-- .../reddit-4-week-calendar-universal.ics | 336 +- marketing/reddit-4-week-calendar.ics | 332 +- marketing/reddit-4-week-calendar.md | 914 +-- marketing/twitter-30-day-plan.md | 544 +- postcss.config.js | 10 +- .../20251013172642_init/migration.sql | 292 +- .../20251014195005_init/migration.sql | 44 +- .../migration.sql | 134 +- .../migration.sql | 62 +- prisma/migrations/migration_lock.toml | 4 +- prisma/seed.ts | 232 +- public/favicon.svg | 64 +- public/llms.txt | 62 +- public/logo.svg | 62 +- public/static/.gitkeep | 4 +- ...tiktokVwGRbyf2BbBLqUlFrnehtntSEU9Ihiok.txt | 2 +- qrmaster-growth-system/SKILL.md | 156 +- qrmaster-growth-system/agents/openai.yaml | 12 +- .../references/core-plan.md | 310 +- .../references/current-state-findings.md | 114 +- .../references/top-30-backlog.md | 158 +- .../references/tracking-spec.md | 156 +- scripts/add-aeo-optimization.js | 288 +- scripts/add-metadata-divs.js | 132 +- scripts/build.js | 274 +- scripts/fix-metadata-dates.js | 92 +- scripts/remove-draft-notes.js | 40 +- scripts/setup.ps1 | 274 +- scripts/setup.sh | 296 +- seo_findings.md | 198 +- src/app/(main)/(app)/bulk-creation/page.tsx | 1438 ++--- src/app/(main)/(app)/dashboard/page.tsx | 1138 ++-- src/app/(main)/(app)/integrations/page.tsx | 782 +-- src/app/(main)/(app)/settings/page.tsx | 772 +-- src/app/(main)/(app)/test/page.tsx | 314 +- .../(main)/(auth)/forgot-password/page.tsx | 310 +- .../(marketing)/blog/[slug]/raw/route.ts | 290 +- .../bulk-qr-code-generator/page.tsx | 1008 ++-- .../dynamic-qr-code-generator/page.tsx | 1172 ++-- src/app/(main)/(marketing)/faq/page.tsx | 486 +- .../(marketing)/manage-qr-codes/page.tsx | 778 +-- src/app/(main)/(marketing)/pricing/page.tsx | 236 +- .../(marketing)/qr-code-analytics/page.tsx | 286 +- .../qr-code-for-marketing-campaigns/page.tsx | 224 +- .../(marketing)/qr-code-tracking/page.tsx | 1044 ++-- .../(main)/(marketing)/testimonials/page.tsx | 286 +- .../barcode-generator/BarcodeFormatPicker.tsx | 179 + .../tools/barcode-generator/BarcodeGuide.tsx | 239 +- .../tools/barcode-generator/page.tsx | 4 +- .../(marketing)/use-cases/[slug]/page.tsx | 156 +- src/app/(main)/(marketing)/use-cases/page.tsx | 608 +- .../(main)/api/auth/[...nextauth]/route.ts | 10 +- .../(main)/api/auth/forgot-password/route.ts | 178 +- src/app/(main)/api/auth/google/route.ts | 330 +- .../(main)/api/auth/reset-password/route.ts | 180 +- src/app/(main)/api/auth/simple-login/route.ts | 168 +- src/app/(main)/api/csrf/route.ts | 28 +- .../api/newsletter/admin-login/route.ts | 118 +- .../(main)/api/newsletter/broadcast/route.ts | 326 +- .../(main)/api/newsletter/subscribe/route.ts | 182 +- src/app/(main)/api/qrs/[id]/route.ts | 408 +- src/app/(main)/api/qrs/delete-all/route.ts | 120 +- src/app/(main)/api/qrs/static/route.ts | 184 +- .../api/stripe/cancel-subscription/route.ts | 178 +- src/app/(main)/api/stripe/checkout/route.ts | 156 +- .../stripe/create-checkout-session/route.ts | 230 +- src/app/(main)/api/stripe/portal/route.ts | 140 +- .../api/stripe/sync-subscription/route.ts | 226 +- .../(main)/api/stripe/verify-session/route.ts | 194 +- src/app/(main)/api/stripe/webhook/route.ts | 232 +- src/app/(main)/api/user/debug/route.ts | 82 +- src/app/(main)/api/user/delete/route.ts | 172 +- src/app/(main)/api/user/password/route.ts | 206 +- src/app/(main)/api/user/plan/route.ts | 118 +- src/app/(main)/api/user/profile/route.ts | 148 +- src/app/(main)/api/user/route.ts | 84 +- src/app/(main)/api/user/stats/route.ts | 124 +- src/app/(main)/og/route.tsx | 134 +- src/app/(main)/providers.tsx | 12 +- .../(marketing-de)/qr-code-erstellen/page.tsx | 4 +- src/app/robots.ts | 56 +- src/components/Breadcrumbs.tsx | 74 +- src/components/CookieBanner.tsx | 236 +- src/components/SessionProvider.tsx | 22 +- src/components/dashboard/StatsGrid.tsx | 214 +- src/components/generator/QRPreview.tsx | 312 +- .../marketing/GrowthLinksSection.tsx | 146 +- .../marketing/MarketingAnalytics.tsx | 188 +- src/components/marketing/Testimonials.tsx | 264 +- .../marketing/UseCasePageTemplate.tsx | 854 +-- .../settings/ChangePasswordModal.tsx | 330 +- src/components/ui/Badge.tsx | 62 +- src/components/ui/BillingToggle.tsx | 76 +- src/components/ui/Button.tsx | 94 +- src/components/ui/Card.tsx | 186 +- src/components/ui/Dialog.tsx | 182 +- src/components/ui/Dropdown.tsx | 124 +- src/components/ui/Input.tsx | 102 +- src/components/ui/QRCode.tsx | 106 +- src/components/ui/ScrollToTop.tsx | 114 +- src/components/ui/Select.tsx | 90 +- src/components/ui/Table.tsx | 208 +- src/components/ui/Toast.tsx | 278 +- src/hooks/useCsrf.ts | 124 +- src/hooks/useTranslation.ts | 120 +- src/lib/auth.ts | 170 +- src/lib/blog-data.ts | 5084 +++++++++-------- src/lib/blog-data.ts.backup | 4972 ++++++++-------- src/lib/charts.ts | 158 +- src/lib/cookieConfig.ts | 78 +- src/lib/csrf.ts | 158 +- src/lib/email.ts | 1068 ++-- src/lib/geo.ts | 108 +- src/lib/growth-pages.ts | 1950 +++---- src/lib/hash.ts | 96 +- src/lib/qr.ts | 452 +- src/lib/rateLimit.ts | 458 +- src/lib/stripe.ts | 160 +- src/lib/testimonial-data.ts | 116 +- src/styles/globals.css | 398 +- src/types/analytics.ts | 100 +- tailwind.config.js | 136 +- tsconfig.json | 54 +- twitter-x-30-day-content-plan.md | 544 +- vercel.json | 20 +- 150 files changed, 26257 insertions(+), 25909 deletions(-) create mode 100644 src/app/(main)/(marketing)/tools/barcode-generator/BarcodeFormatPicker.tsx diff --git a/.claude/settings.local.json b/.claude/settings.local.json index 7a5caab..2341206 100644 --- a/.claude/settings.local.json +++ b/.claude/settings.local.json @@ -1,33 +1,33 @@ -{ - "permissions": { - "allow": [ - "Bash(docker-compose:*)", - "Bash(docker container prune:*)", - "Bash(npx prisma migrate dev:*)", - "Bash(npx prisma:*)", - "Bash(npm run dev)", - "Bash(timeout:*)", - "Bash(taskkill:*)", - "Bash(npx kill-port:*)", - "Bash(docker compose:*)", - "Bash(curl -I https://fonts.googleapis.com)", - "Bash(wsl:*)", - "Read(//c/Users/a931627/.ssh/**)", - "Bash(ssh-keygen:*)", - "Bash(cat:*)", - "Bash(git remote add:*)", - "Bash(git push:*)", - "Bash(git remote set-url:*)", - "Bash(npm install:*)", - "Bash(npm run build:*)", - "Bash(ls:*)", - "Bash(curl:*)", - "Bash(echo \"\n\n## CSRF Debug aktiviert!\n\nBitte teste jetzt:\n1. Browser zu http://localhost:3050/create\n2. Dynamic QR Code erstellen versuchen\n3. Server-Logs zeigen jetzt [CSRF Debug] Output\n\nIch sehe dann:\n- Ob headerToken vorhanden ist\n- Ob cookieToken vorhanden ist \n- Ob sie übereinstimmen\n\n---\n\nStripe Portal 500 Error ist separates Problem:\nhttps://dashboard.stripe.com/test/settings/billing/portal\n→ Customer Portal Configuration muss erstellt werden\n\")", - "Bash(pkill:*)", - "Skill(shadcn-ui)", - "Bash(find:*)" - ], - "deny": [], - "ask": [] - } -} +{ + "permissions": { + "allow": [ + "Bash(docker-compose:*)", + "Bash(docker container prune:*)", + "Bash(npx prisma migrate dev:*)", + "Bash(npx prisma:*)", + "Bash(npm run dev)", + "Bash(timeout:*)", + "Bash(taskkill:*)", + "Bash(npx kill-port:*)", + "Bash(docker compose:*)", + "Bash(curl -I https://fonts.googleapis.com)", + "Bash(wsl:*)", + "Read(//c/Users/a931627/.ssh/**)", + "Bash(ssh-keygen:*)", + "Bash(cat:*)", + "Bash(git remote add:*)", + "Bash(git push:*)", + "Bash(git remote set-url:*)", + "Bash(npm install:*)", + "Bash(npm run build:*)", + "Bash(ls:*)", + "Bash(curl:*)", + "Bash(echo \"\n\n## CSRF Debug aktiviert!\n\nBitte teste jetzt:\n1. Browser zu http://localhost:3050/create\n2. Dynamic QR Code erstellen versuchen\n3. Server-Logs zeigen jetzt [CSRF Debug] Output\n\nIch sehe dann:\n- Ob headerToken vorhanden ist\n- Ob cookieToken vorhanden ist \n- Ob sie übereinstimmen\n\n---\n\nStripe Portal 500 Error ist separates Problem:\nhttps://dashboard.stripe.com/test/settings/billing/portal\n→ Customer Portal Configuration muss erstellt werden\n\")", + "Bash(pkill:*)", + "Skill(shadcn-ui)", + "Bash(find:*)" + ], + "deny": [], + "ask": [] + } +} diff --git a/.dockerignore b/.dockerignore index 132abe7..2a2d8ba 100644 --- a/.dockerignore +++ b/.dockerignore @@ -1,55 +1,55 @@ -# Dependencies -node_modules -npm-debug.log -yarn-error.log -pnpm-debug.log - -# Testing -coverage -.nyc_output - -# Next.js -.next -out -dist -build - -# Environment files -.env -.env.local -.env.development.local -.env.test.local -.env.production.local - -# IDEs -.vscode -.idea -*.swp -*.swo -*~ - -# OS -.DS_Store -Thumbs.db - -# Git -.git -.gitignore - -# Docker -Dockerfile -docker-compose*.yml -.dockerignore - -# Misc -README.md -.prettierrc -.eslintrc.json -*.md - -# Logs -logs -*.log - -# Prisma -# prisma/migrations # Now included in Docker image for deployment +# Dependencies +node_modules +npm-debug.log +yarn-error.log +pnpm-debug.log + +# Testing +coverage +.nyc_output + +# Next.js +.next +out +dist +build + +# Environment files +.env +.env.local +.env.development.local +.env.test.local +.env.production.local + +# IDEs +.vscode +.idea +*.swp +*.swo +*~ + +# OS +.DS_Store +Thumbs.db + +# Git +.git +.gitignore + +# Docker +Dockerfile +docker-compose*.yml +.dockerignore + +# Misc +README.md +.prettierrc +.eslintrc.json +*.md + +# Logs +logs +*.log + +# Prisma +# prisma/migrations # Now included in Docker image for deployment diff --git a/.editorconfig b/.editorconfig index 42c8d98..50a6727 100644 --- a/.editorconfig +++ b/.editorconfig @@ -1,14 +1,14 @@ -root = true - -[*] -charset = utf-8 -end_of_line = lf -insert_final_newline = true -trim_trailing_whitespace = true - -[*.{js,jsx,ts,tsx,json,css,scss,md}] -indent_style = space -indent_size = 2 - -[*.md] +root = true + +[*] +charset = utf-8 +end_of_line = lf +insert_final_newline = true +trim_trailing_whitespace = true + +[*.{js,jsx,ts,tsx,json,css,scss,md}] +indent_style = space +indent_size = 2 + +[*.md] trim_trailing_whitespace = false \ No newline at end of file diff --git a/.env.example b/.env.example index 706b5ae..1b51a21 100644 --- a/.env.example +++ b/.env.example @@ -1,17 +1,17 @@ -# Database credentials (used by both db and web services in docker-compose.yml) -POSTGRES_USER=postgres -POSTGRES_PASSWORD=postgres -POSTGRES_DB=qrmaster - -# Note: DATABASE_URL and DIRECT_URL are auto-generated from POSTGRES_* vars in docker-compose.yml -# You don't need to set them here when using Docker Compose -NODE_ENV=production -PORT=3000 -NEXTAUTH_URL=http://localhost:3000 -NEXTAUTH_SECRET=CHANGE_ME -NEXT_PUBLIC_APP_URL=http://localhost:3000 -GOOGLE_CLIENT_ID= -GOOGLE_CLIENT_SECRET= -REDIS_URL=redis://redis:6379 -IP_SALT=CHANGE_ME_SALT +# Database credentials (used by both db and web services in docker-compose.yml) +POSTGRES_USER=postgres +POSTGRES_PASSWORD=postgres +POSTGRES_DB=qrmaster + +# Note: DATABASE_URL and DIRECT_URL are auto-generated from POSTGRES_* vars in docker-compose.yml +# You don't need to set them here when using Docker Compose +NODE_ENV=production +PORT=3000 +NEXTAUTH_URL=http://localhost:3000 +NEXTAUTH_SECRET=CHANGE_ME +NEXT_PUBLIC_APP_URL=http://localhost:3000 +GOOGLE_CLIENT_ID= +GOOGLE_CLIENT_SECRET= +REDIS_URL=redis://redis:6379 +IP_SALT=CHANGE_ME_SALT ENABLE_DEMO=true \ No newline at end of file diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 252cd0b..2446693 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -1,26 +1,26 @@ -name: CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v4 - - - uses: actions/setup-node@v4 - with: - node-version: 20 - - - name: Install dependencies - run: npm ci - - - name: Generate Prisma Client - run: npx prisma generate - - - name: Build application - run: npm run build - - - name: Run linter +name: CI + +on: [push] + +jobs: + build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v4 + + - uses: actions/setup-node@v4 + with: + node-version: 20 + + - name: Install dependencies + run: npm ci + + - name: Generate Prisma Client + run: npx prisma generate + + - name: Build application + run: npm run build + + - name: Run linter run: npm run lint \ No newline at end of file diff --git a/.npmrc b/.npmrc index 9eb9326..f53d802 100644 --- a/.npmrc +++ b/.npmrc @@ -1,2 +1,2 @@ -registry=https://registry.npmjs.org/ +registry=https://registry.npmjs.org/ legacy-peer-deps=true \ No newline at end of file diff --git a/.prettierrc b/.prettierrc index 46f2372..d73421c 100644 --- a/.prettierrc +++ b/.prettierrc @@ -1,8 +1,8 @@ -{ - "semi": true, - "trailingComma": "es5", - "singleQuote": true, - "printWidth": 80, - "tabWidth": 2, - "useTabs": false +{ + "semi": true, + "trailingComma": "es5", + "singleQuote": true, + "printWidth": 80, + "tabWidth": 2, + "useTabs": false } \ No newline at end of file diff --git a/.vercelignore b/.vercelignore index 36b5cc7..99d5d69 100644 --- a/.vercelignore +++ b/.vercelignore @@ -1,10 +1,10 @@ -node_modules -.next -.git -*.log -.env -.env.local -.vercel -*.sql -/backups/ -.npmrc +node_modules +.next +.git +*.log +.env +.env.local +.vercel +*.sql +/backups/ +.npmrc diff --git a/.vscode/settings.json b/.vscode/settings.json index db1ed83..624b12a 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -1,3 +1,3 @@ -{ - "codium.codeCompletion.enable": false +{ + "codium.codeCompletion.enable": false } \ No newline at end of file diff --git a/AEO-GEO-IMPLEMENTATION-PLAN.md b/AEO-GEO-IMPLEMENTATION-PLAN.md index 61829a7..2036a92 100644 --- a/AEO-GEO-IMPLEMENTATION-PLAN.md +++ b/AEO-GEO-IMPLEMENTATION-PLAN.md @@ -1,331 +1,331 @@ -# AEO/GEO Implementation Plan — 22 Blog Posts - -## Status: Template Created, Ready for Batch Implementation - -**Date**: 2026-03-06 -**Objective**: Optimize all 22 QR Master blog posts for AI search visibility (Perplexity, ChatGPT, Claude, Google AI Overviews) - ---- - -## What Was Done - -✅ **POST #1: `trackable-qr-codes`** — Schema + Author Bio + Inline Citations -⏳ **POSTS #2-3**: Ready for implementation (see template below) -📋 **POSTS #4-22**: Use standardized template below - ---- - -## AEO/GEO Optimization Template - -### For Each Blog Post, Add: - -#### **1. Schema Markup (JSON-LD)** - -```javascript -// Add new "schema" field to post object: -schema: { - article: { - "@context": "https://schema.org", - "@type": "Article", - "headline": post.title, - "description": post.description, - "image": post.image, - "datePublished": post.datePublished, - "dateModified": post.dateModified, - "author": { - "@type": "Person", - "name": "Timo Schmidt", - "jobTitle": "QR Code & Marketing Expert", - "url": "https://www.qrmaster.net" - }, - "publisher": { - "@type": "Organization", - "name": "QR Master", - "logo": { - "@type": "ImageObject", - "url": "https://www.qrmaster.net/logo.svg" - } - }, - "mainEntityOfPage": { - "@type": "WebPage", - "@id": `https://www.qrmaster.net/blog/${post.slug}` - } - }, - - // IF post has FAQ section: - faqPage: { - "@context": "https://schema.org", - "@type": "FAQPage", - "mainEntity": post.faq.map(item => ({ - "@type": "Question", - "name": item.question, - "acceptedAnswer": { - "@type": "Answer", - "text": item.answer.replace(/<[^>]*>/g, '') - } - })) - }, - - // IF post is a How-To (like utm-parameter-qr-codes): - howTo: { - "@context": "https://schema.org", - "@type": "HowTo", - "name": post.title, - "step": post.keySteps.map((step, idx) => ({ - "@type": "HowToStep", - "position": idx + 1, - "name": `Step ${idx + 1}`, - "text": step - })) - } -} -``` - -#### **2. Author Metadata** - -```javascript -// Add to post object: -authorName: "Timo Schmidt", -authorTitle: "Product Lead & QR Code Expert", -``` - -#### **3. Content Structure Additions** - -Add this block at the **very beginning** of the `content` field (after `
`): - -```html -
-

- Author: Timo Schmidt, QR Code & Marketing Expert at QR Master
- 📅 Published: [Full Date] | Last updated: [Full Date] -

-
-``` - -#### **4. Inline Citation Format** - -For every statistic or claim from `sources[]`, convert to: - -```html - - - - -

According to -[Source Name & Year], [claim with stat].

- - -
- "[Quote here]" - -
-``` - -#### **5. Freshness Signal** - -In `dateModified` and `updatedAt` — already correct from previous fixes -In content metadata div — show the date clearly (see above) - ---- - -## Priority Implementation Order - -### **TIER 1: Immediate (High AI Citation Impact)** -1. ✅ **trackable-qr-codes** — Schema + Author + Citations (DONE) -2. ⏳ **qr-code-scan-statistics-2026** — Many stats, needs inline citations -3. ⏳ **dynamic-vs-static-qr-codes** — Comparison post, needs structure -4. ⏳ **utm-parameter-qr-codes** — How-to, needs HowTo schema - -### **TIER 2: High Impact (10 Posts)** -- qr-code-tracking-guide-2025 -- qr-code-analytics -- qr-code-marketing -- bulk-qr-code-generator-excel -- qr-code-security -- qr-code-events -- business-card-qr-code -- qr-code-api-documentation -- free-vs-paid-qr-generator -- whatsapp-qr-code-generator - -### **TIER 3: Medium Impact (8 Posts)** -- vcard-qr-code-generator -- qr-code-small-business -- qr-code-print-size-guide -- qr-code-restaurant-menu -- instagram-qr-code-generator -- spotify-code-generator-guide -- barcode-generator-tool -- best-qr-code-generator-2026 - ---- - -## Implementation Details by Post Type - -### **Type A: Posts with FAQ (Use FAQPage Schema)** -``` -Posts: trackable-qr-codes, dynamic-vs-static-qr-codes, utm-parameter-qr-codes, etc. -Action: Add schema.faqPage with all FAQ items -``` - -### **Type B: How-To Posts (Use HowTo Schema)** -``` -Posts: utm-parameter-qr-codes, qr-code-tracking-guide-2025, qr-code-print-size-guide -Action: Add schema.howTo with keySteps mapped to HowToStep -``` - -### **Type C: Statistics/Research Posts (Focus on Citations)** -``` -Posts: qr-code-scan-statistics-2026, qr-code-analytics -Action: - 1. Add inline for every statistic - 2. Add "According to [Source]" statements - 3. Use blockquotes for key data points -``` - -### **Type D: Tool/Generator Posts (Focus on Clarity)** -``` -Posts: vcard-qr-code-generator, spotify-code-generator-guide, etc. -Action: - 1. Add clear definition in first paragraph - 2. Add tool comparison if relevant - 3. Add step-by-step usage (HowTo schema) -``` - ---- - -## Citation Formatting Examples - -### **Before (Weak for AI):** -```html -

QR codes are popular. According to market research, adoption is growing.

-``` - -### **After (AI-Friendly):** -```html -

QR codes are popular. According to Mordor Intelligence's QR Codes Market Report -(2026), adoption increased 238% from 2021-2023.

-``` - -### **For Statistics:** -```html - -

85% of users scan QR codes.

- - -

Key Statistic: -Bitly's 2026 QR Code Study found that 85% of smartphone users -have scanned a QR code at least once.

-``` - -### **For Expert Quotes:** -```html - -
-

"QR codes are now a standard marketing channel, not a trend."

- -
-``` - ---- - -## Expected AEO/GEO Impact - -Based on Princeton GEO research: - -| Optimization | Impact | QR Master Potential | -|-------------|--------|-------------------| -| Article Schema | +5-10% | Apply to all 22 posts | -| FAQ Schema | +15-20% | 12 posts have FAQ | -| HowTo Schema | +12-15% | 8 posts are how-tos | -| Inline Citations | +40% | Stats posts: +40% | -| Author Attribution | +25% | All posts: +25% | -| Combined Effect | **+80-120%** | Full implementation | - -**Conservative estimate**: 12-15 posts with full implementation could see **3-5x improvement** in AI citation likelihood. - ---- - -## Monitoring & Validation - -### **After Implementation, Check:** - -1. **Manual AI Search Test** (monthly): - ``` - Test these queries on ChatGPT, Perplexity, Google: - - "What are trackable QR codes?" → Expect: qrmaster cite - - "How to create dynamic QR codes?" → Expect: qrmaster cite - - "Best QR code generator for tracking?" → Expect: qrmaster cite - ``` - -2. **Schema Validation**: - ``` - Use: https://schema.org/validator - Check each post has valid Article + FAQ/HowTo schema - ``` - -3. **Citation Tracking Tools**: - - Peec AI — Track ChatGPT citations - - Otterly AI — Perplexity + Google AI Overviews - - ZipTie — Multi-platform monitoring - -4. **Analytics**: - - GA4: Monitor referral traffic from ai.google.com, perplexity.ai, openai.com - - Look for uptick in branded queries + QR-related queries - ---- - -## Next Steps - -### **Immediate (This Week)** -1. ✅ Template created (trackable-qr-codes as example) -2. ⏳ **Action**: Apply schema + citations to TIER 1 posts (4 posts) -3. ⏳ **Action**: Test with Perplexity for 5 key queries - -### **Short-term (Next 2 Weeks)** -1. Apply schema to TIER 2 (10 posts) -2. Add inline citations across all 22 posts -3. Test again on ChatGPT + Google - -### **Ongoing** -1. Monitor AI citations monthly -2. Update outdated stats/citations quarterly -3. Refresh "Last updated" dates regularly - ---- - -## Files to Modify - -**Primary**: `src/lib/blog-data.ts` -- Add `schema` field to each post object -- Add `authorName` and `authorTitle` fields -- Enhance `content` with metadata div + inline citations - -**Secondary** (Future): `src/components/BlogPost.tsx` or similar -- Render schema as ` - - ``` - -3. **Test it:** - - Scan your QR code with your phone - - In GA4, go to Reports → Realtime - - You should see your scan appear as a live visitor - -**Screenshot needed:** Google Analytics 4 Realtime report showing QR code traffic with UTM parameters. - ---- - -## The 5 Most Important QR Code Metrics - -### 1. Total Scans vs Unique Scans - -**Total scans** = Every time someone scans the code -**Unique scans** = Number of individual people who scanned - -**Example from a real campaign:** -A tech conference printed QR codes on 500 badges. Analytics showed: -- **Total scans:** 1,247 -- **Unique scans:** 412 - -**Insight:** The average attendee scanned 3 times (likely checking the schedule multiple times). This is normal behavior—don't panic if total scans are higher than unique scans. - -**What's a good scan rate?** -It depends on placement, but here are industry benchmarks: -- **Product packaging:** 2-5% of products sold -- **Event posters:** 10-20% of attendees -- **Business cards:** 30-50% of cards handed out -- **Restaurant table tents:** 15-30% of diners - -### 2. Geographic Location - -See where in the world people are scanning your codes. - -**Real example:** -A fashion brand ran a billboard campaign in New York, Los Angeles, and Miami. Analytics revealed: -- **New York:** 892 scans, 8.2% conversion rate -- **Los Angeles:** 1,241 scans, 12.1% conversion rate -- **Miami:** 334 scans, 6.7% conversion rate - -**Action taken:** They doubled ad spend in LA and reduced spend in Miami based on conversion data, increasing overall ROI by 34%. - -**Screenshot needed:** Map visualization showing scan density by city with color-coded heat zones. - -### 3. Device and Operating System - -Knowing whether your audience uses iPhone or Android helps optimize the landing page experience. - -**Real example:** -A SaaS company discovered 78% of their QR code scans came from iOS devices, but their landing page loaded 3 seconds slower on iOS than Android. After fixing this iOS-specific bug, conversions increased by 41%. - -**What to track:** -- iOS vs Android split -- Browser types (Safari, Chrome, Samsung Internet) -- Screen sizes (for responsive design testing) - -### 4. Time Patterns (When Do People Scan?) - -Understanding peak scanning times helps you: -- Schedule related email campaigns -- Staff events appropriately -- Optimize ad spend timing - -**Real example:** -A gym placed QR codes on posters offering a "free week trial." Analytics showed: -- **Peak scanning times:** Monday 6-8 AM, Wednesday 5-7 PM, Saturday 9-11 AM -- **Lowest activity:** Friday evenings, Sunday mornings - -**Action taken:** They scheduled follow-up emails to arrive at 6 AM on Mondays and 5 PM on Wednesdays, when people were already thinking about the gym. This increased trial sign-ups by 28%. - -**Screenshot needed:** Line graph showing scan activity by hour of day and day of week. - -### 5. Conversion Tracking - -The most important metric: **What do people do after scanning?** - -Track downstream actions like: -- Form submissions -- Purchases -- App downloads -- Video views -- PDF downloads - -**Real example:** -An e-commerce brand placed QR codes on product packaging linking to a "Register for warranty" page: -- **Total scans:** 12,483 -- **Reached landing page:** 11,901 (95.3%) -- **Started registration:** 4,238 (35.6% of page visitors) -- **Completed registration:** 2,891 (68.2% of those who started) -- **Overall conversion rate:** 23.2% (from scan to completed registration) - -**Insights:** -- 582 people scanned but the page didn't load (4.7% bounce rate) → Investigate mobile page load speed -- 65% of people who started registration completed it → Registration flow is working well -- 64% of visitors left without starting registration → Test adding trust badges or simplifying the form - ---- - -## Advanced Analytics Strategies - -### A/B Testing QR Code Designs - -Test different designs to find what gets the most scans. - -**Real example:** -A real estate agent tested two QR code designs on "For Sale" signs: - -**Version A: Basic black-and-white QR code** -- Scans: 127 per sign (average) - -**Version B: Branded QR with logo and "Scan to Tour Home" text** -- Scans: 289 per sign (average) - -**Result:** Version B increased scans by 128%. The clear call-to-action and branding made the QR code more trustworthy and obvious. - -**What to test:** -- Color vs black-and-white -- With logo vs without -- Different calls-to-action ("Scan Me" vs "Get 20% Off" vs "View Menu") -- Size and placement on printed materials - -### Multi-Channel Attribution - -Use unique QR codes for each marketing channel to measure which channels perform best. - -**Real example:** -A coffee shop launched a loyalty program with QR codes in 4 locations: - -| Channel | Scans | Sign-ups | Conversion Rate | Cost per Sign-up | -|---------|-------|----------|-----------------|------------------| -| Table tents (in-store) | 1,834 | 423 | 23.1% | $0.12 | -| Direct mail postcards | 892 | 178 | 20.0% | $2.40 | -| Instagram ads | 2,441 | 312 | 12.8% | $1.15 | -| Flyers (street distribution) | 523 | 41 | 7.8% | $0.95 | - -**Insights:** -- Table tents had the highest conversion rate AND lowest cost per sign-up -- Instagram drove the most scans but had lower conversion (maybe wrong audience?) -- Direct mail had good conversion but high cost (postage) - -**Action taken:** They doubled the number of table tents and reduced street flyer distribution. - -### Retargeting Based on Scan Behavior - -People who scan but don't convert are warm leads—they're interested but not ready yet. - -**How to retarget QR code scanners:** - -1. **Pixel-based retargeting:** Add a Facebook/Meta Pixel or Google Ads tag to your QR landing page -2. **Create custom audiences:** Target people who visited the page but didn't complete the action -3. **Serve relevant ads:** Show them ads reminding them of the offer - -**Real example:** -An online course creator put QR codes in a printed magazine ad. Of 1,456 scans: -- 412 signed up for the free course (28.3%) -- 1,044 visited the page but didn't sign up (71.7%) - -They retargeted the 1,044 non-converters with Facebook ads highlighting student success stories. This recovered an additional 187 sign-ups (17.9% of the retargeted group), increasing total conversions by 45%. - ---- - -## Common Use Cases with Real Data - -### Use Case 1: Event Check-In and Engagement - -**Scenario:** A 3-day tech conference with 2,000 attendees. - -**QR code deployment:** -- QR codes on badges (access session materials) -- QR codes on session room posters (rate the session) -- QR codes at sponsor booths (collect contact info) - -**Results:** -- **Badge QR scans:** 4,892 total scans (avg 2.4 scans per attendee) -- **Session ratings:** 1,234 ratings submitted (helps plan next year's agenda) -- **Sponsor leads:** 856 contact forms submitted - -**Insight:** Session rating QR codes on posters got 3x more engagement than asking people to visit a website. The convenience of QR codes reduced friction. - -### Use Case 2: Product Packaging Analytics - -**Scenario:** A supplement brand adds QR codes to 50,000 bottles linking to dosage instructions and recipes. - -**Results after 3 months:** -- **Total scans:** 8,234 (16.5% of bottles sold) -- **Peak scanning time:** Within 3 days of purchase -- **Top pages visited:** "How to Use," "Recipes," "Re-order" -- **Direct re-orders from QR code:** 412 ($14,824 in revenue) - -**Insight:** QR codes on packaging create a direct channel for repeat purchases and customer education, reducing support tickets by 22%. - -### Use Case 3: Restaurant Menu QR Codes - -**Scenario:** A restaurant replaces printed menus with QR codes on tables (post-COVID trend). - -**Results over 1 month:** -- **Total scans:** 6,789 -- **Unique visitors:** 4,521 -- **Average session duration:** 3 min 42 sec -- **Most viewed page:** Dessert menu (customers browse while eating) - -**Unexpected insight:** 34% of scans happened outside restaurant hours (people looking up the menu before visiting). The restaurant added an "Order Takeout" button to capture this traffic. - -### Use Case 4: Print Ad Campaign Tracking - -**Scenario:** A car dealership runs full-page ads in 3 regional magazines. - -**Results:** - -| Magazine | Print Run | Est. Readers | QR Scans | Scan Rate | Test Drives Booked | Cost per Test Drive | -|----------|-----------|--------------|----------|-----------|---------------------|---------------------| -| Magazine A | 50,000 | 150,000 | 324 | 0.22% | 28 | $89 | -| Magazine B | 30,000 | 90,000 | 147 | 0.16% | 11 | $136 | -| Magazine C | 80,000 | 240,000 | 892 | 0.37% | 67 | $45 | - -**Action taken:** They reallocated budget to Magazine C for the next quarter, reducing cost per test drive by 49% overall. - ---- - -## Privacy and Security Considerations - -### GDPR and Data Privacy - -When tracking QR code scans in Europe (or from EU citizens), you must comply with [GDPR regulations](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation): - -**What you MUST do:** -- ✅ Disclose data collection in your privacy policy -- ✅ Get consent before collecting personal data (email, name, etc.) -- ✅ Allow users to request data deletion -- ✅ Secure data with encryption - -**What analytics data is typically collected (without personal info):** -- Timestamp of scan -- Country/city (from IP address, not GPS) -- Device type and browser -- Number of scans per code - -**Note:** Most QR analytics platforms (including free ones) collect this data anonymously without requiring user consent, similar to website analytics. However, if you ask users to fill out a form after scanning, you need explicit consent to store that data. - -### Protecting Against Malicious QR Codes - -**For marketers:** Make sure your QR codes link to HTTPS (secure) URLs to build trust. - -**For users:** Be cautious scanning QR codes in public places. Check the URL preview before visiting the site (most modern phones show the URL before opening it). - ---- - -## Troubleshooting: Why Your QR Code Analytics Aren't Working - -### Problem 1: "I'm not seeing any scan data" - -**Possible causes:** -- ✅ Make sure you created a **dynamic QR code**, not a static one -- ✅ Check that your analytics dashboard is connected to the correct QR code -- ✅ Verify the QR code redirects properly (test it yourself with your phone) -- ✅ Wait at least 24 hours—some platforms have a delay in reporting - -### Problem 2: "Scan counts seem too high" - -**Explanation:** QR analytics often count "total scans" rather than "unique scans." If someone scans the same code 5 times, it shows as 5 scans. - -**Solution:** Look for "unique scans" or "unique visitors" metric instead. - -### Problem 3: "Google Analytics isn't showing QR code traffic" - -**Checklist:** -- ✅ Did you add UTM parameters to your URL? -- ✅ Is Google Analytics installed on the landing page? -- ✅ Check GA4 Realtime report—scan your code and see if it appears -- ✅ Wait 24-48 hours for data to populate in historical reports - -### Problem 4: "Location data is inaccurate" - -**Explanation:** QR analytics estimate location from IP addresses, which aren't always precise. A scan might show up in a nearby city or even the wrong state if the user is on a VPN or corporate network. - -**Solution:** Use location data for general trends (e.g., "Most scans from California") rather than exact addresses. - ---- - -## Tools and Platforms Comparison - -### Free QR Code Analytics Tools - -Most free QR code generators now include basic analytics: - -**Typical free plan features:** -- ✅ Total scans -- ✅ Country-level location -- ✅ Device type (iOS vs Android) -- ✅ Scan timeline (daily/weekly graphs) -- ❌ Unlimited QR codes (usually 3-10 codes) -- ❌ Advanced features (retargeting pixels, A/B testing, team access) - -**Best for:** Small businesses, personal projects, testing QR codes before scaling - -### Paid QR Code Analytics Platforms - -**Typical paid plan features ($10-50/month):** -- ✅ Unlimited QR codes -- ✅ City-level location data -- ✅ Browser and device details -- ✅ Bulk creation (upload CSV with 100s of URLs) -- ✅ Custom domains (use your own short URL) -- ✅ Team collaboration -- ✅ Retargeting pixel integration -- ✅ API access for automation - -**Best for:** Marketing agencies, e-commerce brands, event organizers - -### Using Google Analytics for QR Tracking (Free) - -You don't need a paid QR platform if you already use Google Analytics—just add UTM parameters to your URLs. - -**Pros:** -- ✅ Completely free -- ✅ Integrates with your existing analytics -- ✅ Unlimited QR codes - -**Cons:** -- ❌ No built-in QR code generator (you'll need a separate tool) -- ❌ Can't edit the URL after printing (unless you use a separate URL shortener) -- ❌ Less QR-specific insights (no "scan rate" metric) - ---- - -## Maximizing ROI: Optimization Checklist - -Use this checklist after deploying QR codes to optimize performance: - -### Week 1: Monitor and Fix Issues -- [ ] Verify scans are being tracked correctly -- [ ] Check that landing page loads in under 3 seconds on mobile -- [ ] Test QR code scannability from 3 feet away -- [ ] Monitor for error messages or broken links - -### Week 2-4: Analyze Patterns -- [ ] Identify peak scanning times (day of week, time of day) -- [ ] Review device breakdown (iOS vs Android) -- [ ] Check geographic distribution (any unexpected markets?) -- [ ] Calculate conversion rate (scans → desired action) - -### Month 2: Optimize -- [ ] A/B test different QR code designs -- [ ] Test different calls-to-action -- [ ] Adjust landing page based on device data -- [ ] Set up retargeting for non-converters - -### Ongoing: Scale What Works -- [ ] Compare performance across different channels -- [ ] Allocate budget to highest-performing placements -- [ ] Create lookalike audiences from converters -- [ ] Document learnings for future campaigns - ---- - -## FAQ: QR Code Analytics - -### Can I track QR code scans without a paid platform? - -Yes. Use a free QR code generator that includes basic analytics, or add UTM parameters to your URL and track scans in Google Analytics (completely free). - -### Do I need a different QR code for each location/campaign? - -**Best practice:** Yes, use unique QR codes for each channel (e.g., one for Instagram, one for flyers, one for packaging). This lets you compare performance and see which channels drive the best results. - -**Alternative:** Use the same QR code but different UTM parameters. For example: -- Instagram: `yoursite.com/promo?utm_source=instagram` -- Flyers: `yoursite.com/promo?utm_source=flyers` - -Both methods work—unique QR codes are easier to manage in a dashboard, while UTM parameters are simpler if you've already printed the materials. - -### How long does analytics data take to appear? - -Most platforms show real-time data (within seconds to minutes). Google Analytics may take 24-48 hours for historical reports to populate, but the Realtime report shows scans immediately. - -### Can I track QR code scans offline? - -No. QR code analytics require an internet connection to record the scan. However, some advanced solutions use device fingerprinting to attribute offline actions (like in-store purchases) to QR code scans, but this requires complex integration with point-of-sale systems. - -### What's the difference between impressions and scans? - -- **Impressions** = How many people saw the QR code (estimated based on foot traffic, circulation, etc.) -- **Scans** = How many people actually scanned it - -**Example:** A poster in a subway station might have 10,000 impressions (people who walked by) but only 250 scans (2.5% scan rate). - -### Can QR code analytics track individual users across multiple scans? - -Some platforms use device fingerprinting or cookies to identify returning scanners, but this is less reliable on mobile devices (due to privacy settings). Most QR analytics count "unique scans" based on IP address + user agent, which gives a rough estimate but isn't 100% accurate. - ---- - -## Conclusion - -QR code analytics transforms guesswork into data-driven decision making. By tracking who scans your codes, when they scan, and what they do next, you gain the same insights as digital marketing campaigns—even for offline channels like print, packaging, and events. - -**Key takeaways:** -1. **Start with dynamic QR codes** to enable tracking and editing -2. **Add UTM parameters** to integrate with Google Analytics -3. **Focus on 5 key metrics:** Total vs unique scans, location, device type, time patterns, and conversions -4. **Run A/B tests** to optimize design and placement -5. **Use data to reallocate budget** to the highest-performing channels - -Whether you're managing a single QR code on your business card or tracking thousands across a national campaign, analytics gives you the visibility to optimize every scan. - -**Ready to start tracking?** Create your first dynamic QR code with built-in analytics and see the data in real-time. - ---- - -**Related Resources:** -- [Wikipedia: QR Code](https://en.wikipedia.org/wiki/QR_code) - Complete technical overview -- [Dynamic vs Static QR Codes](#) - Which type should you use? -- [Bulk QR Code Generation Guide](#) - Create hundreds of codes at once -- [Google Analytics 4 Setup Guide](https://support.google.com/analytics/answer/9304153) - Official documentation - -**Keywords:** qr code analytics, qr code tracking, track qr code scans, qr code statistics, qr analytics dashboard, dynamic qr code tracking, qr code campaign tracking, qr code metrics, qr code scan data, google analytics qr code +# QR Code Analytics: Track, Measure & Optimize Your Campaigns (2025 Guide) + +**Meta Description:** Learn how to track QR code scans with analytics dashboards. Monitor location, devices, and conversion rates to optimize your marketing campaigns with data-driven insights. + +**Reading Time:** 15 minutes +**Category:** Analytics +**Last Updated:** October 16, 2025 + +--- + +## Introduction + +Ever wondered who's scanning your [QR codes](https://en.wikipedia.org/wiki/QR_code), when they're scanning, and what they do after? QR code analytics turns these questions into actionable insights. + +Unlike traditional print marketing where you're "flying blind," QR code tracking gives you the same level of data you'd get from digital campaigns—location data, device types, peak scanning times, and conversion rates. + +**In this guide, you'll learn:** +- How to set up QR code tracking in 10 minutes +- The 5 most important metrics to monitor +- Real examples with actual campaign numbers +- How to connect QR codes to Google Analytics 4 +- Practical optimization strategies that increase scan rates + +Whether you're running a small event or managing hundreds of QR codes across multiple campaigns, this guide will help you make data-driven decisions. + +--- + +## What Are QR Code Analytics? + +QR code analytics track how people interact with your QR codes. When someone scans a QR code, analytics software records: + +- **When** they scanned (date, time, day of week) +- **Where** they scanned (country, city, GPS coordinates) +- **What device** they used (iPhone vs Android, browser type) +- **What they did next** (visited a page, made a purchase, downloaded a file) + +### Static vs Dynamic QR Codes: Why It Matters + +**Static QR codes** encode the destination URL directly into the image. They cannot track scans or be edited after printing. + +**Dynamic QR codes** contain a short redirect URL that points to your tracking server. This enables: +- ✅ Full analytics tracking +- ✅ URL editing without reprinting +- ✅ A/B testing different destinations +- ✅ Retargeting people who scanned but didn't convert + +**Example:** A restaurant prints 5,000 menus with QR codes linking to their Valentine's Day menu. With static codes, they'd need to reprint all 5,000 menus after February 14th. With dynamic codes, they simply update the URL to point to their spring menu—same QR code, new content. + +--- + +## How to Set Up QR Code Tracking (Step-by-Step) + +### Step 1: Create a Dynamic QR Code (2 minutes) + +Most QR code platforms (including free tiers) now offer dynamic codes with basic tracking: + +1. Go to your QR code generator +2. Select "Dynamic QR Code" +3. Enter your destination URL (e.g., `https://yoursite.com/promo`) +4. Download the QR code + +**Screenshot needed:** Dashboard showing "Create Dynamic QR Code" button and URL input field. + +### Step 2: Add UTM Parameters for Google Analytics (3 minutes) + +UTM parameters let you track QR code scans in Google Analytics alongside your other marketing channels. + +**Example URL structure:** +``` +https://yoursite.com/promo?utm_source=qr_code&utm_medium=print&utm_campaign=summer_sale_2025 +``` + +**UTM Parameter Guide:** +- `utm_source=qr_code` → Identifies traffic source +- `utm_medium=print` → Identifies the medium (print, packaging, business card) +- `utm_campaign=summer_sale_2025` → Identifies the specific campaign + +**Pro tip:** Use consistent naming conventions across all campaigns so you can compare performance. For example, always use `qr_code` (not "qr-code" or "QR_Code") for the source parameter. + +### Step 3: Place Your QR Code and Monitor Results (5 minutes setup) + +After deploying your QR code on posters, flyers, or product packaging, check your analytics dashboard daily for the first week to: + +- Verify scans are being tracked correctly +- Identify the first spike in activity +- Check that your landing page loads properly on mobile devices + +**Screenshot needed:** Analytics dashboard showing real-time scan map with pins for different geographic locations. + +### Step 4: Connect to Google Analytics 4 (Optional, 15 minutes) + +For advanced tracking, integrate QR code data with Google Analytics 4: + +**Quick Integration Guide:** + +1. **In Google Analytics 4:** + - Go to Admin → Data Streams → Your Website + - Copy your Measurement ID (format: `G-XXXXXXXXXX`) + +2. **Add GA4 to your landing page:** + ```html + + + + ``` + +3. **Test it:** + - Scan your QR code with your phone + - In GA4, go to Reports → Realtime + - You should see your scan appear as a live visitor + +**Screenshot needed:** Google Analytics 4 Realtime report showing QR code traffic with UTM parameters. + +--- + +## The 5 Most Important QR Code Metrics + +### 1. Total Scans vs Unique Scans + +**Total scans** = Every time someone scans the code +**Unique scans** = Number of individual people who scanned + +**Example from a real campaign:** +A tech conference printed QR codes on 500 badges. Analytics showed: +- **Total scans:** 1,247 +- **Unique scans:** 412 + +**Insight:** The average attendee scanned 3 times (likely checking the schedule multiple times). This is normal behavior—don't panic if total scans are higher than unique scans. + +**What's a good scan rate?** +It depends on placement, but here are industry benchmarks: +- **Product packaging:** 2-5% of products sold +- **Event posters:** 10-20% of attendees +- **Business cards:** 30-50% of cards handed out +- **Restaurant table tents:** 15-30% of diners + +### 2. Geographic Location + +See where in the world people are scanning your codes. + +**Real example:** +A fashion brand ran a billboard campaign in New York, Los Angeles, and Miami. Analytics revealed: +- **New York:** 892 scans, 8.2% conversion rate +- **Los Angeles:** 1,241 scans, 12.1% conversion rate +- **Miami:** 334 scans, 6.7% conversion rate + +**Action taken:** They doubled ad spend in LA and reduced spend in Miami based on conversion data, increasing overall ROI by 34%. + +**Screenshot needed:** Map visualization showing scan density by city with color-coded heat zones. + +### 3. Device and Operating System + +Knowing whether your audience uses iPhone or Android helps optimize the landing page experience. + +**Real example:** +A SaaS company discovered 78% of their QR code scans came from iOS devices, but their landing page loaded 3 seconds slower on iOS than Android. After fixing this iOS-specific bug, conversions increased by 41%. + +**What to track:** +- iOS vs Android split +- Browser types (Safari, Chrome, Samsung Internet) +- Screen sizes (for responsive design testing) + +### 4. Time Patterns (When Do People Scan?) + +Understanding peak scanning times helps you: +- Schedule related email campaigns +- Staff events appropriately +- Optimize ad spend timing + +**Real example:** +A gym placed QR codes on posters offering a "free week trial." Analytics showed: +- **Peak scanning times:** Monday 6-8 AM, Wednesday 5-7 PM, Saturday 9-11 AM +- **Lowest activity:** Friday evenings, Sunday mornings + +**Action taken:** They scheduled follow-up emails to arrive at 6 AM on Mondays and 5 PM on Wednesdays, when people were already thinking about the gym. This increased trial sign-ups by 28%. + +**Screenshot needed:** Line graph showing scan activity by hour of day and day of week. + +### 5. Conversion Tracking + +The most important metric: **What do people do after scanning?** + +Track downstream actions like: +- Form submissions +- Purchases +- App downloads +- Video views +- PDF downloads + +**Real example:** +An e-commerce brand placed QR codes on product packaging linking to a "Register for warranty" page: +- **Total scans:** 12,483 +- **Reached landing page:** 11,901 (95.3%) +- **Started registration:** 4,238 (35.6% of page visitors) +- **Completed registration:** 2,891 (68.2% of those who started) +- **Overall conversion rate:** 23.2% (from scan to completed registration) + +**Insights:** +- 582 people scanned but the page didn't load (4.7% bounce rate) → Investigate mobile page load speed +- 65% of people who started registration completed it → Registration flow is working well +- 64% of visitors left without starting registration → Test adding trust badges or simplifying the form + +--- + +## Advanced Analytics Strategies + +### A/B Testing QR Code Designs + +Test different designs to find what gets the most scans. + +**Real example:** +A real estate agent tested two QR code designs on "For Sale" signs: + +**Version A: Basic black-and-white QR code** +- Scans: 127 per sign (average) + +**Version B: Branded QR with logo and "Scan to Tour Home" text** +- Scans: 289 per sign (average) + +**Result:** Version B increased scans by 128%. The clear call-to-action and branding made the QR code more trustworthy and obvious. + +**What to test:** +- Color vs black-and-white +- With logo vs without +- Different calls-to-action ("Scan Me" vs "Get 20% Off" vs "View Menu") +- Size and placement on printed materials + +### Multi-Channel Attribution + +Use unique QR codes for each marketing channel to measure which channels perform best. + +**Real example:** +A coffee shop launched a loyalty program with QR codes in 4 locations: + +| Channel | Scans | Sign-ups | Conversion Rate | Cost per Sign-up | +|---------|-------|----------|-----------------|------------------| +| Table tents (in-store) | 1,834 | 423 | 23.1% | $0.12 | +| Direct mail postcards | 892 | 178 | 20.0% | $2.40 | +| Instagram ads | 2,441 | 312 | 12.8% | $1.15 | +| Flyers (street distribution) | 523 | 41 | 7.8% | $0.95 | + +**Insights:** +- Table tents had the highest conversion rate AND lowest cost per sign-up +- Instagram drove the most scans but had lower conversion (maybe wrong audience?) +- Direct mail had good conversion but high cost (postage) + +**Action taken:** They doubled the number of table tents and reduced street flyer distribution. + +### Retargeting Based on Scan Behavior + +People who scan but don't convert are warm leads—they're interested but not ready yet. + +**How to retarget QR code scanners:** + +1. **Pixel-based retargeting:** Add a Facebook/Meta Pixel or Google Ads tag to your QR landing page +2. **Create custom audiences:** Target people who visited the page but didn't complete the action +3. **Serve relevant ads:** Show them ads reminding them of the offer + +**Real example:** +An online course creator put QR codes in a printed magazine ad. Of 1,456 scans: +- 412 signed up for the free course (28.3%) +- 1,044 visited the page but didn't sign up (71.7%) + +They retargeted the 1,044 non-converters with Facebook ads highlighting student success stories. This recovered an additional 187 sign-ups (17.9% of the retargeted group), increasing total conversions by 45%. + +--- + +## Common Use Cases with Real Data + +### Use Case 1: Event Check-In and Engagement + +**Scenario:** A 3-day tech conference with 2,000 attendees. + +**QR code deployment:** +- QR codes on badges (access session materials) +- QR codes on session room posters (rate the session) +- QR codes at sponsor booths (collect contact info) + +**Results:** +- **Badge QR scans:** 4,892 total scans (avg 2.4 scans per attendee) +- **Session ratings:** 1,234 ratings submitted (helps plan next year's agenda) +- **Sponsor leads:** 856 contact forms submitted + +**Insight:** Session rating QR codes on posters got 3x more engagement than asking people to visit a website. The convenience of QR codes reduced friction. + +### Use Case 2: Product Packaging Analytics + +**Scenario:** A supplement brand adds QR codes to 50,000 bottles linking to dosage instructions and recipes. + +**Results after 3 months:** +- **Total scans:** 8,234 (16.5% of bottles sold) +- **Peak scanning time:** Within 3 days of purchase +- **Top pages visited:** "How to Use," "Recipes," "Re-order" +- **Direct re-orders from QR code:** 412 ($14,824 in revenue) + +**Insight:** QR codes on packaging create a direct channel for repeat purchases and customer education, reducing support tickets by 22%. + +### Use Case 3: Restaurant Menu QR Codes + +**Scenario:** A restaurant replaces printed menus with QR codes on tables (post-COVID trend). + +**Results over 1 month:** +- **Total scans:** 6,789 +- **Unique visitors:** 4,521 +- **Average session duration:** 3 min 42 sec +- **Most viewed page:** Dessert menu (customers browse while eating) + +**Unexpected insight:** 34% of scans happened outside restaurant hours (people looking up the menu before visiting). The restaurant added an "Order Takeout" button to capture this traffic. + +### Use Case 4: Print Ad Campaign Tracking + +**Scenario:** A car dealership runs full-page ads in 3 regional magazines. + +**Results:** + +| Magazine | Print Run | Est. Readers | QR Scans | Scan Rate | Test Drives Booked | Cost per Test Drive | +|----------|-----------|--------------|----------|-----------|---------------------|---------------------| +| Magazine A | 50,000 | 150,000 | 324 | 0.22% | 28 | $89 | +| Magazine B | 30,000 | 90,000 | 147 | 0.16% | 11 | $136 | +| Magazine C | 80,000 | 240,000 | 892 | 0.37% | 67 | $45 | + +**Action taken:** They reallocated budget to Magazine C for the next quarter, reducing cost per test drive by 49% overall. + +--- + +## Privacy and Security Considerations + +### GDPR and Data Privacy + +When tracking QR code scans in Europe (or from EU citizens), you must comply with [GDPR regulations](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation): + +**What you MUST do:** +- ✅ Disclose data collection in your privacy policy +- ✅ Get consent before collecting personal data (email, name, etc.) +- ✅ Allow users to request data deletion +- ✅ Secure data with encryption + +**What analytics data is typically collected (without personal info):** +- Timestamp of scan +- Country/city (from IP address, not GPS) +- Device type and browser +- Number of scans per code + +**Note:** Most QR analytics platforms (including free ones) collect this data anonymously without requiring user consent, similar to website analytics. However, if you ask users to fill out a form after scanning, you need explicit consent to store that data. + +### Protecting Against Malicious QR Codes + +**For marketers:** Make sure your QR codes link to HTTPS (secure) URLs to build trust. + +**For users:** Be cautious scanning QR codes in public places. Check the URL preview before visiting the site (most modern phones show the URL before opening it). + +--- + +## Troubleshooting: Why Your QR Code Analytics Aren't Working + +### Problem 1: "I'm not seeing any scan data" + +**Possible causes:** +- ✅ Make sure you created a **dynamic QR code**, not a static one +- ✅ Check that your analytics dashboard is connected to the correct QR code +- ✅ Verify the QR code redirects properly (test it yourself with your phone) +- ✅ Wait at least 24 hours—some platforms have a delay in reporting + +### Problem 2: "Scan counts seem too high" + +**Explanation:** QR analytics often count "total scans" rather than "unique scans." If someone scans the same code 5 times, it shows as 5 scans. + +**Solution:** Look for "unique scans" or "unique visitors" metric instead. + +### Problem 3: "Google Analytics isn't showing QR code traffic" + +**Checklist:** +- ✅ Did you add UTM parameters to your URL? +- ✅ Is Google Analytics installed on the landing page? +- ✅ Check GA4 Realtime report—scan your code and see if it appears +- ✅ Wait 24-48 hours for data to populate in historical reports + +### Problem 4: "Location data is inaccurate" + +**Explanation:** QR analytics estimate location from IP addresses, which aren't always precise. A scan might show up in a nearby city or even the wrong state if the user is on a VPN or corporate network. + +**Solution:** Use location data for general trends (e.g., "Most scans from California") rather than exact addresses. + +--- + +## Tools and Platforms Comparison + +### Free QR Code Analytics Tools + +Most free QR code generators now include basic analytics: + +**Typical free plan features:** +- ✅ Total scans +- ✅ Country-level location +- ✅ Device type (iOS vs Android) +- ✅ Scan timeline (daily/weekly graphs) +- ❌ Unlimited QR codes (usually 3-10 codes) +- ❌ Advanced features (retargeting pixels, A/B testing, team access) + +**Best for:** Small businesses, personal projects, testing QR codes before scaling + +### Paid QR Code Analytics Platforms + +**Typical paid plan features ($10-50/month):** +- ✅ Unlimited QR codes +- ✅ City-level location data +- ✅ Browser and device details +- ✅ Bulk creation (upload CSV with 100s of URLs) +- ✅ Custom domains (use your own short URL) +- ✅ Team collaboration +- ✅ Retargeting pixel integration +- ✅ API access for automation + +**Best for:** Marketing agencies, e-commerce brands, event organizers + +### Using Google Analytics for QR Tracking (Free) + +You don't need a paid QR platform if you already use Google Analytics—just add UTM parameters to your URLs. + +**Pros:** +- ✅ Completely free +- ✅ Integrates with your existing analytics +- ✅ Unlimited QR codes + +**Cons:** +- ❌ No built-in QR code generator (you'll need a separate tool) +- ❌ Can't edit the URL after printing (unless you use a separate URL shortener) +- ❌ Less QR-specific insights (no "scan rate" metric) + +--- + +## Maximizing ROI: Optimization Checklist + +Use this checklist after deploying QR codes to optimize performance: + +### Week 1: Monitor and Fix Issues +- [ ] Verify scans are being tracked correctly +- [ ] Check that landing page loads in under 3 seconds on mobile +- [ ] Test QR code scannability from 3 feet away +- [ ] Monitor for error messages or broken links + +### Week 2-4: Analyze Patterns +- [ ] Identify peak scanning times (day of week, time of day) +- [ ] Review device breakdown (iOS vs Android) +- [ ] Check geographic distribution (any unexpected markets?) +- [ ] Calculate conversion rate (scans → desired action) + +### Month 2: Optimize +- [ ] A/B test different QR code designs +- [ ] Test different calls-to-action +- [ ] Adjust landing page based on device data +- [ ] Set up retargeting for non-converters + +### Ongoing: Scale What Works +- [ ] Compare performance across different channels +- [ ] Allocate budget to highest-performing placements +- [ ] Create lookalike audiences from converters +- [ ] Document learnings for future campaigns + +--- + +## FAQ: QR Code Analytics + +### Can I track QR code scans without a paid platform? + +Yes. Use a free QR code generator that includes basic analytics, or add UTM parameters to your URL and track scans in Google Analytics (completely free). + +### Do I need a different QR code for each location/campaign? + +**Best practice:** Yes, use unique QR codes for each channel (e.g., one for Instagram, one for flyers, one for packaging). This lets you compare performance and see which channels drive the best results. + +**Alternative:** Use the same QR code but different UTM parameters. For example: +- Instagram: `yoursite.com/promo?utm_source=instagram` +- Flyers: `yoursite.com/promo?utm_source=flyers` + +Both methods work—unique QR codes are easier to manage in a dashboard, while UTM parameters are simpler if you've already printed the materials. + +### How long does analytics data take to appear? + +Most platforms show real-time data (within seconds to minutes). Google Analytics may take 24-48 hours for historical reports to populate, but the Realtime report shows scans immediately. + +### Can I track QR code scans offline? + +No. QR code analytics require an internet connection to record the scan. However, some advanced solutions use device fingerprinting to attribute offline actions (like in-store purchases) to QR code scans, but this requires complex integration with point-of-sale systems. + +### What's the difference between impressions and scans? + +- **Impressions** = How many people saw the QR code (estimated based on foot traffic, circulation, etc.) +- **Scans** = How many people actually scanned it + +**Example:** A poster in a subway station might have 10,000 impressions (people who walked by) but only 250 scans (2.5% scan rate). + +### Can QR code analytics track individual users across multiple scans? + +Some platforms use device fingerprinting or cookies to identify returning scanners, but this is less reliable on mobile devices (due to privacy settings). Most QR analytics count "unique scans" based on IP address + user agent, which gives a rough estimate but isn't 100% accurate. + +--- + +## Conclusion + +QR code analytics transforms guesswork into data-driven decision making. By tracking who scans your codes, when they scan, and what they do next, you gain the same insights as digital marketing campaigns—even for offline channels like print, packaging, and events. + +**Key takeaways:** +1. **Start with dynamic QR codes** to enable tracking and editing +2. **Add UTM parameters** to integrate with Google Analytics +3. **Focus on 5 key metrics:** Total vs unique scans, location, device type, time patterns, and conversions +4. **Run A/B tests** to optimize design and placement +5. **Use data to reallocate budget** to the highest-performing channels + +Whether you're managing a single QR code on your business card or tracking thousands across a national campaign, analytics gives you the visibility to optimize every scan. + +**Ready to start tracking?** Create your first dynamic QR code with built-in analytics and see the data in real-time. + +--- + +**Related Resources:** +- [Wikipedia: QR Code](https://en.wikipedia.org/wiki/QR_code) - Complete technical overview +- [Dynamic vs Static QR Codes](#) - Which type should you use? +- [Bulk QR Code Generation Guide](#) - Create hundreds of codes at once +- [Google Analytics 4 Setup Guide](https://support.google.com/analytics/answer/9304153) - Official documentation + +**Keywords:** qr code analytics, qr code tracking, track qr code scans, qr code statistics, qr analytics dashboard, dynamic qr code tracking, qr code campaign tracking, qr code metrics, qr code scan data, google analytics qr code diff --git a/dev-server.js b/dev-server.js index 5911f99..6a70c1a 100644 --- a/dev-server.js +++ b/dev-server.js @@ -1,12 +1,12 @@ -const { spawn } = require('child_process'); - -// Start Next.js dev server with explicit hostname -const next = spawn('next', ['dev', '-p', '3050', '-H', '0.0.0.0'], { - stdio: 'inherit', - shell: true, - env: { ...process.env, HOSTNAME: '0.0.0.0' } -}); - -next.on('close', (code) => { - process.exit(code); -}); +const { spawn } = require('child_process'); + +// Start Next.js dev server with explicit hostname +const next = spawn('next', ['dev', '-p', '3050', '-H', '0.0.0.0'], { + stdio: 'inherit', + shell: true, + env: { ...process.env, HOSTNAME: '0.0.0.0' } +}); + +next.on('close', (code) => { + process.exit(code); +}); diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml index 1de3e58..ad1e559 100644 --- a/docker-compose.dev.yml +++ b/docker-compose.dev.yml @@ -1,66 +1,66 @@ -services: - # PostgreSQL Database - db: - image: postgres:16-alpine - container_name: qrmaster-db-dev - restart: unless-stopped - environment: - POSTGRES_USER: ${POSTGRES_USER} - POSTGRES_PASSWORD: ${POSTGRES_PASSWORD} - POSTGRES_DB: ${POSTGRES_DB} - POSTGRES_INITDB_ARGS: "-E UTF8 --locale=en_US.utf8" - ports: - - "5435:5432" - volumes: - - dbdata_dev:/var/lib/postgresql/data - - ./docker/init-db.sh:/docker-entrypoint-initdb.d/init-db.sh - healthcheck: - test: [ "CMD-SHELL", "pg_isready -U postgres -d qrmaster" ] - interval: 5s - timeout: 5s - retries: 10 - networks: - - qrmaster-network - - # Redis Cache - redis: - image: redis:7-alpine - container_name: qrmaster-redis-dev - restart: unless-stopped - command: redis-server --appendonly yes --maxmemory 256mb --maxmemory-policy allkeys-lru - ports: - - "6379:6379" - volumes: - - redisdata_dev:/data - healthcheck: - test: [ "CMD", "redis-cli", "ping" ] - interval: 5s - timeout: 3s - retries: 5 - networks: - - qrmaster-network - - # Adminer - Database Management UI - adminer: - image: adminer:latest - container_name: qrmaster-adminer-dev - restart: unless-stopped - ports: - - "8081:8080" - environment: - ADMINER_DEFAULT_SERVER: db - ADMINER_DESIGN: pepa-linha - depends_on: - - db - networks: - - qrmaster-network - -volumes: - dbdata_dev: - driver: local - redisdata_dev: - driver: local - -networks: - qrmaster-network: - driver: bridge +services: + # PostgreSQL Database + db: + image: postgres:16-alpine + container_name: qrmaster-db-dev + restart: unless-stopped + environment: + POSTGRES_USER: ${POSTGRES_USER} + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD} + POSTGRES_DB: ${POSTGRES_DB} + POSTGRES_INITDB_ARGS: "-E UTF8 --locale=en_US.utf8" + ports: + - "5435:5432" + volumes: + - dbdata_dev:/var/lib/postgresql/data + - ./docker/init-db.sh:/docker-entrypoint-initdb.d/init-db.sh + healthcheck: + test: [ "CMD-SHELL", "pg_isready -U postgres -d qrmaster" ] + interval: 5s + timeout: 5s + retries: 10 + networks: + - qrmaster-network + + # Redis Cache + redis: + image: redis:7-alpine + container_name: qrmaster-redis-dev + restart: unless-stopped + command: redis-server --appendonly yes --maxmemory 256mb --maxmemory-policy allkeys-lru + ports: + - "6379:6379" + volumes: + - redisdata_dev:/data + healthcheck: + test: [ "CMD", "redis-cli", "ping" ] + interval: 5s + timeout: 3s + retries: 5 + networks: + - qrmaster-network + + # Adminer - Database Management UI + adminer: + image: adminer:latest + container_name: qrmaster-adminer-dev + restart: unless-stopped + ports: + - "8081:8080" + environment: + ADMINER_DEFAULT_SERVER: db + ADMINER_DESIGN: pepa-linha + depends_on: + - db + networks: + - qrmaster-network + +volumes: + dbdata_dev: + driver: local + redisdata_dev: + driver: local + +networks: + qrmaster-network: + driver: bridge diff --git a/docker/README.md b/docker/README.md index 94fb860..b611c3b 100644 --- a/docker/README.md +++ b/docker/README.md @@ -1,276 +1,276 @@ -# Docker Setup for QR Master - -This directory contains Docker configuration files for running QR Master with PostgreSQL database. - -## 🚀 Quick Start - -### Development (Database Only) - -For local development where you run Next.js on your host machine: - -```bash -# Start PostgreSQL and Redis -docker-compose -f docker-compose.dev.yml up -d - -# Run database migrations -npm run db:migrate - -# Start the development server -npm run dev -``` - -Access: -- **Application**: http://localhost:3050 -- **Database**: localhost:5432 -- **Redis**: localhost:6379 -- **Adminer (DB UI)**: http://localhost:8080 - -### Production (Full Stack) - -To run the entire application in Docker: - -```bash -# Build and start all services -docker-compose up -d --build - -# Run database migrations -docker-compose exec web npx prisma migrate deploy - -# (Optional) Seed the database -docker-compose exec web npm run db:seed -``` - -Access: -- **Application**: http://localhost:3050 -- **Database**: localhost:5432 -- **Redis**: localhost:6379 -- **Adminer (DB UI)**: http://localhost:8080 (only with --profile dev) - -To include Adminer in production mode: -```bash -docker-compose --profile dev up -d -``` - -## 📦 Services - -### PostgreSQL (db) -- **Image**: postgres:16-alpine -- **Port**: 5432 -- **Database**: qrmaster -- **User**: postgres -- **Password**: postgres (change in production!) - -### Redis (redis) -- **Image**: redis:7-alpine -- **Port**: 6379 -- **Max Memory**: 256MB with LRU eviction policy -- **Persistence**: AOF enabled - -### Next.js Application (web) -- **Port**: 3050 -- **Environment**: Production -- **Health Check**: HTTP GET on localhost:3050 - -### Adminer (adminer) -- **Image**: adminer:latest -- **Port**: 8080 -- **Purpose**: Database management UI -- **Profile**: dev (optional in production) - -## 🗄️ Database Management - -### Migrations - -```bash -# Create a new migration -npm run db:migrate - -# Deploy migrations in Docker -docker-compose exec web npx prisma migrate deploy - -# Reset database (caution!) -docker-compose exec web npx prisma migrate reset -``` - -### Prisma Studio - -```bash -# On host machine -npm run db:studio - -# Or in Docker -docker-compose exec web npx prisma studio -``` - -### Backup and Restore - -```bash -# Backup -docker-compose exec db pg_dump -U postgres qrmaster > backup.sql - -# Restore -docker-compose exec -T db psql -U postgres qrmaster < backup.sql -``` - -## 🔧 Useful Commands - -### View Logs - -```bash -# All services -docker-compose logs -f - -# Specific service -docker-compose logs -f web -docker-compose logs -f db -docker-compose logs -f redis -``` - -### Shell Access - -```bash -# Next.js container -docker-compose exec web sh - -# PostgreSQL container -docker-compose exec db psql -U postgres -d qrmaster - -# Redis container -docker-compose exec redis redis-cli -``` - -### Stop and Clean - -```bash -# Stop all services -docker-compose down - -# Stop and remove volumes (deletes data!) -docker-compose down -v - -# Stop and remove everything including images -docker-compose down -v --rmi all -``` - -## 🔐 Environment Variables - -Create a `.env` file in the root directory (copy from `env.example`): - -```bash -cp env.example .env -``` - -Required variables: -- `DATABASE_URL`: PostgreSQL connection string -- `NEXTAUTH_SECRET`: Secret for NextAuth.js -- `NEXTAUTH_URL`: Application URL -- `IP_SALT`: Salt for hashing IP addresses -- `REDIS_URL`: Redis connection string - -## 🌐 Network Architecture - -All services run on a custom bridge network `qrmaster-network` which allows: -- Service discovery by container name -- Network isolation from other Docker projects -- Internal DNS resolution - -## 📊 Volumes - -### Persistent Data -- `dbdata`: PostgreSQL data -- `redisdata`: Redis data - -### Volume Management - -```bash -# List volumes -docker volume ls - -# Inspect volume -docker volume inspect qrmaster_dbdata - -# Remove all unused volumes -docker volume prune -``` - -## 🐛 Troubleshooting - -### Database Connection Issues - -```bash -# Check if database is ready -docker-compose exec db pg_isready -U postgres - -# Check database logs -docker-compose logs db - -# Restart database -docker-compose restart db -``` - -### Application Won't Start - -```bash -# Check health status -docker-compose ps - -# View application logs -docker-compose logs web - -# Rebuild the application -docker-compose up -d --build web -``` - -### Port Already in Use - -If ports 3050, 5432, 6379, or 8080 are already in use: - -```bash -# Find process using port -# Windows -netstat -ano | findstr :3050 - -# Linux/Mac -lsof -i :3050 - -# Kill process or change port in docker-compose.yml -``` - -## 🔄 Updates and Maintenance - -### Update Dependencies - -```bash -# Update Node packages -npm update - -# Rebuild Docker images -docker-compose build --no-cache -``` - -### Update Docker Images - -```bash -# Pull latest images -docker-compose pull - -# Restart with new images -docker-compose up -d -``` - -## 📝 Notes - -- **Development**: Use `docker-compose.dev.yml` to run only the database and Redis -- **Production**: Use `docker-compose.yml` to run the full stack -- **Security**: Always change default passwords in production -- **Backups**: Implement regular database backups in production -- **Scaling**: For production, consider using PostgreSQL replication and Redis Sentinel - -## 🆘 Support - -For more information, see: -- [Docker Documentation](https://docs.docker.com/) -- [PostgreSQL Documentation](https://www.postgresql.org/docs/) -- [Prisma Documentation](https://www.prisma.io/docs/) -- [Next.js Documentation](https://nextjs.org/docs) - +# Docker Setup for QR Master + +This directory contains Docker configuration files for running QR Master with PostgreSQL database. + +## 🚀 Quick Start + +### Development (Database Only) + +For local development where you run Next.js on your host machine: + +```bash +# Start PostgreSQL and Redis +docker-compose -f docker-compose.dev.yml up -d + +# Run database migrations +npm run db:migrate + +# Start the development server +npm run dev +``` + +Access: +- **Application**: http://localhost:3050 +- **Database**: localhost:5432 +- **Redis**: localhost:6379 +- **Adminer (DB UI)**: http://localhost:8080 + +### Production (Full Stack) + +To run the entire application in Docker: + +```bash +# Build and start all services +docker-compose up -d --build + +# Run database migrations +docker-compose exec web npx prisma migrate deploy + +# (Optional) Seed the database +docker-compose exec web npm run db:seed +``` + +Access: +- **Application**: http://localhost:3050 +- **Database**: localhost:5432 +- **Redis**: localhost:6379 +- **Adminer (DB UI)**: http://localhost:8080 (only with --profile dev) + +To include Adminer in production mode: +```bash +docker-compose --profile dev up -d +``` + +## 📦 Services + +### PostgreSQL (db) +- **Image**: postgres:16-alpine +- **Port**: 5432 +- **Database**: qrmaster +- **User**: postgres +- **Password**: postgres (change in production!) + +### Redis (redis) +- **Image**: redis:7-alpine +- **Port**: 6379 +- **Max Memory**: 256MB with LRU eviction policy +- **Persistence**: AOF enabled + +### Next.js Application (web) +- **Port**: 3050 +- **Environment**: Production +- **Health Check**: HTTP GET on localhost:3050 + +### Adminer (adminer) +- **Image**: adminer:latest +- **Port**: 8080 +- **Purpose**: Database management UI +- **Profile**: dev (optional in production) + +## 🗄️ Database Management + +### Migrations + +```bash +# Create a new migration +npm run db:migrate + +# Deploy migrations in Docker +docker-compose exec web npx prisma migrate deploy + +# Reset database (caution!) +docker-compose exec web npx prisma migrate reset +``` + +### Prisma Studio + +```bash +# On host machine +npm run db:studio + +# Or in Docker +docker-compose exec web npx prisma studio +``` + +### Backup and Restore + +```bash +# Backup +docker-compose exec db pg_dump -U postgres qrmaster > backup.sql + +# Restore +docker-compose exec -T db psql -U postgres qrmaster < backup.sql +``` + +## 🔧 Useful Commands + +### View Logs + +```bash +# All services +docker-compose logs -f + +# Specific service +docker-compose logs -f web +docker-compose logs -f db +docker-compose logs -f redis +``` + +### Shell Access + +```bash +# Next.js container +docker-compose exec web sh + +# PostgreSQL container +docker-compose exec db psql -U postgres -d qrmaster + +# Redis container +docker-compose exec redis redis-cli +``` + +### Stop and Clean + +```bash +# Stop all services +docker-compose down + +# Stop and remove volumes (deletes data!) +docker-compose down -v + +# Stop and remove everything including images +docker-compose down -v --rmi all +``` + +## 🔐 Environment Variables + +Create a `.env` file in the root directory (copy from `env.example`): + +```bash +cp env.example .env +``` + +Required variables: +- `DATABASE_URL`: PostgreSQL connection string +- `NEXTAUTH_SECRET`: Secret for NextAuth.js +- `NEXTAUTH_URL`: Application URL +- `IP_SALT`: Salt for hashing IP addresses +- `REDIS_URL`: Redis connection string + +## 🌐 Network Architecture + +All services run on a custom bridge network `qrmaster-network` which allows: +- Service discovery by container name +- Network isolation from other Docker projects +- Internal DNS resolution + +## 📊 Volumes + +### Persistent Data +- `dbdata`: PostgreSQL data +- `redisdata`: Redis data + +### Volume Management + +```bash +# List volumes +docker volume ls + +# Inspect volume +docker volume inspect qrmaster_dbdata + +# Remove all unused volumes +docker volume prune +``` + +## 🐛 Troubleshooting + +### Database Connection Issues + +```bash +# Check if database is ready +docker-compose exec db pg_isready -U postgres + +# Check database logs +docker-compose logs db + +# Restart database +docker-compose restart db +``` + +### Application Won't Start + +```bash +# Check health status +docker-compose ps + +# View application logs +docker-compose logs web + +# Rebuild the application +docker-compose up -d --build web +``` + +### Port Already in Use + +If ports 3050, 5432, 6379, or 8080 are already in use: + +```bash +# Find process using port +# Windows +netstat -ano | findstr :3050 + +# Linux/Mac +lsof -i :3050 + +# Kill process or change port in docker-compose.yml +``` + +## 🔄 Updates and Maintenance + +### Update Dependencies + +```bash +# Update Node packages +npm update + +# Rebuild Docker images +docker-compose build --no-cache +``` + +### Update Docker Images + +```bash +# Pull latest images +docker-compose pull + +# Restart with new images +docker-compose up -d +``` + +## 📝 Notes + +- **Development**: Use `docker-compose.dev.yml` to run only the database and Redis +- **Production**: Use `docker-compose.yml` to run the full stack +- **Security**: Always change default passwords in production +- **Backups**: Implement regular database backups in production +- **Scaling**: For production, consider using PostgreSQL replication and Redis Sentinel + +## 🆘 Support + +For more information, see: +- [Docker Documentation](https://docs.docker.com/) +- [PostgreSQL Documentation](https://www.postgresql.org/docs/) +- [Prisma Documentation](https://www.prisma.io/docs/) +- [Next.js Documentation](https://nextjs.org/docs) + diff --git a/docker/init-db.sh b/docker/init-db.sh index 0c863d2..57f56a8 100644 --- a/docker/init-db.sh +++ b/docker/init-db.sh @@ -1,26 +1,26 @@ -#!/bin/bash -set -e - -# This script runs when the PostgreSQL container is first created -# It ensures the database is properly initialized - -echo "🚀 Initializing QR Master database..." - -# Create the database if it doesn't exist (already created by POSTGRES_DB) -psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL - -- Enable required extensions - CREATE EXTENSION IF NOT EXISTS "uuid-ossp"; - CREATE EXTENSION IF NOT EXISTS "pg_trgm"; - - -- Grant privileges - GRANT ALL PRIVILEGES ON DATABASE qrmaster TO postgres; - - -- Set timezone - ALTER DATABASE qrmaster SET timezone TO 'UTC'; -EOSQL - -echo "✅ Database initialization complete!" -echo "📊 Database: $POSTGRES_DB" -echo "👤 User: $POSTGRES_USER" -echo "🌐 Ready to accept connections on port 5432" - +#!/bin/bash +set -e + +# This script runs when the PostgreSQL container is first created +# It ensures the database is properly initialized + +echo "🚀 Initializing QR Master database..." + +# Create the database if it doesn't exist (already created by POSTGRES_DB) +psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL + -- Enable required extensions + CREATE EXTENSION IF NOT EXISTS "uuid-ossp"; + CREATE EXTENSION IF NOT EXISTS "pg_trgm"; + + -- Grant privileges + GRANT ALL PRIVILEGES ON DATABASE qrmaster TO postgres; + + -- Set timezone + ALTER DATABASE qrmaster SET timezone TO 'UTC'; +EOSQL + +echo "✅ Database initialization complete!" +echo "📊 Database: $POSTGRES_DB" +echo "👤 User: $POSTGRES_USER" +echo "🌐 Ready to accept connections on port 5432" + diff --git a/env.example b/env.example index 5111f46..3cb7083 100644 --- a/env.example +++ b/env.example @@ -1,50 +1,50 @@ -# Environment Configuration -NODE_ENV=development -PORT=3000 - -# Database Configuration (PostgreSQL) -POSTGRES_USER=postgres -POSTGRES_PASSWORD=postgres -POSTGRES_DB=qrmaster - -# For local development (without Docker): -# DATABASE_URL=postgresql://postgres:postgres@localhost:5435/qrmaster?schema=public -# For Docker Compose (internal Docker network): -DATABASE_URL=postgresql://postgres:postgres@db:5432/qrmaster?schema=public - -# NextAuth Configuration -NEXTAUTH_URL=http://localhost:3050 -NEXTAUTH_SECRET=your-secret-key-here-change-in-production - -# OAuth Providers (Optional) -GOOGLE_CLIENT_ID= -GOOGLE_CLIENT_SECRET= - -# Redis Configuration (Optional - for rate limiting and caching) -REDIS_URL=redis://redis:6379 - -# Security -# Used for hashing IP addresses in analytics -IP_SALT=your-ip-salt-here-change-in-production - -# Features -ENABLE_DEMO=false - -# SEO Configuration -# Set to 'true' in production to allow search engine indexing -NEXT_PUBLIC_INDEXABLE=true - -# Stripe Payment Configuration (Optional - for subscription payments) -# Get your keys from: https://dashboard.stripe.com/apikeys -STRIPE_SECRET_KEY= -STRIPE_WEBHOOK_SECRET= -NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY= - -# Stripe Price IDs (create these in your Stripe dashboard) -# NEXT_PUBLIC_STRIPE_FREE_PRICE_ID=price_xxx -# NEXT_PUBLIC_STRIPE_PRO_PRICE_ID=price_xxx -# NEXT_PUBLIC_STRIPE_BUSINESS_PRICE_ID=price_xxx - -# Analytics (Optional - PostHog) -NEXT_PUBLIC_POSTHOG_KEY= -NEXT_PUBLIC_POSTHOG_HOST=https://app.posthog.com +# Environment Configuration +NODE_ENV=development +PORT=3000 + +# Database Configuration (PostgreSQL) +POSTGRES_USER=postgres +POSTGRES_PASSWORD=postgres +POSTGRES_DB=qrmaster + +# For local development (without Docker): +# DATABASE_URL=postgresql://postgres:postgres@localhost:5435/qrmaster?schema=public +# For Docker Compose (internal Docker network): +DATABASE_URL=postgresql://postgres:postgres@db:5432/qrmaster?schema=public + +# NextAuth Configuration +NEXTAUTH_URL=http://localhost:3050 +NEXTAUTH_SECRET=your-secret-key-here-change-in-production + +# OAuth Providers (Optional) +GOOGLE_CLIENT_ID= +GOOGLE_CLIENT_SECRET= + +# Redis Configuration (Optional - for rate limiting and caching) +REDIS_URL=redis://redis:6379 + +# Security +# Used for hashing IP addresses in analytics +IP_SALT=your-ip-salt-here-change-in-production + +# Features +ENABLE_DEMO=false + +# SEO Configuration +# Set to 'true' in production to allow search engine indexing +NEXT_PUBLIC_INDEXABLE=true + +# Stripe Payment Configuration (Optional - for subscription payments) +# Get your keys from: https://dashboard.stripe.com/apikeys +STRIPE_SECRET_KEY= +STRIPE_WEBHOOK_SECRET= +NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY= + +# Stripe Price IDs (create these in your Stripe dashboard) +# NEXT_PUBLIC_STRIPE_FREE_PRICE_ID=price_xxx +# NEXT_PUBLIC_STRIPE_PRO_PRICE_ID=price_xxx +# NEXT_PUBLIC_STRIPE_BUSINESS_PRICE_ID=price_xxx + +# Analytics (Optional - PostHog) +NEXT_PUBLIC_POSTHOG_KEY= +NEXT_PUBLIC_POSTHOG_HOST=https://app.posthog.com diff --git a/implementations_idee.md b/implementations_idee.md index 5d85981..076633d 100644 --- a/implementations_idee.md +++ b/implementations_idee.md @@ -1,127 +1,127 @@ -# QR Master: The Growth Masterpiece -## Implementations-Idee (Integrated Strategy V1.1) - -## Executive Summary -Dieses Dokument integriert Conversion-, Copywriting- und Content-Strategie, um QR Master von einem simplen Utility-Tool zu einer Vertical Operations Platform zu entwickeln. - -**Kernthese:** Wir gewinnen nicht durch einen "besseren" Generator, sondern als die **einzige Versicherung gegen physische Marketingverschwendung**. - -## 1. Conversion Architecture (CRO) -### 1.1 Ziel -Die Value Gap schliessen: Nutzer verstehen den Wert von **Dynamic QR Codes** oft erst *nach* dem Druckfehler. - -### 1.2 Funnel-Diagnose & Leak -Aktuelles Problem: -1. Nutzer suchen nach `free qr code generator` (High Volume). -2. Erstellen statischen Code & laden PNG herunter. -3. Drucken Material. -4. Link ändert sich -> Code tot -> Frust & Churn. - -### 1.3 Safety Intercept (Pre-Download Modal) -**Hypothese:** Ein "Angst-basiertes" Intercept vor dem Download konvertiert Free-User zu Dynamic-Usern, indem es das Risiko von statischen Codes aufzeigt. - -**Trigger:** Klick auf `Download PNG` / `Download SVG` bei statischem Code. - -**Modal-Inhalt (Optimiert):** -- **Headline:** `Wait! You are creating a Permanent, Static Code.` -- **Body:** `Once printed, this code cannot be changed. If your link breaks, your flyers are trash. 80% of businesses switch to a **Dynamic QR Code Generator** to stay safe.` -- **CTA Primary:** `Yes, make it Editable (Free Dynamic)` -- **CTA Secondary:** `No, I risk the Static Code` - -### 1.4 Experiment-Setup (A/B Test) -- **Control:** Direkter Download. -- **Variant:** Safety Intercept Modal. -- **Primary KPI:** `intercept_upgrade_rate` (Ziel: >15%). - ---- - -## 2. Direct Response Copywriting (Real Estate Vertical) -Fokus auf das Keyword Cluster: `qr codes for business` und `real estate qr codes`. - -### 2.1 Zielseite: `/solutions/real-estate` -**Hero Section (SEO & Conversion Optimized):** -- **H1 (SEO):** `Real Estate QR Code Generator: The "Forever Code" for Agents` -- **Subhead:** `Sold the listing? Don't trash the flyers. Just reroute your **Dynamic QR Code** to the next property in 1 click.` -- **CTA:** `Create Free Real Estate QR Code` -- **Micro-Copy:** `Works with Canva & Zillow. Trusted by top agents.` - -### 2.2 Nurture Bridge Email Sequence -**Trigger:** Download `Real Estate Toolkit`. - -**Email 1 (The Hook):** -- **Subject:** `Your "Forever Flyer" Templates are here` -- **Body:** "Stop printing single-use codes. Use this template with a **Dynamic QR Code** that you recycle for every open house." - -**Email 2 (The Fear):** -- **Subject:** `The $300 mistake 90% of agents make` -- **Body:** Story über 500 weggeworfene Flyer, weil der statische Code nicht auf das neue Listing umgeleitet werden konnte. Lösung: "The Editable QR Code". - ---- - -## 3. Content Strategy & SEO Operations -Basierend auf `keyword_planer_google.md` (High Volume & High CPC Opportunities). - -### 3.1 Keyword-Prioritäten -Wir attackieren drei Ebenen gleichzeitig: - -1. **Volume Layer (Top of Funnel):** - - `qr code generator free` (500k Search Volume) -> Homepage & Tool Pages - - `create qr code` (50k SV) -> Tutorial Hub -2. **Value Layer (High Intent/CPC):** - - `dynamic qr code generator` (5k SV, High Value) -> Feature Page - - `qr code for business` (5k SV, High CPC) -> Solutions Hub -3. **Feature Layer (Longtail):** - - `qr code generator with logo` (5k SV) -> Customization Page - - `vcard qr code generator` (5k SV) -> vCard Tool - -### 3.2 Content-Pillars & Hubs - -| Hub Page | Target Keyword | Content Angle (H1 Idea) | -| :--- | :--- | :--- | -| **Real Estate** | `real estate qr codes` | "The Only QR Code Generator for Real Estate Agents" | -| **Business** | `qr codes for business` | "Enterprise-Grade QR Code Generator for Business Growth" | -| **Dynamic** | `dynamic qr code generator` | "Create Editable & Trackable Dynamic QR Codes (Free)" | -| **vCard** | `vcard qr code` | "Digital Business Card & vCard QR Code Generator" | - -### 3.3 SEO-Protokoll & On-Page Execution -Für *jede* neue Seite gilt strikt: - -1. **URL-Struktur:** Sprechend & hierarchisch (`/tools/dynamic-qr-code-generator`). -2. **Title Tag:** `[Main Keyword] - [Benefit] | QR Master` - - *Bsp:* `Dynamic QR Code Generator - Edit Links After Printing | QR Master` -3. **H1:** Muss das Main Keyword exakt enthalten. -4. **FAQ Schema:** Fragen aus "People Also Ask" integrieren (z.B. "Can I edit a QR code after printing?"). - ---- - -## 4. Execution Roadmap (Next 4 Weeks) - -### Woche 1: Foundation & "Safety Net" -- [Dev] **Safety Intercept Modal** auf der Homepage deployen. -- [Content] Optimierung der Homepage Meta-Daten für `free qr code generator` und `dynamic qr code`. - -### Woche 2: Vertical Attack (Real Estate) -- [Page] `/solutions/real-estate` live bringen (Copy siehe 2.1). -- [Lead Magnet] "Forever Flyer" Canva Templates erstellen. - -### Woche 3: High-Value Content -- [Blog] Comparison Post: `Bitly vs. QR Master for Business` (Targeting `qr code for business`). -- [Tool] Polishing der `vcard` Seite für das Keyword `vcard qr code generator`. - -### Woche 4: Review & Amplify -- Analyse der `intercept_upgrade_rate`. -- Backlink-Outreach für Real Estate Artikel. - ---- - -## 5. Risiken & Mitigation -- **Risk:** User sind genervt vom Modal. - - **Fix:** "Don't show again" Option nach 2x Anzeigen. -- **Risk:** SEO dauert zu lange (3-6 Monate). - - **Fix:** Parallel "Programmatic SEO" für Longtail-Keywords (z.B. `qr code for [city]`) aufbauen, um schnelleren Traffic zu holen. - -## 6. Definition of Done (V1.1) -- Safety Intercept ist live und trackt Upgrades. -- Real Estate Landingpage rankt für Longtail-Keywords. -- Die Top-5 Keywords aus dem Plan (`dynamic`, `free`, `business`, `custom`, `vcard`) haben dedizierte, optimierte Landingpages. - +# QR Master: The Growth Masterpiece +## Implementations-Idee (Integrated Strategy V1.1) + +## Executive Summary +Dieses Dokument integriert Conversion-, Copywriting- und Content-Strategie, um QR Master von einem simplen Utility-Tool zu einer Vertical Operations Platform zu entwickeln. + +**Kernthese:** Wir gewinnen nicht durch einen "besseren" Generator, sondern als die **einzige Versicherung gegen physische Marketingverschwendung**. + +## 1. Conversion Architecture (CRO) +### 1.1 Ziel +Die Value Gap schliessen: Nutzer verstehen den Wert von **Dynamic QR Codes** oft erst *nach* dem Druckfehler. + +### 1.2 Funnel-Diagnose & Leak +Aktuelles Problem: +1. Nutzer suchen nach `free qr code generator` (High Volume). +2. Erstellen statischen Code & laden PNG herunter. +3. Drucken Material. +4. Link ändert sich -> Code tot -> Frust & Churn. + +### 1.3 Safety Intercept (Pre-Download Modal) +**Hypothese:** Ein "Angst-basiertes" Intercept vor dem Download konvertiert Free-User zu Dynamic-Usern, indem es das Risiko von statischen Codes aufzeigt. + +**Trigger:** Klick auf `Download PNG` / `Download SVG` bei statischem Code. + +**Modal-Inhalt (Optimiert):** +- **Headline:** `Wait! You are creating a Permanent, Static Code.` +- **Body:** `Once printed, this code cannot be changed. If your link breaks, your flyers are trash. 80% of businesses switch to a **Dynamic QR Code Generator** to stay safe.` +- **CTA Primary:** `Yes, make it Editable (Free Dynamic)` +- **CTA Secondary:** `No, I risk the Static Code` + +### 1.4 Experiment-Setup (A/B Test) +- **Control:** Direkter Download. +- **Variant:** Safety Intercept Modal. +- **Primary KPI:** `intercept_upgrade_rate` (Ziel: >15%). + +--- + +## 2. Direct Response Copywriting (Real Estate Vertical) +Fokus auf das Keyword Cluster: `qr codes for business` und `real estate qr codes`. + +### 2.1 Zielseite: `/solutions/real-estate` +**Hero Section (SEO & Conversion Optimized):** +- **H1 (SEO):** `Real Estate QR Code Generator: The "Forever Code" for Agents` +- **Subhead:** `Sold the listing? Don't trash the flyers. Just reroute your **Dynamic QR Code** to the next property in 1 click.` +- **CTA:** `Create Free Real Estate QR Code` +- **Micro-Copy:** `Works with Canva & Zillow. Trusted by top agents.` + +### 2.2 Nurture Bridge Email Sequence +**Trigger:** Download `Real Estate Toolkit`. + +**Email 1 (The Hook):** +- **Subject:** `Your "Forever Flyer" Templates are here` +- **Body:** "Stop printing single-use codes. Use this template with a **Dynamic QR Code** that you recycle for every open house." + +**Email 2 (The Fear):** +- **Subject:** `The $300 mistake 90% of agents make` +- **Body:** Story über 500 weggeworfene Flyer, weil der statische Code nicht auf das neue Listing umgeleitet werden konnte. Lösung: "The Editable QR Code". + +--- + +## 3. Content Strategy & SEO Operations +Basierend auf `keyword_planer_google.md` (High Volume & High CPC Opportunities). + +### 3.1 Keyword-Prioritäten +Wir attackieren drei Ebenen gleichzeitig: + +1. **Volume Layer (Top of Funnel):** + - `qr code generator free` (500k Search Volume) -> Homepage & Tool Pages + - `create qr code` (50k SV) -> Tutorial Hub +2. **Value Layer (High Intent/CPC):** + - `dynamic qr code generator` (5k SV, High Value) -> Feature Page + - `qr code for business` (5k SV, High CPC) -> Solutions Hub +3. **Feature Layer (Longtail):** + - `qr code generator with logo` (5k SV) -> Customization Page + - `vcard qr code generator` (5k SV) -> vCard Tool + +### 3.2 Content-Pillars & Hubs + +| Hub Page | Target Keyword | Content Angle (H1 Idea) | +| :--- | :--- | :--- | +| **Real Estate** | `real estate qr codes` | "The Only QR Code Generator for Real Estate Agents" | +| **Business** | `qr codes for business` | "Enterprise-Grade QR Code Generator for Business Growth" | +| **Dynamic** | `dynamic qr code generator` | "Create Editable & Trackable Dynamic QR Codes (Free)" | +| **vCard** | `vcard qr code` | "Digital Business Card & vCard QR Code Generator" | + +### 3.3 SEO-Protokoll & On-Page Execution +Für *jede* neue Seite gilt strikt: + +1. **URL-Struktur:** Sprechend & hierarchisch (`/tools/dynamic-qr-code-generator`). +2. **Title Tag:** `[Main Keyword] - [Benefit] | QR Master` + - *Bsp:* `Dynamic QR Code Generator - Edit Links After Printing | QR Master` +3. **H1:** Muss das Main Keyword exakt enthalten. +4. **FAQ Schema:** Fragen aus "People Also Ask" integrieren (z.B. "Can I edit a QR code after printing?"). + +--- + +## 4. Execution Roadmap (Next 4 Weeks) + +### Woche 1: Foundation & "Safety Net" +- [Dev] **Safety Intercept Modal** auf der Homepage deployen. +- [Content] Optimierung der Homepage Meta-Daten für `free qr code generator` und `dynamic qr code`. + +### Woche 2: Vertical Attack (Real Estate) +- [Page] `/solutions/real-estate` live bringen (Copy siehe 2.1). +- [Lead Magnet] "Forever Flyer" Canva Templates erstellen. + +### Woche 3: High-Value Content +- [Blog] Comparison Post: `Bitly vs. QR Master for Business` (Targeting `qr code for business`). +- [Tool] Polishing der `vcard` Seite für das Keyword `vcard qr code generator`. + +### Woche 4: Review & Amplify +- Analyse der `intercept_upgrade_rate`. +- Backlink-Outreach für Real Estate Artikel. + +--- + +## 5. Risiken & Mitigation +- **Risk:** User sind genervt vom Modal. + - **Fix:** "Don't show again" Option nach 2x Anzeigen. +- **Risk:** SEO dauert zu lange (3-6 Monate). + - **Fix:** Parallel "Programmatic SEO" für Longtail-Keywords (z.B. `qr code for [city]`) aufbauen, um schnelleren Traffic zu holen. + +## 6. Definition of Done (V1.1) +- Safety Intercept ist live und trackt Upgrades. +- Real Estate Landingpage rankt für Longtail-Keywords. +- Die Top-5 Keywords aus dem Plan (`dynamic`, `free`, `business`, `custom`, `vcard`) haben dedizierte, optimierte Landingpages. + diff --git a/marketing/reddit-4-week-calendar-full.ics b/marketing/reddit-4-week-calendar-full.ics index 40fd93b..d747619 100644 --- a/marketing/reddit-4-week-calendar-full.ics +++ b/marketing/reddit-4-week-calendar-full.ics @@ -1,96 +1,96 @@ -BEGIN:VCALENDAR -VERSION:2.0 -PRODID:-//QR Master//Reddit Full Calendar//EN -CALSCALE:GREGORIAN -METHOD:PUBLISH -X-WR-CALNAME:QR Master Reddit Full -X-WR-TIMEZONE:Europe/Berlin -BEGIN:VEVENT -UID:reddit-full-20260316-library@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260316T100000Z -DTEND:20260316T103000Z -SUMMARY:Reddit reply library - all 15 templates -DESCRIPTION:1) If someone asks what tool you use:\nIf you need the destination to stay editable later\, that’s exactly the problem I built around.\nI built QR Master for this\, so obvious bias:\nhttps://www.qrmaster.net/dynamic-qr-code-generator\nIf you want\, I can also just explain the setup without linking anything.\n\n2) Direct link ask:\nSure. I’m building it\, so bias disclosed:\nhttps://www.qrmaster.net/dynamic-qr-code-generator\nMain use case is when something is already printed and the destination changes later.\n\n3) Restaurant/menu:\nIf the menu changes even semi-regularly\, I wouldn’t print a static QR.\nhttps://www.qrmaster.net/use-cases/restaurant-menu-qr-codes\n\n4) Flyer/print:\nThe problem usually isn’t generating the QR. It’s what happens when the page changes after print.\nhttps://www.qrmaster.net/use-cases/flyer-qr-codes\n\n5) Events:\nFor events\, I’d mainly optimize for can we update this later without reprinting everything?\nhttps://www.qrmaster.net/use-cases/event-qr-codes\n\n6) Packaging/bulk:\nIf you’re dealing with lots of codes\, bulk workflow matters way more than people expect.\nhttps://www.qrmaster.net/bulk-qr-code-generator\n\n7) Analytics:\nYou probably want some scan visibility\, but only the useful stuff.\nhttps://www.qrmaster.net/qr-code-tracking\n\n8) Privacy:\nIf privacy matters\, I’d look very closely at how the tracking is handled.\nhttps://www.qrmaster.net/privacy\n\n9) Agencies:\nYeah\, agencies are actually one of the more interesting use cases.\nhttps://www.qrmaster.net/qr-code-for-marketing-campaigns\n\n10) Alternatives:\nIf you need editability after print\, that’s where tools start to differ.\nhttps://www.qrmaster.net/dynamic-qr-code-generator\n\n11) Skeptical reply:\nFair skepticism. I built it\, so I’m obviously biased:\nhttps://www.qrmaster.net/dynamic-qr-code-generator\n\n12) How set up:\nUse a dynamic destination\, keep the landing page mobile-first\, and make sure you can update it after print.\nhttps://www.qrmaster.net/dynamic-qr-code-generator\n\n13) Recommendations:\nIf the destination might change later\, I’d use a dynamic QR setup.\nhttps://www.qrmaster.net/dynamic-qr-code-generator\n\n14) Feedback thread:\nI’m building in this space\, so this is partly self-interested\, but yes\, this is a real problem.\nhttps://www.qrmaster.net/dynamic-qr-code-generator\n\n15) Direct relevance:\nI built a tool for this exact issue\, so obvious bias:\nhttps://www.qrmaster.net/dynamic-qr-code-generator -END:VEVENT -BEGIN:VEVENT -UID:reddit-full-20260317-post2@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260317T120000Z -DTEND:20260317T124500Z -SUMMARY:r/startups - Post 2 -DESCRIPTION:Title: One URL change can ruin 500 flyers. That pain is more real than I expected.\n\nI underestimated how annoying printed mistakes are.\n\nA lot of software problems are reversible.\nPrint problems aren’t.\n\nIf a landing page changes after flyers\, posters\, inserts\, or menus are already out there\, someone has to:\n- live with a broken flow\n- reprint everything\n- or patch it manually in a messy way\n\nThat sounds minor until you talk to people actually running campaigns or local businesses.\n\nWhat small operational problem ended up being much more expensive than it looked at first?\n\nUse replies: 2\, 4\, 11\, 12\, 15 -END:VEVENT -BEGIN:VEVENT -UID:reddit-full-20260319-post1@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260319T120000Z -DTEND:20260319T124500Z -SUMMARY:r/SaaS - Post 1 -DESCRIPTION:Title: I thought QR code software was about generation. The real pain starts after print.\n\nI used to think the value was make a QR code fast.\n\nIt’s not.\n\nThe painful part starts after something is already printed:\n- the menu changes\n- the event page changes\n- the campaign URL changes\n- someone notices a typo too late\n\nOne small change can turn a stack of flyers into trash.\n\nThat shifted how I think about the whole category.\nThe QR itself is easy.\nThe expensive part is everything around it.\n\nAnyone else building in a category where the simple feature isn’t actually where the value is?\n\nUse replies: 1\, 7\, 10\, 11\, 15 -END:VEVENT -BEGIN:VEVENT -UID:reddit-full-20260324-post3@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260324T123000Z -DTEND:20260324T131500Z -SUMMARY:r/smallbusiness - Post 3 -DESCRIPTION:Title: Small businesses usually don’t need more marketing. They need fewer expensive mistakes.\n\nOne thing I keep noticing:\n\nA lot of owners don’t care about having a fancy tool.\nThey care about not wasting money.\n\nWith QR codes\, the common mistakes seem to be:\n- printing static codes for things that change often\n- sending people to ugly mobile pages\n- having no idea whether anyone scanned anything\n- letting one outdated link stay live for weeks\n\nFeels like a lot of marketing problems are actually ops problems.\n\nWhat’s one small process change that saved your business money this year?\n\nUse replies: 3\, 4\, 10\, 12\, 13 -END:VEVENT -BEGIN:VEVENT -UID:reddit-full-20260326-post4@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260326T120000Z -DTEND:20260326T124500Z -SUMMARY:r/EntrepreneurRideAlong - Post 4 -DESCRIPTION:Title: Building in a boring category taught me that boring problems are usually expensive.\n\nI’m building around QR codes\, which sounds incredibly boring on paper.\n\nBut boring problems are often the ones people pay to avoid.\n\nIn this case\, it’s stuff like:\n- reprinting menus\n- fixing outdated flyers\n- updating event info after posters are already out\n- managing lots of QR destinations across campaigns\n\nNobody is emotionally excited about QR codes.\nThey’re emotionally excited about not dealing with preventable mess.\n\nAnyone else building something unsexy that turned out to have very real pain behind it?\n\nUse replies: 2\, 4\, 9\, 11\, 15 -END:VEVENT -BEGIN:VEVENT -UID:reddit-full-20260327-post5@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260327T133000Z -DTEND:20260327T141500Z -SUMMARY:r/SideProject - Post 5 -DESCRIPTION:Title: The weird part about building a QR product is that the technical problem isn’t the interesting one.\n\nGenerating a QR image is trivial.\n\nWhat turned out to be more interesting:\n- what happens after print\n- whether someone can change the destination later\n- what analytics are actually useful\n- how privacy concerns show up once tracking enters the conversation\n- how bulk workflows matter way more than expected\n\nIt’s one of those products that looks dumb-simple from the outside and much more operational once you talk to users.\n\nWhat kind of side project looked simple until real use cases started showing up?\n\nUse replies: 1\, 6\, 7\, 8\, 15 -END:VEVENT -BEGIN:VEVENT -UID:reddit-full-20260331-post7@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260331T120000Z -DTEND:20260331T124500Z -SUMMARY:r/AlphaandBetaTesters - Post 7 -DESCRIPTION:Title: Looking for feedback from anyone who has used QR codes in restaurants\, events\, print\, or packaging.\n\nI’m trying to learn from people who use QR codes in the real world\, not just in theory.\n\nEspecially if you’ve used them for:\n- menus\n- flyers\n- product packaging\n- event materials\n- WiFi / contact sharing\n- agency campaigns\n\nThings I’m curious about:\n- what changes most often after something is printed?\n- what’s annoying about current tools?\n- do you actually care about scan analytics?\n- does privacy / GDPR affect vendor choice at all?\n\nI’m happy to share what I’m building if useful\, but mostly looking for honest feedback from people who’ve dealt with this firsthand.\n\nUse replies: 3\, 5\, 6\, 8\, 14 -END:VEVENT -BEGIN:VEVENT -UID:reddit-full-20260402-post8@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260402T120000Z -DTEND:20260402T124500Z -SUMMARY:r/RoastMyStartup - Post 8 -DESCRIPTION:Title: Roast my positioning: is avoid reprints and broken QR campaigns a strong enough problem?\n\nI’m working on a product around dynamic QR codes.\n\nThe positioning I’m testing is less make QR codes and more avoid reprints\, outdated links\, and messy campaign management.\n\nTarget users are mostly:\n- small businesses\n- restaurants\n- marketers\n- agencies\n- event / packaging use cases\n\nThe questions I’d love roasted:\n- does the pain feel real enough?\n- does this sound too niche?\n- what part sounds generic or weak?\n- what would make you ignore this instantly?\n\nHappy to share the product if the sub is okay with it.\n\nUse replies: 2\, 10\, 11\, 14\, 15 -END:VEVENT -BEGIN:VEVENT -UID:reddit-full-20260403-post6@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260403T123000Z -DTEND:20260403T131500Z -SUMMARY:r/ProductMgmt - Post 6 -DESCRIPTION:Title: Users say they want a QR generator. What they actually want is damage control.\n\nA PM lesson I didn’t expect:\n\nPeople describe the need as I need a QR code.\nBut what they actually care about is something like:\nI need this thing to not break once it’s already printed.\n\nThat changes what feels important.\n\nGenerate code sounds like the core feature.\nBut retention/value probably sits closer to:\n- edit later\n- track scans\n- handle multiple codes\n- avoid privacy headaches\n- manage existing campaigns cleanly\n\nHave you seen that mismatch in your own product?\nWhat users ask for first vs. what actually matters later?\n\nUse replies: 1\, 7\, 8\, 10\, 12 -END:VEVENT -BEGIN:VEVENT -UID:reddit-full-20260407-post9@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260407T120000Z -DTEND:20260407T124500Z -SUMMARY:r/startups - Post 9 -DESCRIPTION:Title: I’m starting to think edit after print is a stronger product promise than track scans.\n\nInteresting thing from early positioning:\n\nI assumed analytics would be the hero feature.\nBut I can change the destination later seems to click faster.\n\nMakes sense in hindsight.\nTracking is nice.\nAvoiding expensive mistakes is urgent.\n\nSo now I’m wondering if the better message is:\n- first promise control\n- then introduce analytics\n- then layer in bulk / workflow / privacy\n\nIf you’ve sold into small businesses or marketers:\nwhat kind of promise gets attention faster\, insight or control?\n\nUse replies: 1\, 7\, 9\, 10\, 15 -END:VEVENT -BEGIN:VEVENT -UID:reddit-full-20260409-post10@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260409T123000Z -DTEND:20260409T131500Z -SUMMARY:r/smallbusiness - Post 10 -DESCRIPTION:Title: What looks like a tiny print detail can quietly waste a lot of money.\n\nI keep coming back to this:\n\nA broken link on a website is annoying.\nA broken link on printed material is expensive.\n\nBecause now the problem is sitting in:\n- stores\n- restaurants\n- posters\n- packaging\n- tables\n- flyers already handed out\n\nFeels like one of those things that sounds tiny until you count the friction and replacement cost.\n\nWhat’s a small detail in your business that causes way more downstream cost than people assume?\n\nUse replies: 3\, 4\, 6\, 13\, 15 -END:VEVENT -END:VCALENDAR +BEGIN:VCALENDAR +VERSION:2.0 +PRODID:-//QR Master//Reddit Full Calendar//EN +CALSCALE:GREGORIAN +METHOD:PUBLISH +X-WR-CALNAME:QR Master Reddit Full +X-WR-TIMEZONE:Europe/Berlin +BEGIN:VEVENT +UID:reddit-full-20260316-library@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260316T100000Z +DTEND:20260316T103000Z +SUMMARY:Reddit reply library - all 15 templates +DESCRIPTION:1) If someone asks what tool you use:\nIf you need the destination to stay editable later\, that’s exactly the problem I built around.\nI built QR Master for this\, so obvious bias:\nhttps://www.qrmaster.net/dynamic-qr-code-generator\nIf you want\, I can also just explain the setup without linking anything.\n\n2) Direct link ask:\nSure. I’m building it\, so bias disclosed:\nhttps://www.qrmaster.net/dynamic-qr-code-generator\nMain use case is when something is already printed and the destination changes later.\n\n3) Restaurant/menu:\nIf the menu changes even semi-regularly\, I wouldn’t print a static QR.\nhttps://www.qrmaster.net/use-cases/restaurant-menu-qr-codes\n\n4) Flyer/print:\nThe problem usually isn’t generating the QR. It’s what happens when the page changes after print.\nhttps://www.qrmaster.net/use-cases/flyer-qr-codes\n\n5) Events:\nFor events\, I’d mainly optimize for can we update this later without reprinting everything?\nhttps://www.qrmaster.net/use-cases/event-qr-codes\n\n6) Packaging/bulk:\nIf you’re dealing with lots of codes\, bulk workflow matters way more than people expect.\nhttps://www.qrmaster.net/bulk-qr-code-generator\n\n7) Analytics:\nYou probably want some scan visibility\, but only the useful stuff.\nhttps://www.qrmaster.net/qr-code-tracking\n\n8) Privacy:\nIf privacy matters\, I’d look very closely at how the tracking is handled.\nhttps://www.qrmaster.net/privacy\n\n9) Agencies:\nYeah\, agencies are actually one of the more interesting use cases.\nhttps://www.qrmaster.net/qr-code-for-marketing-campaigns\n\n10) Alternatives:\nIf you need editability after print\, that’s where tools start to differ.\nhttps://www.qrmaster.net/dynamic-qr-code-generator\n\n11) Skeptical reply:\nFair skepticism. I built it\, so I’m obviously biased:\nhttps://www.qrmaster.net/dynamic-qr-code-generator\n\n12) How set up:\nUse a dynamic destination\, keep the landing page mobile-first\, and make sure you can update it after print.\nhttps://www.qrmaster.net/dynamic-qr-code-generator\n\n13) Recommendations:\nIf the destination might change later\, I’d use a dynamic QR setup.\nhttps://www.qrmaster.net/dynamic-qr-code-generator\n\n14) Feedback thread:\nI’m building in this space\, so this is partly self-interested\, but yes\, this is a real problem.\nhttps://www.qrmaster.net/dynamic-qr-code-generator\n\n15) Direct relevance:\nI built a tool for this exact issue\, so obvious bias:\nhttps://www.qrmaster.net/dynamic-qr-code-generator +END:VEVENT +BEGIN:VEVENT +UID:reddit-full-20260317-post2@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260317T120000Z +DTEND:20260317T124500Z +SUMMARY:r/startups - Post 2 +DESCRIPTION:Title: One URL change can ruin 500 flyers. That pain is more real than I expected.\n\nI underestimated how annoying printed mistakes are.\n\nA lot of software problems are reversible.\nPrint problems aren’t.\n\nIf a landing page changes after flyers\, posters\, inserts\, or menus are already out there\, someone has to:\n- live with a broken flow\n- reprint everything\n- or patch it manually in a messy way\n\nThat sounds minor until you talk to people actually running campaigns or local businesses.\n\nWhat small operational problem ended up being much more expensive than it looked at first?\n\nUse replies: 2\, 4\, 11\, 12\, 15 +END:VEVENT +BEGIN:VEVENT +UID:reddit-full-20260319-post1@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260319T120000Z +DTEND:20260319T124500Z +SUMMARY:r/SaaS - Post 1 +DESCRIPTION:Title: I thought QR code software was about generation. The real pain starts after print.\n\nI used to think the value was make a QR code fast.\n\nIt’s not.\n\nThe painful part starts after something is already printed:\n- the menu changes\n- the event page changes\n- the campaign URL changes\n- someone notices a typo too late\n\nOne small change can turn a stack of flyers into trash.\n\nThat shifted how I think about the whole category.\nThe QR itself is easy.\nThe expensive part is everything around it.\n\nAnyone else building in a category where the simple feature isn’t actually where the value is?\n\nUse replies: 1\, 7\, 10\, 11\, 15 +END:VEVENT +BEGIN:VEVENT +UID:reddit-full-20260324-post3@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260324T123000Z +DTEND:20260324T131500Z +SUMMARY:r/smallbusiness - Post 3 +DESCRIPTION:Title: Small businesses usually don’t need more marketing. They need fewer expensive mistakes.\n\nOne thing I keep noticing:\n\nA lot of owners don’t care about having a fancy tool.\nThey care about not wasting money.\n\nWith QR codes\, the common mistakes seem to be:\n- printing static codes for things that change often\n- sending people to ugly mobile pages\n- having no idea whether anyone scanned anything\n- letting one outdated link stay live for weeks\n\nFeels like a lot of marketing problems are actually ops problems.\n\nWhat’s one small process change that saved your business money this year?\n\nUse replies: 3\, 4\, 10\, 12\, 13 +END:VEVENT +BEGIN:VEVENT +UID:reddit-full-20260326-post4@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260326T120000Z +DTEND:20260326T124500Z +SUMMARY:r/EntrepreneurRideAlong - Post 4 +DESCRIPTION:Title: Building in a boring category taught me that boring problems are usually expensive.\n\nI’m building around QR codes\, which sounds incredibly boring on paper.\n\nBut boring problems are often the ones people pay to avoid.\n\nIn this case\, it’s stuff like:\n- reprinting menus\n- fixing outdated flyers\n- updating event info after posters are already out\n- managing lots of QR destinations across campaigns\n\nNobody is emotionally excited about QR codes.\nThey’re emotionally excited about not dealing with preventable mess.\n\nAnyone else building something unsexy that turned out to have very real pain behind it?\n\nUse replies: 2\, 4\, 9\, 11\, 15 +END:VEVENT +BEGIN:VEVENT +UID:reddit-full-20260327-post5@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260327T133000Z +DTEND:20260327T141500Z +SUMMARY:r/SideProject - Post 5 +DESCRIPTION:Title: The weird part about building a QR product is that the technical problem isn’t the interesting one.\n\nGenerating a QR image is trivial.\n\nWhat turned out to be more interesting:\n- what happens after print\n- whether someone can change the destination later\n- what analytics are actually useful\n- how privacy concerns show up once tracking enters the conversation\n- how bulk workflows matter way more than expected\n\nIt’s one of those products that looks dumb-simple from the outside and much more operational once you talk to users.\n\nWhat kind of side project looked simple until real use cases started showing up?\n\nUse replies: 1\, 6\, 7\, 8\, 15 +END:VEVENT +BEGIN:VEVENT +UID:reddit-full-20260331-post7@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260331T120000Z +DTEND:20260331T124500Z +SUMMARY:r/AlphaandBetaTesters - Post 7 +DESCRIPTION:Title: Looking for feedback from anyone who has used QR codes in restaurants\, events\, print\, or packaging.\n\nI’m trying to learn from people who use QR codes in the real world\, not just in theory.\n\nEspecially if you’ve used them for:\n- menus\n- flyers\n- product packaging\n- event materials\n- WiFi / contact sharing\n- agency campaigns\n\nThings I’m curious about:\n- what changes most often after something is printed?\n- what’s annoying about current tools?\n- do you actually care about scan analytics?\n- does privacy / GDPR affect vendor choice at all?\n\nI’m happy to share what I’m building if useful\, but mostly looking for honest feedback from people who’ve dealt with this firsthand.\n\nUse replies: 3\, 5\, 6\, 8\, 14 +END:VEVENT +BEGIN:VEVENT +UID:reddit-full-20260402-post8@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260402T120000Z +DTEND:20260402T124500Z +SUMMARY:r/RoastMyStartup - Post 8 +DESCRIPTION:Title: Roast my positioning: is avoid reprints and broken QR campaigns a strong enough problem?\n\nI’m working on a product around dynamic QR codes.\n\nThe positioning I’m testing is less make QR codes and more avoid reprints\, outdated links\, and messy campaign management.\n\nTarget users are mostly:\n- small businesses\n- restaurants\n- marketers\n- agencies\n- event / packaging use cases\n\nThe questions I’d love roasted:\n- does the pain feel real enough?\n- does this sound too niche?\n- what part sounds generic or weak?\n- what would make you ignore this instantly?\n\nHappy to share the product if the sub is okay with it.\n\nUse replies: 2\, 10\, 11\, 14\, 15 +END:VEVENT +BEGIN:VEVENT +UID:reddit-full-20260403-post6@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260403T123000Z +DTEND:20260403T131500Z +SUMMARY:r/ProductMgmt - Post 6 +DESCRIPTION:Title: Users say they want a QR generator. What they actually want is damage control.\n\nA PM lesson I didn’t expect:\n\nPeople describe the need as I need a QR code.\nBut what they actually care about is something like:\nI need this thing to not break once it’s already printed.\n\nThat changes what feels important.\n\nGenerate code sounds like the core feature.\nBut retention/value probably sits closer to:\n- edit later\n- track scans\n- handle multiple codes\n- avoid privacy headaches\n- manage existing campaigns cleanly\n\nHave you seen that mismatch in your own product?\nWhat users ask for first vs. what actually matters later?\n\nUse replies: 1\, 7\, 8\, 10\, 12 +END:VEVENT +BEGIN:VEVENT +UID:reddit-full-20260407-post9@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260407T120000Z +DTEND:20260407T124500Z +SUMMARY:r/startups - Post 9 +DESCRIPTION:Title: I’m starting to think edit after print is a stronger product promise than track scans.\n\nInteresting thing from early positioning:\n\nI assumed analytics would be the hero feature.\nBut I can change the destination later seems to click faster.\n\nMakes sense in hindsight.\nTracking is nice.\nAvoiding expensive mistakes is urgent.\n\nSo now I’m wondering if the better message is:\n- first promise control\n- then introduce analytics\n- then layer in bulk / workflow / privacy\n\nIf you’ve sold into small businesses or marketers:\nwhat kind of promise gets attention faster\, insight or control?\n\nUse replies: 1\, 7\, 9\, 10\, 15 +END:VEVENT +BEGIN:VEVENT +UID:reddit-full-20260409-post10@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260409T123000Z +DTEND:20260409T131500Z +SUMMARY:r/smallbusiness - Post 10 +DESCRIPTION:Title: What looks like a tiny print detail can quietly waste a lot of money.\n\nI keep coming back to this:\n\nA broken link on a website is annoying.\nA broken link on printed material is expensive.\n\nBecause now the problem is sitting in:\n- stores\n- restaurants\n- posters\n- packaging\n- tables\n- flyers already handed out\n\nFeels like one of those things that sounds tiny until you count the friction and replacement cost.\n\nWhat’s a small detail in your business that causes way more downstream cost than people assume?\n\nUse replies: 3\, 4\, 6\, 13\, 15 +END:VEVENT +END:VCALENDAR diff --git a/marketing/reddit-4-week-calendar-full.md b/marketing/reddit-4-week-calendar-full.md index 2d56d93..2e087ff 100644 --- a/marketing/reddit-4-week-calendar-full.md +++ b/marketing/reddit-4-week-calendar-full.md @@ -1,443 +1,443 @@ -# QR Master Reddit Calendar - Full 4 Weeks - -Times are in Europe/Berlin. - -## Link Map - -- Core dynamic angle: `https://www.qrmaster.net/dynamic-qr-code-generator` -- Reprint / waste angle: `https://www.qrmaster.net/reprint-calculator` -- Restaurant / menu: `https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes` -- Flyer / print campaigns: `https://www.qrmaster.net/use-cases/flyer-qr-codes` -- Event use case: `https://www.qrmaster.net/use-cases/event-qr-codes` -- Bulk / packaging: `https://www.qrmaster.net/bulk-qr-code-generator` -- Packaging use case: `https://www.qrmaster.net/use-cases/packaging-qr-codes` -- Tracking / analytics: `https://www.qrmaster.net/qr-code-tracking` -- Privacy: `https://www.qrmaster.net/privacy` -- Campaign workflows: `https://www.qrmaster.net/qr-code-for-marketing-campaigns` -- Main site: `https://www.qrmaster.net/` - -## Reply Library - -### 1. If someone asks what tool you use - -```text -If you need the destination to stay editable later, that’s exactly the problem I built around. - -I built QR Master for this, so obvious bias: -https://www.qrmaster.net/dynamic-qr-code-generator - -If you want, I can also just explain the setup without linking anything. -``` - -### 2. If someone asks for the link directly - -```text -Sure. I’m building it, so bias disclosed: -https://www.qrmaster.net/dynamic-qr-code-generator - -Main use case is when something is already printed and the destination changes later. -``` - -### 3. Restaurant / menu threads - -```text -If the menu changes even semi-regularly, I wouldn’t print a static QR. - -I built a tool for exactly that use case, so obvious bias here: -https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes - -Even without using mine, I’d still recommend a dynamic destination and a very mobile-friendly menu page. -``` - -### 4. Flyer / print campaign threads - -```text -The problem usually isn’t generating the QR. It’s what happens when the page changes after print. - -I built something specifically for that: -https://www.qrmaster.net/use-cases/flyer-qr-codes - -If helpful, I can outline the print-safe setup here too. -``` - -### 5. Event use case - -```text -For events, I’d mainly optimize for “can we update this later without reprinting everything?” - -I built QR Master around that exact headache, so bias here: -https://www.qrmaster.net/use-cases/event-qr-codes -``` - -### 6. Packaging / bulk - -```text -If you’re dealing with lots of codes, bulk workflow matters way more than people expect. - -I built this with that in mind: -https://www.qrmaster.net/bulk-qr-code-generator - -Happy to share what a clean CSV / batch setup usually looks like. -``` - -### 7. Analytics questions - -```text -You probably want some scan visibility, but only the useful stuff. - -I built QR Master with that angle in mind, so obvious bias: -https://www.qrmaster.net/qr-code-tracking - -Personally I think basic scan data + clean attribution matters more than a flashy dashboard. -``` - -### 8. Privacy / GDPR - -```text -If privacy matters, I’d look very closely at how the tracking is handled. - -I’m building QR Master, so not pretending to be neutral: -https://www.qrmaster.net/privacy - -That said, I’d ask the same questions to any vendor. -``` - -### 9. If someone says this would be useful for agencies - -```text -Yeah, agencies are actually one of the more interesting use cases. - -I built this partly with that workflow in mind: -https://www.qrmaster.net/qr-code-for-marketing-campaigns - -Managing multiple destinations gets messy fast otherwise. -``` - -### 10. If someone asks about alternatives - -```text -Depends what you care about. - -If you just need a basic static code, almost anything works. -If you need editability after print, that’s where tools start to differ. - -I built QR Master for that second case: -https://www.qrmaster.net/dynamic-qr-code-generator -``` - -### 11. If someone is skeptical - -```text -Fair skepticism. - -I built it, so I’m obviously biased: -https://www.qrmaster.net/dynamic-qr-code-generator - -If you’d rather keep it link-free, I’m happy to just explain the tradeoffs here. -``` - -### 12. If someone asks how you would set this up - -```text -Short version: -use a dynamic destination, keep the landing page mobile-first, and make sure you can update it after print. - -I built a tool for exactly that flow: -https://www.qrmaster.net/dynamic-qr-code-generator -``` - -### 13. If someone asks for recommendations - -```text -If the destination might change later, I’d use a dynamic QR setup. - -I built one for that use case, so take this with bias: -https://www.qrmaster.net/dynamic-qr-code-generator - -If not mine, I’d still choose something that makes post-print edits easy. -``` - -### 14. Feedback threads - -```text -I’m building in this space, so this is partly self-interested, but yes, this is a real problem. - -Here’s what I’m working on if useful: -https://www.qrmaster.net/dynamic-qr-code-generator - -Would genuinely love blunt feedback more than polite praise. -``` - -### 15. Direct relevance / no hard sell - -```text -I built a tool for this exact issue, so obvious bias: -https://www.qrmaster.net/dynamic-qr-code-generator - -No hard sell. Just seemed directly relevant to what you asked. -``` - -## Schedule - -### 2026-03-17 Tuesday, 13:00 - -- Subreddit: `r/startups` -- Post #2 -- Title: `One URL change can ruin 500 flyers. That pain is more real than I expected.` -- Use replies: `2`, `4`, `11`, `12`, `15` - -```text -I underestimated how annoying printed mistakes are. - -A lot of software problems are reversible. -Print problems aren’t. - -If a landing page changes after flyers, posters, inserts, or menus are already out there, someone has to: -- live with a broken flow -- reprint everything -- or patch it manually in a messy way - -That sounds minor until you talk to people actually running campaigns or local businesses. - -What small operational problem ended up being much more expensive than it looked at first? -``` - -### 2026-03-19 Thursday, 13:00 - -- Subreddit: `r/SaaS` -- Post #1 -- Title: `I thought QR code software was about generation. The real pain starts after print.` -- Use replies: `1`, `7`, `10`, `11`, `15` - -```text -I used to think the value was “make a QR code fast.” - -It’s not. - -The painful part starts after something is already printed: -- the menu changes -- the event page changes -- the campaign URL changes -- someone notices a typo too late - -One small change can turn a stack of flyers into trash. - -That shifted how I think about the whole category. -The QR itself is easy. -The expensive part is everything around it. - -Anyone else building in a category where the “simple feature” isn’t actually where the value is? -``` - -### 2026-03-24 Tuesday, 13:30 - -- Subreddit: `r/smallbusiness` -- Post #3 -- Title: `Small businesses usually don’t need “more marketing.” They need fewer expensive mistakes.` -- Use replies: `3`, `4`, `10`, `12`, `13` - -```text -One thing I keep noticing: - -A lot of owners don’t care about having a fancy tool. -They care about not wasting money. - -With QR codes, the common mistakes seem to be: -- printing static codes for things that change often -- sending people to ugly mobile pages -- having no idea whether anyone scanned anything -- letting one outdated link stay live for weeks - -Feels like a lot of “marketing problems” are actually ops problems. - -What’s one small process change that saved your business money this year? -``` - -### 2026-03-26 Thursday, 13:00 - -- Subreddit: `r/EntrepreneurRideAlong` -- Post #4 -- Use replies: `2`, `4`, `9`, `11`, `15` - -```text -Building in a boring category taught me that boring problems are usually expensive - -I’m building around QR codes, which sounds incredibly boring on paper. - -But boring problems are often the ones people pay to avoid. - -In this case, it’s stuff like: -- reprinting menus -- fixing outdated flyers -- updating event info after posters are already out -- managing lots of QR destinations across campaigns - -Nobody is emotionally excited about QR codes. -They’re emotionally excited about not dealing with preventable mess. - -Anyone else building something “unsexy” that turned out to have very real pain behind it? -``` - -### 2026-03-27 Friday, 14:30 - -- Subreddit: `r/SideProject` -- Post #5 -- Title: `The weird part about building a QR product is that the technical problem isn’t the interesting one` -- Use replies: `1`, `6`, `7`, `8`, `15` - -```text -Generating a QR image is trivial. - -What turned out to be more interesting: -- what happens after print -- whether someone can change the destination later -- what analytics are actually useful -- how privacy concerns show up once tracking enters the conversation -- how bulk workflows matter way more than expected - -It’s one of those products that looks dumb-simple from the outside and much more operational once you talk to users. - -What kind of side project looked simple until real use cases started showing up? -``` - -### 2026-03-31 Tuesday, 14:00 - -- Subreddit: `r/AlphaandBetaTesters` -- Post #7 -- Use replies: `3`, `5`, `6`, `8`, `14` - -```text -Looking for feedback from anyone who has used QR codes in restaurants, events, print, or packaging - -I’m trying to learn from people who use QR codes in the real world, not just in theory. - -Especially if you’ve used them for: -- menus -- flyers -- product packaging -- event materials -- WiFi / contact sharing -- agency campaigns - -Things I’m curious about: -- what changes most often after something is printed? -- what’s annoying about current tools? -- do you actually care about scan analytics? -- does privacy / GDPR affect vendor choice at all? - -I’m happy to share what I’m building if useful, but mostly looking for honest feedback from people who’ve dealt with this firsthand. -``` - -### 2026-04-02 Thursday, 14:00 - -- Subreddit: `r/RoastMyStartup` -- Post #8 -- Use replies: `2`, `10`, `11`, `14`, `15` - -```text -Roast my positioning: is “avoid reprints and broken QR campaigns” a strong enough problem? - -I’m working on a product around dynamic QR codes. - -The positioning I’m testing is less “make QR codes” and more: -“avoid reprints, outdated links, and messy campaign management.” - -Target users are mostly: -- small businesses -- restaurants -- marketers -- agencies -- event / packaging use cases - -The questions I’d love roasted: -- does the pain feel real enough? -- does this sound too niche? -- what part sounds generic or weak? -- what would make you ignore this instantly? - -Happy to share the product if the sub is okay with it. -``` - -### 2026-04-03 Friday, 14:30 - -- Subreddit: `r/ProductMgmt` -- Post #6 -- Use replies: `1`, `7`, `8`, `10`, `12` - -```text -Users say they want a QR generator. What they actually want is damage control. - -A PM lesson I didn’t expect: - -People describe the need as “I need a QR code.” -But what they actually care about is something like: -“I need this thing to not break once it’s already printed.” - -That changes what feels important. - -“Generate code” sounds like the core feature. -But retention/value probably sits closer to: -- edit later -- track scans -- handle multiple codes -- avoid privacy headaches -- manage existing campaigns cleanly - -Have you seen that mismatch in your own product? -What users ask for first vs. what actually matters later? -``` - -### 2026-04-07 Tuesday, 14:00 - -- Subreddit: `r/startups` -- Post #9 -- Use replies: `1`, `7`, `9`, `10`, `15` - -```text -I’m starting to think “edit after print” is a stronger product promise than “track scans” - -Interesting thing from early positioning: - -I assumed analytics would be the hero feature. -But “I can change the destination later” seems to click faster. - -Makes sense in hindsight. -Tracking is nice. -Avoiding expensive mistakes is urgent. - -So now I’m wondering if the better message is: -- first promise control -- then introduce analytics -- then layer in bulk / workflow / privacy - -If you’ve sold into small businesses or marketers: -what kind of promise gets attention faster, insight or control? -``` - -### 2026-04-09 Thursday, 14:30 - -- Subreddit: `r/smallbusiness` -- Post #10 -- Use replies: `3`, `4`, `6`, `13`, `15` - -```text -What looks like a tiny print detail can quietly waste a lot of money - -I keep coming back to this: - -A broken link on a website is annoying. -A broken link on printed material is expensive. - -Because now the problem is sitting in: -- stores -- restaurants -- posters -- packaging -- tables -- flyers already handed out - -Feels like one of those things that sounds tiny until you count the friction and replacement cost. - -What’s a “small detail” in your business that causes way more downstream cost than people assume? -``` - +# QR Master Reddit Calendar - Full 4 Weeks + +Times are in Europe/Berlin. + +## Link Map + +- Core dynamic angle: `https://www.qrmaster.net/dynamic-qr-code-generator` +- Reprint / waste angle: `https://www.qrmaster.net/reprint-calculator` +- Restaurant / menu: `https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes` +- Flyer / print campaigns: `https://www.qrmaster.net/use-cases/flyer-qr-codes` +- Event use case: `https://www.qrmaster.net/use-cases/event-qr-codes` +- Bulk / packaging: `https://www.qrmaster.net/bulk-qr-code-generator` +- Packaging use case: `https://www.qrmaster.net/use-cases/packaging-qr-codes` +- Tracking / analytics: `https://www.qrmaster.net/qr-code-tracking` +- Privacy: `https://www.qrmaster.net/privacy` +- Campaign workflows: `https://www.qrmaster.net/qr-code-for-marketing-campaigns` +- Main site: `https://www.qrmaster.net/` + +## Reply Library + +### 1. If someone asks what tool you use + +```text +If you need the destination to stay editable later, that’s exactly the problem I built around. + +I built QR Master for this, so obvious bias: +https://www.qrmaster.net/dynamic-qr-code-generator + +If you want, I can also just explain the setup without linking anything. +``` + +### 2. If someone asks for the link directly + +```text +Sure. I’m building it, so bias disclosed: +https://www.qrmaster.net/dynamic-qr-code-generator + +Main use case is when something is already printed and the destination changes later. +``` + +### 3. Restaurant / menu threads + +```text +If the menu changes even semi-regularly, I wouldn’t print a static QR. + +I built a tool for exactly that use case, so obvious bias here: +https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes + +Even without using mine, I’d still recommend a dynamic destination and a very mobile-friendly menu page. +``` + +### 4. Flyer / print campaign threads + +```text +The problem usually isn’t generating the QR. It’s what happens when the page changes after print. + +I built something specifically for that: +https://www.qrmaster.net/use-cases/flyer-qr-codes + +If helpful, I can outline the print-safe setup here too. +``` + +### 5. Event use case + +```text +For events, I’d mainly optimize for “can we update this later without reprinting everything?” + +I built QR Master around that exact headache, so bias here: +https://www.qrmaster.net/use-cases/event-qr-codes +``` + +### 6. Packaging / bulk + +```text +If you’re dealing with lots of codes, bulk workflow matters way more than people expect. + +I built this with that in mind: +https://www.qrmaster.net/bulk-qr-code-generator + +Happy to share what a clean CSV / batch setup usually looks like. +``` + +### 7. Analytics questions + +```text +You probably want some scan visibility, but only the useful stuff. + +I built QR Master with that angle in mind, so obvious bias: +https://www.qrmaster.net/qr-code-tracking + +Personally I think basic scan data + clean attribution matters more than a flashy dashboard. +``` + +### 8. Privacy / GDPR + +```text +If privacy matters, I’d look very closely at how the tracking is handled. + +I’m building QR Master, so not pretending to be neutral: +https://www.qrmaster.net/privacy + +That said, I’d ask the same questions to any vendor. +``` + +### 9. If someone says this would be useful for agencies + +```text +Yeah, agencies are actually one of the more interesting use cases. + +I built this partly with that workflow in mind: +https://www.qrmaster.net/qr-code-for-marketing-campaigns + +Managing multiple destinations gets messy fast otherwise. +``` + +### 10. If someone asks about alternatives + +```text +Depends what you care about. + +If you just need a basic static code, almost anything works. +If you need editability after print, that’s where tools start to differ. + +I built QR Master for that second case: +https://www.qrmaster.net/dynamic-qr-code-generator +``` + +### 11. If someone is skeptical + +```text +Fair skepticism. + +I built it, so I’m obviously biased: +https://www.qrmaster.net/dynamic-qr-code-generator + +If you’d rather keep it link-free, I’m happy to just explain the tradeoffs here. +``` + +### 12. If someone asks how you would set this up + +```text +Short version: +use a dynamic destination, keep the landing page mobile-first, and make sure you can update it after print. + +I built a tool for exactly that flow: +https://www.qrmaster.net/dynamic-qr-code-generator +``` + +### 13. If someone asks for recommendations + +```text +If the destination might change later, I’d use a dynamic QR setup. + +I built one for that use case, so take this with bias: +https://www.qrmaster.net/dynamic-qr-code-generator + +If not mine, I’d still choose something that makes post-print edits easy. +``` + +### 14. Feedback threads + +```text +I’m building in this space, so this is partly self-interested, but yes, this is a real problem. + +Here’s what I’m working on if useful: +https://www.qrmaster.net/dynamic-qr-code-generator + +Would genuinely love blunt feedback more than polite praise. +``` + +### 15. Direct relevance / no hard sell + +```text +I built a tool for this exact issue, so obvious bias: +https://www.qrmaster.net/dynamic-qr-code-generator + +No hard sell. Just seemed directly relevant to what you asked. +``` + +## Schedule + +### 2026-03-17 Tuesday, 13:00 + +- Subreddit: `r/startups` +- Post #2 +- Title: `One URL change can ruin 500 flyers. That pain is more real than I expected.` +- Use replies: `2`, `4`, `11`, `12`, `15` + +```text +I underestimated how annoying printed mistakes are. + +A lot of software problems are reversible. +Print problems aren’t. + +If a landing page changes after flyers, posters, inserts, or menus are already out there, someone has to: +- live with a broken flow +- reprint everything +- or patch it manually in a messy way + +That sounds minor until you talk to people actually running campaigns or local businesses. + +What small operational problem ended up being much more expensive than it looked at first? +``` + +### 2026-03-19 Thursday, 13:00 + +- Subreddit: `r/SaaS` +- Post #1 +- Title: `I thought QR code software was about generation. The real pain starts after print.` +- Use replies: `1`, `7`, `10`, `11`, `15` + +```text +I used to think the value was “make a QR code fast.” + +It’s not. + +The painful part starts after something is already printed: +- the menu changes +- the event page changes +- the campaign URL changes +- someone notices a typo too late + +One small change can turn a stack of flyers into trash. + +That shifted how I think about the whole category. +The QR itself is easy. +The expensive part is everything around it. + +Anyone else building in a category where the “simple feature” isn’t actually where the value is? +``` + +### 2026-03-24 Tuesday, 13:30 + +- Subreddit: `r/smallbusiness` +- Post #3 +- Title: `Small businesses usually don’t need “more marketing.” They need fewer expensive mistakes.` +- Use replies: `3`, `4`, `10`, `12`, `13` + +```text +One thing I keep noticing: + +A lot of owners don’t care about having a fancy tool. +They care about not wasting money. + +With QR codes, the common mistakes seem to be: +- printing static codes for things that change often +- sending people to ugly mobile pages +- having no idea whether anyone scanned anything +- letting one outdated link stay live for weeks + +Feels like a lot of “marketing problems” are actually ops problems. + +What’s one small process change that saved your business money this year? +``` + +### 2026-03-26 Thursday, 13:00 + +- Subreddit: `r/EntrepreneurRideAlong` +- Post #4 +- Use replies: `2`, `4`, `9`, `11`, `15` + +```text +Building in a boring category taught me that boring problems are usually expensive + +I’m building around QR codes, which sounds incredibly boring on paper. + +But boring problems are often the ones people pay to avoid. + +In this case, it’s stuff like: +- reprinting menus +- fixing outdated flyers +- updating event info after posters are already out +- managing lots of QR destinations across campaigns + +Nobody is emotionally excited about QR codes. +They’re emotionally excited about not dealing with preventable mess. + +Anyone else building something “unsexy” that turned out to have very real pain behind it? +``` + +### 2026-03-27 Friday, 14:30 + +- Subreddit: `r/SideProject` +- Post #5 +- Title: `The weird part about building a QR product is that the technical problem isn’t the interesting one` +- Use replies: `1`, `6`, `7`, `8`, `15` + +```text +Generating a QR image is trivial. + +What turned out to be more interesting: +- what happens after print +- whether someone can change the destination later +- what analytics are actually useful +- how privacy concerns show up once tracking enters the conversation +- how bulk workflows matter way more than expected + +It’s one of those products that looks dumb-simple from the outside and much more operational once you talk to users. + +What kind of side project looked simple until real use cases started showing up? +``` + +### 2026-03-31 Tuesday, 14:00 + +- Subreddit: `r/AlphaandBetaTesters` +- Post #7 +- Use replies: `3`, `5`, `6`, `8`, `14` + +```text +Looking for feedback from anyone who has used QR codes in restaurants, events, print, or packaging + +I’m trying to learn from people who use QR codes in the real world, not just in theory. + +Especially if you’ve used them for: +- menus +- flyers +- product packaging +- event materials +- WiFi / contact sharing +- agency campaigns + +Things I’m curious about: +- what changes most often after something is printed? +- what’s annoying about current tools? +- do you actually care about scan analytics? +- does privacy / GDPR affect vendor choice at all? + +I’m happy to share what I’m building if useful, but mostly looking for honest feedback from people who’ve dealt with this firsthand. +``` + +### 2026-04-02 Thursday, 14:00 + +- Subreddit: `r/RoastMyStartup` +- Post #8 +- Use replies: `2`, `10`, `11`, `14`, `15` + +```text +Roast my positioning: is “avoid reprints and broken QR campaigns” a strong enough problem? + +I’m working on a product around dynamic QR codes. + +The positioning I’m testing is less “make QR codes” and more: +“avoid reprints, outdated links, and messy campaign management.” + +Target users are mostly: +- small businesses +- restaurants +- marketers +- agencies +- event / packaging use cases + +The questions I’d love roasted: +- does the pain feel real enough? +- does this sound too niche? +- what part sounds generic or weak? +- what would make you ignore this instantly? + +Happy to share the product if the sub is okay with it. +``` + +### 2026-04-03 Friday, 14:30 + +- Subreddit: `r/ProductMgmt` +- Post #6 +- Use replies: `1`, `7`, `8`, `10`, `12` + +```text +Users say they want a QR generator. What they actually want is damage control. + +A PM lesson I didn’t expect: + +People describe the need as “I need a QR code.” +But what they actually care about is something like: +“I need this thing to not break once it’s already printed.” + +That changes what feels important. + +“Generate code” sounds like the core feature. +But retention/value probably sits closer to: +- edit later +- track scans +- handle multiple codes +- avoid privacy headaches +- manage existing campaigns cleanly + +Have you seen that mismatch in your own product? +What users ask for first vs. what actually matters later? +``` + +### 2026-04-07 Tuesday, 14:00 + +- Subreddit: `r/startups` +- Post #9 +- Use replies: `1`, `7`, `9`, `10`, `15` + +```text +I’m starting to think “edit after print” is a stronger product promise than “track scans” + +Interesting thing from early positioning: + +I assumed analytics would be the hero feature. +But “I can change the destination later” seems to click faster. + +Makes sense in hindsight. +Tracking is nice. +Avoiding expensive mistakes is urgent. + +So now I’m wondering if the better message is: +- first promise control +- then introduce analytics +- then layer in bulk / workflow / privacy + +If you’ve sold into small businesses or marketers: +what kind of promise gets attention faster, insight or control? +``` + +### 2026-04-09 Thursday, 14:30 + +- Subreddit: `r/smallbusiness` +- Post #10 +- Use replies: `3`, `4`, `6`, `13`, `15` + +```text +What looks like a tiny print detail can quietly waste a lot of money + +I keep coming back to this: + +A broken link on a website is annoying. +A broken link on printed material is expensive. + +Because now the problem is sitting in: +- stores +- restaurants +- posters +- packaging +- tables +- flyers already handed out + +Feels like one of those things that sounds tiny until you count the friction and replacement cost. + +What’s a “small detail” in your business that causes way more downstream cost than people assume? +``` + diff --git a/marketing/reddit-4-week-calendar-universal.ics b/marketing/reddit-4-week-calendar-universal.ics index 694d37a..8ef4a3f 100644 --- a/marketing/reddit-4-week-calendar-universal.ics +++ b/marketing/reddit-4-week-calendar-universal.ics @@ -1,168 +1,168 @@ -BEGIN:VCALENDAR -VERSION:2.0 -PRODID:-//QR Master//Reddit 4 Week Calendar Universal//EN -CALSCALE:GREGORIAN -METHOD:PUBLISH -X-WR-CALNAME:QR Master Reddit Plan -X-WR-TIMEZONE:Europe/Berlin -BEGIN:VEVENT -UID:reddit-20260316-comments-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260316T133000Z -DTEND:20260316T141500Z -SUMMARY:Reddit comment block - r/startups + r/SaaS -DESCRIPTION:Warm up account and build relevant karma. No links unless asked directly. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260317-startups-post-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260317T120000Z -DTEND:20260317T124500Z -SUMMARY:Reddit post - r/startups -DESCRIPTION:Post: One URL change can ruin 500 flyers. Link only if asked. Use https://www.qrmaster.net/reprint-calculator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260318-startups-replies-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260318T133000Z -DTEND:20260318T141500Z -SUMMARY:Reddit replies - r/startups -DESCRIPTION:Reply to all serious comments from Tuesday. Keep link-free unless asked directly. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260319-saas-post-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260319T120000Z -DTEND:20260319T124500Z -SUMMARY:Reddit post - r/SaaS -DESCRIPTION:Post: The real pain starts after print. Link only if asked. Use https://www.qrmaster.net/dynamic-qr-code-generator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260320-saas-comments-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260320T133000Z -DTEND:20260320T141500Z -SUMMARY:Reddit comment block - r/SaaS -DESCRIPTION:Extend the Thursday discussion. Tracking link if needed: https://www.qrmaster.net/qr-code-tracking -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260323-smallbiz-sideproject-comments-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260323T133000Z -DTEND:20260323T141500Z -SUMMARY:Reddit comment block - r/smallbusiness + r/SideProject -DESCRIPTION:Warm both subs before posting this week. No links unless asked directly. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260324-smallbusiness-post-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260324T123000Z -DTEND:20260324T131500Z -SUMMARY:Reddit post - r/smallbusiness -DESCRIPTION:Post: Most small businesses do not need more tools. Default link if asked: https://www.qrmaster.net/reprint-calculator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260325-smallbusiness-replies-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260325T133000Z -DTEND:20260325T141500Z -SUMMARY:Reddit replies - r/smallbusiness -DESCRIPTION:Answer practical questions from Tuesday. Drop links only when the use case is obvious. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260326-sideproject-post-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260326T120000Z -DTEND:20260326T124500Z -SUMMARY:Reddit post - r/SideProject -DESCRIPTION:Post: The technical problem is not the interesting one. Core link: https://www.qrmaster.net/dynamic-qr-code-generator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260327-sideproject-comments-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260327T133000Z -DTEND:20260327T141500Z -SUMMARY:Reddit comment block - r/SideProject -DESCRIPTION:Follow up on Thursday. Bulk link if needed: https://www.qrmaster.net/bulk-qr-code-generator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260330-feedback-roast-comments-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260330T133000Z -DTEND:20260330T141500Z -SUMMARY:Reddit comment block - feedback week warm-up -DESCRIPTION:Warm up r/AlphaandBetaTesters and r/RoastMyStartup. No links today. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260331-alpha-beta-post-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260331T120000Z -DTEND:20260331T124500Z -SUMMARY:Reddit post - r/AlphaandBetaTesters -DESCRIPTION:Feedback request. Put the link in the first comment. Use https://www.qrmaster.net/dynamic-qr-code-generator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260401-alpha-beta-replies-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260401T133000Z -DTEND:20260401T141500Z -SUMMARY:Reddit replies - r/AlphaandBetaTesters -DESCRIPTION:Answer all serious feedback. Privacy proof only if asked: https://www.qrmaster.net/privacy -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260402-roast-post-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260402T120000Z -DTEND:20260402T124500Z -SUMMARY:Reddit post - r/RoastMyStartup -DESCRIPTION:Roast my positioning. Direct site link is okay here: https://www.qrmaster.net/ -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260403-objection-review-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260403T133000Z -DTEND:20260403T141500Z -SUMMARY:Reddit objection review -DESCRIPTION:Summarize week 3 objections: pricing, niche, privacy, free generator comparison, ICP clarity. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260406-saas-comments-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260406T133000Z -DTEND:20260406T141500Z -SUMMARY:Reddit comment block - r/SaaS -DESCRIPTION:Re-enter with objection-informed comments before the next post. No links unless asked. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260407-saas-post-2-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260407T120000Z -DTEND:20260407T124500Z -SUMMARY:Reddit post - r/SaaS follow-up -DESCRIPTION:Post: edit later vs track scans. Default link if asked: https://www.qrmaster.net/dynamic-qr-code-generator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260408-saas-replies-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260408T133000Z -DTEND:20260408T141500Z -SUMMARY:Reddit replies - r/SaaS -DESCRIPTION:Work the Tuesday thread hard for comments, not just upvotes. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260409-promo-post-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260409T123000Z -DTEND:20260409T131500Z -SUMMARY:Reddit promo post -DESCRIPTION:Post in r/Plugyourproduct or r/startups_promotion. Direct link okay: https://www.qrmaster.net/ -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260410-followup-universal@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260410T133000Z -DTEND:20260410T141500Z -SUMMARY:Reddit follow-up block -DESCRIPTION:Answer all promo-thread comments publicly. No DMs, no pressure. -END:VEVENT -END:VCALENDAR +BEGIN:VCALENDAR +VERSION:2.0 +PRODID:-//QR Master//Reddit 4 Week Calendar Universal//EN +CALSCALE:GREGORIAN +METHOD:PUBLISH +X-WR-CALNAME:QR Master Reddit Plan +X-WR-TIMEZONE:Europe/Berlin +BEGIN:VEVENT +UID:reddit-20260316-comments-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260316T133000Z +DTEND:20260316T141500Z +SUMMARY:Reddit comment block - r/startups + r/SaaS +DESCRIPTION:Warm up account and build relevant karma. No links unless asked directly. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260317-startups-post-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260317T120000Z +DTEND:20260317T124500Z +SUMMARY:Reddit post - r/startups +DESCRIPTION:Post: One URL change can ruin 500 flyers. Link only if asked. Use https://www.qrmaster.net/reprint-calculator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260318-startups-replies-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260318T133000Z +DTEND:20260318T141500Z +SUMMARY:Reddit replies - r/startups +DESCRIPTION:Reply to all serious comments from Tuesday. Keep link-free unless asked directly. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260319-saas-post-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260319T120000Z +DTEND:20260319T124500Z +SUMMARY:Reddit post - r/SaaS +DESCRIPTION:Post: The real pain starts after print. Link only if asked. Use https://www.qrmaster.net/dynamic-qr-code-generator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260320-saas-comments-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260320T133000Z +DTEND:20260320T141500Z +SUMMARY:Reddit comment block - r/SaaS +DESCRIPTION:Extend the Thursday discussion. Tracking link if needed: https://www.qrmaster.net/qr-code-tracking +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260323-smallbiz-sideproject-comments-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260323T133000Z +DTEND:20260323T141500Z +SUMMARY:Reddit comment block - r/smallbusiness + r/SideProject +DESCRIPTION:Warm both subs before posting this week. No links unless asked directly. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260324-smallbusiness-post-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260324T123000Z +DTEND:20260324T131500Z +SUMMARY:Reddit post - r/smallbusiness +DESCRIPTION:Post: Most small businesses do not need more tools. Default link if asked: https://www.qrmaster.net/reprint-calculator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260325-smallbusiness-replies-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260325T133000Z +DTEND:20260325T141500Z +SUMMARY:Reddit replies - r/smallbusiness +DESCRIPTION:Answer practical questions from Tuesday. Drop links only when the use case is obvious. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260326-sideproject-post-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260326T120000Z +DTEND:20260326T124500Z +SUMMARY:Reddit post - r/SideProject +DESCRIPTION:Post: The technical problem is not the interesting one. Core link: https://www.qrmaster.net/dynamic-qr-code-generator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260327-sideproject-comments-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260327T133000Z +DTEND:20260327T141500Z +SUMMARY:Reddit comment block - r/SideProject +DESCRIPTION:Follow up on Thursday. Bulk link if needed: https://www.qrmaster.net/bulk-qr-code-generator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260330-feedback-roast-comments-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260330T133000Z +DTEND:20260330T141500Z +SUMMARY:Reddit comment block - feedback week warm-up +DESCRIPTION:Warm up r/AlphaandBetaTesters and r/RoastMyStartup. No links today. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260331-alpha-beta-post-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260331T120000Z +DTEND:20260331T124500Z +SUMMARY:Reddit post - r/AlphaandBetaTesters +DESCRIPTION:Feedback request. Put the link in the first comment. Use https://www.qrmaster.net/dynamic-qr-code-generator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260401-alpha-beta-replies-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260401T133000Z +DTEND:20260401T141500Z +SUMMARY:Reddit replies - r/AlphaandBetaTesters +DESCRIPTION:Answer all serious feedback. Privacy proof only if asked: https://www.qrmaster.net/privacy +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260402-roast-post-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260402T120000Z +DTEND:20260402T124500Z +SUMMARY:Reddit post - r/RoastMyStartup +DESCRIPTION:Roast my positioning. Direct site link is okay here: https://www.qrmaster.net/ +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260403-objection-review-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260403T133000Z +DTEND:20260403T141500Z +SUMMARY:Reddit objection review +DESCRIPTION:Summarize week 3 objections: pricing, niche, privacy, free generator comparison, ICP clarity. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260406-saas-comments-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260406T133000Z +DTEND:20260406T141500Z +SUMMARY:Reddit comment block - r/SaaS +DESCRIPTION:Re-enter with objection-informed comments before the next post. No links unless asked. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260407-saas-post-2-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260407T120000Z +DTEND:20260407T124500Z +SUMMARY:Reddit post - r/SaaS follow-up +DESCRIPTION:Post: edit later vs track scans. Default link if asked: https://www.qrmaster.net/dynamic-qr-code-generator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260408-saas-replies-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260408T133000Z +DTEND:20260408T141500Z +SUMMARY:Reddit replies - r/SaaS +DESCRIPTION:Work the Tuesday thread hard for comments, not just upvotes. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260409-promo-post-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260409T123000Z +DTEND:20260409T131500Z +SUMMARY:Reddit promo post +DESCRIPTION:Post in r/Plugyourproduct or r/startups_promotion. Direct link okay: https://www.qrmaster.net/ +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260410-followup-universal@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260410T133000Z +DTEND:20260410T141500Z +SUMMARY:Reddit follow-up block +DESCRIPTION:Answer all promo-thread comments publicly. No DMs, no pressure. +END:VEVENT +END:VCALENDAR diff --git a/marketing/reddit-4-week-calendar.ics b/marketing/reddit-4-week-calendar.ics index 9244af6..df49780 100644 --- a/marketing/reddit-4-week-calendar.ics +++ b/marketing/reddit-4-week-calendar.ics @@ -1,166 +1,166 @@ -BEGIN:VCALENDAR -VERSION:2.0 -PRODID:-//QR Master//Reddit 4 Week Calendar//EN -CALSCALE:GREGORIAN -METHOD:PUBLISH -BEGIN:VEVENT -UID:reddit-20260316-comments@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260316T143000 -DTEND:20260316T151500 -SUMMARY:Reddit comment block - r/startups + r/SaaS -DESCRIPTION:Goal: warm up account and build relevant karma. No links unless asked directly. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260317-startups-post@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260317T130000 -DTEND:20260317T134500 -SUMMARY:Reddit post - r/startups -DESCRIPTION:Title: One URL change can ruin 500 flyers. Link only if asked. Use https://www.qrmaster.net/reprint-calculator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260318-startups-replies@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260318T143000 -DTEND:20260318T151500 -SUMMARY:Reddit replies - r/startups -DESCRIPTION:Reply to all serious comments from Tuesday. Keep link-free unless asked directly. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260319-saas-post@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260319T130000 -DTEND:20260319T134500 -SUMMARY:Reddit post - r/SaaS -DESCRIPTION:Title: The real pain starts after print. Link only if asked. Use https://www.qrmaster.net/dynamic-qr-code-generator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260320-saas-comments@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260320T143000 -DTEND:20260320T151500 -SUMMARY:Reddit comment block - r/SaaS -DESCRIPTION:Extend the Thursday discussion. If asked about tracking, use https://www.qrmaster.net/qr-code-tracking -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260323-smallbiz-sideproject-comments@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260323T143000 -DTEND:20260323T151500 -SUMMARY:Reddit comment block - r/smallbusiness + r/SideProject -DESCRIPTION:Warm both subs before posting this week. No links unless asked directly. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260324-smallbusiness-post@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260324T133000 -DTEND:20260324T141500 -SUMMARY:Reddit post - r/smallbusiness -DESCRIPTION:Title: Most small businesses don't need more tools. Default link if asked: https://www.qrmaster.net/reprint-calculator Restaurant link: https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260325-smallbusiness-replies@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260325T143000 -DTEND:20260325T151500 -SUMMARY:Reddit replies - r/smallbusiness -DESCRIPTION:Answer practical questions from Tuesday. Drop links only when the use case is obvious. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260326-sideproject-post@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260326T130000 -DTEND:20260326T134500 -SUMMARY:Reddit post - r/SideProject -DESCRIPTION:Title: The technical problem isn't the interesting one. Core link if asked: https://www.qrmaster.net/dynamic-qr-code-generator Bulk link: https://www.qrmaster.net/bulk-qr-code-generator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260327-sideproject-comments@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260327T143000 -DTEND:20260327T151500 -SUMMARY:Reddit comment block - r/SideProject -DESCRIPTION:Follow up on the Thursday thread. Use bulk link if people ask about scale or packaging. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260330-feedback-roast-comments@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260330T153000 -DTEND:20260330T161500 -SUMMARY:Reddit comment block - feedback week warm-up -DESCRIPTION:Warm up r/AlphaandBetaTesters and r/RoastMyStartup. No links today. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260331-alpha-beta-post@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260331T140000 -DTEND:20260331T144500 -SUMMARY:Reddit post - r/AlphaandBetaTesters -DESCRIPTION:Feedback request. Put the link in the first comment, not the post body. Use https://www.qrmaster.net/dynamic-qr-code-generator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260401-alpha-beta-replies@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260401T153000 -DTEND:20260401T161500 -SUMMARY:Reddit replies - r/AlphaandBetaTesters -DESCRIPTION:Answer all serious feedback. Privacy proof only if asked: https://www.qrmaster.net/privacy -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260402-roast-post@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260402T140000 -DTEND:20260402T144500 -SUMMARY:Reddit post - r/RoastMyStartup -DESCRIPTION:Roast my positioning. Direct site link is okay here: https://www.qrmaster.net/ -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260403-objection-review@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260403T153000 -DTEND:20260403T161500 -SUMMARY:Reddit objection review -DESCRIPTION:Summarize the week-3 objections: pricing, niche, privacy, free generator comparison, ICP clarity. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260406-saas-comments@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260406T153000 -DTEND:20260406T161500 -SUMMARY:Reddit comment block - r/SaaS -DESCRIPTION:Re-enter with objection-informed comments before the next post. No links unless asked. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260407-saas-post-2@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260407T140000 -DTEND:20260407T144500 -SUMMARY:Reddit post - r/SaaS follow-up -DESCRIPTION:Title: edit later vs track scans. Default link if asked: https://www.qrmaster.net/dynamic-qr-code-generator Measurement angle: https://www.qrmaster.net/qr-code-for-marketing-campaigns -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260408-saas-replies@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260408T153000 -DTEND:20260408T161500 -SUMMARY:Reddit replies - r/SaaS -DESCRIPTION:Work the Tuesday thread hard for comments, not just upvotes. -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260409-promo-post@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260409T143000 -DTEND:20260409T151500 -SUMMARY:Reddit promo post - r/Plugyourproduct or r/startups_promotion -DESCRIPTION:Direct link in post is okay. Use https://www.qrmaster.net/ Optional focused link: https://www.qrmaster.net/dynamic-qr-code-generator -END:VEVENT -BEGIN:VEVENT -UID:reddit-20260410-followup@qrmaster.net -DTSTAMP:20260312T120000Z -DTSTART:20260410T153000 -DTEND:20260410T161500 -SUMMARY:Reddit follow-up block -DESCRIPTION:Answer all promo-thread comments publicly. No DMs, no pressure, keep it in-thread. -END:VEVENT -END:VCALENDAR +BEGIN:VCALENDAR +VERSION:2.0 +PRODID:-//QR Master//Reddit 4 Week Calendar//EN +CALSCALE:GREGORIAN +METHOD:PUBLISH +BEGIN:VEVENT +UID:reddit-20260316-comments@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260316T143000 +DTEND:20260316T151500 +SUMMARY:Reddit comment block - r/startups + r/SaaS +DESCRIPTION:Goal: warm up account and build relevant karma. No links unless asked directly. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260317-startups-post@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260317T130000 +DTEND:20260317T134500 +SUMMARY:Reddit post - r/startups +DESCRIPTION:Title: One URL change can ruin 500 flyers. Link only if asked. Use https://www.qrmaster.net/reprint-calculator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260318-startups-replies@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260318T143000 +DTEND:20260318T151500 +SUMMARY:Reddit replies - r/startups +DESCRIPTION:Reply to all serious comments from Tuesday. Keep link-free unless asked directly. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260319-saas-post@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260319T130000 +DTEND:20260319T134500 +SUMMARY:Reddit post - r/SaaS +DESCRIPTION:Title: The real pain starts after print. Link only if asked. Use https://www.qrmaster.net/dynamic-qr-code-generator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260320-saas-comments@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260320T143000 +DTEND:20260320T151500 +SUMMARY:Reddit comment block - r/SaaS +DESCRIPTION:Extend the Thursday discussion. If asked about tracking, use https://www.qrmaster.net/qr-code-tracking +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260323-smallbiz-sideproject-comments@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260323T143000 +DTEND:20260323T151500 +SUMMARY:Reddit comment block - r/smallbusiness + r/SideProject +DESCRIPTION:Warm both subs before posting this week. No links unless asked directly. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260324-smallbusiness-post@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260324T133000 +DTEND:20260324T141500 +SUMMARY:Reddit post - r/smallbusiness +DESCRIPTION:Title: Most small businesses don't need more tools. Default link if asked: https://www.qrmaster.net/reprint-calculator Restaurant link: https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260325-smallbusiness-replies@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260325T143000 +DTEND:20260325T151500 +SUMMARY:Reddit replies - r/smallbusiness +DESCRIPTION:Answer practical questions from Tuesday. Drop links only when the use case is obvious. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260326-sideproject-post@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260326T130000 +DTEND:20260326T134500 +SUMMARY:Reddit post - r/SideProject +DESCRIPTION:Title: The technical problem isn't the interesting one. Core link if asked: https://www.qrmaster.net/dynamic-qr-code-generator Bulk link: https://www.qrmaster.net/bulk-qr-code-generator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260327-sideproject-comments@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260327T143000 +DTEND:20260327T151500 +SUMMARY:Reddit comment block - r/SideProject +DESCRIPTION:Follow up on the Thursday thread. Use bulk link if people ask about scale or packaging. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260330-feedback-roast-comments@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260330T153000 +DTEND:20260330T161500 +SUMMARY:Reddit comment block - feedback week warm-up +DESCRIPTION:Warm up r/AlphaandBetaTesters and r/RoastMyStartup. No links today. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260331-alpha-beta-post@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260331T140000 +DTEND:20260331T144500 +SUMMARY:Reddit post - r/AlphaandBetaTesters +DESCRIPTION:Feedback request. Put the link in the first comment, not the post body. Use https://www.qrmaster.net/dynamic-qr-code-generator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260401-alpha-beta-replies@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260401T153000 +DTEND:20260401T161500 +SUMMARY:Reddit replies - r/AlphaandBetaTesters +DESCRIPTION:Answer all serious feedback. Privacy proof only if asked: https://www.qrmaster.net/privacy +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260402-roast-post@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260402T140000 +DTEND:20260402T144500 +SUMMARY:Reddit post - r/RoastMyStartup +DESCRIPTION:Roast my positioning. Direct site link is okay here: https://www.qrmaster.net/ +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260403-objection-review@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260403T153000 +DTEND:20260403T161500 +SUMMARY:Reddit objection review +DESCRIPTION:Summarize the week-3 objections: pricing, niche, privacy, free generator comparison, ICP clarity. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260406-saas-comments@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260406T153000 +DTEND:20260406T161500 +SUMMARY:Reddit comment block - r/SaaS +DESCRIPTION:Re-enter with objection-informed comments before the next post. No links unless asked. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260407-saas-post-2@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260407T140000 +DTEND:20260407T144500 +SUMMARY:Reddit post - r/SaaS follow-up +DESCRIPTION:Title: edit later vs track scans. Default link if asked: https://www.qrmaster.net/dynamic-qr-code-generator Measurement angle: https://www.qrmaster.net/qr-code-for-marketing-campaigns +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260408-saas-replies@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260408T153000 +DTEND:20260408T161500 +SUMMARY:Reddit replies - r/SaaS +DESCRIPTION:Work the Tuesday thread hard for comments, not just upvotes. +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260409-promo-post@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260409T143000 +DTEND:20260409T151500 +SUMMARY:Reddit promo post - r/Plugyourproduct or r/startups_promotion +DESCRIPTION:Direct link in post is okay. Use https://www.qrmaster.net/ Optional focused link: https://www.qrmaster.net/dynamic-qr-code-generator +END:VEVENT +BEGIN:VEVENT +UID:reddit-20260410-followup@qrmaster.net +DTSTAMP:20260312T120000Z +DTSTART:20260410T153000 +DTEND:20260410T161500 +SUMMARY:Reddit follow-up block +DESCRIPTION:Answer all promo-thread comments publicly. No DMs, no pressure, keep it in-thread. +END:VEVENT +END:VCALENDAR diff --git a/marketing/reddit-4-week-calendar.md b/marketing/reddit-4-week-calendar.md index def4dfd..8d60ef2 100644 --- a/marketing/reddit-4-week-calendar.md +++ b/marketing/reddit-4-week-calendar.md @@ -1,457 +1,457 @@ -# Reddit 4-Week Calendar for QR Master - -Times below are in Europe/Berlin local time. -Use clean URLs only. Do not add UTM parameters to public Reddit links. - -## Link Map - -- Reprint / cost angle: `https://www.qrmaster.net/reprint-calculator` -- Dynamic after print: `https://www.qrmaster.net/dynamic-qr-code-generator` -- Restaurant / menu angle: `https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes` -- Flyer / print attribution: `https://www.qrmaster.net/use-cases/flyer-qr-codes` -- Campaign measurement: `https://www.qrmaster.net/qr-code-for-marketing-campaigns` -- Tracking / analytics: `https://www.qrmaster.net/qr-code-tracking` -- Bulk / packaging: `https://www.qrmaster.net/bulk-qr-code-generator` -- Packaging use case: `https://www.qrmaster.net/use-cases/packaging-qr-codes` -- Privacy proof only: `https://www.qrmaster.net/privacy` -- Full site feedback / promo-only subs: `https://www.qrmaster.net/` - -## 2026-03-16 Monday, 14:30 - -- Type: Comment block -- Subreddits: `r/startups`, `r/SaaS` -- Goal: Warm up account and build relevant karma -- Rule: No links unless someone explicitly asks -- Comment prompt ideas: - - "The expensive part starts after print, not at QR generation." - - "A lot of SMB tools sound boring until one mistake turns printed material into waste." - - "I care less about the QR itself and more about what happens when the destination changes later." - -## 2026-03-17 Tuesday, 13:00 - -- Type: Main post -- Subreddit: `r/startups` -- Title: `One URL change can ruin 500 flyers. That pain is more real than I expected.` -- Body: - -```text -I underestimated how annoying printed mistakes are. - -A lot of software problems are reversible. -Print problems aren’t. - -If a landing page changes after flyers, posters, inserts, or menus are already out there, someone has to: -- live with a broken flow -- reprint everything -- or patch it manually in a messy way - -That sounds minor until you talk to people actually running campaigns or local businesses. - -What small operational problem ended up being much more expensive than it looked at first? -``` - -- Link if asked: `https://www.qrmaster.net/reprint-calculator` -- Possible replies: - -```text -Yeah, that’s the part I underestimated too. The QR itself is easy. The expensive part is when the destination changes after print. -``` - -```text -I built around exactly that issue, so obvious bias here: -https://www.qrmaster.net/reprint-calculator - -If links are annoying in this thread, I can just explain the workflow here. -``` - -```text -Static is fine if the URL is truly permanent. The pain starts when someone assumes “permanent” and the campaign changes two weeks later. -``` - -## 2026-03-18 Wednesday, 14:30 - -- Type: Reply block -- Subreddits: `r/startups` -- Goal: Reply to every serious comment from the Tuesday post -- Link rule: Only if asked directly -- Safe reply template: - -```text -That’s fair. I’m building in this space, so obvious bias if I share the product. Happy to keep it link-free and just explain the setup. -``` - -## 2026-03-19 Thursday, 13:00 - -- Type: Main post -- Subreddit: `r/SaaS` -- Title: `I thought QR code software was about generation. The real pain starts after print.` -- Body: - -```text -I used to think the value was “make a QR code fast.” - -It’s not. - -The painful part starts after something is already printed: -- the menu changes -- the event page changes -- the campaign URL changes -- someone notices a typo too late - -One small change can turn a stack of flyers into trash. - -That shifted how I think about the whole category. -The QR itself is easy. -The expensive part is everything around it. - -Anyone else building in a category where the “simple feature” isn’t actually where the value is? -``` - -- Link if asked: `https://www.qrmaster.net/dynamic-qr-code-generator` -- Possible replies: - -```text -That’s exactly how I see it now too. “Generate” sounds like the product, but “edit after print” is where the value starts. -``` - -```text -I built a tool for that exact use case, so obvious founder bias: -https://www.qrmaster.net/dynamic-qr-code-generator -``` - -```text -I thought analytics would be the hook. In practice, “don’t make me reprint stuff” lands faster. -``` - -## 2026-03-20 Friday, 14:30 - -- Type: Comment block -- Subreddits: `r/SaaS` -- Goal: Extend the Thursday discussion without posting a new link -- If someone asks about tracking: `https://www.qrmaster.net/qr-code-tracking` -- Safe tracking reply: - -```text -If the goal is proof instead of guesswork, tracking matters. I’m building in that space too, so obvious bias: -https://www.qrmaster.net/qr-code-tracking -``` - -## 2026-03-23 Monday, 14:30 - -- Type: Comment block -- Subreddits: `r/smallbusiness`, `r/SideProject` -- Goal: Warm both subs before posting this week -- Rule: No link unless asked directly - -## 2026-03-24 Tuesday, 13:30 - -- Type: Main post -- Subreddit: `r/smallbusiness` -- Title: `Most small businesses don’t need more tools. They need fewer preventable mistakes.` -- Body: - -```text -I keep seeing the same pattern: - -Owners usually don’t want “more software.” -They want fewer headaches. - -With QR codes, the common headaches seem to be: -- printing a code that can’t be updated later -- linking to a bad mobile page -- not knowing if anyone scanned it -- having to redo materials because one URL changed - -That feels less like a marketing problem and more like an operations problem. - -What low-effort process change saved you time or money recently? -``` - -- Default link if asked: `https://www.qrmaster.net/reprint-calculator` -- Restaurant/menu link if relevant: `https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes` -- Possible replies: - -```text -That’s basically how I think about it now too. Most owners don’t want a “QR platform.” They want to avoid paying twice for the same print run. -``` - -```text -If the menu changes regularly, I wouldn’t print a static QR. I built around exactly that use case, so bias disclosed: -https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes -``` - -```text -For a more general cost angle, this is the cleanest page to share: -https://www.qrmaster.net/reprint-calculator -``` - -## 2026-03-25 Wednesday, 14:30 - -- Type: Reply block -- Subreddits: `r/smallbusiness` -- Goal: Answer every practical question from the Tuesday post -- Rule: Only drop a link when the use case is obvious - -## 2026-03-26 Thursday, 13:00 - -- Type: Main post -- Subreddit: `r/SideProject` -- Title: `The weird part about building a QR product is that the technical problem isn’t the interesting one` -- Body: - -```text -Generating a QR image is trivial. - -What turned out to be more interesting: -- what happens after print -- whether someone can change the destination later -- what analytics are actually useful -- how privacy concerns show up once tracking enters the conversation -- how bulk workflows matter way more than expected - -It’s one of those products that looks dumb-simple from the outside and much more operational once you talk to users. - -What kind of side project looked simple until real use cases started showing up? -``` - -- Link if asked: `https://www.qrmaster.net/dynamic-qr-code-generator` -- Bulk link if someone asks about scale: `https://www.qrmaster.net/bulk-qr-code-generator` -- Possible replies: - -```text -Exactly. The QR itself is not the product. The post-print control is. -``` - -```text -I built around that exact issue, so obvious bias: -https://www.qrmaster.net/dynamic-qr-code-generator -``` - -```text -If the interesting part for you is scale, the bulk side is here: -https://www.qrmaster.net/bulk-qr-code-generator -``` - -## 2026-03-27 Friday, 14:30 - -- Type: Comment block -- Subreddits: `r/SideProject` -- Goal: Follow up on the Thursday thread and answer bulk/packaging questions -- Primary link if relevant: `https://www.qrmaster.net/bulk-qr-code-generator` - -## 2026-03-30 Monday, 15:30 - -- Type: Comment block -- Subreddits: `r/AlphaandBetaTesters`, `r/RoastMyStartup` -- Goal: Warm up both communities before feedback posts -- Rule: No links today - -## 2026-03-31 Tuesday, 14:00 - -- Type: Feedback post -- Subreddit: `r/AlphaandBetaTesters` -- Title: `Looking for feedback from anyone who has used QR codes in restaurants, events, print, or packaging` -- Body: - -```text -I’m trying to learn from people who use QR codes in the real world, not just in theory. - -Especially if you’ve used them for: -- menus -- flyers -- product packaging -- event materials -- WiFi / contact sharing -- agency campaigns - -Things I’m curious about: -- what changes most often after something is printed? -- what’s annoying about current tools? -- do you actually care about scan analytics? -- does privacy / GDPR affect vendor choice at all? - -I’m happy to share what I’m building if useful, but mostly looking for honest feedback from people who’ve dealt with this firsthand. -``` - -- Link placement: first comment, not the post body -- First comment link: `https://www.qrmaster.net/dynamic-qr-code-generator` -- Possible replies: - -```text -This is the product I’m testing the messaging on, so obvious bias: -https://www.qrmaster.net/dynamic-qr-code-generator -``` - -```text -That’s useful. The thing I keep hearing too is that the problem starts once something is already printed. -``` - -```text -If the privacy side is the bigger concern, I can share how I’m handling that specifically instead of pitching the product. -``` - -## 2026-04-01 Wednesday, 15:30 - -- Type: Reply block -- Subreddits: `r/AlphaandBetaTesters` -- Goal: Answer all serious feedback and record objections -- Privacy proof link only if asked: `https://www.qrmaster.net/privacy` - -## 2026-04-02 Thursday, 14:00 - -- Type: Roast post -- Subreddit: `r/RoastMyStartup` -- Title: `Roast my positioning: is “avoid reprints and broken QR campaigns” a strong enough problem?` -- Body: - -```text -I’m working on a product around dynamic QR codes. - -The positioning I’m testing is less “make QR codes” and more: -“avoid reprints, outdated links, and messy campaign management.” - -Target users are mostly: -- small businesses -- restaurants -- marketers -- agencies -- event / packaging use cases - -The questions I’d love roasted: -- does the pain feel real enough? -- does this sound too niche? -- what part sounds generic or weak? -- what would make you ignore this instantly? - -Happy to share the product if the sub is okay with it. -``` - -- Link placement: direct link in post is okay -- Link: `https://www.qrmaster.net/` -- Possible replies: - -```text -Fair. The goal here is honestly sharper criticism, not a soft launch. -``` - -```text -That’s a good callout. If the pain still sounds too “small,” then the messaging isn’t strong enough yet. -``` - -```text -Yep, that’s the site: -https://www.qrmaster.net/ -``` - -## 2026-04-03 Friday, 15:30 - -- Type: Objection review -- Goal: Summarize the week-3 feedback into 3 to 5 objections -- Typical objection buckets: - - "why pay for QR codes?" - - "sounds niche" - - "privacy / GDPR?" - - "what’s different from free generators?" - - "who is this really for?" - -## 2026-04-06 Monday, 15:30 - -- Type: Comment block -- Subreddits: `r/SaaS` -- Goal: Re-enter with objection-informed comments before the next post -- Rule: No links unless asked - -## 2026-04-07 Tuesday, 14:00 - -- Type: Main post -- Subreddit: `r/SaaS` -- Title: `I’m starting to think “edit later” is a stronger product promise than “track scans”` -- Body: - -```text -Interesting thing from early positioning: - -I assumed analytics would be the hero feature. -But “I can change the destination later” seems to click faster. - -Makes sense in hindsight. -Tracking is nice. -Avoiding expensive mistakes is urgent. - -So now I’m wondering if the better message is: -- first promise control -- then introduce analytics -- then layer in bulk / workflow / privacy - -If you’ve sold into small businesses or marketers: -what kind of promise gets attention faster, insight or control? -``` - -- Default link if asked: `https://www.qrmaster.net/dynamic-qr-code-generator` -- If the thread becomes measurement-heavy: `https://www.qrmaster.net/qr-code-for-marketing-campaigns` -- Possible replies: - -```text -That’s exactly the split I’m seeing too. “Insight” sounds nice, “control” feels urgent. -``` - -```text -I built around that exact use case, so obvious bias: -https://www.qrmaster.net/dynamic-qr-code-generator -``` - -```text -If the attribution side is the interesting part for you, this is the more relevant page: -https://www.qrmaster.net/qr-code-for-marketing-campaigns -``` - -## 2026-04-08 Wednesday, 15:30 - -- Type: Reply block -- Subreddits: `r/SaaS` -- Goal: Work the Tuesday thread hard for comments, not just upvotes - -## 2026-04-09 Thursday, 14:30 - -- Type: Promo post -- Subreddit: `r/Plugyourproduct` or `r/startups_promotion` -- Title: `QR Master: editable QR codes for print campaigns, menus, packaging, and analytics` -- Body: - -```text -Built QR Master to solve a simple but expensive problem: -people print QR codes, then the destination changes later. - -What it does: -- editable QR destinations after print -- scan tracking -- bulk workflows -- campaign-friendly use cases for menus, flyers, events, and packaging - -Looking for honest feedback on the value prop and landing page clarity. -``` - -- Link placement: direct link in post -- Link: `https://www.qrmaster.net/` -- Possible replies: - -```text -Appreciate it. The core promise is really “don’t reprint just because the URL changed.” -``` - -```text -If you want the most direct core page instead of the homepage, this is it: -https://www.qrmaster.net/dynamic-qr-code-generator -``` - -```text -If you’re more interested in measurement than editability, this page is the better entry point: -https://www.qrmaster.net/qr-code-tracking -``` - -## 2026-04-10 Friday, 15:30 - -- Type: Follow-up block -- Goal: Answer all promo-thread comments publicly and close the 4-week run -- Rule: No DMs, no pressure, keep every answer in-thread - +# Reddit 4-Week Calendar for QR Master + +Times below are in Europe/Berlin local time. +Use clean URLs only. Do not add UTM parameters to public Reddit links. + +## Link Map + +- Reprint / cost angle: `https://www.qrmaster.net/reprint-calculator` +- Dynamic after print: `https://www.qrmaster.net/dynamic-qr-code-generator` +- Restaurant / menu angle: `https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes` +- Flyer / print attribution: `https://www.qrmaster.net/use-cases/flyer-qr-codes` +- Campaign measurement: `https://www.qrmaster.net/qr-code-for-marketing-campaigns` +- Tracking / analytics: `https://www.qrmaster.net/qr-code-tracking` +- Bulk / packaging: `https://www.qrmaster.net/bulk-qr-code-generator` +- Packaging use case: `https://www.qrmaster.net/use-cases/packaging-qr-codes` +- Privacy proof only: `https://www.qrmaster.net/privacy` +- Full site feedback / promo-only subs: `https://www.qrmaster.net/` + +## 2026-03-16 Monday, 14:30 + +- Type: Comment block +- Subreddits: `r/startups`, `r/SaaS` +- Goal: Warm up account and build relevant karma +- Rule: No links unless someone explicitly asks +- Comment prompt ideas: + - "The expensive part starts after print, not at QR generation." + - "A lot of SMB tools sound boring until one mistake turns printed material into waste." + - "I care less about the QR itself and more about what happens when the destination changes later." + +## 2026-03-17 Tuesday, 13:00 + +- Type: Main post +- Subreddit: `r/startups` +- Title: `One URL change can ruin 500 flyers. That pain is more real than I expected.` +- Body: + +```text +I underestimated how annoying printed mistakes are. + +A lot of software problems are reversible. +Print problems aren’t. + +If a landing page changes after flyers, posters, inserts, or menus are already out there, someone has to: +- live with a broken flow +- reprint everything +- or patch it manually in a messy way + +That sounds minor until you talk to people actually running campaigns or local businesses. + +What small operational problem ended up being much more expensive than it looked at first? +``` + +- Link if asked: `https://www.qrmaster.net/reprint-calculator` +- Possible replies: + +```text +Yeah, that’s the part I underestimated too. The QR itself is easy. The expensive part is when the destination changes after print. +``` + +```text +I built around exactly that issue, so obvious bias here: +https://www.qrmaster.net/reprint-calculator + +If links are annoying in this thread, I can just explain the workflow here. +``` + +```text +Static is fine if the URL is truly permanent. The pain starts when someone assumes “permanent” and the campaign changes two weeks later. +``` + +## 2026-03-18 Wednesday, 14:30 + +- Type: Reply block +- Subreddits: `r/startups` +- Goal: Reply to every serious comment from the Tuesday post +- Link rule: Only if asked directly +- Safe reply template: + +```text +That’s fair. I’m building in this space, so obvious bias if I share the product. Happy to keep it link-free and just explain the setup. +``` + +## 2026-03-19 Thursday, 13:00 + +- Type: Main post +- Subreddit: `r/SaaS` +- Title: `I thought QR code software was about generation. The real pain starts after print.` +- Body: + +```text +I used to think the value was “make a QR code fast.” + +It’s not. + +The painful part starts after something is already printed: +- the menu changes +- the event page changes +- the campaign URL changes +- someone notices a typo too late + +One small change can turn a stack of flyers into trash. + +That shifted how I think about the whole category. +The QR itself is easy. +The expensive part is everything around it. + +Anyone else building in a category where the “simple feature” isn’t actually where the value is? +``` + +- Link if asked: `https://www.qrmaster.net/dynamic-qr-code-generator` +- Possible replies: + +```text +That’s exactly how I see it now too. “Generate” sounds like the product, but “edit after print” is where the value starts. +``` + +```text +I built a tool for that exact use case, so obvious founder bias: +https://www.qrmaster.net/dynamic-qr-code-generator +``` + +```text +I thought analytics would be the hook. In practice, “don’t make me reprint stuff” lands faster. +``` + +## 2026-03-20 Friday, 14:30 + +- Type: Comment block +- Subreddits: `r/SaaS` +- Goal: Extend the Thursday discussion without posting a new link +- If someone asks about tracking: `https://www.qrmaster.net/qr-code-tracking` +- Safe tracking reply: + +```text +If the goal is proof instead of guesswork, tracking matters. I’m building in that space too, so obvious bias: +https://www.qrmaster.net/qr-code-tracking +``` + +## 2026-03-23 Monday, 14:30 + +- Type: Comment block +- Subreddits: `r/smallbusiness`, `r/SideProject` +- Goal: Warm both subs before posting this week +- Rule: No link unless asked directly + +## 2026-03-24 Tuesday, 13:30 + +- Type: Main post +- Subreddit: `r/smallbusiness` +- Title: `Most small businesses don’t need more tools. They need fewer preventable mistakes.` +- Body: + +```text +I keep seeing the same pattern: + +Owners usually don’t want “more software.” +They want fewer headaches. + +With QR codes, the common headaches seem to be: +- printing a code that can’t be updated later +- linking to a bad mobile page +- not knowing if anyone scanned it +- having to redo materials because one URL changed + +That feels less like a marketing problem and more like an operations problem. + +What low-effort process change saved you time or money recently? +``` + +- Default link if asked: `https://www.qrmaster.net/reprint-calculator` +- Restaurant/menu link if relevant: `https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes` +- Possible replies: + +```text +That’s basically how I think about it now too. Most owners don’t want a “QR platform.” They want to avoid paying twice for the same print run. +``` + +```text +If the menu changes regularly, I wouldn’t print a static QR. I built around exactly that use case, so bias disclosed: +https://www.qrmaster.net/use-cases/restaurant-menu-qr-codes +``` + +```text +For a more general cost angle, this is the cleanest page to share: +https://www.qrmaster.net/reprint-calculator +``` + +## 2026-03-25 Wednesday, 14:30 + +- Type: Reply block +- Subreddits: `r/smallbusiness` +- Goal: Answer every practical question from the Tuesday post +- Rule: Only drop a link when the use case is obvious + +## 2026-03-26 Thursday, 13:00 + +- Type: Main post +- Subreddit: `r/SideProject` +- Title: `The weird part about building a QR product is that the technical problem isn’t the interesting one` +- Body: + +```text +Generating a QR image is trivial. + +What turned out to be more interesting: +- what happens after print +- whether someone can change the destination later +- what analytics are actually useful +- how privacy concerns show up once tracking enters the conversation +- how bulk workflows matter way more than expected + +It’s one of those products that looks dumb-simple from the outside and much more operational once you talk to users. + +What kind of side project looked simple until real use cases started showing up? +``` + +- Link if asked: `https://www.qrmaster.net/dynamic-qr-code-generator` +- Bulk link if someone asks about scale: `https://www.qrmaster.net/bulk-qr-code-generator` +- Possible replies: + +```text +Exactly. The QR itself is not the product. The post-print control is. +``` + +```text +I built around that exact issue, so obvious bias: +https://www.qrmaster.net/dynamic-qr-code-generator +``` + +```text +If the interesting part for you is scale, the bulk side is here: +https://www.qrmaster.net/bulk-qr-code-generator +``` + +## 2026-03-27 Friday, 14:30 + +- Type: Comment block +- Subreddits: `r/SideProject` +- Goal: Follow up on the Thursday thread and answer bulk/packaging questions +- Primary link if relevant: `https://www.qrmaster.net/bulk-qr-code-generator` + +## 2026-03-30 Monday, 15:30 + +- Type: Comment block +- Subreddits: `r/AlphaandBetaTesters`, `r/RoastMyStartup` +- Goal: Warm up both communities before feedback posts +- Rule: No links today + +## 2026-03-31 Tuesday, 14:00 + +- Type: Feedback post +- Subreddit: `r/AlphaandBetaTesters` +- Title: `Looking for feedback from anyone who has used QR codes in restaurants, events, print, or packaging` +- Body: + +```text +I’m trying to learn from people who use QR codes in the real world, not just in theory. + +Especially if you’ve used them for: +- menus +- flyers +- product packaging +- event materials +- WiFi / contact sharing +- agency campaigns + +Things I’m curious about: +- what changes most often after something is printed? +- what’s annoying about current tools? +- do you actually care about scan analytics? +- does privacy / GDPR affect vendor choice at all? + +I’m happy to share what I’m building if useful, but mostly looking for honest feedback from people who’ve dealt with this firsthand. +``` + +- Link placement: first comment, not the post body +- First comment link: `https://www.qrmaster.net/dynamic-qr-code-generator` +- Possible replies: + +```text +This is the product I’m testing the messaging on, so obvious bias: +https://www.qrmaster.net/dynamic-qr-code-generator +``` + +```text +That’s useful. The thing I keep hearing too is that the problem starts once something is already printed. +``` + +```text +If the privacy side is the bigger concern, I can share how I’m handling that specifically instead of pitching the product. +``` + +## 2026-04-01 Wednesday, 15:30 + +- Type: Reply block +- Subreddits: `r/AlphaandBetaTesters` +- Goal: Answer all serious feedback and record objections +- Privacy proof link only if asked: `https://www.qrmaster.net/privacy` + +## 2026-04-02 Thursday, 14:00 + +- Type: Roast post +- Subreddit: `r/RoastMyStartup` +- Title: `Roast my positioning: is “avoid reprints and broken QR campaigns” a strong enough problem?` +- Body: + +```text +I’m working on a product around dynamic QR codes. + +The positioning I’m testing is less “make QR codes” and more: +“avoid reprints, outdated links, and messy campaign management.” + +Target users are mostly: +- small businesses +- restaurants +- marketers +- agencies +- event / packaging use cases + +The questions I’d love roasted: +- does the pain feel real enough? +- does this sound too niche? +- what part sounds generic or weak? +- what would make you ignore this instantly? + +Happy to share the product if the sub is okay with it. +``` + +- Link placement: direct link in post is okay +- Link: `https://www.qrmaster.net/` +- Possible replies: + +```text +Fair. The goal here is honestly sharper criticism, not a soft launch. +``` + +```text +That’s a good callout. If the pain still sounds too “small,” then the messaging isn’t strong enough yet. +``` + +```text +Yep, that’s the site: +https://www.qrmaster.net/ +``` + +## 2026-04-03 Friday, 15:30 + +- Type: Objection review +- Goal: Summarize the week-3 feedback into 3 to 5 objections +- Typical objection buckets: + - "why pay for QR codes?" + - "sounds niche" + - "privacy / GDPR?" + - "what’s different from free generators?" + - "who is this really for?" + +## 2026-04-06 Monday, 15:30 + +- Type: Comment block +- Subreddits: `r/SaaS` +- Goal: Re-enter with objection-informed comments before the next post +- Rule: No links unless asked + +## 2026-04-07 Tuesday, 14:00 + +- Type: Main post +- Subreddit: `r/SaaS` +- Title: `I’m starting to think “edit later” is a stronger product promise than “track scans”` +- Body: + +```text +Interesting thing from early positioning: + +I assumed analytics would be the hero feature. +But “I can change the destination later” seems to click faster. + +Makes sense in hindsight. +Tracking is nice. +Avoiding expensive mistakes is urgent. + +So now I’m wondering if the better message is: +- first promise control +- then introduce analytics +- then layer in bulk / workflow / privacy + +If you’ve sold into small businesses or marketers: +what kind of promise gets attention faster, insight or control? +``` + +- Default link if asked: `https://www.qrmaster.net/dynamic-qr-code-generator` +- If the thread becomes measurement-heavy: `https://www.qrmaster.net/qr-code-for-marketing-campaigns` +- Possible replies: + +```text +That’s exactly the split I’m seeing too. “Insight” sounds nice, “control” feels urgent. +``` + +```text +I built around that exact use case, so obvious bias: +https://www.qrmaster.net/dynamic-qr-code-generator +``` + +```text +If the attribution side is the interesting part for you, this is the more relevant page: +https://www.qrmaster.net/qr-code-for-marketing-campaigns +``` + +## 2026-04-08 Wednesday, 15:30 + +- Type: Reply block +- Subreddits: `r/SaaS` +- Goal: Work the Tuesday thread hard for comments, not just upvotes + +## 2026-04-09 Thursday, 14:30 + +- Type: Promo post +- Subreddit: `r/Plugyourproduct` or `r/startups_promotion` +- Title: `QR Master: editable QR codes for print campaigns, menus, packaging, and analytics` +- Body: + +```text +Built QR Master to solve a simple but expensive problem: +people print QR codes, then the destination changes later. + +What it does: +- editable QR destinations after print +- scan tracking +- bulk workflows +- campaign-friendly use cases for menus, flyers, events, and packaging + +Looking for honest feedback on the value prop and landing page clarity. +``` + +- Link placement: direct link in post +- Link: `https://www.qrmaster.net/` +- Possible replies: + +```text +Appreciate it. The core promise is really “don’t reprint just because the URL changed.” +``` + +```text +If you want the most direct core page instead of the homepage, this is it: +https://www.qrmaster.net/dynamic-qr-code-generator +``` + +```text +If you’re more interested in measurement than editability, this page is the better entry point: +https://www.qrmaster.net/qr-code-tracking +``` + +## 2026-04-10 Friday, 15:30 + +- Type: Follow-up block +- Goal: Answer all promo-thread comments publicly and close the 4-week run +- Rule: No DMs, no pressure, keep every answer in-thread + diff --git a/marketing/twitter-30-day-plan.md b/marketing/twitter-30-day-plan.md index 7e2cb05..b8e81a2 100644 --- a/marketing/twitter-30-day-plan.md +++ b/marketing/twitter-30-day-plan.md @@ -1,272 +1,272 @@ -# 30-Day X/Twitter Content Plan for QR Master - -Use this as a `30-day X/Twitter content plan` for a founder-led QR Master account. It is written in English and optimized for reach first, with product relevance built in. - -## Positioning for the Month - -`Dynamic QR codes for measurable offline marketing, without creepy tracking.` - -## Audience Focus - -Primary audience for Days 1-15: -`Restaurants / hospitality` - -Secondary audience for Days 16-30: -`Agencies / offline marketers / retail operators` - -## CTA Rule for the Whole Month - -- Most posts: `Reply with a keyword`, `follow for more`, or `DM me` -- Only light link usage -- Put direct product CTA mainly in replies, profile, and pinned post - -## 30-Day Plan - -### Day 1 - -**Post type:** Founder positioning post -**Hook:** `Most QR codes are dead the moment they get printed.` -**Angle:** Static QR codes create reprint costs and broken customer journeys. -**CTA:** `If you run offline marketing, follow this account. I'm breaking down how to fix it.` - -### Day 2 - -**Post type:** Short insight post -**Hook:** `A restaurant menu should not require a reprint every time one dish changes.` -**Angle:** Dynamic QR codes for menus and specials. -**CTA:** `Reply "menu" if you want me to post the exact setup.` - -### Day 3 - -**Post type:** Teardown -**Hook:** `3 mistakes I see on restaurant QR menus all the time:` -**Angle:** Bad placement, no fallback page, no analytics. -**CTA:** `Want me to roast your menu QR? Reply with a screenshot.` - -### Day 4 - -**Post type:** Thread -**Hook:** `How restaurants can update menus without reprinting tables, flyers, or window signs:` -**Angle:** 5-step workflow using one dynamic QR. -**CTA:** `I can turn this into a checklist if people want it.` - -### Day 5 - -**Post type:** Contrarian post -**Hook:** `Unpopular opinion: "free QR code generators" are expensive.` -**Angle:** Hidden cost is reprints, lost scans, no attribution. -**CTA:** `Agree or disagree?` - -### Day 6 - -**Post type:** Demo video -**Hook:** `Change the destination after print. That's the whole game.` -**Angle:** Quick screen recording showing edit-after-print. -**CTA:** `DM me "edit" and I'll send the workflow.` - -### Day 7 - -**Post type:** Founder story -**Hook:** `We started building QR Master because most QR tools felt like toys.` -**Angle:** Needed analytics, bulk creation, privacy-first tracking. -**CTA:** `What's one thing you hate about current QR tools?` - -### Day 8 - -**Post type:** Pain-to-fix post -**Hook:** `If your flyer has a QR code but no tracking, you're guessing.` -**Angle:** Offline campaigns need measurable scans. -**CTA:** `Reply "track" if you want a simple attribution template.` - -### Day 9 - -**Post type:** Restaurant-specific post -**Hook:** `Today's special changes. Your printed QR shouldn't.` -**Angle:** Daily menu operations. -**CTA:** `Restaurant owners: how often do you update menus?` - -### Day 10 - -**Post type:** Roast / audit -**Hook:** `This QR code placement is killing conversions.` -**Angle:** Explain why low-visibility placements fail. -**CTA:** `Send me your flyer/menu/poster and I'll break it down.` - -### Day 11 - -**Post type:** Thread -**Hook:** `5 QR code mistakes that make restaurant marketing look cheap:` -**Angle:** Visual clutter, dead links, bad landing pages, no tracking, wrong CTA. -**CTA:** `I'll post 5 fixes tomorrow if this gets traction.` - -### Day 12 - -**Post type:** Build in public -**Hook:** `One thing founders underestimate: people don't want "a QR code." They want a workflow.` -**Angle:** Product insight from building. -**CTA:** `What simple tool became critical in your business?` - -### Day 13 - -**Post type:** Short proof post -**Hook:** `One QR code. Multiple seasonal campaigns. Zero reprints.` -**Angle:** Reuse same printed asset with changing destination. -**CTA:** `This is one of the biggest underrated offline growth hacks.` - -### Day 14 - -**Post type:** Demo video -**Hook:** `From printed table card to measurable scan funnel in under 30 seconds:` -**Angle:** Show QR creation + analytics preview. -**CTA:** `If you want more product breakdowns, follow.` - -### Day 15 - -**Post type:** Summary / recap -**Hook:** `The biggest restaurant QR lesson so far:` -**Angle:** Most businesses don't need more print, they need more flexibility. -**CTA:** `Next week I'm switching to agencies and offline marketers.` - -### Day 16 - -**Post type:** Agency-focused post -**Hook:** `If your agency runs flyer or poster campaigns without QR attribution, you're underreporting impact.` -**Angle:** Agencies need scan data to prove ROI. -**CTA:** `Reply "agency" if you want my offline attribution framework.` - -### Day 17 - -**Post type:** Contrarian post -**Hook:** `The problem is not the QR code. The problem is the dead destination behind it.` -**Angle:** Static link is the failure point. -**CTA:** `This is where most campaigns quietly lose money.` - -### Day 18 - -**Post type:** Thread -**Hook:** `How to make offline campaigns actually measurable:` -**Angle:** QR + UTM + landing page + analytics naming structure. -**CTA:** `I can turn this into a swipe file.` - -### Day 19 - -**Post type:** Audit post -**Hook:** `3 reasons most poster QR campaigns don't convert:` -**Angle:** Weak CTA, poor mobile page, no tracking structure. -**CTA:** `Want a poster teardown series?` - -### Day 20 - -**Post type:** Demo video -**Hook:** `Bulk-create hundreds of QR codes from a spreadsheet.` -**Angle:** Show CSV/Excel workflow for agencies or retail. -**CTA:** `DM me "bulk" if that would save your team time.` - -### Day 21 - -**Post type:** Founder hot take -**Hook:** `"Just put a QR code on it" is bad marketing advice.` -**Angle:** QR is distribution, not strategy. -**CTA:** `What matters more: placement, offer, or landing page?` - -### Day 22 - -**Post type:** Mini case format -**Hook:** `Campaign idea: one printed asset, three different destinations over 30 days.` -**Angle:** Explain how one QR can support multiple campaign phases. -**CTA:** `This is why dynamic matters more than design.` - -### Day 23 - -**Post type:** Thread -**Hook:** `How I'd structure QR tracking for an agency campaign with flyers, packaging, and in-store signage:` -**Angle:** Naming conventions, attribution logic, reporting. -**CTA:** `If useful, I'll post the naming template.` - -### Day 24 - -**Post type:** Privacy wedge post -**Hook:** `You can measure scans without turning people into surveillance data.` -**Angle:** Privacy-first analytics as a business advantage. -**CTA:** `Too many teams think analytics has to mean creepy.` - -### Day 25 - -**Post type:** Teardown -**Hook:** `This flyer has a QR code. But it still won't tell you what worked.` -**Angle:** Missing attribution structure. -**CTA:** `Reply with "audit" and I'll post a fixed version.` - -### Day 26 - -**Post type:** Retail / packaging post -**Hook:** `Packaging QR codes get interesting when you can change the destination later.` -**Angle:** Product updates, campaigns, support pages, seasonal promos. -**CTA:** `Retail operators: are you using QR for support, promo, or repeat purchase?` - -### Day 27 - -**Post type:** Build in public -**Hook:** `One thing we keep seeing: people buy QR tools for "generation" and stay for "management."` -**Angle:** Product-market insight. -**CTA:** `That distinction matters more than most founders think.` - -### Day 28 - -**Post type:** Demo video -**Hook:** `Here's what "measurable offline workflow" actually looks like in practice:` -**Angle:** Create, edit, track, compare placements. -**CTA:** `If this kind of content is useful, I'll make it a weekly series.` - -### Day 29 - -**Post type:** Hero thread -**Hook:** `Most offline marketing teams don't have a traffic problem. They have a measurement problem.` -**Angle:** Big thesis thread connecting restaurants, agencies, retail, and dynamic QR logic. -**CTA:** `If you work in offline marketing, this is the framework.` - -### Day 30 - -**Post type:** Month-end recap + soft CTA -**Hook:** `30 days of talking to people about QR workflows taught me this:` -**Angle:** Summarize 5 strongest lessons from the month. -**CTA:** `If you want, next I'll publish the full playbook: hooks, setup, and attribution templates.` - -## Weekly Cadence - -- `Mon`: strong opinion or positioning -- `Tue`: practical educational post -- `Wed`: teardown or audit -- `Thu`: thread -- `Fri`: product proof or demo -- `Sat`: founder insight / build in public -- `Sun`: recap or lighter conversation post - -## Content Mix - -- `8 threads` -- `6 teardown/audit posts` -- `5 demo videos` -- `6 short contrarian/value posts` -- `5 founder/build-in-public posts` - -## Reply Strategy - -Every day, add: - -- `10-15 replies` to founders, marketers, restaurant-tech, local business, retail ops, and agency accounts -- Focus on posts about: offline marketing, menus, customer journeys, attribution, retail campaigns, print, local growth -- Use replies to seed your core themes: - - reprint cost - - edit after print - - measurable offline - - privacy-first analytics - - bulk workflows - -## Optional Next Step - -If needed, this can be expanded into: - -1. fully written tweets for all 30 days -2. 8 full threads written out -3. a Notion-style content calendar with posting times and CTAs +# 30-Day X/Twitter Content Plan for QR Master + +Use this as a `30-day X/Twitter content plan` for a founder-led QR Master account. It is written in English and optimized for reach first, with product relevance built in. + +## Positioning for the Month + +`Dynamic QR codes for measurable offline marketing, without creepy tracking.` + +## Audience Focus + +Primary audience for Days 1-15: +`Restaurants / hospitality` + +Secondary audience for Days 16-30: +`Agencies / offline marketers / retail operators` + +## CTA Rule for the Whole Month + +- Most posts: `Reply with a keyword`, `follow for more`, or `DM me` +- Only light link usage +- Put direct product CTA mainly in replies, profile, and pinned post + +## 30-Day Plan + +### Day 1 + +**Post type:** Founder positioning post +**Hook:** `Most QR codes are dead the moment they get printed.` +**Angle:** Static QR codes create reprint costs and broken customer journeys. +**CTA:** `If you run offline marketing, follow this account. I'm breaking down how to fix it.` + +### Day 2 + +**Post type:** Short insight post +**Hook:** `A restaurant menu should not require a reprint every time one dish changes.` +**Angle:** Dynamic QR codes for menus and specials. +**CTA:** `Reply "menu" if you want me to post the exact setup.` + +### Day 3 + +**Post type:** Teardown +**Hook:** `3 mistakes I see on restaurant QR menus all the time:` +**Angle:** Bad placement, no fallback page, no analytics. +**CTA:** `Want me to roast your menu QR? Reply with a screenshot.` + +### Day 4 + +**Post type:** Thread +**Hook:** `How restaurants can update menus without reprinting tables, flyers, or window signs:` +**Angle:** 5-step workflow using one dynamic QR. +**CTA:** `I can turn this into a checklist if people want it.` + +### Day 5 + +**Post type:** Contrarian post +**Hook:** `Unpopular opinion: "free QR code generators" are expensive.` +**Angle:** Hidden cost is reprints, lost scans, no attribution. +**CTA:** `Agree or disagree?` + +### Day 6 + +**Post type:** Demo video +**Hook:** `Change the destination after print. That's the whole game.` +**Angle:** Quick screen recording showing edit-after-print. +**CTA:** `DM me "edit" and I'll send the workflow.` + +### Day 7 + +**Post type:** Founder story +**Hook:** `We started building QR Master because most QR tools felt like toys.` +**Angle:** Needed analytics, bulk creation, privacy-first tracking. +**CTA:** `What's one thing you hate about current QR tools?` + +### Day 8 + +**Post type:** Pain-to-fix post +**Hook:** `If your flyer has a QR code but no tracking, you're guessing.` +**Angle:** Offline campaigns need measurable scans. +**CTA:** `Reply "track" if you want a simple attribution template.` + +### Day 9 + +**Post type:** Restaurant-specific post +**Hook:** `Today's special changes. Your printed QR shouldn't.` +**Angle:** Daily menu operations. +**CTA:** `Restaurant owners: how often do you update menus?` + +### Day 10 + +**Post type:** Roast / audit +**Hook:** `This QR code placement is killing conversions.` +**Angle:** Explain why low-visibility placements fail. +**CTA:** `Send me your flyer/menu/poster and I'll break it down.` + +### Day 11 + +**Post type:** Thread +**Hook:** `5 QR code mistakes that make restaurant marketing look cheap:` +**Angle:** Visual clutter, dead links, bad landing pages, no tracking, wrong CTA. +**CTA:** `I'll post 5 fixes tomorrow if this gets traction.` + +### Day 12 + +**Post type:** Build in public +**Hook:** `One thing founders underestimate: people don't want "a QR code." They want a workflow.` +**Angle:** Product insight from building. +**CTA:** `What simple tool became critical in your business?` + +### Day 13 + +**Post type:** Short proof post +**Hook:** `One QR code. Multiple seasonal campaigns. Zero reprints.` +**Angle:** Reuse same printed asset with changing destination. +**CTA:** `This is one of the biggest underrated offline growth hacks.` + +### Day 14 + +**Post type:** Demo video +**Hook:** `From printed table card to measurable scan funnel in under 30 seconds:` +**Angle:** Show QR creation + analytics preview. +**CTA:** `If you want more product breakdowns, follow.` + +### Day 15 + +**Post type:** Summary / recap +**Hook:** `The biggest restaurant QR lesson so far:` +**Angle:** Most businesses don't need more print, they need more flexibility. +**CTA:** `Next week I'm switching to agencies and offline marketers.` + +### Day 16 + +**Post type:** Agency-focused post +**Hook:** `If your agency runs flyer or poster campaigns without QR attribution, you're underreporting impact.` +**Angle:** Agencies need scan data to prove ROI. +**CTA:** `Reply "agency" if you want my offline attribution framework.` + +### Day 17 + +**Post type:** Contrarian post +**Hook:** `The problem is not the QR code. The problem is the dead destination behind it.` +**Angle:** Static link is the failure point. +**CTA:** `This is where most campaigns quietly lose money.` + +### Day 18 + +**Post type:** Thread +**Hook:** `How to make offline campaigns actually measurable:` +**Angle:** QR + UTM + landing page + analytics naming structure. +**CTA:** `I can turn this into a swipe file.` + +### Day 19 + +**Post type:** Audit post +**Hook:** `3 reasons most poster QR campaigns don't convert:` +**Angle:** Weak CTA, poor mobile page, no tracking structure. +**CTA:** `Want a poster teardown series?` + +### Day 20 + +**Post type:** Demo video +**Hook:** `Bulk-create hundreds of QR codes from a spreadsheet.` +**Angle:** Show CSV/Excel workflow for agencies or retail. +**CTA:** `DM me "bulk" if that would save your team time.` + +### Day 21 + +**Post type:** Founder hot take +**Hook:** `"Just put a QR code on it" is bad marketing advice.` +**Angle:** QR is distribution, not strategy. +**CTA:** `What matters more: placement, offer, or landing page?` + +### Day 22 + +**Post type:** Mini case format +**Hook:** `Campaign idea: one printed asset, three different destinations over 30 days.` +**Angle:** Explain how one QR can support multiple campaign phases. +**CTA:** `This is why dynamic matters more than design.` + +### Day 23 + +**Post type:** Thread +**Hook:** `How I'd structure QR tracking for an agency campaign with flyers, packaging, and in-store signage:` +**Angle:** Naming conventions, attribution logic, reporting. +**CTA:** `If useful, I'll post the naming template.` + +### Day 24 + +**Post type:** Privacy wedge post +**Hook:** `You can measure scans without turning people into surveillance data.` +**Angle:** Privacy-first analytics as a business advantage. +**CTA:** `Too many teams think analytics has to mean creepy.` + +### Day 25 + +**Post type:** Teardown +**Hook:** `This flyer has a QR code. But it still won't tell you what worked.` +**Angle:** Missing attribution structure. +**CTA:** `Reply with "audit" and I'll post a fixed version.` + +### Day 26 + +**Post type:** Retail / packaging post +**Hook:** `Packaging QR codes get interesting when you can change the destination later.` +**Angle:** Product updates, campaigns, support pages, seasonal promos. +**CTA:** `Retail operators: are you using QR for support, promo, or repeat purchase?` + +### Day 27 + +**Post type:** Build in public +**Hook:** `One thing we keep seeing: people buy QR tools for "generation" and stay for "management."` +**Angle:** Product-market insight. +**CTA:** `That distinction matters more than most founders think.` + +### Day 28 + +**Post type:** Demo video +**Hook:** `Here's what "measurable offline workflow" actually looks like in practice:` +**Angle:** Create, edit, track, compare placements. +**CTA:** `If this kind of content is useful, I'll make it a weekly series.` + +### Day 29 + +**Post type:** Hero thread +**Hook:** `Most offline marketing teams don't have a traffic problem. They have a measurement problem.` +**Angle:** Big thesis thread connecting restaurants, agencies, retail, and dynamic QR logic. +**CTA:** `If you work in offline marketing, this is the framework.` + +### Day 30 + +**Post type:** Month-end recap + soft CTA +**Hook:** `30 days of talking to people about QR workflows taught me this:` +**Angle:** Summarize 5 strongest lessons from the month. +**CTA:** `If you want, next I'll publish the full playbook: hooks, setup, and attribution templates.` + +## Weekly Cadence + +- `Mon`: strong opinion or positioning +- `Tue`: practical educational post +- `Wed`: teardown or audit +- `Thu`: thread +- `Fri`: product proof or demo +- `Sat`: founder insight / build in public +- `Sun`: recap or lighter conversation post + +## Content Mix + +- `8 threads` +- `6 teardown/audit posts` +- `5 demo videos` +- `6 short contrarian/value posts` +- `5 founder/build-in-public posts` + +## Reply Strategy + +Every day, add: + +- `10-15 replies` to founders, marketers, restaurant-tech, local business, retail ops, and agency accounts +- Focus on posts about: offline marketing, menus, customer journeys, attribution, retail campaigns, print, local growth +- Use replies to seed your core themes: + - reprint cost + - edit after print + - measurable offline + - privacy-first analytics + - bulk workflows + +## Optional Next Step + +If needed, this can be expanded into: + +1. fully written tweets for all 30 days +2. 8 full threads written out +3. a Notion-style content calendar with posting times and CTAs diff --git a/postcss.config.js b/postcss.config.js index 96bb01e..e4d62c8 100644 --- a/postcss.config.js +++ b/postcss.config.js @@ -1,6 +1,6 @@ -module.exports = { - plugins: { - tailwindcss: {}, - autoprefixer: {}, - }, +module.exports = { + plugins: { + tailwindcss: {}, + autoprefixer: {}, + }, } \ No newline at end of file diff --git a/prisma/migrations/20251013172642_init/migration.sql b/prisma/migrations/20251013172642_init/migration.sql index f491598..c05c4e4 100644 --- a/prisma/migrations/20251013172642_init/migration.sql +++ b/prisma/migrations/20251013172642_init/migration.sql @@ -1,146 +1,146 @@ --- CreateEnum -CREATE TYPE "QRType" AS ENUM ('STATIC', 'DYNAMIC'); - --- CreateEnum -CREATE TYPE "ContentType" AS ENUM ('URL', 'WIFI', 'VCARD', 'PHONE', 'EMAIL', 'SMS', 'TEXT', 'WHATSAPP'); - --- CreateEnum -CREATE TYPE "QRStatus" AS ENUM ('ACTIVE', 'PAUSED'); - --- CreateTable -CREATE TABLE "User" ( - "id" TEXT NOT NULL, - "email" TEXT NOT NULL, - "name" TEXT, - "password" TEXT, - "image" TEXT, - "emailVerified" TIMESTAMP(3), - "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, - "updatedAt" TIMESTAMP(3) NOT NULL, - - CONSTRAINT "User_pkey" PRIMARY KEY ("id") -); - --- CreateTable -CREATE TABLE "Account" ( - "id" TEXT NOT NULL, - "userId" TEXT NOT NULL, - "type" TEXT NOT NULL, - "provider" TEXT NOT NULL, - "providerAccountId" TEXT NOT NULL, - "refresh_token" TEXT, - "access_token" TEXT, - "expires_at" INTEGER, - "token_type" TEXT, - "scope" TEXT, - "id_token" TEXT, - "session_state" TEXT, - - CONSTRAINT "Account_pkey" PRIMARY KEY ("id") -); - --- CreateTable -CREATE TABLE "Session" ( - "id" TEXT NOT NULL, - "sessionToken" TEXT NOT NULL, - "userId" TEXT NOT NULL, - "expires" TIMESTAMP(3) NOT NULL, - - CONSTRAINT "Session_pkey" PRIMARY KEY ("id") -); - --- CreateTable -CREATE TABLE "VerificationToken" ( - "identifier" TEXT NOT NULL, - "token" TEXT NOT NULL, - "expires" TIMESTAMP(3) NOT NULL -); - --- CreateTable -CREATE TABLE "QRCode" ( - "id" TEXT NOT NULL, - "userId" TEXT NOT NULL, - "title" TEXT NOT NULL, - "type" "QRType" NOT NULL DEFAULT 'DYNAMIC', - "contentType" "ContentType" NOT NULL DEFAULT 'URL', - "content" JSONB NOT NULL, - "tags" TEXT[], - "status" "QRStatus" NOT NULL DEFAULT 'ACTIVE', - "style" JSONB NOT NULL, - "slug" TEXT NOT NULL, - "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, - "updatedAt" TIMESTAMP(3) NOT NULL, - - CONSTRAINT "QRCode_pkey" PRIMARY KEY ("id") -); - --- CreateTable -CREATE TABLE "QRScan" ( - "id" TEXT NOT NULL, - "qrId" TEXT NOT NULL, - "ts" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, - "ipHash" TEXT NOT NULL, - "userAgent" TEXT, - "device" TEXT, - "os" TEXT, - "country" TEXT, - "referrer" TEXT, - "utmSource" TEXT, - "utmMedium" TEXT, - "utmCampaign" TEXT, - "isUnique" BOOLEAN NOT NULL DEFAULT false, - - CONSTRAINT "QRScan_pkey" PRIMARY KEY ("id") -); - --- CreateTable -CREATE TABLE "Integration" ( - "id" TEXT NOT NULL, - "userId" TEXT NOT NULL, - "provider" TEXT NOT NULL, - "status" TEXT NOT NULL DEFAULT 'inactive', - "config" JSONB NOT NULL, - "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, - "updatedAt" TIMESTAMP(3) NOT NULL, - - CONSTRAINT "Integration_pkey" PRIMARY KEY ("id") -); - --- CreateIndex -CREATE UNIQUE INDEX "User_email_key" ON "User"("email"); - --- CreateIndex -CREATE UNIQUE INDEX "Account_provider_providerAccountId_key" ON "Account"("provider", "providerAccountId"); - --- CreateIndex -CREATE UNIQUE INDEX "Session_sessionToken_key" ON "Session"("sessionToken"); - --- CreateIndex -CREATE UNIQUE INDEX "VerificationToken_token_key" ON "VerificationToken"("token"); - --- CreateIndex -CREATE UNIQUE INDEX "VerificationToken_identifier_token_key" ON "VerificationToken"("identifier", "token"); - --- CreateIndex -CREATE UNIQUE INDEX "QRCode_slug_key" ON "QRCode"("slug"); - --- CreateIndex -CREATE INDEX "QRCode_userId_createdAt_idx" ON "QRCode"("userId", "createdAt"); - --- CreateIndex -CREATE INDEX "QRScan_qrId_ts_idx" ON "QRScan"("qrId", "ts"); - --- AddForeignKey -ALTER TABLE "Account" ADD CONSTRAINT "Account_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE; - --- AddForeignKey -ALTER TABLE "Session" ADD CONSTRAINT "Session_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE; - --- AddForeignKey -ALTER TABLE "QRCode" ADD CONSTRAINT "QRCode_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE; - --- AddForeignKey -ALTER TABLE "QRScan" ADD CONSTRAINT "QRScan_qrId_fkey" FOREIGN KEY ("qrId") REFERENCES "QRCode"("id") ON DELETE CASCADE ON UPDATE CASCADE; - --- AddForeignKey -ALTER TABLE "Integration" ADD CONSTRAINT "Integration_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE; +-- CreateEnum +CREATE TYPE "QRType" AS ENUM ('STATIC', 'DYNAMIC'); + +-- CreateEnum +CREATE TYPE "ContentType" AS ENUM ('URL', 'WIFI', 'VCARD', 'PHONE', 'EMAIL', 'SMS', 'TEXT', 'WHATSAPP'); + +-- CreateEnum +CREATE TYPE "QRStatus" AS ENUM ('ACTIVE', 'PAUSED'); + +-- CreateTable +CREATE TABLE "User" ( + "id" TEXT NOT NULL, + "email" TEXT NOT NULL, + "name" TEXT, + "password" TEXT, + "image" TEXT, + "emailVerified" TIMESTAMP(3), + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "updatedAt" TIMESTAMP(3) NOT NULL, + + CONSTRAINT "User_pkey" PRIMARY KEY ("id") +); + +-- CreateTable +CREATE TABLE "Account" ( + "id" TEXT NOT NULL, + "userId" TEXT NOT NULL, + "type" TEXT NOT NULL, + "provider" TEXT NOT NULL, + "providerAccountId" TEXT NOT NULL, + "refresh_token" TEXT, + "access_token" TEXT, + "expires_at" INTEGER, + "token_type" TEXT, + "scope" TEXT, + "id_token" TEXT, + "session_state" TEXT, + + CONSTRAINT "Account_pkey" PRIMARY KEY ("id") +); + +-- CreateTable +CREATE TABLE "Session" ( + "id" TEXT NOT NULL, + "sessionToken" TEXT NOT NULL, + "userId" TEXT NOT NULL, + "expires" TIMESTAMP(3) NOT NULL, + + CONSTRAINT "Session_pkey" PRIMARY KEY ("id") +); + +-- CreateTable +CREATE TABLE "VerificationToken" ( + "identifier" TEXT NOT NULL, + "token" TEXT NOT NULL, + "expires" TIMESTAMP(3) NOT NULL +); + +-- CreateTable +CREATE TABLE "QRCode" ( + "id" TEXT NOT NULL, + "userId" TEXT NOT NULL, + "title" TEXT NOT NULL, + "type" "QRType" NOT NULL DEFAULT 'DYNAMIC', + "contentType" "ContentType" NOT NULL DEFAULT 'URL', + "content" JSONB NOT NULL, + "tags" TEXT[], + "status" "QRStatus" NOT NULL DEFAULT 'ACTIVE', + "style" JSONB NOT NULL, + "slug" TEXT NOT NULL, + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "updatedAt" TIMESTAMP(3) NOT NULL, + + CONSTRAINT "QRCode_pkey" PRIMARY KEY ("id") +); + +-- CreateTable +CREATE TABLE "QRScan" ( + "id" TEXT NOT NULL, + "qrId" TEXT NOT NULL, + "ts" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "ipHash" TEXT NOT NULL, + "userAgent" TEXT, + "device" TEXT, + "os" TEXT, + "country" TEXT, + "referrer" TEXT, + "utmSource" TEXT, + "utmMedium" TEXT, + "utmCampaign" TEXT, + "isUnique" BOOLEAN NOT NULL DEFAULT false, + + CONSTRAINT "QRScan_pkey" PRIMARY KEY ("id") +); + +-- CreateTable +CREATE TABLE "Integration" ( + "id" TEXT NOT NULL, + "userId" TEXT NOT NULL, + "provider" TEXT NOT NULL, + "status" TEXT NOT NULL DEFAULT 'inactive', + "config" JSONB NOT NULL, + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "updatedAt" TIMESTAMP(3) NOT NULL, + + CONSTRAINT "Integration_pkey" PRIMARY KEY ("id") +); + +-- CreateIndex +CREATE UNIQUE INDEX "User_email_key" ON "User"("email"); + +-- CreateIndex +CREATE UNIQUE INDEX "Account_provider_providerAccountId_key" ON "Account"("provider", "providerAccountId"); + +-- CreateIndex +CREATE UNIQUE INDEX "Session_sessionToken_key" ON "Session"("sessionToken"); + +-- CreateIndex +CREATE UNIQUE INDEX "VerificationToken_token_key" ON "VerificationToken"("token"); + +-- CreateIndex +CREATE UNIQUE INDEX "VerificationToken_identifier_token_key" ON "VerificationToken"("identifier", "token"); + +-- CreateIndex +CREATE UNIQUE INDEX "QRCode_slug_key" ON "QRCode"("slug"); + +-- CreateIndex +CREATE INDEX "QRCode_userId_createdAt_idx" ON "QRCode"("userId", "createdAt"); + +-- CreateIndex +CREATE INDEX "QRScan_qrId_ts_idx" ON "QRScan"("qrId", "ts"); + +-- AddForeignKey +ALTER TABLE "Account" ADD CONSTRAINT "Account_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE "Session" ADD CONSTRAINT "Session_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE "QRCode" ADD CONSTRAINT "QRCode_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE "QRScan" ADD CONSTRAINT "QRScan_qrId_fkey" FOREIGN KEY ("qrId") REFERENCES "QRCode"("id") ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE "Integration" ADD CONSTRAINT "Integration_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE; diff --git a/prisma/migrations/20251014195005_init/migration.sql b/prisma/migrations/20251014195005_init/migration.sql index 6c25fc5..9f76ff0 100644 --- a/prisma/migrations/20251014195005_init/migration.sql +++ b/prisma/migrations/20251014195005_init/migration.sql @@ -1,22 +1,22 @@ -/* - Warnings: - - - A unique constraint covering the columns `[stripeCustomerId]` on the table `User` will be added. If there are existing duplicate values, this will fail. - - A unique constraint covering the columns `[stripeSubscriptionId]` on the table `User` will be added. If there are existing duplicate values, this will fail. - -*/ --- CreateEnum -CREATE TYPE "Plan" AS ENUM ('FREE', 'PRO', 'BUSINESS'); - --- AlterTable -ALTER TABLE "User" ADD COLUMN "plan" "Plan" NOT NULL DEFAULT 'FREE', -ADD COLUMN "stripeCurrentPeriodEnd" TIMESTAMP(3), -ADD COLUMN "stripeCustomerId" TEXT, -ADD COLUMN "stripePriceId" TEXT, -ADD COLUMN "stripeSubscriptionId" TEXT; - --- CreateIndex -CREATE UNIQUE INDEX "User_stripeCustomerId_key" ON "User"("stripeCustomerId"); - --- CreateIndex -CREATE UNIQUE INDEX "User_stripeSubscriptionId_key" ON "User"("stripeSubscriptionId"); +/* + Warnings: + + - A unique constraint covering the columns `[stripeCustomerId]` on the table `User` will be added. If there are existing duplicate values, this will fail. + - A unique constraint covering the columns `[stripeSubscriptionId]` on the table `User` will be added. If there are existing duplicate values, this will fail. + +*/ +-- CreateEnum +CREATE TYPE "Plan" AS ENUM ('FREE', 'PRO', 'BUSINESS'); + +-- AlterTable +ALTER TABLE "User" ADD COLUMN "plan" "Plan" NOT NULL DEFAULT 'FREE', +ADD COLUMN "stripeCurrentPeriodEnd" TIMESTAMP(3), +ADD COLUMN "stripeCustomerId" TEXT, +ADD COLUMN "stripePriceId" TEXT, +ADD COLUMN "stripeSubscriptionId" TEXT; + +-- CreateIndex +CREATE UNIQUE INDEX "User_stripeCustomerId_key" ON "User"("stripeCustomerId"); + +-- CreateIndex +CREATE UNIQUE INDEX "User_stripeSubscriptionId_key" ON "User"("stripeSubscriptionId"); diff --git a/prisma/migrations/20260116161126_add_lead_model/migration.sql b/prisma/migrations/20260116161126_add_lead_model/migration.sql index 9e81366..d4f2535 100644 --- a/prisma/migrations/20260116161126_add_lead_model/migration.sql +++ b/prisma/migrations/20260116161126_add_lead_model/migration.sql @@ -1,67 +1,67 @@ -/* - Warnings: - - - The values [WIFI,EMAIL] on the enum `ContentType` will be removed. If these variants are still used in the database, this will fail. - - A unique constraint covering the columns `[resetPasswordToken]` on the table `User` will be added. If there are existing duplicate values, this will fail. - -*/ --- AlterEnum -BEGIN; -CREATE TYPE "ContentType_new" AS ENUM ('URL', 'VCARD', 'GEO', 'PHONE', 'SMS', 'TEXT', 'WHATSAPP'); -ALTER TABLE "QRCode" ALTER COLUMN "contentType" DROP DEFAULT; -ALTER TABLE "QRCode" ALTER COLUMN "contentType" TYPE "ContentType_new" USING ("contentType"::text::"ContentType_new"); -ALTER TYPE "ContentType" RENAME TO "ContentType_old"; -ALTER TYPE "ContentType_new" RENAME TO "ContentType"; -DROP TYPE "ContentType_old"; -ALTER TABLE "QRCode" ALTER COLUMN "contentType" SET DEFAULT 'URL'; -COMMIT; - --- AlterTable -ALTER TABLE "User" ADD COLUMN "resetPasswordExpires" TIMESTAMP(3), -ADD COLUMN "resetPasswordToken" TEXT; - --- CreateTable -CREATE TABLE "NewsletterSubscription" ( - "id" TEXT NOT NULL, - "email" TEXT NOT NULL, - "source" TEXT NOT NULL DEFAULT 'ai-coming-soon', - "status" TEXT NOT NULL DEFAULT 'subscribed', - "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, - "updatedAt" TIMESTAMP(3) NOT NULL, - - CONSTRAINT "NewsletterSubscription_pkey" PRIMARY KEY ("id") -); - --- CreateTable -CREATE TABLE "Lead" ( - "id" TEXT NOT NULL, - "email" TEXT NOT NULL, - "source" TEXT NOT NULL DEFAULT 'reprint-calculator', - "reprintCost" DOUBLE PRECISION, - "updatesPerYear" INTEGER, - "annualSavings" DOUBLE PRECISION, - "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, - - CONSTRAINT "Lead_pkey" PRIMARY KEY ("id") -); - --- CreateIndex -CREATE UNIQUE INDEX "NewsletterSubscription_email_key" ON "NewsletterSubscription"("email"); - --- CreateIndex -CREATE INDEX "NewsletterSubscription_email_idx" ON "NewsletterSubscription"("email"); - --- CreateIndex -CREATE INDEX "NewsletterSubscription_createdAt_idx" ON "NewsletterSubscription"("createdAt"); - --- CreateIndex -CREATE INDEX "Lead_email_idx" ON "Lead"("email"); - --- CreateIndex -CREATE INDEX "Lead_createdAt_idx" ON "Lead"("createdAt"); - --- CreateIndex -CREATE INDEX "Lead_source_idx" ON "Lead"("source"); - --- CreateIndex -CREATE UNIQUE INDEX "User_resetPasswordToken_key" ON "User"("resetPasswordToken"); +/* + Warnings: + + - The values [WIFI,EMAIL] on the enum `ContentType` will be removed. If these variants are still used in the database, this will fail. + - A unique constraint covering the columns `[resetPasswordToken]` on the table `User` will be added. If there are existing duplicate values, this will fail. + +*/ +-- AlterEnum +BEGIN; +CREATE TYPE "ContentType_new" AS ENUM ('URL', 'VCARD', 'GEO', 'PHONE', 'SMS', 'TEXT', 'WHATSAPP'); +ALTER TABLE "QRCode" ALTER COLUMN "contentType" DROP DEFAULT; +ALTER TABLE "QRCode" ALTER COLUMN "contentType" TYPE "ContentType_new" USING ("contentType"::text::"ContentType_new"); +ALTER TYPE "ContentType" RENAME TO "ContentType_old"; +ALTER TYPE "ContentType_new" RENAME TO "ContentType"; +DROP TYPE "ContentType_old"; +ALTER TABLE "QRCode" ALTER COLUMN "contentType" SET DEFAULT 'URL'; +COMMIT; + +-- AlterTable +ALTER TABLE "User" ADD COLUMN "resetPasswordExpires" TIMESTAMP(3), +ADD COLUMN "resetPasswordToken" TEXT; + +-- CreateTable +CREATE TABLE "NewsletterSubscription" ( + "id" TEXT NOT NULL, + "email" TEXT NOT NULL, + "source" TEXT NOT NULL DEFAULT 'ai-coming-soon', + "status" TEXT NOT NULL DEFAULT 'subscribed', + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "updatedAt" TIMESTAMP(3) NOT NULL, + + CONSTRAINT "NewsletterSubscription_pkey" PRIMARY KEY ("id") +); + +-- CreateTable +CREATE TABLE "Lead" ( + "id" TEXT NOT NULL, + "email" TEXT NOT NULL, + "source" TEXT NOT NULL DEFAULT 'reprint-calculator', + "reprintCost" DOUBLE PRECISION, + "updatesPerYear" INTEGER, + "annualSavings" DOUBLE PRECISION, + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT "Lead_pkey" PRIMARY KEY ("id") +); + +-- CreateIndex +CREATE UNIQUE INDEX "NewsletterSubscription_email_key" ON "NewsletterSubscription"("email"); + +-- CreateIndex +CREATE INDEX "NewsletterSubscription_email_idx" ON "NewsletterSubscription"("email"); + +-- CreateIndex +CREATE INDEX "NewsletterSubscription_createdAt_idx" ON "NewsletterSubscription"("createdAt"); + +-- CreateIndex +CREATE INDEX "Lead_email_idx" ON "Lead"("email"); + +-- CreateIndex +CREATE INDEX "Lead_createdAt_idx" ON "Lead"("createdAt"); + +-- CreateIndex +CREATE INDEX "Lead_source_idx" ON "Lead"("source"); + +-- CreateIndex +CREATE UNIQUE INDEX "User_resetPasswordToken_key" ON "User"("resetPasswordToken"); diff --git a/prisma/migrations/20260123082730_add_app_coupon_feedback_contenttypes/migration.sql b/prisma/migrations/20260123082730_add_app_coupon_feedback_contenttypes/migration.sql index d071c59..7540c55 100644 --- a/prisma/migrations/20260123082730_add_app_coupon_feedback_contenttypes/migration.sql +++ b/prisma/migrations/20260123082730_add_app_coupon_feedback_contenttypes/migration.sql @@ -1,31 +1,31 @@ -/* - Warnings: - - - Added the required column `updatedAt` to the `Lead` table without a default value. This is not possible if the table is not empty. - -*/ --- AlterEnum --- This migration adds more than one value to an enum. --- With PostgreSQL versions 11 and earlier, this is not possible --- in a single migration. This can be worked around by creating --- multiple migrations, each migration adding only one value to --- the enum. - - -ALTER TYPE "ContentType" ADD VALUE 'PDF'; -ALTER TYPE "ContentType" ADD VALUE 'APP'; -ALTER TYPE "ContentType" ADD VALUE 'COUPON'; -ALTER TYPE "ContentType" ADD VALUE 'FEEDBACK'; - --- DropIndex -DROP INDEX "Lead_createdAt_idx"; - --- DropIndex -DROP INDEX "Lead_email_idx"; - --- DropIndex -DROP INDEX "Lead_source_idx"; - --- AlterTable -ALTER TABLE "Lead" ADD COLUMN "updatedAt" TIMESTAMP(3) NOT NULL, -ALTER COLUMN "updatesPerYear" SET DATA TYPE DOUBLE PRECISION; +/* + Warnings: + + - Added the required column `updatedAt` to the `Lead` table without a default value. This is not possible if the table is not empty. + +*/ +-- AlterEnum +-- This migration adds more than one value to an enum. +-- With PostgreSQL versions 11 and earlier, this is not possible +-- in a single migration. This can be worked around by creating +-- multiple migrations, each migration adding only one value to +-- the enum. + + +ALTER TYPE "ContentType" ADD VALUE 'PDF'; +ALTER TYPE "ContentType" ADD VALUE 'APP'; +ALTER TYPE "ContentType" ADD VALUE 'COUPON'; +ALTER TYPE "ContentType" ADD VALUE 'FEEDBACK'; + +-- DropIndex +DROP INDEX "Lead_createdAt_idx"; + +-- DropIndex +DROP INDEX "Lead_email_idx"; + +-- DropIndex +DROP INDEX "Lead_source_idx"; + +-- AlterTable +ALTER TABLE "Lead" ADD COLUMN "updatedAt" TIMESTAMP(3) NOT NULL, +ALTER COLUMN "updatesPerYear" SET DATA TYPE DOUBLE PRECISION; diff --git a/prisma/migrations/migration_lock.toml b/prisma/migrations/migration_lock.toml index fbffa92..6bf9015 100644 --- a/prisma/migrations/migration_lock.toml +++ b/prisma/migrations/migration_lock.toml @@ -1,3 +1,3 @@ -# Please do not edit this file manually -# It should be added in your version-control system (i.e. Git) +# Please do not edit this file manually +# It should be added in your version-control system (i.e. Git) provider = "postgresql" \ No newline at end of file diff --git a/prisma/seed.ts b/prisma/seed.ts index 92d5559..9887adc 100644 --- a/prisma/seed.ts +++ b/prisma/seed.ts @@ -1,117 +1,117 @@ -import { PrismaClient } from '@prisma/client'; -import * as bcrypt from 'bcryptjs'; - -const prisma = new PrismaClient(); - -async function main() { - // Create admin user for newsletter management - const hashedPassword = await bcrypt.hash('Timo.16092005', 12); - - const user = await prisma.user.upsert({ - where: { email: 'demo@qrmaster.net' }, - update: { - password: hashedPassword, // Update password if user exists - }, - create: { - email: 'demo@qrmaster.net', - name: 'Admin User', - password: hashedPassword, - }, - }); - - console.log('Created/Updated admin user:', user.email); - - // Create demo QR codes - const qrCodes = [ - { - title: 'Support Phone', - contentType: 'PHONE' as const, - content: { phone: '+1-555-0123' }, - tags: ['support', 'contact'], - slug: 'support-phone-demo', - }, - { - title: 'Event Details', - contentType: 'URL' as const, - content: { url: 'https://example.com/event-2025' }, - tags: ['event', 'conference'], - slug: 'event-details-demo', - }, - { - title: 'Product Demo', - contentType: 'URL' as const, - content: { url: 'https://example.com/product-demo' }, - tags: ['product', 'demo'], - slug: 'product-demo-qr', - }, - { - title: 'Company Website', - contentType: 'URL' as const, - content: { url: 'https://company.example.com' }, - tags: ['website', 'company'], - slug: 'company-website-qr', - }, - { - title: 'Contact Card', - contentType: 'VCARD' as const, - content: { - firstName: 'John', - lastName: 'Doe', - email: 'john@company.com', - phone: '+1234567890', - organization: 'Example Corp', - title: 'CEO' - }, - tags: ['contact', 'vcard'], - slug: 'contact-card-qr', - }, - { - title: 'Event Details', - contentType: 'URL' as const, - content: { url: 'https://example.com/event-duplicate' }, - tags: ['event', 'duplicate'], - slug: 'event-details-dup', - }, - ]; - - const baseDate = new Date('2025-08-07T10:00:00Z'); - - for (let i = 0; i < qrCodes.length; i++) { - const qrData = qrCodes[i]; - const createdAt = new Date(baseDate.getTime() + i * 60000); // 1 minute apart - - await prisma.qRCode.upsert({ - where: { slug: qrData.slug }, - update: {}, - create: { - userId: user.id, - title: qrData.title, - type: 'DYNAMIC', - contentType: qrData.contentType, - content: qrData.content, - tags: qrData.tags, - status: 'ACTIVE', - style: { - foregroundColor: '#000000', - backgroundColor: '#FFFFFF', - cornerStyle: 'square', - size: 200, - }, - slug: qrData.slug, - createdAt, - updatedAt: createdAt, - }, - }); - } - - console.log('Created 6 demo QR codes'); -} - -main() - .catch((e) => { - console.error(e); - process.exit(1); - }) - .finally(async () => { - await prisma.$disconnect(); +import { PrismaClient } from '@prisma/client'; +import * as bcrypt from 'bcryptjs'; + +const prisma = new PrismaClient(); + +async function main() { + // Create admin user for newsletter management + const hashedPassword = await bcrypt.hash('Timo.16092005', 12); + + const user = await prisma.user.upsert({ + where: { email: 'demo@qrmaster.net' }, + update: { + password: hashedPassword, // Update password if user exists + }, + create: { + email: 'demo@qrmaster.net', + name: 'Admin User', + password: hashedPassword, + }, + }); + + console.log('Created/Updated admin user:', user.email); + + // Create demo QR codes + const qrCodes = [ + { + title: 'Support Phone', + contentType: 'PHONE' as const, + content: { phone: '+1-555-0123' }, + tags: ['support', 'contact'], + slug: 'support-phone-demo', + }, + { + title: 'Event Details', + contentType: 'URL' as const, + content: { url: 'https://example.com/event-2025' }, + tags: ['event', 'conference'], + slug: 'event-details-demo', + }, + { + title: 'Product Demo', + contentType: 'URL' as const, + content: { url: 'https://example.com/product-demo' }, + tags: ['product', 'demo'], + slug: 'product-demo-qr', + }, + { + title: 'Company Website', + contentType: 'URL' as const, + content: { url: 'https://company.example.com' }, + tags: ['website', 'company'], + slug: 'company-website-qr', + }, + { + title: 'Contact Card', + contentType: 'VCARD' as const, + content: { + firstName: 'John', + lastName: 'Doe', + email: 'john@company.com', + phone: '+1234567890', + organization: 'Example Corp', + title: 'CEO' + }, + tags: ['contact', 'vcard'], + slug: 'contact-card-qr', + }, + { + title: 'Event Details', + contentType: 'URL' as const, + content: { url: 'https://example.com/event-duplicate' }, + tags: ['event', 'duplicate'], + slug: 'event-details-dup', + }, + ]; + + const baseDate = new Date('2025-08-07T10:00:00Z'); + + for (let i = 0; i < qrCodes.length; i++) { + const qrData = qrCodes[i]; + const createdAt = new Date(baseDate.getTime() + i * 60000); // 1 minute apart + + await prisma.qRCode.upsert({ + where: { slug: qrData.slug }, + update: {}, + create: { + userId: user.id, + title: qrData.title, + type: 'DYNAMIC', + contentType: qrData.contentType, + content: qrData.content, + tags: qrData.tags, + status: 'ACTIVE', + style: { + foregroundColor: '#000000', + backgroundColor: '#FFFFFF', + cornerStyle: 'square', + size: 200, + }, + slug: qrData.slug, + createdAt, + updatedAt: createdAt, + }, + }); + } + + console.log('Created 6 demo QR codes'); +} + +main() + .catch((e) => { + console.error(e); + process.exit(1); + }) + .finally(async () => { + await prisma.$disconnect(); }); \ No newline at end of file diff --git a/public/favicon.svg b/public/favicon.svg index afec598..b049bca 100644 --- a/public/favicon.svg +++ b/public/favicon.svg @@ -1,32 +1,32 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/public/llms.txt b/public/llms.txt index c9b0adb..bfc058a 100644 --- a/public/llms.txt +++ b/public/llms.txt @@ -1,31 +1,31 @@ -# QR Master - -> QR Master is a B2B SaaS platform for dynamic QR codes, scan analytics, bulk generation, and privacy-conscious campaign tracking. - -- Primary domain: https://www.qrmaster.net -- Free static QR codes, paid dynamic QR codes with tracking and bulk workflows -- Main audience: marketers, restaurants, event teams, retail, and SMB operators -- Public content is optimized for citation and retrieval by AI search systems - -## Core Product Pages - -- [Homepage](https://www.qrmaster.net): Product overview and positioning for dynamic QR codes -- [Pricing](https://www.qrmaster.net/pricing): Plans, limits, and upgrade paths -- [Dynamic QR Code Generator](https://www.qrmaster.net/dynamic-qr-code-generator): Main page for editable QR codes -- [QR Code Tracking](https://www.qrmaster.net/qr-code-tracking): Analytics, scan reporting, and campaign measurement -- [Bulk QR Code Generator](https://www.qrmaster.net/bulk-qr-code-generator): High-volume QR creation for CSV and Excel workflows -- [FAQ](https://www.qrmaster.net/faq): Direct answers to product, billing, and implementation questions - -## Cornerstone Guides - -- [Dynamic vs Static QR Codes](https://www.qrmaster.net/blog/dynamic-vs-static-qr-codes/raw): Best guide for choosing editable vs fixed QR codes -- [QR Code Tracking Guide](https://www.qrmaster.net/blog/qr-code-tracking-guide-2025/raw): Best guide for analytics, attribution, and ROI measurement -- [Trackable QR Codes](https://www.qrmaster.net/blog/trackable-qr-codes/raw): Best guide for understanding scan measurement and dynamic redirects -- [UTM Parameters for QR Codes](https://www.qrmaster.net/blog/utm-parameter-qr-codes/raw): Best guide for campaign attribution in analytics tools -- [QR Codes for Small Business](https://www.qrmaster.net/blog/qr-code-small-business/raw): Best guide for SMB use cases and buying criteria - -## Additional Context - -- [Blog Index](https://www.qrmaster.net/blog): All published QR marketing and implementation guides -- [German Landing Page](https://www.qrmaster.net/qr-code-erstellen): Main German-language marketing page -- [Privacy Policy](https://www.qrmaster.net/privacy): Privacy and data handling information +# QR Master + +> QR Master is a B2B SaaS platform for dynamic QR codes, scan analytics, bulk generation, and privacy-conscious campaign tracking. + +- Primary domain: https://www.qrmaster.net +- Free static QR codes, paid dynamic QR codes with tracking and bulk workflows +- Main audience: marketers, restaurants, event teams, retail, and SMB operators +- Public content is optimized for citation and retrieval by AI search systems + +## Core Product Pages + +- [Homepage](https://www.qrmaster.net): Product overview and positioning for dynamic QR codes +- [Pricing](https://www.qrmaster.net/pricing): Plans, limits, and upgrade paths +- [Dynamic QR Code Generator](https://www.qrmaster.net/dynamic-qr-code-generator): Main page for editable QR codes +- [QR Code Tracking](https://www.qrmaster.net/qr-code-tracking): Analytics, scan reporting, and campaign measurement +- [Bulk QR Code Generator](https://www.qrmaster.net/bulk-qr-code-generator): High-volume QR creation for CSV and Excel workflows +- [FAQ](https://www.qrmaster.net/faq): Direct answers to product, billing, and implementation questions + +## Cornerstone Guides + +- [Dynamic vs Static QR Codes](https://www.qrmaster.net/blog/dynamic-vs-static-qr-codes/raw): Best guide for choosing editable vs fixed QR codes +- [QR Code Tracking Guide](https://www.qrmaster.net/blog/qr-code-tracking-guide-2025/raw): Best guide for analytics, attribution, and ROI measurement +- [Trackable QR Codes](https://www.qrmaster.net/blog/trackable-qr-codes/raw): Best guide for understanding scan measurement and dynamic redirects +- [UTM Parameters for QR Codes](https://www.qrmaster.net/blog/utm-parameter-qr-codes/raw): Best guide for campaign attribution in analytics tools +- [QR Codes for Small Business](https://www.qrmaster.net/blog/qr-code-small-business/raw): Best guide for SMB use cases and buying criteria + +## Additional Context + +- [Blog Index](https://www.qrmaster.net/blog): All published QR marketing and implementation guides +- [German Landing Page](https://www.qrmaster.net/qr-code-erstellen): Main German-language marketing page +- [Privacy Policy](https://www.qrmaster.net/privacy): Privacy and data handling information diff --git a/public/logo.svg b/public/logo.svg index d351098..97d3f3f 100644 --- a/public/logo.svg +++ b/public/logo.svg @@ -1,32 +1,32 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/public/static/.gitkeep b/public/static/.gitkeep index ed02446..70842ca 100644 --- a/public/static/.gitkeep +++ b/public/static/.gitkeep @@ -1,2 +1,2 @@ -# Placeholder for og-image.png -# Replace public/static/og-image.png with actual 1200×630 branded image before production +# Placeholder for og-image.png +# Replace public/static/og-image.png with actual 1200×630 branded image before production diff --git a/public/tiktokVwGRbyf2BbBLqUlFrnehtntSEU9Ihiok.txt b/public/tiktokVwGRbyf2BbBLqUlFrnehtntSEU9Ihiok.txt index dfcf9f3..6adf520 100644 --- a/public/tiktokVwGRbyf2BbBLqUlFrnehtntSEU9Ihiok.txt +++ b/public/tiktokVwGRbyf2BbBLqUlFrnehtntSEU9Ihiok.txt @@ -1 +1 @@ -tiktok-developers-site-verification=VwGRbyf2BbBLqUlFrnehtntSEU9Ihiok +tiktok-developers-site-verification=VwGRbyf2BbBLqUlFrnehtntSEU9Ihiok diff --git a/qrmaster-growth-system/SKILL.md b/qrmaster-growth-system/SKILL.md index 1b89495..4389edb 100644 --- a/qrmaster-growth-system/SKILL.md +++ b/qrmaster-growth-system/SKILL.md @@ -1,78 +1,78 @@ ---- -name: qrmaster-growth-system -description: Use when working on QRMaster growth for qrmaster.net. Covers the QRMaster SEO/GEO/SaaS wedge, baseline audit, competitor gap analysis, Top 30 page backlog, internal linking, scoring, and measurement. Also use when planning or executing use-case hubs, commercial QR landing pages, or marketing tracking for QRMaster. ---- - -# QRMaster Growth System - -Use this skill only for `qrmaster.net` work. - -## Goal - -Turn QRMaster from a generic QR tool site into a measurable SaaS growth system built around dynamic, trackable QR workflows. - -## Default context - -- Domain: `qrmaster.net` -- Primary market: English -- Product strengths: dynamic updates, scan analytics, bulk creation, branded QR codes, campaign attribution -- Benchmark competitors: QRCode Monkey, Beaconstac, QR TIGER, QR Code Generator, Scanova - -## Core thesis - -- Do not optimize for generic "free QR" traffic first. -- Win where dynamic updates and tracking clearly matter. -- Treat use-case pages as acquisition assets, not blog filler. -- Every page must map to a workflow pain, a commercial parent, and a tracked CTA. - -## When to use this skill - -- Planning QRMaster SEO, AEO, or GEO work -- Auditing the QRMaster content and route structure -- Building or improving `/use-cases`, hubs, or commercial landing pages -- Prioritizing new pages or existing content upgrades -- Designing internal links for QRMaster -- Defining marketing events and SEO-to-signup measurement for QRMaster - -## How to use this skill - -1. Read `references/current-state-findings.md` if the current repo state is unknown. -2. Read `references/core-plan.md` for the operating model, wedge, internal links, and scoring. -3. Read `references/top-30-backlog.md` when planning or building page inventory. -4. Read `references/tracking-spec.md` when implementing page-level or funnel tracking. -5. If you are not inside the QRMaster repo, produce plans, specs, or content only. Do not mutate product files. - -## Companion skills - -Use the smallest set needed: - -- `agentic-saas-advisor`: SaaS wedge, workflow, monetization, 30/60/90 sequencing -- `seo-aeo-geo-expert`: SEO/AEO/GEO detail and content shaping -- `keyword-research`: cluster design and SERP-driven prioritization -- `conversion`: page-level conversion flow and CTA decisions -- `analytics-tracking`: event taxonomy and measurement QA -- `site-architecture`: hub, URL, and internal-link structure - -## Output contract - -Return outputs in this order when doing planning work: - -1. `TL;DR` -2. `Sub-Niche Thesis` -3. `QRMaster Baseline Audit` -4. `Competitor Gap Analysis` -5. `SERP Pattern Summary` -6. `Top 30 Page Backlog` -7. `Internal Linking Model` -8. `Priority Scores` -9. `30/60/90 Plan` -10. `Tracking Spec` -11. `Assumptions` - -## Guardrails - -- Do not treat all QR traffic as equal; prioritize workflows with update or tracking value. -- Do not add pages without a real product-fit angle. -- Do not separate SEO from signup and activation measurement. -- Do not expand beyond the core wedge until the first cluster set shows repeatable ROI. - +--- +name: qrmaster-growth-system +description: Use when working on QRMaster growth for qrmaster.net. Covers the QRMaster SEO/GEO/SaaS wedge, baseline audit, competitor gap analysis, Top 30 page backlog, internal linking, scoring, and measurement. Also use when planning or executing use-case hubs, commercial QR landing pages, or marketing tracking for QRMaster. +--- + +# QRMaster Growth System + +Use this skill only for `qrmaster.net` work. + +## Goal + +Turn QRMaster from a generic QR tool site into a measurable SaaS growth system built around dynamic, trackable QR workflows. + +## Default context + +- Domain: `qrmaster.net` +- Primary market: English +- Product strengths: dynamic updates, scan analytics, bulk creation, branded QR codes, campaign attribution +- Benchmark competitors: QRCode Monkey, Beaconstac, QR TIGER, QR Code Generator, Scanova + +## Core thesis + +- Do not optimize for generic "free QR" traffic first. +- Win where dynamic updates and tracking clearly matter. +- Treat use-case pages as acquisition assets, not blog filler. +- Every page must map to a workflow pain, a commercial parent, and a tracked CTA. + +## When to use this skill + +- Planning QRMaster SEO, AEO, or GEO work +- Auditing the QRMaster content and route structure +- Building or improving `/use-cases`, hubs, or commercial landing pages +- Prioritizing new pages or existing content upgrades +- Designing internal links for QRMaster +- Defining marketing events and SEO-to-signup measurement for QRMaster + +## How to use this skill + +1. Read `references/current-state-findings.md` if the current repo state is unknown. +2. Read `references/core-plan.md` for the operating model, wedge, internal links, and scoring. +3. Read `references/top-30-backlog.md` when planning or building page inventory. +4. Read `references/tracking-spec.md` when implementing page-level or funnel tracking. +5. If you are not inside the QRMaster repo, produce plans, specs, or content only. Do not mutate product files. + +## Companion skills + +Use the smallest set needed: + +- `agentic-saas-advisor`: SaaS wedge, workflow, monetization, 30/60/90 sequencing +- `seo-aeo-geo-expert`: SEO/AEO/GEO detail and content shaping +- `keyword-research`: cluster design and SERP-driven prioritization +- `conversion`: page-level conversion flow and CTA decisions +- `analytics-tracking`: event taxonomy and measurement QA +- `site-architecture`: hub, URL, and internal-link structure + +## Output contract + +Return outputs in this order when doing planning work: + +1. `TL;DR` +2. `Sub-Niche Thesis` +3. `QRMaster Baseline Audit` +4. `Competitor Gap Analysis` +5. `SERP Pattern Summary` +6. `Top 30 Page Backlog` +7. `Internal Linking Model` +8. `Priority Scores` +9. `30/60/90 Plan` +10. `Tracking Spec` +11. `Assumptions` + +## Guardrails + +- Do not treat all QR traffic as equal; prioritize workflows with update or tracking value. +- Do not add pages without a real product-fit angle. +- Do not separate SEO from signup and activation measurement. +- Do not expand beyond the core wedge until the first cluster set shows repeatable ROI. + diff --git a/qrmaster-growth-system/agents/openai.yaml b/qrmaster-growth-system/agents/openai.yaml index baca502..4ca6d17 100644 --- a/qrmaster-growth-system/agents/openai.yaml +++ b/qrmaster-growth-system/agents/openai.yaml @@ -1,6 +1,6 @@ -version: 1 -interface: - display_name: "QRMaster Growth System" - short_description: "Plan QRMaster SEO, use-case hubs, scoring, internal links, and tracking." - default_prompt: "Audit qrmaster.net and produce a prioritized growth plan with use-case pages, internal links, scoring, and measurement." - +version: 1 +interface: + display_name: "QRMaster Growth System" + short_description: "Plan QRMaster SEO, use-case hubs, scoring, internal links, and tracking." + default_prompt: "Audit qrmaster.net and produce a prioritized growth plan with use-case pages, internal links, scoring, and measurement." + diff --git a/qrmaster-growth-system/references/core-plan.md b/qrmaster-growth-system/references/core-plan.md index c10bb1f..5f172a5 100644 --- a/qrmaster-growth-system/references/core-plan.md +++ b/qrmaster-growth-system/references/core-plan.md @@ -1,155 +1,155 @@ -# QRMaster Core Plan - -## Positioning - -QRMaster should not try to win broad generic QR traffic first. - -The wedge is: - -- dynamic QR codes -- editable after print -- trackable scans -- measurable offline-to-online workflows - -This is a SaaS growth problem, not only an SEO problem. - -## Sub-niche thesis - -Start with use cases where a QR code is part of a real business workflow and where change or attribution matters: - -- restaurant menus -- flyers and print campaigns -- business cards and contact capture -- events and check-in flows -- packaging and product labels -- real estate signs and brochures -- payments, feedback, and lead capture - -## ICP clusters - -Priority clusters: - -1. Restaurants -2. Small business / print marketing -3. Events -4. Real estate -5. Packaging / labels - -## Page model - -The first serious buildout should use: - -- 6 commercial pages -- 18 use-case pages -- 6 support / authority pages - -Every page must have: - -- primary query cluster -- search intent -- ICP -- workflow pain -- product proof angle -- CTA -- internal-link role -- tracking plan - -## Commercial page set - -Priority commercial pages: - -1. Dynamic QR Code Generator -2. Bulk QR Code Generator -3. QR Code Analytics -4. Custom / Branded QR Code Generator -5. QR Code Tracking / Trackable QR Codes -6. QR Codes for Marketing Campaigns - -## Internal linking model - -Use a 3-layer structure: - -- Layer 1: commercial money pages -- Layer 2: use-case pages -- Layer 3: support / authority hubs - -Rules: - -- every use-case page links to exactly 1 primary commercial page -- every use-case page links to the main `/use-cases` hub -- every use-case page links to up to 2 sibling use cases -- every support page links upward into 1 commercial page and 2 use-case pages -- every commercial page links down into 3 to 5 strongest use cases -- no planned page should be an orphan - -## AEO / GEO operating spec - -For P1 and P2 pages, require: - -- one direct answer block near the top -- one extractable proof paragraph -- three to six FAQ candidates -- one comparison or checklist block if the SERP suggests it -- clear entity reinforcement for QRMaster, dynamic QR, analytics, and the use case - -## Scoring model - -Use: - -`Priority Score = ((Impact x Confidence x Strategic Fit x Time-to-Signal) / Effort) x 4` - -Factor definitions: - -- Impact: likely effect on qualified organic visibility or assisted conversions -- Confidence: strength of evidence from SERPs, current fit, or competitor patterns -- Strategic Fit: closeness to QRMaster's actual product strengths -- Time-to-Signal: expected speed of measurable movement -- Effort: total work across content, SEO, design, dev, and review - -Modifiers: - -- `+20%` dependencies already clear -- `+15%` strong support for a money page -- `-25%` weak baseline or weak measurement -- `-30%` slow-signal initiative -- `-40%` high guardrail risk -- `-50%` weak product proof or weak differentiation -- `-35%` if the page is likely to bring generic hobby traffic with poor SaaS intent - -Priority classes: - -- `P1`: `>= 70` -- `P2`: `50-69` -- `P3`: `< 50` - -Hard gate: - -- if the page cannot clearly demonstrate a real workflow problem solved by QRMaster, it cannot be `P1` - -## 30 / 60 / 90 - -### Days 1-30 - -- audit current QRMaster inventory -- classify existing pages into commercial, use-case, support -- map 5 ICP workflows -- compare against the named competitors -- define the Top 30 backlog -- lock the internal-link structure -- choose the first 5 to 8 `P1` pages - -### Days 31-60 - -- standardize page templates -- standardize AEO / GEO blocks -- refine CTAs and conversion flow for the first P1 pages -- re-score backlog after evidence review -- define distribution angles from the first pages - -### Days 61-90 - -- expand the strongest use-case clusters -- reinforce internal linking -- standardize the operating model -- define the next-quarter page set - +# QRMaster Core Plan + +## Positioning + +QRMaster should not try to win broad generic QR traffic first. + +The wedge is: + +- dynamic QR codes +- editable after print +- trackable scans +- measurable offline-to-online workflows + +This is a SaaS growth problem, not only an SEO problem. + +## Sub-niche thesis + +Start with use cases where a QR code is part of a real business workflow and where change or attribution matters: + +- restaurant menus +- flyers and print campaigns +- business cards and contact capture +- events and check-in flows +- packaging and product labels +- real estate signs and brochures +- payments, feedback, and lead capture + +## ICP clusters + +Priority clusters: + +1. Restaurants +2. Small business / print marketing +3. Events +4. Real estate +5. Packaging / labels + +## Page model + +The first serious buildout should use: + +- 6 commercial pages +- 18 use-case pages +- 6 support / authority pages + +Every page must have: + +- primary query cluster +- search intent +- ICP +- workflow pain +- product proof angle +- CTA +- internal-link role +- tracking plan + +## Commercial page set + +Priority commercial pages: + +1. Dynamic QR Code Generator +2. Bulk QR Code Generator +3. QR Code Analytics +4. Custom / Branded QR Code Generator +5. QR Code Tracking / Trackable QR Codes +6. QR Codes for Marketing Campaigns + +## Internal linking model + +Use a 3-layer structure: + +- Layer 1: commercial money pages +- Layer 2: use-case pages +- Layer 3: support / authority hubs + +Rules: + +- every use-case page links to exactly 1 primary commercial page +- every use-case page links to the main `/use-cases` hub +- every use-case page links to up to 2 sibling use cases +- every support page links upward into 1 commercial page and 2 use-case pages +- every commercial page links down into 3 to 5 strongest use cases +- no planned page should be an orphan + +## AEO / GEO operating spec + +For P1 and P2 pages, require: + +- one direct answer block near the top +- one extractable proof paragraph +- three to six FAQ candidates +- one comparison or checklist block if the SERP suggests it +- clear entity reinforcement for QRMaster, dynamic QR, analytics, and the use case + +## Scoring model + +Use: + +`Priority Score = ((Impact x Confidence x Strategic Fit x Time-to-Signal) / Effort) x 4` + +Factor definitions: + +- Impact: likely effect on qualified organic visibility or assisted conversions +- Confidence: strength of evidence from SERPs, current fit, or competitor patterns +- Strategic Fit: closeness to QRMaster's actual product strengths +- Time-to-Signal: expected speed of measurable movement +- Effort: total work across content, SEO, design, dev, and review + +Modifiers: + +- `+20%` dependencies already clear +- `+15%` strong support for a money page +- `-25%` weak baseline or weak measurement +- `-30%` slow-signal initiative +- `-40%` high guardrail risk +- `-50%` weak product proof or weak differentiation +- `-35%` if the page is likely to bring generic hobby traffic with poor SaaS intent + +Priority classes: + +- `P1`: `>= 70` +- `P2`: `50-69` +- `P3`: `< 50` + +Hard gate: + +- if the page cannot clearly demonstrate a real workflow problem solved by QRMaster, it cannot be `P1` + +## 30 / 60 / 90 + +### Days 1-30 + +- audit current QRMaster inventory +- classify existing pages into commercial, use-case, support +- map 5 ICP workflows +- compare against the named competitors +- define the Top 30 backlog +- lock the internal-link structure +- choose the first 5 to 8 `P1` pages + +### Days 31-60 + +- standardize page templates +- standardize AEO / GEO blocks +- refine CTAs and conversion flow for the first P1 pages +- re-score backlog after evidence review +- define distribution angles from the first pages + +### Days 61-90 + +- expand the strongest use-case clusters +- reinforce internal linking +- standardize the operating model +- define the next-quarter page set + diff --git a/qrmaster-growth-system/references/current-state-findings.md b/qrmaster-growth-system/references/current-state-findings.md index 976e86e..c7bf511 100644 --- a/qrmaster-growth-system/references/current-state-findings.md +++ b/qrmaster-growth-system/references/current-state-findings.md @@ -1,57 +1,57 @@ -# QRMaster Current-State Findings - -These findings came from a local repo review of `C:\Users\a931627\Documents\QRMASTER`. - -## Existing structural strengths - -- QRMASTER already has several commercial marketing routes: - - `/dynamic-qr-code-generator` - - `/bulk-qr-code-generator` - - `/custom-qr-code-generator` - - `/qr-code-tracking` -- There is already a `Learn` hub and pillar structure: - - `/learn` - - `/learn/basics` - - `/learn/tracking` - - `/learn/use-cases` - - `/learn/security` - - `/learn/developer` -- There is a large blog data layer with many QR use-case and tracking posts. -- There is a tool layer under `/tools/*` that already covers many practical generators. - -## Existing content opportunities - -The repo already includes or strongly hints at: - -- restaurant menu content -- business card / vCard content -- event content -- QR marketing / tracking content -- print-size and dynamic-vs-static support content -- Instagram, WhatsApp, PayPal, Event, and other tool pages that can support use-case clusters - -This means the next growth step should usually be: - -- improve surfacing -- improve internal linking -- improve commercial-parent relationships -- improve measurement - -not blindly create 30 net-new pages first - -## Observed gaps - -- no dedicated `/use-cases` hub was evident in the reviewed route set -- use-case content appears spread across blog, learn, and tools -- the site likely needs stronger internal-link choreography between commercial pages, use-case content, and support content -- current tracking appeared stronger on product actions than on marketing CTAs - -## Practical implication - -For future QRMASTER repo work: - -1. surface the existing use-case inventory better -2. connect it to the correct commercial parent pages -3. add consistent CTA and landing-page measurement -4. then expand the page set based on score and proof - +# QRMaster Current-State Findings + +These findings came from a local repo review of `C:\Users\a931627\Documents\QRMASTER`. + +## Existing structural strengths + +- QRMASTER already has several commercial marketing routes: + - `/dynamic-qr-code-generator` + - `/bulk-qr-code-generator` + - `/custom-qr-code-generator` + - `/qr-code-tracking` +- There is already a `Learn` hub and pillar structure: + - `/learn` + - `/learn/basics` + - `/learn/tracking` + - `/learn/use-cases` + - `/learn/security` + - `/learn/developer` +- There is a large blog data layer with many QR use-case and tracking posts. +- There is a tool layer under `/tools/*` that already covers many practical generators. + +## Existing content opportunities + +The repo already includes or strongly hints at: + +- restaurant menu content +- business card / vCard content +- event content +- QR marketing / tracking content +- print-size and dynamic-vs-static support content +- Instagram, WhatsApp, PayPal, Event, and other tool pages that can support use-case clusters + +This means the next growth step should usually be: + +- improve surfacing +- improve internal linking +- improve commercial-parent relationships +- improve measurement + +not blindly create 30 net-new pages first + +## Observed gaps + +- no dedicated `/use-cases` hub was evident in the reviewed route set +- use-case content appears spread across blog, learn, and tools +- the site likely needs stronger internal-link choreography between commercial pages, use-case content, and support content +- current tracking appeared stronger on product actions than on marketing CTAs + +## Practical implication + +For future QRMASTER repo work: + +1. surface the existing use-case inventory better +2. connect it to the correct commercial parent pages +3. add consistent CTA and landing-page measurement +4. then expand the page set based on score and proof + diff --git a/qrmaster-growth-system/references/top-30-backlog.md b/qrmaster-growth-system/references/top-30-backlog.md index a62ebbe..e9f2b89 100644 --- a/qrmaster-growth-system/references/top-30-backlog.md +++ b/qrmaster-growth-system/references/top-30-backlog.md @@ -1,79 +1,79 @@ -# QRMaster Top 30 Backlog - -This is the initial candidate backlog for the first serious QRMaster growth sprint. -It is not a promise to build every page immediately; it is the structured pool to score and sequence. - -## 1. Commercial pages - -| Bucket | Page | Primary cluster | Route status | Notes | -|---|---|---|---|---| -| Commercial | Dynamic QR Code Generator | dynamic qr code generator | existing | Core money page, strongest wedge fit | -| Commercial | Bulk QR Code Generator | bulk qr code generator | existing | Strong for teams, labels, events | -| Commercial | QR Code Analytics | qr code analytics | existing content / upgrade | Needs stronger SaaS CTA alignment | -| Commercial | Custom QR Code Generator | custom qr code generator | existing | Strong for branded print use cases | -| Commercial | QR Code Tracking | qr code tracking, trackable qr codes | existing | Bridge between SEO and product proof | -| Commercial | QR Codes for Marketing Campaigns | qr code marketing | likely upgrade/new | Important parent for flyer/poster clusters | - -## 2. Use-case pages - -| Cluster | Page | Primary cluster | Route status | Primary commercial parent | -|---|---|---|---|---| -| Restaurants | Restaurant Menu QR Codes | qr code for restaurant menu | existing blog post | Dynamic QR Code Generator | -| Restaurants | Table Ordering QR Codes | qr code for table ordering | future | Dynamic QR Code Generator | -| Print / SMB | Flyer QR Codes | qr code for flyer | future | QR Codes for Marketing Campaigns | -| Print / SMB | Brochure QR Codes | qr code for brochure | future | QR Codes for Marketing Campaigns | -| Print / SMB | Coupon QR Codes | qr code for coupons | future | QR Code Tracking | -| Print / SMB | Small Business QR Codes | qr code for small business | existing blog post | Dynamic QR Code Generator | -| Business Cards | vCard QR Codes | vcard qr code | existing tool + blog | Dynamic QR Code Generator | -| Business Cards | Business Card QR Codes | qr on business card | existing blog post | Dynamic QR Code Generator | -| Events | Event QR Codes | qr code for events | existing tool + blog | QR Code Tracking | -| Events | Event Ticket QR Codes | qr code for event ticket | future | QR Code Tracking | -| Events | Trade Show Booth QR Codes | qr code for trade show booth | future | QR Codes for Marketing Campaigns | -| Packaging | Packaging QR Codes | qr code for packaging | future | QR Code Analytics | -| Packaging | Product Label QR Codes | qr code for product labels | future | Bulk QR Code Generator | -| Packaging | QR Codes for Inserts / Manuals | qr code for product manuals | future | QR Code Analytics | -| Real Estate | Real Estate Sign QR Codes | qr code for real estate signs | future | QR Code Tracking | -| Real Estate | Property Flyer QR Codes | qr code for property flyers | future | QR Codes for Marketing Campaigns | -| Payments | Payment QR Codes | qr code for payment | future | Dynamic QR Code Generator | -| Feedback | Feedback QR Codes | qr code for feedback collection | future | QR Code Tracking | - -## 3. Support / authority pages - -| Bucket | Page | Primary cluster | Route status | Notes | -|---|---|---|---|---| -| Support | Use Cases Hub | qr code use cases | future | Main hub and distribution point | -| Support | Dynamic vs Static QR Codes | dynamic vs static qr codes | existing blog post | Supports the wedge education | -| Support | QR Code Print Size Guide | qr code print size | existing blog post | Supports print-heavy use cases | -| Support | UTM Parameters with QR Codes | utm parameters qr codes | existing blog post | Supports attribution and tracking wedge | -| Support | Trackable QR Codes | trackable qr codes | existing blog post | Supports analytics and ROI framing | -| Support | Best QR Code Generator Comparison | best qr code generator 2026 | existing blog post | Comparison and alternatives support | - -## Prioritization logic - -Default early `P1` pool: - -1. Dynamic QR Code Generator -2. QR Code Tracking -3. Restaurant Menu QR Codes -4. Flyer QR Codes -5. Business Card QR Codes -6. Event QR Codes -7. Packaging QR Codes -8. Use Cases Hub - -Likely early `P2` pool: - -- Bulk QR Code Generator -- QR Code Analytics -- vCard QR Codes -- UTM Parameters with QR Codes -- Trackable QR Codes -- Small Business QR Codes -- Real Estate Sign QR Codes - -Likely `P3` until proof improves: - -- low-intent vanity generators -- generic "free QR" comparison pages without wedge fit -- pages with weak product proof or unclear CTA path - +# QRMaster Top 30 Backlog + +This is the initial candidate backlog for the first serious QRMaster growth sprint. +It is not a promise to build every page immediately; it is the structured pool to score and sequence. + +## 1. Commercial pages + +| Bucket | Page | Primary cluster | Route status | Notes | +|---|---|---|---|---| +| Commercial | Dynamic QR Code Generator | dynamic qr code generator | existing | Core money page, strongest wedge fit | +| Commercial | Bulk QR Code Generator | bulk qr code generator | existing | Strong for teams, labels, events | +| Commercial | QR Code Analytics | qr code analytics | existing content / upgrade | Needs stronger SaaS CTA alignment | +| Commercial | Custom QR Code Generator | custom qr code generator | existing | Strong for branded print use cases | +| Commercial | QR Code Tracking | qr code tracking, trackable qr codes | existing | Bridge between SEO and product proof | +| Commercial | QR Codes for Marketing Campaigns | qr code marketing | likely upgrade/new | Important parent for flyer/poster clusters | + +## 2. Use-case pages + +| Cluster | Page | Primary cluster | Route status | Primary commercial parent | +|---|---|---|---|---| +| Restaurants | Restaurant Menu QR Codes | qr code for restaurant menu | existing blog post | Dynamic QR Code Generator | +| Restaurants | Table Ordering QR Codes | qr code for table ordering | future | Dynamic QR Code Generator | +| Print / SMB | Flyer QR Codes | qr code for flyer | future | QR Codes for Marketing Campaigns | +| Print / SMB | Brochure QR Codes | qr code for brochure | future | QR Codes for Marketing Campaigns | +| Print / SMB | Coupon QR Codes | qr code for coupons | future | QR Code Tracking | +| Print / SMB | Small Business QR Codes | qr code for small business | existing blog post | Dynamic QR Code Generator | +| Business Cards | vCard QR Codes | vcard qr code | existing tool + blog | Dynamic QR Code Generator | +| Business Cards | Business Card QR Codes | qr on business card | existing blog post | Dynamic QR Code Generator | +| Events | Event QR Codes | qr code for events | existing tool + blog | QR Code Tracking | +| Events | Event Ticket QR Codes | qr code for event ticket | future | QR Code Tracking | +| Events | Trade Show Booth QR Codes | qr code for trade show booth | future | QR Codes for Marketing Campaigns | +| Packaging | Packaging QR Codes | qr code for packaging | future | QR Code Analytics | +| Packaging | Product Label QR Codes | qr code for product labels | future | Bulk QR Code Generator | +| Packaging | QR Codes for Inserts / Manuals | qr code for product manuals | future | QR Code Analytics | +| Real Estate | Real Estate Sign QR Codes | qr code for real estate signs | future | QR Code Tracking | +| Real Estate | Property Flyer QR Codes | qr code for property flyers | future | QR Codes for Marketing Campaigns | +| Payments | Payment QR Codes | qr code for payment | future | Dynamic QR Code Generator | +| Feedback | Feedback QR Codes | qr code for feedback collection | future | QR Code Tracking | + +## 3. Support / authority pages + +| Bucket | Page | Primary cluster | Route status | Notes | +|---|---|---|---|---| +| Support | Use Cases Hub | qr code use cases | future | Main hub and distribution point | +| Support | Dynamic vs Static QR Codes | dynamic vs static qr codes | existing blog post | Supports the wedge education | +| Support | QR Code Print Size Guide | qr code print size | existing blog post | Supports print-heavy use cases | +| Support | UTM Parameters with QR Codes | utm parameters qr codes | existing blog post | Supports attribution and tracking wedge | +| Support | Trackable QR Codes | trackable qr codes | existing blog post | Supports analytics and ROI framing | +| Support | Best QR Code Generator Comparison | best qr code generator 2026 | existing blog post | Comparison and alternatives support | + +## Prioritization logic + +Default early `P1` pool: + +1. Dynamic QR Code Generator +2. QR Code Tracking +3. Restaurant Menu QR Codes +4. Flyer QR Codes +5. Business Card QR Codes +6. Event QR Codes +7. Packaging QR Codes +8. Use Cases Hub + +Likely early `P2` pool: + +- Bulk QR Code Generator +- QR Code Analytics +- vCard QR Codes +- UTM Parameters with QR Codes +- Trackable QR Codes +- Small Business QR Codes +- Real Estate Sign QR Codes + +Likely `P3` until proof improves: + +- low-intent vanity generators +- generic "free QR" comparison pages without wedge fit +- pages with weak product proof or unclear CTA path + diff --git a/qrmaster-growth-system/references/tracking-spec.md b/qrmaster-growth-system/references/tracking-spec.md index 8ed773b..d34f8cc 100644 --- a/qrmaster-growth-system/references/tracking-spec.md +++ b/qrmaster-growth-system/references/tracking-spec.md @@ -1,78 +1,78 @@ -# QRMaster Tracking Spec - -## Why this exists - -QRMaster growth pages should not be judged by traffic alone. -Each page must support a measurable movement into signup or first product value. - -## Core event set - -Required marketing events: - -- `landing_page_viewed` -- `cta_clicked` -- `signup_started` -- `signup_completed` -- `login_started` -- `login_completed` -- `qr_created_first` -- `tool_qr_generated` (optional, for free tools) - -## Required properties - -Use these whenever possible: - -- `landing_page_slug` -- `page_type` -- `cluster` -- `use_case` -- `cta_label` -- `cta_location` -- `destination` -- `utm_source` -- `utm_medium` -- `utm_campaign` -- `utm_content` - -## Page-type model - -Recommended `page_type` values: - -- `homepage` -- `commercial` -- `use_case_hub` -- `use_case` -- `blog_post` -- `learn_hub` -- `pillar` -- `tool` -- `auth` - -## Funnel interpretation - -The minimum useful path is: - -`landing_page_viewed -> cta_clicked -> signup_started -> signup_completed -> qr_created_first` - -Use this to answer: - -- which pages bring qualified visitors -- which pages push users into signup -- which signups actually reach first QR creation - -## Known repo findings from prior QRMaster review - -- PostHog is the real custom-event system. -- GA is wired mainly for pageviews. -- Cookie consent is client-side via `localStorage['cookieConsent']`. -- CTA tracking was previously inconsistent. -- Prior analysis suggested likely duplicate pageviews from repeated PostHog/Facebook pixel mounts. - -If you implement tracking later in the QRMaster repo, verify those points again before shipping changes. - -## Decision rules - -- do not create new events that do not support a decision -- do not track only clicks without tying them to page context -- do not judge SEO pages only by sessions; inspect signup and activation movement too - +# QRMaster Tracking Spec + +## Why this exists + +QRMaster growth pages should not be judged by traffic alone. +Each page must support a measurable movement into signup or first product value. + +## Core event set + +Required marketing events: + +- `landing_page_viewed` +- `cta_clicked` +- `signup_started` +- `signup_completed` +- `login_started` +- `login_completed` +- `qr_created_first` +- `tool_qr_generated` (optional, for free tools) + +## Required properties + +Use these whenever possible: + +- `landing_page_slug` +- `page_type` +- `cluster` +- `use_case` +- `cta_label` +- `cta_location` +- `destination` +- `utm_source` +- `utm_medium` +- `utm_campaign` +- `utm_content` + +## Page-type model + +Recommended `page_type` values: + +- `homepage` +- `commercial` +- `use_case_hub` +- `use_case` +- `blog_post` +- `learn_hub` +- `pillar` +- `tool` +- `auth` + +## Funnel interpretation + +The minimum useful path is: + +`landing_page_viewed -> cta_clicked -> signup_started -> signup_completed -> qr_created_first` + +Use this to answer: + +- which pages bring qualified visitors +- which pages push users into signup +- which signups actually reach first QR creation + +## Known repo findings from prior QRMaster review + +- PostHog is the real custom-event system. +- GA is wired mainly for pageviews. +- Cookie consent is client-side via `localStorage['cookieConsent']`. +- CTA tracking was previously inconsistent. +- Prior analysis suggested likely duplicate pageviews from repeated PostHog/Facebook pixel mounts. + +If you implement tracking later in the QRMaster repo, verify those points again before shipping changes. + +## Decision rules + +- do not create new events that do not support a decision +- do not track only clicks without tying them to page context +- do not judge SEO pages only by sessions; inspect signup and activation movement too + diff --git a/scripts/add-aeo-optimization.js b/scripts/add-aeo-optimization.js index a5fc072..8a61443 100644 --- a/scripts/add-aeo-optimization.js +++ b/scripts/add-aeo-optimization.js @@ -1,144 +1,144 @@ -#!/usr/bin/env node - -const fs = require('fs'); -const path = require('path'); - -// Read the blog-data.ts file -const filePath = path.join(__dirname, '../src/lib/blog-data.ts'); -let content = fs.readFileSync(filePath, 'utf-8'); - -// Get all blog post objects using regex -const postRegex = /\{\s*slug:\s*"([^"]+)"[^}]*?keySteps:\s*\[([\s\S]*?)\]\s*,\s*faq:\s*\[([\s\S]*?)\]\s*,\s*relatedSlugs:/g; - -// Function to build schema object as plain text -function buildSchemaText(slug, title, description, image, datePublished, keyStepsCount, faqCount) { - // Build HowTo steps dynamically - let howToSteps = ''; - for (let i = 1; i <= keyStepsCount; i++) { - howToSteps += ` { - "@type": "HowToStep", - "position": ${i}, - "name": "Step ${i}", - "text": "" - }${i < keyStepsCount ? ',' : ''} -`; - } - - // Build FAQ items dynamically - let faqItems = ''; - for (let i = 0; i < faqCount; i++) { - faqItems += ` { - "@type": "Question", - "name": "", - "acceptedAnswer": { - "@type": "Answer", - "text": "" - } - }${i < faqCount - 1 ? ',' : ''} -`; - } - - return ` - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - - schema: { - article: { - "@context": "https://schema.org", - "@type": "Article", - "headline": "${title}", - "description": "${description}", - "image": "https://www.qrmaster.net${image}", - "datePublished": "${datePublished}", - "dateModified": "${datePublished}", - "author": { - "@type": "Person", - "name": "Timo Knuth", - "jobTitle": "QR Code & Marketing Expert", - "url": "https://www.qrmaster.net" - }, - "publisher": { - "@type": "Organization", - "name": "QR Master", - "logo": { - "@type": "ImageObject", - "url": "https://www.qrmaster.net/logo.svg" - } - }, - "mainEntityOfPage": { - "@type": "WebPage", - "@id": "https://www.qrmaster.net/blog/${slug}" - } - }, - faqPage: { - "@context": "https://schema.org", - "@type": "FAQPage", - "mainEntity": [ -${faqItems} - ] - }, - howTo: { - "@context": "https://schema.org", - "@type": "HowTo", - "name": "${title}", - "step": [ -${howToSteps} - ] - } - },`; -} - -// Simple approach: insert author and schema after relatedSlugs line -// Find each post and inject the fields - -const lines = content.split('\n'); -const newLines = []; -let inPost = false; -let postBuffer = []; - -for (let i = 0; i < lines.length; i++) { - const line = lines[i]; - - // Check if this is a post start - if (line.trim().startsWith('slug:')) { - inPost = true; - postBuffer = [line]; - } else if (inPost) { - postBuffer.push(line); - - // Check if we've found the relatedSlugs line - if (line.trim().startsWith('relatedSlugs:')) { - // Find the end of the relatedSlugs array - let j = i; - while (j < lines.length && !lines[j].includes('],')) { - j++; - } - - // Add the relatedSlugs lines as-is - for (let k = i; k <= j; k++) { - newLines.push(postBuffer[postBuffer.length - (j - k) - 1] || lines[k]); - } - - // Now add author and schema marker - newLines.push(' authorName: "Timo Knuth",'); - newLines.push(' authorTitle: "QR Code & Marketing Expert",'); - newLines.push(' // AEO/GEO optimization: schema added'); - - // Skip ahead - inPost = false; - i = j; - postBuffer = []; - continue; - } - } - - if (!inPost) { - newLines.push(line); - } -} - -// Write the modified content -const modifiedContent = newLines.join('\n'); -fs.writeFileSync(filePath, modifiedContent, 'utf-8'); - -console.log('Added authorName and authorTitle to all posts'); +#!/usr/bin/env node + +const fs = require('fs'); +const path = require('path'); + +// Read the blog-data.ts file +const filePath = path.join(__dirname, '../src/lib/blog-data.ts'); +let content = fs.readFileSync(filePath, 'utf-8'); + +// Get all blog post objects using regex +const postRegex = /\{\s*slug:\s*"([^"]+)"[^}]*?keySteps:\s*\[([\s\S]*?)\]\s*,\s*faq:\s*\[([\s\S]*?)\]\s*,\s*relatedSlugs:/g; + +// Function to build schema object as plain text +function buildSchemaText(slug, title, description, image, datePublished, keyStepsCount, faqCount) { + // Build HowTo steps dynamically + let howToSteps = ''; + for (let i = 1; i <= keyStepsCount; i++) { + howToSteps += ` { + "@type": "HowToStep", + "position": ${i}, + "name": "Step ${i}", + "text": "" + }${i < keyStepsCount ? ',' : ''} +`; + } + + // Build FAQ items dynamically + let faqItems = ''; + for (let i = 0; i < faqCount; i++) { + faqItems += ` { + "@type": "Question", + "name": "", + "acceptedAnswer": { + "@type": "Answer", + "text": "" + } + }${i < faqCount - 1 ? ',' : ''} +`; + } + + return ` + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + + schema: { + article: { + "@context": "https://schema.org", + "@type": "Article", + "headline": "${title}", + "description": "${description}", + "image": "https://www.qrmaster.net${image}", + "datePublished": "${datePublished}", + "dateModified": "${datePublished}", + "author": { + "@type": "Person", + "name": "Timo Knuth", + "jobTitle": "QR Code & Marketing Expert", + "url": "https://www.qrmaster.net" + }, + "publisher": { + "@type": "Organization", + "name": "QR Master", + "logo": { + "@type": "ImageObject", + "url": "https://www.qrmaster.net/logo.svg" + } + }, + "mainEntityOfPage": { + "@type": "WebPage", + "@id": "https://www.qrmaster.net/blog/${slug}" + } + }, + faqPage: { + "@context": "https://schema.org", + "@type": "FAQPage", + "mainEntity": [ +${faqItems} + ] + }, + howTo: { + "@context": "https://schema.org", + "@type": "HowTo", + "name": "${title}", + "step": [ +${howToSteps} + ] + } + },`; +} + +// Simple approach: insert author and schema after relatedSlugs line +// Find each post and inject the fields + +const lines = content.split('\n'); +const newLines = []; +let inPost = false; +let postBuffer = []; + +for (let i = 0; i < lines.length; i++) { + const line = lines[i]; + + // Check if this is a post start + if (line.trim().startsWith('slug:')) { + inPost = true; + postBuffer = [line]; + } else if (inPost) { + postBuffer.push(line); + + // Check if we've found the relatedSlugs line + if (line.trim().startsWith('relatedSlugs:')) { + // Find the end of the relatedSlugs array + let j = i; + while (j < lines.length && !lines[j].includes('],')) { + j++; + } + + // Add the relatedSlugs lines as-is + for (let k = i; k <= j; k++) { + newLines.push(postBuffer[postBuffer.length - (j - k) - 1] || lines[k]); + } + + // Now add author and schema marker + newLines.push(' authorName: "Timo Knuth",'); + newLines.push(' authorTitle: "QR Code & Marketing Expert",'); + newLines.push(' // AEO/GEO optimization: schema added'); + + // Skip ahead + inPost = false; + i = j; + postBuffer = []; + continue; + } + } + + if (!inPost) { + newLines.push(line); + } +} + +// Write the modified content +const modifiedContent = newLines.join('\n'); +fs.writeFileSync(filePath, modifiedContent, 'utf-8'); + +console.log('Added authorName and authorTitle to all posts'); diff --git a/scripts/add-metadata-divs.js b/scripts/add-metadata-divs.js index beda144..603d78f 100644 --- a/scripts/add-metadata-divs.js +++ b/scripts/add-metadata-divs.js @@ -1,66 +1,66 @@ -const fs = require('fs'); -const path = require('path'); - -const filePath = path.join(__dirname, '../src/lib/blog-data.ts'); -let content = fs.readFileSync(filePath, 'utf-8'); - -// Function to format date from ISO format -function formatDate(isoDate) { - const date = new Date(isoDate + 'T00:00:00Z'); - const months = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']; - return `${months[date.getUTCMonth()]} ${date.getUTCDate()}, ${date.getUTCFullYear()}`; -} - -// Replace each post's content to add metadata div -content = content.replace( - /content:\s*`
/g, - (match) => { - // We'll do a more sophisticated replacement with the post data - return match; - } -); - -// Actually, we need a smarter approach - match each post and extract date info -// Let's use a different strategy: find each post object and inject the metadata - -const postRegex = /(\{\s*slug:\s*"([^"]+)"[\s\S]*?publishDate:\s*"([^"]+)"[\s\S]*?dateModified:\s*"([^"]+)"[\s\S]*?authorName:\s*"([^"]+)"[\s\S]*?authorTitle:\s*"([^"]+)"[\s\S]*?content:\s*`
)/g; - -let match; -const replacements = []; - -while ((match = postRegex.exec(content)) !== null) { - const fullMatch = match[0]; - const slug = match[2]; - const publishDate = match[3]; - const dateModified = match[4]; - const authorName = match[5]; - const authorTitle = match[6]; - - const publishFormatted = formatDate(publishDate); - const modifiedFormatted = formatDate(dateModified); - - const metadataDiv = `
-

- Author: ${authorName}, ${authorTitle}
- 📅 Published: ${publishFormatted} | Last updated: ${modifiedFormatted} -

-
- `; - - const replacement = fullMatch.replace( - '
', - `
- ${metadataDiv}` - ); - - replacements.push({ original: fullMatch, replacement, slug }); -} - -// Apply replacements in reverse order to maintain indices -replacements.reverse().forEach(({ original, replacement }) => { - content = content.replace(original, replacement); -}); - -fs.writeFileSync(filePath, content, 'utf-8'); -console.log(`✅ Added metadata divs to ${replacements.length} posts`); -replacements.forEach(r => console.log(` - ${r.slug}`)); +const fs = require('fs'); +const path = require('path'); + +const filePath = path.join(__dirname, '../src/lib/blog-data.ts'); +let content = fs.readFileSync(filePath, 'utf-8'); + +// Function to format date from ISO format +function formatDate(isoDate) { + const date = new Date(isoDate + 'T00:00:00Z'); + const months = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']; + return `${months[date.getUTCMonth()]} ${date.getUTCDate()}, ${date.getUTCFullYear()}`; +} + +// Replace each post's content to add metadata div +content = content.replace( + /content:\s*`
/g, + (match) => { + // We'll do a more sophisticated replacement with the post data + return match; + } +); + +// Actually, we need a smarter approach - match each post and extract date info +// Let's use a different strategy: find each post object and inject the metadata + +const postRegex = /(\{\s*slug:\s*"([^"]+)"[\s\S]*?publishDate:\s*"([^"]+)"[\s\S]*?dateModified:\s*"([^"]+)"[\s\S]*?authorName:\s*"([^"]+)"[\s\S]*?authorTitle:\s*"([^"]+)"[\s\S]*?content:\s*`
)/g; + +let match; +const replacements = []; + +while ((match = postRegex.exec(content)) !== null) { + const fullMatch = match[0]; + const slug = match[2]; + const publishDate = match[3]; + const dateModified = match[4]; + const authorName = match[5]; + const authorTitle = match[6]; + + const publishFormatted = formatDate(publishDate); + const modifiedFormatted = formatDate(dateModified); + + const metadataDiv = `
+

+ Author: ${authorName}, ${authorTitle}
+ 📅 Published: ${publishFormatted} | Last updated: ${modifiedFormatted} +

+
+ `; + + const replacement = fullMatch.replace( + '
', + `
+ ${metadataDiv}` + ); + + replacements.push({ original: fullMatch, replacement, slug }); +} + +// Apply replacements in reverse order to maintain indices +replacements.reverse().forEach(({ original, replacement }) => { + content = content.replace(original, replacement); +}); + +fs.writeFileSync(filePath, content, 'utf-8'); +console.log(`✅ Added metadata divs to ${replacements.length} posts`); +replacements.forEach(r => console.log(` - ${r.slug}`)); diff --git a/scripts/build.js b/scripts/build.js index adb22b7..ba10053 100644 --- a/scripts/build.js +++ b/scripts/build.js @@ -1,137 +1,137 @@ -const { spawnSync } = require('child_process'); -const fs = require('fs'); -const path = require('path'); - -const repoRoot = path.resolve(__dirname, '..'); -const prismaSchemaPath = path.join(repoRoot, 'prisma', 'schema.prisma'); -const generatedSchemaPath = path.join( - repoRoot, - 'node_modules', - '.prisma', - 'client', - 'schema.prisma' -); - -function readFileIfExists(filePath) { - try { - return fs.readFileSync(filePath, 'utf8'); - } catch (error) { - if (error && error.code === 'ENOENT') { - return null; - } - - throw error; - } -} - -function normalizeSchema(schema) { - return schema.replace(/\s+/g, ''); -} - -function schemasMatch() { - const sourceSchema = readFileIfExists(prismaSchemaPath); - const generatedSchema = readFileIfExists(generatedSchemaPath); - - return Boolean( - sourceSchema && - generatedSchema && - normalizeSchema(sourceSchema) === normalizeSchema(generatedSchema) - ); -} - -function run(command, args, options = {}) { - const shouldUseShell = - process.platform === 'win32' && command.toLowerCase().endsWith('.cmd'); - - const result = spawnSync(command, args, { - cwd: repoRoot, - encoding: 'utf8', - stdio: 'pipe', - shell: shouldUseShell, - env: { - ...process.env, - ...options.env, - }, - }); - - if (result.stdout) { - process.stdout.write(result.stdout); - } - - if (result.stderr) { - process.stderr.write(result.stderr); - } - - return result; -} - -function isWindowsPrismaRenameLock(output) { - const text = [output.stdout, output.stderr] - .filter(Boolean) - .join('\n'); - - return ( - process.platform === 'win32' && - text.includes('EPERM: operation not permitted, rename') && - text.includes('query_engine-windows.dll.node') - ); -} - -function runPrismaGenerate() { - const prismaBin = - process.platform === 'win32' - ? path.join(repoRoot, 'node_modules', '.bin', 'prisma.cmd') - : path.join(repoRoot, 'node_modules', '.bin', 'prisma'); - - const result = run(prismaBin, ['generate']); - - if (result.error) { - throw result.error; - } - - if ((result.status ?? 1) === 0) { - return 0; - } - - if (!isWindowsPrismaRenameLock(result) || !schemasMatch()) { - return result.status ?? 1; - } - - console.warn( - '\nPrisma generate hit a Windows file lock, but the generated client already matches prisma/schema.prisma. Continuing with the existing client.\n' - ); - - return 0; -} - -function runNextBuild() { - const nextBin = - process.platform === 'win32' - ? path.join(repoRoot, 'node_modules', '.bin', 'next.cmd') - : path.join(repoRoot, 'node_modules', '.bin', 'next'); - - // WSL needs more aggressive memory settings - const isWSL = process.platform === 'linux' && require('fs').existsSync('/proc/version') && - require('fs').readFileSync('/proc/version', 'utf8').toLowerCase().includes('microsoft'); - - const memoryLimit = isWSL ? '8192' : '4096'; - - return run(nextBin, ['build'], { - env: { - NODE_OPTIONS: `--max-old-space-size=${memoryLimit}`, - SKIP_ENV_VALIDATION: 'true', - }, - }); -} - -const prismaExitCode = runPrismaGenerate(); -if (prismaExitCode !== 0) { - process.exit(prismaExitCode); -} - -const nextResult = runNextBuild(); -if (nextResult.error) { - throw nextResult.error; -} - -process.exit(nextResult.status ?? 1); +const { spawnSync } = require('child_process'); +const fs = require('fs'); +const path = require('path'); + +const repoRoot = path.resolve(__dirname, '..'); +const prismaSchemaPath = path.join(repoRoot, 'prisma', 'schema.prisma'); +const generatedSchemaPath = path.join( + repoRoot, + 'node_modules', + '.prisma', + 'client', + 'schema.prisma' +); + +function readFileIfExists(filePath) { + try { + return fs.readFileSync(filePath, 'utf8'); + } catch (error) { + if (error && error.code === 'ENOENT') { + return null; + } + + throw error; + } +} + +function normalizeSchema(schema) { + return schema.replace(/\s+/g, ''); +} + +function schemasMatch() { + const sourceSchema = readFileIfExists(prismaSchemaPath); + const generatedSchema = readFileIfExists(generatedSchemaPath); + + return Boolean( + sourceSchema && + generatedSchema && + normalizeSchema(sourceSchema) === normalizeSchema(generatedSchema) + ); +} + +function run(command, args, options = {}) { + const shouldUseShell = + process.platform === 'win32' && command.toLowerCase().endsWith('.cmd'); + + const result = spawnSync(command, args, { + cwd: repoRoot, + encoding: 'utf8', + stdio: 'pipe', + shell: shouldUseShell, + env: { + ...process.env, + ...options.env, + }, + }); + + if (result.stdout) { + process.stdout.write(result.stdout); + } + + if (result.stderr) { + process.stderr.write(result.stderr); + } + + return result; +} + +function isWindowsPrismaRenameLock(output) { + const text = [output.stdout, output.stderr] + .filter(Boolean) + .join('\n'); + + return ( + process.platform === 'win32' && + text.includes('EPERM: operation not permitted, rename') && + text.includes('query_engine-windows.dll.node') + ); +} + +function runPrismaGenerate() { + const prismaBin = + process.platform === 'win32' + ? path.join(repoRoot, 'node_modules', '.bin', 'prisma.cmd') + : path.join(repoRoot, 'node_modules', '.bin', 'prisma'); + + const result = run(prismaBin, ['generate']); + + if (result.error) { + throw result.error; + } + + if ((result.status ?? 1) === 0) { + return 0; + } + + if (!isWindowsPrismaRenameLock(result) || !schemasMatch()) { + return result.status ?? 1; + } + + console.warn( + '\nPrisma generate hit a Windows file lock, but the generated client already matches prisma/schema.prisma. Continuing with the existing client.\n' + ); + + return 0; +} + +function runNextBuild() { + const nextBin = + process.platform === 'win32' + ? path.join(repoRoot, 'node_modules', '.bin', 'next.cmd') + : path.join(repoRoot, 'node_modules', '.bin', 'next'); + + // WSL needs more aggressive memory settings + const isWSL = process.platform === 'linux' && require('fs').existsSync('/proc/version') && + require('fs').readFileSync('/proc/version', 'utf8').toLowerCase().includes('microsoft'); + + const memoryLimit = isWSL ? '8192' : '4096'; + + return run(nextBin, ['build'], { + env: { + NODE_OPTIONS: `--max-old-space-size=${memoryLimit}`, + SKIP_ENV_VALIDATION: 'true', + }, + }); +} + +const prismaExitCode = runPrismaGenerate(); +if (prismaExitCode !== 0) { + process.exit(prismaExitCode); +} + +const nextResult = runNextBuild(); +if (nextResult.error) { + throw nextResult.error; +} + +process.exit(nextResult.status ?? 1); diff --git a/scripts/fix-metadata-dates.js b/scripts/fix-metadata-dates.js index d71c49f..a036cce 100644 --- a/scripts/fix-metadata-dates.js +++ b/scripts/fix-metadata-dates.js @@ -1,46 +1,46 @@ -const fs = require('fs'); -const path = require('path'); - -const filePath = path.join(__dirname, '../src/lib/blog-data.ts'); -let content = fs.readFileSync(filePath, 'utf-8'); - -// Fix the date formatting issue in metadata divs -// Replace "undefined NaN, NaN" with proper formatted dates from the post data - -const postRegex = /slug:\s*"([^"]+)"[\s\S]*?date:\s*"([^"]+)"[\s\S]*?updatedAt:\s*"([^"]+)"[\s\S]*?
{ - const pattern = new RegExp( - `(
{ + const pattern = new RegExp( + `(
/dev/null; then - echo -e "${RED}❌ Docker is not installed. Please install Docker first.${NC}" - exit 1 -fi - -# Check if Docker Compose is installed -if ! command -v docker-compose &> /dev/null; then - echo -e "${RED}❌ Docker Compose is not installed. Please install Docker Compose first.${NC}" - exit 1 -fi - -echo -e "${GREEN}✓${NC} Docker is installed" -echo -e "${GREEN}✓${NC} Docker Compose is installed" -echo "" - -# Check if .env exists -if [ ! -f .env ]; then - echo "📝 Creating .env file from template..." - cp env.example .env - - # Generate secrets - if command -v openssl &> /dev/null; then - NEXTAUTH_SECRET=$(openssl rand -base64 32) - IP_SALT=$(openssl rand -base64 32) - - # Update .env with generated secrets - sed -i.bak "s|NEXTAUTH_SECRET=.*|NEXTAUTH_SECRET=$NEXTAUTH_SECRET|" .env - sed -i.bak "s|IP_SALT=.*|IP_SALT=$IP_SALT|" .env - rm .env.bak 2>/dev/null || true - - echo -e "${GREEN}✓${NC} Generated secure secrets" - else - echo -e "${YELLOW}⚠${NC} OpenSSL not found. Please manually update NEXTAUTH_SECRET and IP_SALT in .env" - fi -else - echo -e "${GREEN}✓${NC} .env file already exists" -fi - -echo "" - -# Ask user what mode they want -echo "Choose setup mode:" -echo "1) Development (database only in Docker, app on host)" -echo "2) Production (full stack in Docker)" -read -p "Enter choice [1-2]: " choice - -echo "" - -case $choice in - 1) - echo "🔧 Setting up development environment..." - echo "" - - # Start database services - echo "Starting PostgreSQL and Redis..." - docker-compose -f docker-compose.dev.yml up -d - - # Wait for database to be ready - echo "Waiting for database to be ready..." - sleep 5 - - # Install dependencies - echo "Installing dependencies..." - npm install - - # Run migrations - echo "Running database migrations..." - npm run db:migrate - - # Seed database - echo "Seeding database with demo data..." - npm run db:seed - - echo "" - echo -e "${GREEN}✅ Development environment ready!${NC}" - echo "" - echo "To start the application:" - echo " npm run dev" - echo "" - echo "Access points:" - echo " - App: http://localhost:3050" - echo " - Database UI: http://localhost:8080" - echo " - Database: localhost:5435" - echo " - Redis: localhost:6379" - ;; - 2) - echo "🚀 Setting up production environment..." - echo "" - - # Build and start all services - echo "Building and starting all services..." - docker-compose up -d --build - - # Wait for services to be ready - echo "Waiting for services to be ready..." - sleep 10 - - # Run migrations - echo "Running database migrations..." - docker-compose exec web npx prisma migrate deploy - - # Seed database - echo "Seeding database with demo data..." - docker-compose exec web npm run db:seed - - echo "" - echo -e "${GREEN}✅ Production environment ready!${NC}" - echo "" - echo "Access points:" - echo " - App: http://localhost:3050" - echo " - Database: localhost:5435" - echo " - Redis: localhost:6379" - echo "" - echo "To view logs:" - echo " docker-compose logs -f" - ;; - *) - echo -e "${RED}Invalid choice. Exiting.${NC}" - exit 1 - ;; -esac - -echo "" -echo "📚 Documentation:" -echo " - Quick start: README.md" -echo " - Docker guide: DOCKER_SETUP.md" -echo " - Migration guide: MIGRATION_FROM_SUPABASE.md" -echo "" -echo "🎉 Setup complete! Happy coding!" - +#!/bin/bash + +# QR Master - Quick Setup Script +# This script automates the initial setup process + +set -e + +echo "🚀 QR Master - Quick Setup" +echo "================================" +echo "" + +# Colors for output +RED='\033[0;31m' +GREEN='\033[0;32m' +YELLOW='\033[1;33m' +NC='\033[0m' # No Color + +# Check if Docker is installed +if ! command -v docker &> /dev/null; then + echo -e "${RED}❌ Docker is not installed. Please install Docker first.${NC}" + exit 1 +fi + +# Check if Docker Compose is installed +if ! command -v docker-compose &> /dev/null; then + echo -e "${RED}❌ Docker Compose is not installed. Please install Docker Compose first.${NC}" + exit 1 +fi + +echo -e "${GREEN}✓${NC} Docker is installed" +echo -e "${GREEN}✓${NC} Docker Compose is installed" +echo "" + +# Check if .env exists +if [ ! -f .env ]; then + echo "📝 Creating .env file from template..." + cp env.example .env + + # Generate secrets + if command -v openssl &> /dev/null; then + NEXTAUTH_SECRET=$(openssl rand -base64 32) + IP_SALT=$(openssl rand -base64 32) + + # Update .env with generated secrets + sed -i.bak "s|NEXTAUTH_SECRET=.*|NEXTAUTH_SECRET=$NEXTAUTH_SECRET|" .env + sed -i.bak "s|IP_SALT=.*|IP_SALT=$IP_SALT|" .env + rm .env.bak 2>/dev/null || true + + echo -e "${GREEN}✓${NC} Generated secure secrets" + else + echo -e "${YELLOW}⚠${NC} OpenSSL not found. Please manually update NEXTAUTH_SECRET and IP_SALT in .env" + fi +else + echo -e "${GREEN}✓${NC} .env file already exists" +fi + +echo "" + +# Ask user what mode they want +echo "Choose setup mode:" +echo "1) Development (database only in Docker, app on host)" +echo "2) Production (full stack in Docker)" +read -p "Enter choice [1-2]: " choice + +echo "" + +case $choice in + 1) + echo "🔧 Setting up development environment..." + echo "" + + # Start database services + echo "Starting PostgreSQL and Redis..." + docker-compose -f docker-compose.dev.yml up -d + + # Wait for database to be ready + echo "Waiting for database to be ready..." + sleep 5 + + # Install dependencies + echo "Installing dependencies..." + npm install + + # Run migrations + echo "Running database migrations..." + npm run db:migrate + + # Seed database + echo "Seeding database with demo data..." + npm run db:seed + + echo "" + echo -e "${GREEN}✅ Development environment ready!${NC}" + echo "" + echo "To start the application:" + echo " npm run dev" + echo "" + echo "Access points:" + echo " - App: http://localhost:3050" + echo " - Database UI: http://localhost:8080" + echo " - Database: localhost:5435" + echo " - Redis: localhost:6379" + ;; + 2) + echo "🚀 Setting up production environment..." + echo "" + + # Build and start all services + echo "Building and starting all services..." + docker-compose up -d --build + + # Wait for services to be ready + echo "Waiting for services to be ready..." + sleep 10 + + # Run migrations + echo "Running database migrations..." + docker-compose exec web npx prisma migrate deploy + + # Seed database + echo "Seeding database with demo data..." + docker-compose exec web npm run db:seed + + echo "" + echo -e "${GREEN}✅ Production environment ready!${NC}" + echo "" + echo "Access points:" + echo " - App: http://localhost:3050" + echo " - Database: localhost:5435" + echo " - Redis: localhost:6379" + echo "" + echo "To view logs:" + echo " docker-compose logs -f" + ;; + *) + echo -e "${RED}Invalid choice. Exiting.${NC}" + exit 1 + ;; +esac + +echo "" +echo "📚 Documentation:" +echo " - Quick start: README.md" +echo " - Docker guide: DOCKER_SETUP.md" +echo " - Migration guide: MIGRATION_FROM_SUPABASE.md" +echo "" +echo "🎉 Setup complete! Happy coding!" + diff --git a/seo_findings.md b/seo_findings.md index 77fbd02..7fed7c6 100644 --- a/seo_findings.md +++ b/seo_findings.md @@ -1,100 +1,100 @@ -# QR Master SEO Analysis Report -**Domain:** www.qrmaster.net -**Date:** January 5, 2026 - ---- - -## Executive Summary - -| Metric | Current | Target | -|--------|---------|--------| -| Domain Rating (DR) | 0 | 20+ | -| Backlinks | 0 | 50+ | -| OnPage Score | 67% | 90%+ | -| Organic Keywords | 0 | 50+ | - ---- - -## ✅ What's Working Well - -- **Meta-Angaben:** 100% ✓ (Title, Description, Canonical) -- **Mobile Optimization:** Viewport + Apple Touch Icon ✓ -- **HTTPS:** Fully implemented ✓ -- **Doctype & Encoding:** Correct ✓ -- **Server Configuration:** 90% ✓ (redirects, compression) - ---- - -## 🔴 Critical Issues (Fix Immediately) - -### 1. Missing H1 & Content -- **Problem:** "0 words" detected on homepage -- **Cause:** Client-side rendering not visible to crawlers -- **Status:** ✅ FIXED - Added server-side SEO content block - -### 2. No Internal Links -- **Problem:** Homepage appears as landing page with few links -- **Solution:** Blog posts now include internal links to key pages - -### 3. X-Powered-By Header -- **Problem:** Exposes tech stack -- **Status:** ✅ FIXED - Added `poweredByHeader: false` to next.config - -### 4. Zero Backlinks -- **Problem:** No external links pointing to domain -- **Solution:** Submit to directories, create Claude artifacts - ---- - -## Keyword Opportunities - -### High Priority (Low/Medium Difficulty) -| Keyword | KD | Volume | Action | -|---------|-----|--------|--------| -| qr code tracking | 4 (Easy) | ~1.7K | ✅ Existing blog post | -| qr code for restaurant menu | 44 (Hard) | ~100+ | ✅ NEW blog post | -| vcard qr code generator | 47 (Hard) | ~100+ | ✅ NEW blog post | -| bulk qr code generator | 54 (Hard) | ~795 | ✅ Existing page | - -### Avoid (Too Competitive) -| Keyword | KD | Required Backlinks | -|---------|-----|-------------------| -| qr code generator | 94 | ~1,197 | -| dynamic qr code generator | 85 | ~488 | - ---- - -## Competitor Analysis (Top 3) - -| Rank | Domain | DR | Backlinks | Traffic | -|------|--------|-----|-----------|---------| -| 1 | qr-code-generator.com | 83 | 67K | 986K | -| 2 | canva.com/qr | 93 | 7.4K | 433K | -| 3 | adobe.com/express/qr | 96 | 13K | 317K | - -**Takeaway:** Focus on long-tail keywords and niche content. Direct competition for head terms is not viable without 100+ quality backlinks. - ---- - -## Action Plan - -### Phase 1: Technical (Completed ✅) -- [x] Add server-side H1 to homepage -- [x] Remove X-Powered-By header -- [x] Add 4 new blog posts - -### Phase 2: Backlinks (Your Action Required) -- [ ] Submit to Product Hunt -- [ ] Submit to AlternativeTo -- [ ] Submit to SaaSHub -- [ ] Create Claude artifacts with backlinks - -### Phase 3: Monitoring -- [ ] Re-run SEO audit in 2 weeks -- [ ] Check GSC for indexed pages -- [ ] Monitor keyword rankings monthly - ---- - -## Source Data +# QR Master SEO Analysis Report +**Domain:** www.qrmaster.net +**Date:** January 5, 2026 + +--- + +## Executive Summary + +| Metric | Current | Target | +|--------|---------|--------| +| Domain Rating (DR) | 0 | 20+ | +| Backlinks | 0 | 50+ | +| OnPage Score | 67% | 90%+ | +| Organic Keywords | 0 | 50+ | + +--- + +## ✅ What's Working Well + +- **Meta-Angaben:** 100% ✓ (Title, Description, Canonical) +- **Mobile Optimization:** Viewport + Apple Touch Icon ✓ +- **HTTPS:** Fully implemented ✓ +- **Doctype & Encoding:** Correct ✓ +- **Server Configuration:** 90% ✓ (redirects, compression) + +--- + +## 🔴 Critical Issues (Fix Immediately) + +### 1. Missing H1 & Content +- **Problem:** "0 words" detected on homepage +- **Cause:** Client-side rendering not visible to crawlers +- **Status:** ✅ FIXED - Added server-side SEO content block + +### 2. No Internal Links +- **Problem:** Homepage appears as landing page with few links +- **Solution:** Blog posts now include internal links to key pages + +### 3. X-Powered-By Header +- **Problem:** Exposes tech stack +- **Status:** ✅ FIXED - Added `poweredByHeader: false` to next.config + +### 4. Zero Backlinks +- **Problem:** No external links pointing to domain +- **Solution:** Submit to directories, create Claude artifacts + +--- + +## Keyword Opportunities + +### High Priority (Low/Medium Difficulty) +| Keyword | KD | Volume | Action | +|---------|-----|--------|--------| +| qr code tracking | 4 (Easy) | ~1.7K | ✅ Existing blog post | +| qr code for restaurant menu | 44 (Hard) | ~100+ | ✅ NEW blog post | +| vcard qr code generator | 47 (Hard) | ~100+ | ✅ NEW blog post | +| bulk qr code generator | 54 (Hard) | ~795 | ✅ Existing page | + +### Avoid (Too Competitive) +| Keyword | KD | Required Backlinks | +|---------|-----|-------------------| +| qr code generator | 94 | ~1,197 | +| dynamic qr code generator | 85 | ~488 | + +--- + +## Competitor Analysis (Top 3) + +| Rank | Domain | DR | Backlinks | Traffic | +|------|--------|-----|-----------|---------| +| 1 | qr-code-generator.com | 83 | 67K | 986K | +| 2 | canva.com/qr | 93 | 7.4K | 433K | +| 3 | adobe.com/express/qr | 96 | 13K | 317K | + +**Takeaway:** Focus on long-tail keywords and niche content. Direct competition for head terms is not viable without 100+ quality backlinks. + +--- + +## Action Plan + +### Phase 1: Technical (Completed ✅) +- [x] Add server-side H1 to homepage +- [x] Remove X-Powered-By header +- [x] Add 4 new blog posts + +### Phase 2: Backlinks (Your Action Required) +- [ ] Submit to Product Hunt +- [ ] Submit to AlternativeTo +- [ ] Submit to SaaSHub +- [ ] Create Claude artifacts with backlinks + +### Phase 3: Monitoring +- [ ] Re-run SEO audit in 2 weeks +- [ ] Check GSC for indexed pages +- [ ] Monitor keyword rankings monthly + +--- + +## Source Data Raw data from: Seobility SEO Check, Ahrefs Free Tools, SpyFu \ No newline at end of file diff --git a/src/app/(main)/(app)/bulk-creation/page.tsx b/src/app/(main)/(app)/bulk-creation/page.tsx index 0021624..bc6a9d9 100644 --- a/src/app/(main)/(app)/bulk-creation/page.tsx +++ b/src/app/(main)/(app)/bulk-creation/page.tsx @@ -1,719 +1,719 @@ -'use client'; - -import React, { useState, useCallback } from 'react'; -import { useDropzone } from 'react-dropzone'; -import Papa from 'papaparse'; -import ExcelJS from 'exceljs'; -import { Card, CardHeader, CardTitle, CardContent } from '@/components/ui/Card'; -import { Button } from '@/components/ui/Button'; -import { Badge } from '@/components/ui/Badge'; -import { Select } from '@/components/ui/Select'; -import { QRCodeSVG } from 'qrcode.react'; -import { showToast } from '@/components/ui/Toast'; -import { useTranslation } from '@/hooks/useTranslation'; -import { useCsrf } from '@/hooks/useCsrf'; -import JSZip from 'jszip'; -import { saveAs } from 'file-saver'; - -interface BulkQRData { - title: string; - content: string; -} - -interface GeneratedQR { - title: string; - content: string; // Original URL - svg: string; // SVG markup -} - -export default function BulkCreationPage() { - const { t } = useTranslation(); - const { fetchWithCsrf } = useCsrf(); - const [step, setStep] = useState<'upload' | 'preview' | 'complete'>('upload'); - const [data, setData] = useState([]); - const [mapping, setMapping] = useState>({}); - const [loading, setLoading] = useState(false); - const [generatedQRs, setGeneratedQRs] = useState([]); - const [userPlan, setUserPlan] = useState('FREE'); - - // Check user plan on mount - React.useEffect(() => { - const checkPlan = async () => { - try { - const response = await fetch('/api/user/plan'); - if (response.ok) { - const data = await response.json(); - setUserPlan(data.plan || 'FREE'); - } - } catch (error) { - console.error('Error checking plan:', error); - } - }; - checkPlan(); - }, []); - - const onDrop = useCallback((acceptedFiles: File[]) => { - const file = acceptedFiles[0]; - if (!file) return; - - const reader = new FileReader(); - - if (file.name.endsWith('.csv')) { - reader.onload = (e) => { - const text = e.target?.result as string; - const result = Papa.parse(text, { header: true }); - processData(result.data); - }; - reader.readAsText(file); - } else if (file.name.endsWith('.xlsx') || file.name.endsWith('.xls')) { - reader.onload = async (e) => { - const buffer = e.target?.result as ArrayBuffer; - const workbook = new ExcelJS.Workbook(); - await workbook.xlsx.load(buffer); - const worksheet = workbook.worksheets[0]; - const jsonData: any[] = []; - - // Get headers from first row - const headers: string[] = []; - const firstRow = worksheet.getRow(1); - firstRow.eachCell((cell, colNumber) => { - headers[colNumber - 1] = cell.value?.toString() || ''; - }); - - // Convert rows to objects - worksheet.eachRow((row, rowNumber) => { - if (rowNumber === 1) return; // Skip header row - const rowData: any = {}; - row.eachCell((cell, colNumber) => { - const header = headers[colNumber - 1]; - if (header) { - rowData[header] = cell.value; - } - }); - jsonData.push(rowData); - }); - - processData(jsonData); - }; - reader.readAsArrayBuffer(file); - } - }, []); - - const { getRootProps, getInputProps, isDragActive } = useDropzone({ - onDrop, - accept: { - 'text/csv': ['.csv'], - 'application/vnd.ms-excel': ['.xls'], - 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': ['.xlsx'], - }, - maxFiles: 1, - }); - - const processData = (rawData: any[]) => { - // Limit to 1000 rows - const limitedData = rawData.slice(0, 1000); - - // Auto-detect columns - if (limitedData.length > 0) { - const columns = Object.keys(limitedData[0]); - const autoMapping: Record = {}; - - columns.forEach((col) => { - const lowerCol = col.toLowerCase(); - if (lowerCol.includes('title') || lowerCol.includes('name') || lowerCol === 'test') { - autoMapping.title = col; - } else if (lowerCol.includes('content') || lowerCol.includes('url') || lowerCol.includes('data') || lowerCol.includes('link')) { - autoMapping.content = col; - } - }); - - // If no title column found, use first column - if (!autoMapping.title && columns.length > 0) { - autoMapping.title = columns[0]; - } - // If no content column found, use second column - if (!autoMapping.content && columns.length > 1) { - autoMapping.content = columns[1]; - } - - setMapping(autoMapping); - } - - setData(limitedData); - setStep('preview'); - }; - - const generateStaticQRCodes = async () => { - setLoading(true); - - try { - const qrCodes: GeneratedQR[] = []; - - // Generate all QR codes client-side (Static QR Codes) - for (const row of data) { - const title = row[mapping.title as keyof typeof row] || 'Untitled'; - const content = row[mapping.content as keyof typeof row] || 'https://example.com'; - - // Create a temporary div to render QR code - const tempDiv = document.createElement('div'); - tempDiv.style.display = 'none'; - document.body.appendChild(tempDiv); - - const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg'); - svg.setAttribute('width', '300'); - svg.setAttribute('height', '300'); - tempDiv.appendChild(svg); - - // Use qrcode library to generate SVG - const QRCode = require('qrcode'); - const qrSvg = await QRCode.toString(content, { - type: 'svg', - width: 300, - margin: 2, - color: { - dark: '#000000', - light: '#FFFFFF', - }, - }); - - qrCodes.push({ - title: String(title), - content: String(content), // Store the original URL - svg: qrSvg, - }); - - document.body.removeChild(tempDiv); - } - - setGeneratedQRs(qrCodes); - setStep('complete'); - showToast(`Successfully generated ${qrCodes.length} static QR codes!`, 'success'); - } catch (error) { - console.error('QR generation error:', error); - showToast('Failed to generate QR codes', 'error'); - } finally { - setLoading(false); - } - }; - - const downloadAllQRCodes = async () => { - const zip = new JSZip(); - - generatedQRs.forEach((qr, index) => { - const fileName = `${qr.title.replace(/[^a-z0-9]/gi, '_').toLowerCase()}_${index + 1}.svg`; - zip.file(fileName, qr.svg); - }); - - const blob = await zip.generateAsync({ type: 'blob' }); - saveAs(blob, 'qr-codes-bulk.zip'); - showToast('Download started!', 'success'); - }; - - const saveQRCodesToDatabase = async () => { - setLoading(true); - - try { - const qrCodesToSave = generatedQRs.map((qr) => ({ - title: qr.title, - isStatic: true, // This tells the API it's a static QR code - contentType: 'URL', - content: { url: qr.content }, // Content needs to be an object with url property - status: 'ACTIVE', - })); - - // Save each QR code to the database - const savePromises = qrCodesToSave.map((qr) => - fetchWithCsrf('/api/qrs', { - method: 'POST', - body: JSON.stringify(qr), - }) - ); - - const results = await Promise.all(savePromises); - const failedCount = results.filter((r) => !r.ok).length; - - if (failedCount === 0) { - showToast(`Successfully saved ${qrCodesToSave.length} QR codes!`, 'success'); - // Redirect to dashboard after 1 second - setTimeout(() => { - window.location.href = '/dashboard'; - }, 1000); - } else { - showToast(`Saved ${qrCodesToSave.length - failedCount} QR codes, ${failedCount} failed`, 'warning'); - } - } catch (error) { - console.error('Error saving QR codes:', error); - showToast('Failed to save QR codes', 'error'); - } finally { - setLoading(false); - } - }; - - const downloadTemplate = () => { - const template = [ - { title: 'Product Page', content: 'https://example.com/product' }, - { title: 'Landing Page', content: 'https://example.com/landing' }, - { title: 'Contact Form', content: 'https://example.com/contact' }, - { title: 'About Us', content: 'https://example.com/about' }, - { title: 'Pricing Page', content: 'https://example.com/pricing' }, - { title: 'FAQ Page', content: 'https://example.com/faq' }, - { title: 'Blog Article', content: 'https://example.com/blog/article-1' }, - { title: 'Support Portal', content: 'https://example.com/support' }, - { title: 'Download Page', content: 'https://example.com/download' }, - { title: 'Social Media', content: 'https://instagram.com/yourcompany' }, - { title: 'YouTube Video', content: 'https://youtube.com/watch?v=example' }, - ]; - - const csv = Papa.unparse(template); - const blob = new Blob([csv], { type: 'text/csv' }); - const url = URL.createObjectURL(blob); - const a = document.createElement('a'); - a.href = url; - a.download = 'bulk-qr-template.csv'; - a.click(); - URL.revokeObjectURL(url); - }; - - // Show upgrade prompt if not Business plan - if (userPlan !== 'BUSINESS') { - return ( -
- - -
- - - -
-

Business Plan Required

-

- Bulk QR code creation is exclusively available for Business plan subscribers. - Upgrade now to generate up to 1,000 static QR codes at once. -

-
- - -
- - -
- ); - } - - return ( -
-
-

{t('bulk.title')}

-

{t('bulk.subtitle')}

-
- - {/* Template Warning Banner */} - - -
- - - -
-

Please Follow the Template Format

-

- Download the template below and follow the format exactly. Your CSV must include columns for title and content (URL). -

-
-
- - - - {/* Info Banner */} - - -
- - - -
-

Static QR Codes Only

-

- Bulk creation generates static QR codes that cannot be edited after creation. - These QR codes do not include tracking or analytics. Perfect for print materials and offline use. -

-
-
- - - - {/* Progress Steps */} -
-
-
-
- 1 -
- Upload File -
- -
-
-
- -
-
- 2 -
- Preview & Map -
- -
-
-
- -
-
- 3 -
- Download -
-
-
- - {/* Upload Step */} - {step === 'upload' && ( - - -
- -
- -
- - - - -

- {isDragActive ? 'Drop the file here' : 'Drag & drop your file here'} -

-

or click to browse

-

Supports CSV, XLS, XLSX (max 1,000 rows)

-
- -
- - -
-
- - - -
-
-

Simple Format

-

Just title & URL

-
-
- - - - - -
-
- - - -
-
-

Static QR Codes

-

No tracking included

-
-
- - - - - -
-
- - - -
-
-

Instant Download

-

Get ZIP with all SVGs

-
-
- - -
- - {/* Supported QR Code Types Section */} -
- - - 📋 Supported QR Code Types - - -
-

- This bulk generator creates static QR codes for multiple content types. Choose the format that matches your needs: -

- -
-
-

🌐 URL - Website Links

-

Format: https://example.com

-

Example: Product Page,https://example.com/product

-
- -
-

👤 VCARD - Contact Cards

-

Format: FirstName,LastName,Email,Phone,Organization,Title

-

Example: John Doe,"John,Doe,john@example.com,+1234567890,Company,CEO"

-
- -
-

📍 GEO - Locations

-

Format: latitude,longitude,label

-

Example: Office Location,"37.7749,-122.4194,Main Office"

-
- -
-

📞 PHONE - Phone Numbers

-

Format: +1234567890

-

Example: Support Hotline,+1234567890

-
- -
-

📝 TEXT - Plain Text

-

Format: Any text content

-

Example: Serial Number,SN-12345-ABCDE

-
-
- -
-

📥 CSV File Format:

-

- Your file needs two columns: title and content -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
titlecontent
Product Pagehttps://example.com/product
John DoeJohn,Doe,john@example.com,+1234567890,Company,CEO
Office Location37.7749,-122.4194,Main Office
Support Hotline+1234567890
Serial NumberSN-12345-ABCDE
-
-
- -
-

ℹ️ Important Notes

-
    -
  • • Static QR codes - Cannot be edited after creation
    • -
  • • No tracking or analytics - Scans are not tracked
    • -
  • • Maximum 1,000 QR codes per upload
    • -
  • • Download as ZIP or save to your dashboard
    • -
  • • All QR types supported - URLs, vCards, locations, phone numbers, and text
    • -
-
- -
-

- 💡 Tip: Download the template above to see examples of all 5 QR code types with 11 ready-to-use examples! -

-
-
- - -
- - - )} - - {/* Preview Step */} - {step === 'preview' && ( - - -
- Preview & Map Columns - {data.length} rows detected -
- - -
-
- - setMapping({ ...mapping, content: e.target.value })} - options={Object.keys(data[0] || {}).map((col) => ({ value: col, label: col }))} - /> -
-
- -
- - - - - - - - - - {data.slice(0, 5).map((row: any, index) => ( - - - - - - ))} - -
PreviewTitleContent
- - - {row[mapping.title] || 'Untitled'} - - {(row[mapping.content] || '').substring(0, 50)}... -
-
- - {data.length > 5 && ( -

- Showing 5 of {data.length} rows -

- )} - -
- - -
- - - )} - - {/* Complete Step */} - {step === 'complete' && ( - - -
- - - -
-

Generation Complete!

-

- Successfully generated {generatedQRs.length} static QR codes -

- -
-
- {generatedQRs.slice(0, 8).map((qr, index) => ( -
-
-
-
-

{qr.title}

-
- ))} -
-
- - - -
- - - -
- - - )} -
- ); -} +'use client'; + +import React, { useState, useCallback } from 'react'; +import { useDropzone } from 'react-dropzone'; +import Papa from 'papaparse'; +import ExcelJS from 'exceljs'; +import { Card, CardHeader, CardTitle, CardContent } from '@/components/ui/Card'; +import { Button } from '@/components/ui/Button'; +import { Badge } from '@/components/ui/Badge'; +import { Select } from '@/components/ui/Select'; +import { QRCodeSVG } from 'qrcode.react'; +import { showToast } from '@/components/ui/Toast'; +import { useTranslation } from '@/hooks/useTranslation'; +import { useCsrf } from '@/hooks/useCsrf'; +import JSZip from 'jszip'; +import { saveAs } from 'file-saver'; + +interface BulkQRData { + title: string; + content: string; +} + +interface GeneratedQR { + title: string; + content: string; // Original URL + svg: string; // SVG markup +} + +export default function BulkCreationPage() { + const { t } = useTranslation(); + const { fetchWithCsrf } = useCsrf(); + const [step, setStep] = useState<'upload' | 'preview' | 'complete'>('upload'); + const [data, setData] = useState([]); + const [mapping, setMapping] = useState>({}); + const [loading, setLoading] = useState(false); + const [generatedQRs, setGeneratedQRs] = useState([]); + const [userPlan, setUserPlan] = useState('FREE'); + + // Check user plan on mount + React.useEffect(() => { + const checkPlan = async () => { + try { + const response = await fetch('/api/user/plan'); + if (response.ok) { + const data = await response.json(); + setUserPlan(data.plan || 'FREE'); + } + } catch (error) { + console.error('Error checking plan:', error); + } + }; + checkPlan(); + }, []); + + const onDrop = useCallback((acceptedFiles: File[]) => { + const file = acceptedFiles[0]; + if (!file) return; + + const reader = new FileReader(); + + if (file.name.endsWith('.csv')) { + reader.onload = (e) => { + const text = e.target?.result as string; + const result = Papa.parse(text, { header: true }); + processData(result.data); + }; + reader.readAsText(file); + } else if (file.name.endsWith('.xlsx') || file.name.endsWith('.xls')) { + reader.onload = async (e) => { + const buffer = e.target?.result as ArrayBuffer; + const workbook = new ExcelJS.Workbook(); + await workbook.xlsx.load(buffer); + const worksheet = workbook.worksheets[0]; + const jsonData: any[] = []; + + // Get headers from first row + const headers: string[] = []; + const firstRow = worksheet.getRow(1); + firstRow.eachCell((cell, colNumber) => { + headers[colNumber - 1] = cell.value?.toString() || ''; + }); + + // Convert rows to objects + worksheet.eachRow((row, rowNumber) => { + if (rowNumber === 1) return; // Skip header row + const rowData: any = {}; + row.eachCell((cell, colNumber) => { + const header = headers[colNumber - 1]; + if (header) { + rowData[header] = cell.value; + } + }); + jsonData.push(rowData); + }); + + processData(jsonData); + }; + reader.readAsArrayBuffer(file); + } + }, []); + + const { getRootProps, getInputProps, isDragActive } = useDropzone({ + onDrop, + accept: { + 'text/csv': ['.csv'], + 'application/vnd.ms-excel': ['.xls'], + 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': ['.xlsx'], + }, + maxFiles: 1, + }); + + const processData = (rawData: any[]) => { + // Limit to 1000 rows + const limitedData = rawData.slice(0, 1000); + + // Auto-detect columns + if (limitedData.length > 0) { + const columns = Object.keys(limitedData[0]); + const autoMapping: Record = {}; + + columns.forEach((col) => { + const lowerCol = col.toLowerCase(); + if (lowerCol.includes('title') || lowerCol.includes('name') || lowerCol === 'test') { + autoMapping.title = col; + } else if (lowerCol.includes('content') || lowerCol.includes('url') || lowerCol.includes('data') || lowerCol.includes('link')) { + autoMapping.content = col; + } + }); + + // If no title column found, use first column + if (!autoMapping.title && columns.length > 0) { + autoMapping.title = columns[0]; + } + // If no content column found, use second column + if (!autoMapping.content && columns.length > 1) { + autoMapping.content = columns[1]; + } + + setMapping(autoMapping); + } + + setData(limitedData); + setStep('preview'); + }; + + const generateStaticQRCodes = async () => { + setLoading(true); + + try { + const qrCodes: GeneratedQR[] = []; + + // Generate all QR codes client-side (Static QR Codes) + for (const row of data) { + const title = row[mapping.title as keyof typeof row] || 'Untitled'; + const content = row[mapping.content as keyof typeof row] || 'https://example.com'; + + // Create a temporary div to render QR code + const tempDiv = document.createElement('div'); + tempDiv.style.display = 'none'; + document.body.appendChild(tempDiv); + + const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg'); + svg.setAttribute('width', '300'); + svg.setAttribute('height', '300'); + tempDiv.appendChild(svg); + + // Use qrcode library to generate SVG + const QRCode = require('qrcode'); + const qrSvg = await QRCode.toString(content, { + type: 'svg', + width: 300, + margin: 2, + color: { + dark: '#000000', + light: '#FFFFFF', + }, + }); + + qrCodes.push({ + title: String(title), + content: String(content), // Store the original URL + svg: qrSvg, + }); + + document.body.removeChild(tempDiv); + } + + setGeneratedQRs(qrCodes); + setStep('complete'); + showToast(`Successfully generated ${qrCodes.length} static QR codes!`, 'success'); + } catch (error) { + console.error('QR generation error:', error); + showToast('Failed to generate QR codes', 'error'); + } finally { + setLoading(false); + } + }; + + const downloadAllQRCodes = async () => { + const zip = new JSZip(); + + generatedQRs.forEach((qr, index) => { + const fileName = `${qr.title.replace(/[^a-z0-9]/gi, '_').toLowerCase()}_${index + 1}.svg`; + zip.file(fileName, qr.svg); + }); + + const blob = await zip.generateAsync({ type: 'blob' }); + saveAs(blob, 'qr-codes-bulk.zip'); + showToast('Download started!', 'success'); + }; + + const saveQRCodesToDatabase = async () => { + setLoading(true); + + try { + const qrCodesToSave = generatedQRs.map((qr) => ({ + title: qr.title, + isStatic: true, // This tells the API it's a static QR code + contentType: 'URL', + content: { url: qr.content }, // Content needs to be an object with url property + status: 'ACTIVE', + })); + + // Save each QR code to the database + const savePromises = qrCodesToSave.map((qr) => + fetchWithCsrf('/api/qrs', { + method: 'POST', + body: JSON.stringify(qr), + }) + ); + + const results = await Promise.all(savePromises); + const failedCount = results.filter((r) => !r.ok).length; + + if (failedCount === 0) { + showToast(`Successfully saved ${qrCodesToSave.length} QR codes!`, 'success'); + // Redirect to dashboard after 1 second + setTimeout(() => { + window.location.href = '/dashboard'; + }, 1000); + } else { + showToast(`Saved ${qrCodesToSave.length - failedCount} QR codes, ${failedCount} failed`, 'warning'); + } + } catch (error) { + console.error('Error saving QR codes:', error); + showToast('Failed to save QR codes', 'error'); + } finally { + setLoading(false); + } + }; + + const downloadTemplate = () => { + const template = [ + { title: 'Product Page', content: 'https://example.com/product' }, + { title: 'Landing Page', content: 'https://example.com/landing' }, + { title: 'Contact Form', content: 'https://example.com/contact' }, + { title: 'About Us', content: 'https://example.com/about' }, + { title: 'Pricing Page', content: 'https://example.com/pricing' }, + { title: 'FAQ Page', content: 'https://example.com/faq' }, + { title: 'Blog Article', content: 'https://example.com/blog/article-1' }, + { title: 'Support Portal', content: 'https://example.com/support' }, + { title: 'Download Page', content: 'https://example.com/download' }, + { title: 'Social Media', content: 'https://instagram.com/yourcompany' }, + { title: 'YouTube Video', content: 'https://youtube.com/watch?v=example' }, + ]; + + const csv = Papa.unparse(template); + const blob = new Blob([csv], { type: 'text/csv' }); + const url = URL.createObjectURL(blob); + const a = document.createElement('a'); + a.href = url; + a.download = 'bulk-qr-template.csv'; + a.click(); + URL.revokeObjectURL(url); + }; + + // Show upgrade prompt if not Business plan + if (userPlan !== 'BUSINESS') { + return ( +
+ + +
+ + + +
+

Business Plan Required

+

+ Bulk QR code creation is exclusively available for Business plan subscribers. + Upgrade now to generate up to 1,000 static QR codes at once. +

+
+ + +
+ + +
+ ); + } + + return ( +
+
+

{t('bulk.title')}

+

{t('bulk.subtitle')}

+
+ + {/* Template Warning Banner */} + + +
+ + + +
+

Please Follow the Template Format

+

+ Download the template below and follow the format exactly. Your CSV must include columns for title and content (URL). +

+
+
+ + + + {/* Info Banner */} + + +
+ + + +
+

Static QR Codes Only

+

+ Bulk creation generates static QR codes that cannot be edited after creation. + These QR codes do not include tracking or analytics. Perfect for print materials and offline use. +

+
+
+ + + + {/* Progress Steps */} +
+
+
+
+ 1 +
+ Upload File +
+ +
+
+
+ +
+
+ 2 +
+ Preview & Map +
+ +
+
+
+ +
+
+ 3 +
+ Download +
+
+
+ + {/* Upload Step */} + {step === 'upload' && ( + + +
+ +
+ +
+ + + + +

+ {isDragActive ? 'Drop the file here' : 'Drag & drop your file here'} +

+

or click to browse

+

Supports CSV, XLS, XLSX (max 1,000 rows)

+
+ +
+ + +
+
+ + + +
+
+

Simple Format

+

Just title & URL

+
+
+ + + + + +
+
+ + + +
+
+

Static QR Codes

+

No tracking included

+
+
+ + + + + +
+
+ + + +
+
+

Instant Download

+

Get ZIP with all SVGs

+
+
+ + +
+ + {/* Supported QR Code Types Section */} +
+ + + 📋 Supported QR Code Types + + +
+

+ This bulk generator creates static QR codes for multiple content types. Choose the format that matches your needs: +

+ +
+
+

🌐 URL - Website Links

+

Format: https://example.com

+

Example: Product Page,https://example.com/product

+
+ +
+

👤 VCARD - Contact Cards

+

Format: FirstName,LastName,Email,Phone,Organization,Title

+

Example: John Doe,"John,Doe,john@example.com,+1234567890,Company,CEO"

+
+ +
+

📍 GEO - Locations

+

Format: latitude,longitude,label

+

Example: Office Location,"37.7749,-122.4194,Main Office"

+
+ +
+

📞 PHONE - Phone Numbers

+

Format: +1234567890

+

Example: Support Hotline,+1234567890

+
+ +
+

📝 TEXT - Plain Text

+

Format: Any text content

+

Example: Serial Number,SN-12345-ABCDE

+
+
+ +
+

📥 CSV File Format:

+

+ Your file needs two columns: title and content +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
titlecontent
Product Pagehttps://example.com/product
John DoeJohn,Doe,john@example.com,+1234567890,Company,CEO
Office Location37.7749,-122.4194,Main Office
Support Hotline+1234567890
Serial NumberSN-12345-ABCDE
+
+
+ +
+

ℹ️ Important Notes

+
    +
  • • Static QR codes - Cannot be edited after creation
    • +
  • • No tracking or analytics - Scans are not tracked
    • +
  • • Maximum 1,000 QR codes per upload
    • +
  • • Download as ZIP or save to your dashboard
    • +
  • • All QR types supported - URLs, vCards, locations, phone numbers, and text
    • +
+
+ +
+

+ 💡 Tip: Download the template above to see examples of all 5 QR code types with 11 ready-to-use examples! +

+
+
+ + +
+ + + )} + + {/* Preview Step */} + {step === 'preview' && ( + + +
+ Preview & Map Columns + {data.length} rows detected +
+ + +
+
+ + setMapping({ ...mapping, content: e.target.value })} + options={Object.keys(data[0] || {}).map((col) => ({ value: col, label: col }))} + /> +
+
+ +
+ + + + + + + + + + {data.slice(0, 5).map((row: any, index) => ( + + + + + + ))} + +
PreviewTitleContent
+ + + {row[mapping.title] || 'Untitled'} + + {(row[mapping.content] || '').substring(0, 50)}... +
+
+ + {data.length > 5 && ( +

+ Showing 5 of {data.length} rows +

+ )} + +
+ + +
+ + + )} + + {/* Complete Step */} + {step === 'complete' && ( + + +
+ + + +
+

Generation Complete!

+

+ Successfully generated {generatedQRs.length} static QR codes +

+ +
+
+ {generatedQRs.slice(0, 8).map((qr, index) => ( +
+
+
+
+

{qr.title}

+
+ ))} +
+
+ + + +
+ + + +
+ + + )} +
+ ); +} diff --git a/src/app/(main)/(app)/dashboard/page.tsx b/src/app/(main)/(app)/dashboard/page.tsx index 214daef..d99c6a2 100644 --- a/src/app/(main)/(app)/dashboard/page.tsx +++ b/src/app/(main)/(app)/dashboard/page.tsx @@ -1,570 +1,570 @@ -'use client'; - -import React, { useState, useEffect } from 'react'; -import Link from 'next/link'; -import { useRouter, useSearchParams } from 'next/navigation'; -import { StatsGrid } from '@/components/dashboard/StatsGrid'; -import { QRCodeCard } from '@/components/dashboard/QRCodeCard'; -import { Card, CardHeader, CardTitle, CardContent } from '@/components/ui/Card'; -import { Button } from '@/components/ui/Button'; -import { Badge } from '@/components/ui/Badge'; -import { useTranslation } from '@/hooks/useTranslation'; -import { useCsrf } from '@/hooks/useCsrf'; -import { showToast } from '@/components/ui/Toast'; -import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter } from '@/components/ui/Dialog'; - -interface QRCodeData { - id: string; - title: string; - type: 'STATIC' | 'DYNAMIC'; - contentType: string; - content?: any; - slug: string; - createdAt: string; - scans: number; - style?: any; - status?: 'ACTIVE' | 'INACTIVE'; -} - -export default function DashboardPage() { - const { t } = useTranslation(); - const router = useRouter(); - const searchParams = useSearchParams(); - const { fetchWithCsrf } = useCsrf(); - const [qrCodes, setQrCodes] = useState([]); - const [loading, setLoading] = useState(true); - const [userPlan, setUserPlan] = useState('FREE'); - const [showUpgradeDialog, setShowUpgradeDialog] = useState(false); - const [upgradedPlan, setUpgradedPlan] = useState(''); - const [deletingAll, setDeletingAll] = useState(false); - const [stats, setStats] = useState({ - totalScans: 0, - activeQRCodes: 0, - conversionRate: 0, - uniqueScans: 0, - }); - const [analyticsData, setAnalyticsData] = useState(null); - - const mockQRCodes = [ - { - id: '1', - title: 'Support Phone', - type: 'DYNAMIC' as const, - contentType: 'PHONE', - slug: 'support-phone-demo', - status: 'ACTIVE' as const, - createdAt: '2025-08-07T10:00:00Z', - scans: 0, - }, - { - id: '2', - title: 'Event Details', - type: 'DYNAMIC' as const, - contentType: 'URL', - slug: 'event-details-demo', - status: 'ACTIVE' as const, - createdAt: '2025-08-07T10:01:00Z', - scans: 0, - }, - { - id: '3', - title: 'Product Demo', - type: 'DYNAMIC' as const, - contentType: 'URL', - slug: 'product-demo-qr', - status: 'ACTIVE' as const, - createdAt: '2025-08-07T10:02:00Z', - scans: 0, - }, - { - id: '4', - title: 'Company Website', - type: 'DYNAMIC' as const, - contentType: 'URL', - slug: 'company-website-qr', - status: 'ACTIVE' as const, - createdAt: '2025-08-07T10:03:00Z', - scans: 0, - }, - { - id: '5', - title: 'Contact Card', - type: 'DYNAMIC' as const, - contentType: 'VCARD', - slug: 'contact-card-qr', - status: 'ACTIVE' as const, - createdAt: '2025-08-07T10:04:00Z', - scans: 0, - }, - { - id: '6', - title: 'Event Details', - type: 'DYNAMIC' as const, - contentType: 'URL', - slug: 'event-details-dup', - status: 'ACTIVE' as const, - createdAt: '2025-08-07T10:05:00Z', - scans: 0, - }, - ]; - - const blogPosts = [ - // NEW POSTS - { - title: 'How to Create a QR Code for Restaurant Menu', - excerpt: 'Step-by-step guide to creating digital menu QR codes for your restaurant. Best practices for touchless menus.', - readTime: '12 Min', - slug: 'qr-code-restaurant-menu', - }, - { - title: 'Free vCard QR Code Generator: Digital Business Cards', - excerpt: 'Create professional vCard QR codes for digital business cards. Share contact info instantly.', - readTime: '10 Min', - slug: 'vcard-qr-code-generator', - }, - { - title: 'Best QR Code Generator for Small Business', - excerpt: 'Find the best QR code solution for your small business. Compare features, pricing, and use cases.', - readTime: '14 Min', - slug: 'qr-code-small-business', - }, - { - title: 'QR Code Print Size Guide', - excerpt: 'Complete guide to QR code print sizes. Minimum dimensions for business cards, posters, and more.', - readTime: '8 Min', - slug: 'qr-code-print-size-guide', - }, - // EXISTING POSTS - { - title: 'QR Code Tracking: Complete Guide 2025', - excerpt: 'Learn how to track QR code scans with real-time analytics. Compare free vs paid tracking tools.', - readTime: '12 Min', - slug: 'qr-code-tracking-guide-2025', - }, - { - title: 'Dynamic vs Static QR Codes: Which Should You Use?', - excerpt: 'Understand the difference between static and dynamic QR codes. Pros, cons, and when to use each.', - readTime: '10 Min', - slug: 'dynamic-vs-static-qr-codes', - }, - { - title: 'How to Generate Bulk QR Codes from Excel', - excerpt: 'Generate hundreds of QR codes from Excel or CSV files in minutes. Step-by-step guide.', - readTime: '13 Min', - slug: 'bulk-qr-code-generator-excel', - }, - { - title: 'QR Code Analytics: Track, Measure & Optimize', - excerpt: 'Learn how to leverage scan analytics and dashboard insights to maximize QR code ROI.', - readTime: '15 Min', - slug: 'qr-code-analytics', - }, - ]; - - // Track Google OAuth login/signup - useEffect(() => { - const authMethod = searchParams.get('authMethod'); - const isNewUser = searchParams.get('isNewUser') === 'true'; - - if (authMethod === 'google') { - const trackGoogleAuth = async () => { - try { - // Fetch user data from API (cookie-based auth) - const response = await fetch('/api/user'); - if (!response.ok) return; - - const user = await response.json(); - - // Store in localStorage for consistency - localStorage.setItem('user', JSON.stringify(user)); - - const { identifyUser, trackEvent } = await import('@/components/PostHogProvider'); - identifyUser(user.id, { - email: user.email, - name: user.name, - plan: user.plan || 'FREE', - provider: 'google', - }); - - trackEvent(isNewUser ? 'user_signup' : 'user_login', { - method: 'google', - email: user.email, - isNewUser, - }); - - // Clean up URL params - router.replace('/dashboard'); - } catch (error) { - console.error('PostHog tracking error:', error); - } - }; - - trackGoogleAuth(); - } - }, [searchParams, router]); - - // Check for successful payment and verify session - useEffect(() => { - const success = searchParams.get('success'); - if (success === 'true') { - const verifySession = async () => { - try { - const response = await fetch('/api/stripe/verify-session', { - method: 'POST', - }); - - if (response.ok) { - const data = await response.json(); - setUserPlan(data.plan); - setUpgradedPlan(data.plan); - setShowUpgradeDialog(true); - // Remove success parameter from URL - router.replace('/dashboard'); - } else { - console.error('Failed to verify session:', await response.text()); - } - } catch (error) { - console.error('Error verifying session:', error); - } - }; - - verifySession(); - } - }, [searchParams, router]); - - useEffect(() => { - // Load real QR codes and user plan from API - const fetchData = async () => { - try { - // Fetch QR codes - const qrResponse = await fetch('/api/qrs'); - if (qrResponse.ok) { - const data = await qrResponse.json(); - setQrCodes(data); - - // Calculate real stats - const totalScans = data.reduce((sum: number, qr: QRCodeData) => sum + (qr.scans || 0), 0); - const activeQRCodes = data.filter((qr: QRCodeData) => qr.status === 'ACTIVE').length; - // Calculate unique scans (absolute count) - const uniqueScans = data.reduce((acc: number, qr: any) => acc + (qr.uniqueScans || 0), 0); - const conversionRate = totalScans > 0 ? Math.round((uniqueScans / totalScans) * 100) : 0; - - setStats({ - totalScans, - activeQRCodes, - conversionRate, - uniqueScans, - }); - } else { - // If not logged in, show zeros - setQrCodes([]); - setStats({ - totalScans: 0, - activeQRCodes: 0, - conversionRate: 0, - uniqueScans: 0, - }); - } - - // Fetch user plan (using cookie-based auth, no session needed) - const userResponse = await fetch('/api/user/plan'); - if (userResponse.ok) { - const userData = await userResponse.json(); - setUserPlan(userData.plan || 'FREE'); - } - - // Fetch analytics data for trends (last 30 days = month comparison) - const analyticsResponse = await fetch('/api/analytics/summary?range=30'); - if (analyticsResponse.ok) { - const analytics = await analyticsResponse.json(); - setAnalyticsData(analytics); - } - } catch (error) { - console.error('Error fetching data:', error); - setQrCodes([]); - setStats({ - totalScans: 0, - activeQRCodes: 0, - conversionRate: 0, - uniqueScans: 0, - }); - } finally { - setLoading(false); - } - }; - - fetchData(); - }, []); - - const handleEdit = (id: string) => { - // Redirect to edit page - router.push(`/qr/${id}/edit`); - }; - - const handleDelete = async (id: string) => { - if (!confirm('Are you sure you want to delete this QR code? This action cannot be undone.')) { - return; - } - - try { - const response = await fetchWithCsrf(`/api/qrs/${id}`, { - method: 'DELETE', - }); - - if (response.ok) { - // Remove from local state - setQrCodes(qrCodes.filter(q => q.id !== id)); - showToast('QR code deleted successfully!', 'success'); - } else { - throw new Error('Failed to delete'); - } - } catch (error) { - console.error('Error deleting QR:', error); - showToast('Failed to delete QR code', 'error'); - } - }; - - const handleDeleteAll = async () => { - if (!confirm('Are you sure you want to delete ALL QR codes? This action cannot be undone.')) { - return; - } - - // Double confirmation - if (!confirm('This will permanently delete ALL your QR codes. Are you absolutely sure?')) { - return; - } - - setDeletingAll(true); - - try { - const response = await fetchWithCsrf('/api/qrs/delete-all', { - method: 'DELETE', - }); - - if (response.ok) { - const data = await response.json(); - setQrCodes([]); - setStats({ - totalScans: 0, - activeQRCodes: 0, - conversionRate: 0, - uniqueScans: 0, - }); - showToast(`Successfully deleted ${data.deletedCount} QR code${data.deletedCount !== 1 ? 's' : ''}`, 'success'); - } else { - throw new Error('Failed to delete all QR codes'); - } - } catch (error) { - console.error('Error deleting all QR codes:', error); - showToast('Failed to delete QR codes', 'error'); - } finally { - setDeletingAll(false); - } - }; - - const getPlanBadgeColor = (plan: string) => { - switch (plan) { - case 'PRO': - return 'info'; - case 'BUSINESS': - return 'warning'; - default: - return 'default'; - } - }; - - const getPlanEmoji = (plan: string) => { - // No emojis anymore - return ''; - }; - - return ( -
- {/* Header with Plan Badge */} -
-
-

{t('dashboard.title')}

-

{t('dashboard.subtitle')}

-
-
- - {userPlan} Plan - - {userPlan === 'FREE' && ( - - - - )} -
-
- - {/* Stats Grid */} - - - {/* Recent QR Codes */} -
-
-

{t('dashboard.recent_codes')}

-
- {qrCodes.length > 0 && ( - - )} - - - -
-
- - {loading ? ( -
- {[1, 2, 3, 4, 5, 6].map((i) => ( - - -
-
-
-
-
-
-
-
- - - ))} -
- ) : ( -
- {qrCodes.map((qr) => ( - - ))} -
- )} -
- - {/* Blog & Resources - Horizontal Scroll */} -
-

{t('dashboard.blog_resources')}

-
-
- {blogPosts.map((post) => ( - - -
- {post.readTime} -
- {post.title} - - -

{post.excerpt}

- - Read more → - - - - ))} -
-
-
- - {/* Upgrade Success Dialog */} - - - - - Upgrade Successful! - - - Welcome to the {upgradedPlan} Plan! Your account has been successfully upgraded. - - - -
-
-

Your New Features:

-
    - {upgradedPlan === 'PRO' && ( - <> -
  • - ✓ - 50 Dynamic QR Codes -
    • -
  • - ✓ - Custom Branding (Colors & Logo) -
    • -
  • - ✓ - Detailed Analytics (Devices, Locations, Time-Series) -
    • -
  • - ✓ - CSV Export -
    • -
  • - ✓ - SVG/PNG Download -
    • - - )} - {upgradedPlan === 'BUSINESS' && ( - <> -
  • - ✓ - 500 Dynamic QR Codes -
    • -
  • - ✓ - Everything from Pro -
    • -
  • - ✓ - Bulk QR Generation (up to 1,000) -
    • -
  • - ✓ - Priority Support -
    • - - )} -
-
-
- - - - - - -
- ); +'use client'; + +import React, { useState, useEffect } from 'react'; +import Link from 'next/link'; +import { useRouter, useSearchParams } from 'next/navigation'; +import { StatsGrid } from '@/components/dashboard/StatsGrid'; +import { QRCodeCard } from '@/components/dashboard/QRCodeCard'; +import { Card, CardHeader, CardTitle, CardContent } from '@/components/ui/Card'; +import { Button } from '@/components/ui/Button'; +import { Badge } from '@/components/ui/Badge'; +import { useTranslation } from '@/hooks/useTranslation'; +import { useCsrf } from '@/hooks/useCsrf'; +import { showToast } from '@/components/ui/Toast'; +import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter } from '@/components/ui/Dialog'; + +interface QRCodeData { + id: string; + title: string; + type: 'STATIC' | 'DYNAMIC'; + contentType: string; + content?: any; + slug: string; + createdAt: string; + scans: number; + style?: any; + status?: 'ACTIVE' | 'INACTIVE'; +} + +export default function DashboardPage() { + const { t } = useTranslation(); + const router = useRouter(); + const searchParams = useSearchParams(); + const { fetchWithCsrf } = useCsrf(); + const [qrCodes, setQrCodes] = useState([]); + const [loading, setLoading] = useState(true); + const [userPlan, setUserPlan] = useState('FREE'); + const [showUpgradeDialog, setShowUpgradeDialog] = useState(false); + const [upgradedPlan, setUpgradedPlan] = useState(''); + const [deletingAll, setDeletingAll] = useState(false); + const [stats, setStats] = useState({ + totalScans: 0, + activeQRCodes: 0, + conversionRate: 0, + uniqueScans: 0, + }); + const [analyticsData, setAnalyticsData] = useState(null); + + const mockQRCodes = [ + { + id: '1', + title: 'Support Phone', + type: 'DYNAMIC' as const, + contentType: 'PHONE', + slug: 'support-phone-demo', + status: 'ACTIVE' as const, + createdAt: '2025-08-07T10:00:00Z', + scans: 0, + }, + { + id: '2', + title: 'Event Details', + type: 'DYNAMIC' as const, + contentType: 'URL', + slug: 'event-details-demo', + status: 'ACTIVE' as const, + createdAt: '2025-08-07T10:01:00Z', + scans: 0, + }, + { + id: '3', + title: 'Product Demo', + type: 'DYNAMIC' as const, + contentType: 'URL', + slug: 'product-demo-qr', + status: 'ACTIVE' as const, + createdAt: '2025-08-07T10:02:00Z', + scans: 0, + }, + { + id: '4', + title: 'Company Website', + type: 'DYNAMIC' as const, + contentType: 'URL', + slug: 'company-website-qr', + status: 'ACTIVE' as const, + createdAt: '2025-08-07T10:03:00Z', + scans: 0, + }, + { + id: '5', + title: 'Contact Card', + type: 'DYNAMIC' as const, + contentType: 'VCARD', + slug: 'contact-card-qr', + status: 'ACTIVE' as const, + createdAt: '2025-08-07T10:04:00Z', + scans: 0, + }, + { + id: '6', + title: 'Event Details', + type: 'DYNAMIC' as const, + contentType: 'URL', + slug: 'event-details-dup', + status: 'ACTIVE' as const, + createdAt: '2025-08-07T10:05:00Z', + scans: 0, + }, + ]; + + const blogPosts = [ + // NEW POSTS + { + title: 'How to Create a QR Code for Restaurant Menu', + excerpt: 'Step-by-step guide to creating digital menu QR codes for your restaurant. Best practices for touchless menus.', + readTime: '12 Min', + slug: 'qr-code-restaurant-menu', + }, + { + title: 'Free vCard QR Code Generator: Digital Business Cards', + excerpt: 'Create professional vCard QR codes for digital business cards. Share contact info instantly.', + readTime: '10 Min', + slug: 'vcard-qr-code-generator', + }, + { + title: 'Best QR Code Generator for Small Business', + excerpt: 'Find the best QR code solution for your small business. Compare features, pricing, and use cases.', + readTime: '14 Min', + slug: 'qr-code-small-business', + }, + { + title: 'QR Code Print Size Guide', + excerpt: 'Complete guide to QR code print sizes. Minimum dimensions for business cards, posters, and more.', + readTime: '8 Min', + slug: 'qr-code-print-size-guide', + }, + // EXISTING POSTS + { + title: 'QR Code Tracking: Complete Guide 2025', + excerpt: 'Learn how to track QR code scans with real-time analytics. Compare free vs paid tracking tools.', + readTime: '12 Min', + slug: 'qr-code-tracking-guide-2025', + }, + { + title: 'Dynamic vs Static QR Codes: Which Should You Use?', + excerpt: 'Understand the difference between static and dynamic QR codes. Pros, cons, and when to use each.', + readTime: '10 Min', + slug: 'dynamic-vs-static-qr-codes', + }, + { + title: 'How to Generate Bulk QR Codes from Excel', + excerpt: 'Generate hundreds of QR codes from Excel or CSV files in minutes. Step-by-step guide.', + readTime: '13 Min', + slug: 'bulk-qr-code-generator-excel', + }, + { + title: 'QR Code Analytics: Track, Measure & Optimize', + excerpt: 'Learn how to leverage scan analytics and dashboard insights to maximize QR code ROI.', + readTime: '15 Min', + slug: 'qr-code-analytics', + }, + ]; + + // Track Google OAuth login/signup + useEffect(() => { + const authMethod = searchParams.get('authMethod'); + const isNewUser = searchParams.get('isNewUser') === 'true'; + + if (authMethod === 'google') { + const trackGoogleAuth = async () => { + try { + // Fetch user data from API (cookie-based auth) + const response = await fetch('/api/user'); + if (!response.ok) return; + + const user = await response.json(); + + // Store in localStorage for consistency + localStorage.setItem('user', JSON.stringify(user)); + + const { identifyUser, trackEvent } = await import('@/components/PostHogProvider'); + identifyUser(user.id, { + email: user.email, + name: user.name, + plan: user.plan || 'FREE', + provider: 'google', + }); + + trackEvent(isNewUser ? 'user_signup' : 'user_login', { + method: 'google', + email: user.email, + isNewUser, + }); + + // Clean up URL params + router.replace('/dashboard'); + } catch (error) { + console.error('PostHog tracking error:', error); + } + }; + + trackGoogleAuth(); + } + }, [searchParams, router]); + + // Check for successful payment and verify session + useEffect(() => { + const success = searchParams.get('success'); + if (success === 'true') { + const verifySession = async () => { + try { + const response = await fetch('/api/stripe/verify-session', { + method: 'POST', + }); + + if (response.ok) { + const data = await response.json(); + setUserPlan(data.plan); + setUpgradedPlan(data.plan); + setShowUpgradeDialog(true); + // Remove success parameter from URL + router.replace('/dashboard'); + } else { + console.error('Failed to verify session:', await response.text()); + } + } catch (error) { + console.error('Error verifying session:', error); + } + }; + + verifySession(); + } + }, [searchParams, router]); + + useEffect(() => { + // Load real QR codes and user plan from API + const fetchData = async () => { + try { + // Fetch QR codes + const qrResponse = await fetch('/api/qrs'); + if (qrResponse.ok) { + const data = await qrResponse.json(); + setQrCodes(data); + + // Calculate real stats + const totalScans = data.reduce((sum: number, qr: QRCodeData) => sum + (qr.scans || 0), 0); + const activeQRCodes = data.filter((qr: QRCodeData) => qr.status === 'ACTIVE').length; + // Calculate unique scans (absolute count) + const uniqueScans = data.reduce((acc: number, qr: any) => acc + (qr.uniqueScans || 0), 0); + const conversionRate = totalScans > 0 ? Math.round((uniqueScans / totalScans) * 100) : 0; + + setStats({ + totalScans, + activeQRCodes, + conversionRate, + uniqueScans, + }); + } else { + // If not logged in, show zeros + setQrCodes([]); + setStats({ + totalScans: 0, + activeQRCodes: 0, + conversionRate: 0, + uniqueScans: 0, + }); + } + + // Fetch user plan (using cookie-based auth, no session needed) + const userResponse = await fetch('/api/user/plan'); + if (userResponse.ok) { + const userData = await userResponse.json(); + setUserPlan(userData.plan || 'FREE'); + } + + // Fetch analytics data for trends (last 30 days = month comparison) + const analyticsResponse = await fetch('/api/analytics/summary?range=30'); + if (analyticsResponse.ok) { + const analytics = await analyticsResponse.json(); + setAnalyticsData(analytics); + } + } catch (error) { + console.error('Error fetching data:', error); + setQrCodes([]); + setStats({ + totalScans: 0, + activeQRCodes: 0, + conversionRate: 0, + uniqueScans: 0, + }); + } finally { + setLoading(false); + } + }; + + fetchData(); + }, []); + + const handleEdit = (id: string) => { + // Redirect to edit page + router.push(`/qr/${id}/edit`); + }; + + const handleDelete = async (id: string) => { + if (!confirm('Are you sure you want to delete this QR code? This action cannot be undone.')) { + return; + } + + try { + const response = await fetchWithCsrf(`/api/qrs/${id}`, { + method: 'DELETE', + }); + + if (response.ok) { + // Remove from local state + setQrCodes(qrCodes.filter(q => q.id !== id)); + showToast('QR code deleted successfully!', 'success'); + } else { + throw new Error('Failed to delete'); + } + } catch (error) { + console.error('Error deleting QR:', error); + showToast('Failed to delete QR code', 'error'); + } + }; + + const handleDeleteAll = async () => { + if (!confirm('Are you sure you want to delete ALL QR codes? This action cannot be undone.')) { + return; + } + + // Double confirmation + if (!confirm('This will permanently delete ALL your QR codes. Are you absolutely sure?')) { + return; + } + + setDeletingAll(true); + + try { + const response = await fetchWithCsrf('/api/qrs/delete-all', { + method: 'DELETE', + }); + + if (response.ok) { + const data = await response.json(); + setQrCodes([]); + setStats({ + totalScans: 0, + activeQRCodes: 0, + conversionRate: 0, + uniqueScans: 0, + }); + showToast(`Successfully deleted ${data.deletedCount} QR code${data.deletedCount !== 1 ? 's' : ''}`, 'success'); + } else { + throw new Error('Failed to delete all QR codes'); + } + } catch (error) { + console.error('Error deleting all QR codes:', error); + showToast('Failed to delete QR codes', 'error'); + } finally { + setDeletingAll(false); + } + }; + + const getPlanBadgeColor = (plan: string) => { + switch (plan) { + case 'PRO': + return 'info'; + case 'BUSINESS': + return 'warning'; + default: + return 'default'; + } + }; + + const getPlanEmoji = (plan: string) => { + // No emojis anymore + return ''; + }; + + return ( +
+ {/* Header with Plan Badge */} +
+
+

{t('dashboard.title')}

+

{t('dashboard.subtitle')}

+
+
+ + {userPlan} Plan + + {userPlan === 'FREE' && ( + + + + )} +
+
+ + {/* Stats Grid */} + + + {/* Recent QR Codes */} +
+
+

{t('dashboard.recent_codes')}

+
+ {qrCodes.length > 0 && ( + + )} + + + +
+
+ + {loading ? ( +
+ {[1, 2, 3, 4, 5, 6].map((i) => ( + + +
+
+
+
+
+
+
+
+ + + ))} +
+ ) : ( +
+ {qrCodes.map((qr) => ( + + ))} +
+ )} +
+ + {/* Blog & Resources - Horizontal Scroll */} +
+

{t('dashboard.blog_resources')}

+
+
+ {blogPosts.map((post) => ( + + +
+ {post.readTime} +
+ {post.title} + + +

{post.excerpt}

+ + Read more → + + + + ))} +
+
+
+ + {/* Upgrade Success Dialog */} + + + + + Upgrade Successful! + + + Welcome to the {upgradedPlan} Plan! Your account has been successfully upgraded. + + + +
+
+

Your New Features:

+
    + {upgradedPlan === 'PRO' && ( + <> +
  • + ✓ + 50 Dynamic QR Codes +
    • +
  • + ✓ + Custom Branding (Colors & Logo) +
    • +
  • + ✓ + Detailed Analytics (Devices, Locations, Time-Series) +
    • +
  • + ✓ + CSV Export +
    • +
  • + ✓ + SVG/PNG Download +
    • + + )} + {upgradedPlan === 'BUSINESS' && ( + <> +
  • + ✓ + 500 Dynamic QR Codes +
    • +
  • + ✓ + Everything from Pro +
    • +
  • + ✓ + Bulk QR Generation (up to 1,000) +
    • +
  • + ✓ + Priority Support +
    • + + )} +
+
+
+ + + + + + +
+ ); } \ No newline at end of file diff --git a/src/app/(main)/(app)/integrations/page.tsx b/src/app/(main)/(app)/integrations/page.tsx index 0ec5a65..4acc4e5 100644 --- a/src/app/(main)/(app)/integrations/page.tsx +++ b/src/app/(main)/(app)/integrations/page.tsx @@ -1,392 +1,392 @@ -'use client'; - -import React, { useState } from 'react'; -import { Card, CardHeader, CardTitle, CardContent } from '@/components/ui/Card'; -import { Button } from '@/components/ui/Button'; -import { Badge } from '@/components/ui/Badge'; -import { Input } from '@/components/ui/Input'; -import { Dialog } from '@/components/ui/Dialog'; -import { useTranslation } from '@/hooks/useTranslation'; - -interface Integration { - id: string; - name: string; - description: string; - icon: string; - status: 'active' | 'inactive' | 'coming_soon'; - category: string; - features: string[]; -} - -export default function IntegrationsPage() { - const { t } = useTranslation(); - const [selectedIntegration, setSelectedIntegration] = useState(null); - const [showSetupDialog, setShowSetupDialog] = useState(false); - const [apiKey, setApiKey] = useState(''); - const [webhookUrl, setWebhookUrl] = useState(''); - - const integrations: Integration[] = [ - { - id: 'zapier', - name: 'Zapier', - description: 'Connect QR Master with 5,000+ apps', - icon: '⚡', - status: 'active', - category: 'Automation', - features: [ - 'Trigger actions when QR codes are scanned', - 'Create QR codes from other apps', - 'Update QR destinations automatically', - 'Sync analytics to spreadsheets', - ], - }, - { - id: 'airtable', - name: 'Airtable', - description: 'Sync QR codes with your Airtable bases', - icon: '📊', - status: 'inactive', - category: 'Database', - features: [ - 'Two-way sync with Airtable', - 'Bulk import from bases', - 'Auto-update QR content', - 'Analytics dashboard integration', - ], - }, - { - id: 'google-sheets', - name: 'Google Sheets', - description: 'Manage QR codes from spreadsheets', - icon: '📈', - status: 'inactive', - category: 'Spreadsheet', - features: [ - 'Import QR codes from sheets', - 'Export analytics data', - 'Real-time sync', - 'Collaborative QR management', - ], - }, - { - id: 'slack', - name: 'Slack', - description: 'Get QR scan notifications in Slack', - icon: '💬', - status: 'coming_soon', - category: 'Communication', - features: [ - 'Real-time scan notifications', - 'Daily analytics summaries', - 'Team collaboration', - 'Custom alert rules', - ], - }, - { - id: 'webhook', - name: 'Webhooks', - description: 'Send data to any URL', - icon: '🔗', - status: 'active', - category: 'Developer', - features: [ - 'Custom webhook endpoints', - 'Real-time event streaming', - 'Retry logic', - 'Event filtering', - ], - }, - { - id: 'api', - name: 'REST API', - description: 'Full programmatic access', - icon: '🔧', - status: 'active', - category: 'Developer', - features: [ - 'Complete CRUD operations', - 'Bulk operations', - 'Analytics API', - 'Rate limiting: 1000 req/hour', - ], - }, - ]; - - const stats = { - totalQRCodes: 234, - activeIntegrations: 2, - syncStatus: 'Synced', - availableServices: 6, - }; - - const handleActivate = (integration: Integration) => { - setSelectedIntegration(integration); - setShowSetupDialog(true); - }; - - const handleTestConnection = async () => { - // Simulate API test - await new Promise(resolve => setTimeout(resolve, 1000)); - alert('Connection successful!'); - }; - - const handleSaveIntegration = () => { - setShowSetupDialog(false); - // Update integration status - }; - - return ( -
- {/* Header */} -
-

{t('integrations.title')}

-

{t('integrations.subtitle')}

-
- - {/* Stats */} -
- - -
-
-

QR Codes Total

-

{stats.totalQRCodes}

-
-
- - - -
-
- - - - - -
-
-

Active Integrations

-

{stats.activeIntegrations}

-
-
- - - -
-
- - - - - -
-
-

Sync Status

-

{stats.syncStatus}

-
-
- - - -
-
- - - - - -
-
-

Available Services

-

{stats.availableServices}

-
-
- - - -
-
- - -
- - {/* Integration Cards */} -
- {integrations.map((integration) => ( - - -
-
-
{integration.icon}
-
- {integration.name} - - {integration.status === 'active' ? 'Active' : - integration.status === 'coming_soon' ? 'Coming Soon' : - 'Inactive'} - -
-
-
- - -

{integration.description}

- -
- {integration.features.slice(0, 3).map((feature, index) => ( -
- - - - {feature} -
- ))} -
- - {integration.status === 'active' ? ( - - ) : integration.status === 'coming_soon' ? ( - - ) : ( - - )} - - - ))} -
- - {/* Setup Dialog */} - {showSetupDialog && selectedIntegration && ( - -
-

Setup {selectedIntegration.name}

-
- {selectedIntegration.id === 'zapier' && ( - <> -
- - -

- Copy this URL to your Zapier trigger -

-
- -
- -
- - - -
-
- -
-

Sample Payload

- 
-                      {`{
-  "event": "qr_scanned",
-  "qr_id": "abc123",
-  "title": "Product Page",
-  "timestamp": "2025-01-01T12:00:00Z",
-  "location": "United States",
-  "device": "mobile"
-}`}
-
-
- - )} - - {selectedIntegration.id === 'airtable' && ( - <> - setApiKey(e.target.value)} - placeholder="key..." - /> - - - - - )} - - {selectedIntegration.id === 'google-sheets' && ( - <> -
- -
- - - )} - -
- - -
-
-
- - )} -
- ); +'use client'; + +import React, { useState } from 'react'; +import { Card, CardHeader, CardTitle, CardContent } from '@/components/ui/Card'; +import { Button } from '@/components/ui/Button'; +import { Badge } from '@/components/ui/Badge'; +import { Input } from '@/components/ui/Input'; +import { Dialog } from '@/components/ui/Dialog'; +import { useTranslation } from '@/hooks/useTranslation'; + +interface Integration { + id: string; + name: string; + description: string; + icon: string; + status: 'active' | 'inactive' | 'coming_soon'; + category: string; + features: string[]; +} + +export default function IntegrationsPage() { + const { t } = useTranslation(); + const [selectedIntegration, setSelectedIntegration] = useState(null); + const [showSetupDialog, setShowSetupDialog] = useState(false); + const [apiKey, setApiKey] = useState(''); + const [webhookUrl, setWebhookUrl] = useState(''); + + const integrations: Integration[] = [ + { + id: 'zapier', + name: 'Zapier', + description: 'Connect QR Master with 5,000+ apps', + icon: '⚡', + status: 'active', + category: 'Automation', + features: [ + 'Trigger actions when QR codes are scanned', + 'Create QR codes from other apps', + 'Update QR destinations automatically', + 'Sync analytics to spreadsheets', + ], + }, + { + id: 'airtable', + name: 'Airtable', + description: 'Sync QR codes with your Airtable bases', + icon: '📊', + status: 'inactive', + category: 'Database', + features: [ + 'Two-way sync with Airtable', + 'Bulk import from bases', + 'Auto-update QR content', + 'Analytics dashboard integration', + ], + }, + { + id: 'google-sheets', + name: 'Google Sheets', + description: 'Manage QR codes from spreadsheets', + icon: '📈', + status: 'inactive', + category: 'Spreadsheet', + features: [ + 'Import QR codes from sheets', + 'Export analytics data', + 'Real-time sync', + 'Collaborative QR management', + ], + }, + { + id: 'slack', + name: 'Slack', + description: 'Get QR scan notifications in Slack', + icon: '💬', + status: 'coming_soon', + category: 'Communication', + features: [ + 'Real-time scan notifications', + 'Daily analytics summaries', + 'Team collaboration', + 'Custom alert rules', + ], + }, + { + id: 'webhook', + name: 'Webhooks', + description: 'Send data to any URL', + icon: '🔗', + status: 'active', + category: 'Developer', + features: [ + 'Custom webhook endpoints', + 'Real-time event streaming', + 'Retry logic', + 'Event filtering', + ], + }, + { + id: 'api', + name: 'REST API', + description: 'Full programmatic access', + icon: '🔧', + status: 'active', + category: 'Developer', + features: [ + 'Complete CRUD operations', + 'Bulk operations', + 'Analytics API', + 'Rate limiting: 1000 req/hour', + ], + }, + ]; + + const stats = { + totalQRCodes: 234, + activeIntegrations: 2, + syncStatus: 'Synced', + availableServices: 6, + }; + + const handleActivate = (integration: Integration) => { + setSelectedIntegration(integration); + setShowSetupDialog(true); + }; + + const handleTestConnection = async () => { + // Simulate API test + await new Promise(resolve => setTimeout(resolve, 1000)); + alert('Connection successful!'); + }; + + const handleSaveIntegration = () => { + setShowSetupDialog(false); + // Update integration status + }; + + return ( +
+ {/* Header */} +
+

{t('integrations.title')}

+

{t('integrations.subtitle')}

+
+ + {/* Stats */} +
+ + +
+
+

QR Codes Total

+

{stats.totalQRCodes}

+
+
+ + + +
+
+ + + + + +
+
+

Active Integrations

+

{stats.activeIntegrations}

+
+
+ + + +
+
+ + + + + +
+
+

Sync Status

+

{stats.syncStatus}

+
+
+ + + +
+
+ + + + + +
+
+

Available Services

+

{stats.availableServices}

+
+
+ + + +
+
+ + +
+ + {/* Integration Cards */} +
+ {integrations.map((integration) => ( + + +
+
+
{integration.icon}
+
+ {integration.name} + + {integration.status === 'active' ? 'Active' : + integration.status === 'coming_soon' ? 'Coming Soon' : + 'Inactive'} + +
+
+
+ + +

{integration.description}

+ +
+ {integration.features.slice(0, 3).map((feature, index) => ( +
+ + + + {feature} +
+ ))} +
+ + {integration.status === 'active' ? ( + + ) : integration.status === 'coming_soon' ? ( + + ) : ( + + )} + + + ))} +
+ + {/* Setup Dialog */} + {showSetupDialog && selectedIntegration && ( + +
+

Setup {selectedIntegration.name}

+
+ {selectedIntegration.id === 'zapier' && ( + <> +
+ + +

+ Copy this URL to your Zapier trigger +

+
+ +
+ +
+ + + +
+
+ +
+

Sample Payload

+ 
+                      {`{
+  "event": "qr_scanned",
+  "qr_id": "abc123",
+  "title": "Product Page",
+  "timestamp": "2025-01-01T12:00:00Z",
+  "location": "United States",
+  "device": "mobile"
+}`}
+
+
+ + )} + + {selectedIntegration.id === 'airtable' && ( + <> + setApiKey(e.target.value)} + placeholder="key..." + /> + + + + + )} + + {selectedIntegration.id === 'google-sheets' && ( + <> +
+ +
+ + + )} + +
+ + +
+
+
+ + )} +
+ ); } \ No newline at end of file diff --git a/src/app/(main)/(app)/settings/page.tsx b/src/app/(main)/(app)/settings/page.tsx index cf7e9b4..d224a3f 100644 --- a/src/app/(main)/(app)/settings/page.tsx +++ b/src/app/(main)/(app)/settings/page.tsx @@ -1,386 +1,386 @@ -'use client'; - -import React, { useState, useEffect } from 'react'; -import { Card, CardHeader, CardTitle, CardContent } from '@/components/ui/Card'; -import { Button } from '@/components/ui/Button'; -import { Badge } from '@/components/ui/Badge'; -import { useCsrf } from '@/hooks/useCsrf'; -import { showToast } from '@/components/ui/Toast'; -import ChangePasswordModal from '@/components/settings/ChangePasswordModal'; - -type TabType = 'profile' | 'subscription'; - -export default function SettingsPage() { - const { fetchWithCsrf } = useCsrf(); - const [activeTab, setActiveTab] = useState('profile'); - const [loading, setLoading] = useState(false); - const [showPasswordModal, setShowPasswordModal] = useState(false); - - // Profile states - const [name, setName] = useState(''); - const [email, setEmail] = useState(''); - - // Subscription states - const [plan, setPlan] = useState('FREE'); - const [usageStats, setUsageStats] = useState({ - dynamicUsed: 0, - dynamicLimit: 3, - staticUsed: 0, - }); - - // Load user data - useEffect(() => { - const fetchUserData = async () => { - try { - // Load from localStorage - const userStr = localStorage.getItem('user'); - if (userStr) { - const user = JSON.parse(userStr); - setName(user.name || ''); - setEmail(user.email || ''); - } - - // Fetch plan from API - const planResponse = await fetch('/api/user/plan'); - if (planResponse.ok) { - const data = await planResponse.json(); - setPlan(data.plan || 'FREE'); - } - - // Fetch usage stats from API - const statsResponse = await fetch('/api/user/stats'); - if (statsResponse.ok) { - const data = await statsResponse.json(); - setUsageStats(data); - } - } catch (e) { - console.error('Failed to load user data:', e); - } - }; - - fetchUserData(); - }, []); - - const handleSaveProfile = async () => { - setLoading(true); - - try { - // Save to backend API - const response = await fetchWithCsrf('/api/user/profile', { - method: 'PATCH', - body: JSON.stringify({ name }), - }); - - const data = await response.json(); - - if (!response.ok) { - throw new Error(data.error || 'Failed to update profile'); - } - - // Update user data in localStorage - const userStr = localStorage.getItem('user'); - if (userStr) { - const user = JSON.parse(userStr); - user.name = name; - localStorage.setItem('user', JSON.stringify(user)); - } - - showToast('Profile updated successfully!', 'success'); - } catch (error: any) { - console.error('Error saving profile:', error); - showToast(error.message || 'Failed to update profile', 'error'); - } finally { - setLoading(false); - } - }; - - const handleManageSubscription = async () => { - setLoading(true); - - try { - const response = await fetchWithCsrf('/api/stripe/portal', { - method: 'POST', - }); - - const data = await response.json(); - - if (!response.ok) { - throw new Error(data.error || 'Failed to open subscription management'); - } - - // Redirect to Stripe Customer Portal - window.location.href = data.url; - } catch (error: any) { - console.error('Error opening portal:', error); - showToast(error.message || 'Failed to open subscription management', 'error'); - setLoading(false); - } - }; - - const handleDeleteAccount = async () => { - const confirmed = window.confirm( - 'Are you sure you want to delete your account? This will permanently delete all your data, including all QR codes and analytics. This action cannot be undone.' - ); - - if (!confirmed) return; - - // Double confirmation for safety - const doubleConfirmed = window.confirm( - 'This is your last warning. Are you absolutely sure you want to permanently delete your account?' - ); - - if (!doubleConfirmed) return; - - setLoading(true); - - try { - const response = await fetchWithCsrf('/api/user/delete', { - method: 'DELETE', - }); - - const data = await response.json(); - - if (!response.ok) { - throw new Error(data.error || 'Failed to delete account'); - } - - // Clear local storage and redirect to login - localStorage.clear(); - showToast('Account deleted successfully', 'success'); - - // Redirect to home page after a short delay - setTimeout(() => { - window.location.href = '/'; - }, 1500); - } catch (error: any) { - console.error('Error deleting account:', error); - showToast(error.message || 'Failed to delete account', 'error'); - setLoading(false); - } - }; - - const getPlanLimits = () => { - switch (plan) { - case 'PRO': - return { dynamic: 50, price: '€9', period: 'per month' }; - case 'BUSINESS': - return { dynamic: 500, price: '€29', period: 'per month' }; - default: - return { dynamic: 3, price: '€0', period: 'forever' }; - } - }; - - const planLimits = getPlanLimits(); - const usagePercentage = (usageStats.dynamicUsed / usageStats.dynamicLimit) * 100; - - return ( -
-
-

Settings

-

Manage your account settings and preferences

-
- - {/* Tabs */} -
- -
- - {/* Tab Content */} - {activeTab === 'profile' && ( -
- {/* Profile Information */} - - - Profile Information - - -
- - setName(e.target.value)} - className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-primary-500 focus:border-primary-500" - placeholder="Enter your name" - /> -
- -
- - -

- Email cannot be changed -

-
- - - - {/* Security */} - - - Security - - -
-
-

Password

-

- Update your password to keep your account secure -

-
- -
- - - - {/* Account Deletion */} - - - Delete Account - - -
-
-

Delete your account

-

- Permanently delete your account and all data. This action cannot be undone. -

-
- -
- - - - {/* Save Button */} -
- -
-
- )} - - {activeTab === 'subscription' && ( -
- {/* Current Plan */} - - -
- Current Plan - - {plan} - -
- - -
- {planLimits.price} - {planLimits.period} -
- -
-
- Dynamic QR Codes - - {usageStats.dynamicUsed} of {usageStats.dynamicLimit} used - -
-
-
-
-
- -
-
- Static QR Codes - Unlimited ∞ -
-
-
-
-
- - {plan !== 'FREE' && ( -
- -
- )} - - {plan === 'FREE' && ( -
- -
- )} - - -
- )} - - {/* Change Password Modal */} - setShowPasswordModal(false)} - onSuccess={() => { - setShowPasswordModal(false); - }} - /> -
- ); -} +'use client'; + +import React, { useState, useEffect } from 'react'; +import { Card, CardHeader, CardTitle, CardContent } from '@/components/ui/Card'; +import { Button } from '@/components/ui/Button'; +import { Badge } from '@/components/ui/Badge'; +import { useCsrf } from '@/hooks/useCsrf'; +import { showToast } from '@/components/ui/Toast'; +import ChangePasswordModal from '@/components/settings/ChangePasswordModal'; + +type TabType = 'profile' | 'subscription'; + +export default function SettingsPage() { + const { fetchWithCsrf } = useCsrf(); + const [activeTab, setActiveTab] = useState('profile'); + const [loading, setLoading] = useState(false); + const [showPasswordModal, setShowPasswordModal] = useState(false); + + // Profile states + const [name, setName] = useState(''); + const [email, setEmail] = useState(''); + + // Subscription states + const [plan, setPlan] = useState('FREE'); + const [usageStats, setUsageStats] = useState({ + dynamicUsed: 0, + dynamicLimit: 3, + staticUsed: 0, + }); + + // Load user data + useEffect(() => { + const fetchUserData = async () => { + try { + // Load from localStorage + const userStr = localStorage.getItem('user'); + if (userStr) { + const user = JSON.parse(userStr); + setName(user.name || ''); + setEmail(user.email || ''); + } + + // Fetch plan from API + const planResponse = await fetch('/api/user/plan'); + if (planResponse.ok) { + const data = await planResponse.json(); + setPlan(data.plan || 'FREE'); + } + + // Fetch usage stats from API + const statsResponse = await fetch('/api/user/stats'); + if (statsResponse.ok) { + const data = await statsResponse.json(); + setUsageStats(data); + } + } catch (e) { + console.error('Failed to load user data:', e); + } + }; + + fetchUserData(); + }, []); + + const handleSaveProfile = async () => { + setLoading(true); + + try { + // Save to backend API + const response = await fetchWithCsrf('/api/user/profile', { + method: 'PATCH', + body: JSON.stringify({ name }), + }); + + const data = await response.json(); + + if (!response.ok) { + throw new Error(data.error || 'Failed to update profile'); + } + + // Update user data in localStorage + const userStr = localStorage.getItem('user'); + if (userStr) { + const user = JSON.parse(userStr); + user.name = name; + localStorage.setItem('user', JSON.stringify(user)); + } + + showToast('Profile updated successfully!', 'success'); + } catch (error: any) { + console.error('Error saving profile:', error); + showToast(error.message || 'Failed to update profile', 'error'); + } finally { + setLoading(false); + } + }; + + const handleManageSubscription = async () => { + setLoading(true); + + try { + const response = await fetchWithCsrf('/api/stripe/portal', { + method: 'POST', + }); + + const data = await response.json(); + + if (!response.ok) { + throw new Error(data.error || 'Failed to open subscription management'); + } + + // Redirect to Stripe Customer Portal + window.location.href = data.url; + } catch (error: any) { + console.error('Error opening portal:', error); + showToast(error.message || 'Failed to open subscription management', 'error'); + setLoading(false); + } + }; + + const handleDeleteAccount = async () => { + const confirmed = window.confirm( + 'Are you sure you want to delete your account? This will permanently delete all your data, including all QR codes and analytics. This action cannot be undone.' + ); + + if (!confirmed) return; + + // Double confirmation for safety + const doubleConfirmed = window.confirm( + 'This is your last warning. Are you absolutely sure you want to permanently delete your account?' + ); + + if (!doubleConfirmed) return; + + setLoading(true); + + try { + const response = await fetchWithCsrf('/api/user/delete', { + method: 'DELETE', + }); + + const data = await response.json(); + + if (!response.ok) { + throw new Error(data.error || 'Failed to delete account'); + } + + // Clear local storage and redirect to login + localStorage.clear(); + showToast('Account deleted successfully', 'success'); + + // Redirect to home page after a short delay + setTimeout(() => { + window.location.href = '/'; + }, 1500); + } catch (error: any) { + console.error('Error deleting account:', error); + showToast(error.message || 'Failed to delete account', 'error'); + setLoading(false); + } + }; + + const getPlanLimits = () => { + switch (plan) { + case 'PRO': + return { dynamic: 50, price: '€9', period: 'per month' }; + case 'BUSINESS': + return { dynamic: 500, price: '€29', period: 'per month' }; + default: + return { dynamic: 3, price: '€0', period: 'forever' }; + } + }; + + const planLimits = getPlanLimits(); + const usagePercentage = (usageStats.dynamicUsed / usageStats.dynamicLimit) * 100; + + return ( +
+
+

Settings

+

Manage your account settings and preferences

+
+ + {/* Tabs */} +
+ +
+ + {/* Tab Content */} + {activeTab === 'profile' && ( +
+ {/* Profile Information */} + + + Profile Information + + +
+ + setName(e.target.value)} + className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-primary-500 focus:border-primary-500" + placeholder="Enter your name" + /> +
+ +
+ + +

+ Email cannot be changed +

+
+ + + + {/* Security */} + + + Security + + +
+
+

Password

+

+ Update your password to keep your account secure +

+
+ +
+ + + + {/* Account Deletion */} + + + Delete Account + + +
+
+

Delete your account

+

+ Permanently delete your account and all data. This action cannot be undone. +

+
+ +
+ + + + {/* Save Button */} +
+ +
+
+ )} + + {activeTab === 'subscription' && ( +
+ {/* Current Plan */} + + +
+ Current Plan + + {plan} + +
+ + +
+ {planLimits.price} + {planLimits.period} +
+ +
+
+ Dynamic QR Codes + + {usageStats.dynamicUsed} of {usageStats.dynamicLimit} used + +
+
+
+
+
+ +
+
+ Static QR Codes + Unlimited ∞ +
+
+
+
+
+ + {plan !== 'FREE' && ( +
+ +
+ )} + + {plan === 'FREE' && ( +
+ +
+ )} + + +
+ )} + + {/* Change Password Modal */} + setShowPasswordModal(false)} + onSuccess={() => { + setShowPasswordModal(false); + }} + /> +
+ ); +} diff --git a/src/app/(main)/(app)/test/page.tsx b/src/app/(main)/(app)/test/page.tsx index a26d380..a25abd4 100644 --- a/src/app/(main)/(app)/test/page.tsx +++ b/src/app/(main)/(app)/test/page.tsx @@ -1,158 +1,158 @@ -'use client'; - -import React, { useState } from 'react'; -import { QRCodeSVG } from 'qrcode.react'; -import { Button } from '@/components/ui/Button'; -import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/Card'; - -export default function TestPage() { - const [testResults, setTestResults] = useState({}); - const [loading, setLoading] = useState(false); - - const runTest = async () => { - setLoading(true); - const results: any = {}; - - try { - // Step 1: Create a STATIC QR code - console.log('Creating STATIC QR code...'); - const createResponse = await fetch('/api/qrs', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ - title: 'Test Static QR', - contentType: 'URL', - content: { url: 'https://google.com' }, - isStatic: true, - tags: [], - style: { - foregroundColor: '#000000', - backgroundColor: '#FFFFFF', - cornerStyle: 'square', - size: 200, - }, - }), - }); - - const createdQR = await createResponse.json(); - results.created = createdQR; - console.log('Created QR:', createdQR); - - // Step 2: Fetch all QR codes - console.log('Fetching QR codes...'); - const fetchResponse = await fetch('/api/qrs'); - const allQRs = await fetchResponse.json(); - results.fetched = allQRs; - console.log('Fetched QRs:', allQRs); - - // Step 3: Check debug endpoint - console.log('Checking debug endpoint...'); - const debugResponse = await fetch('/api/debug'); - const debugData = await debugResponse.json(); - results.debug = debugData; - console.log('Debug data:', debugData); - - } catch (error) { - results.error = String(error); - console.error('Test error:', error); - } - - setTestResults(results); - setLoading(false); - }; - - const getQRValue = (qr: any) => { - // Check for qrContent field - if (qr?.content?.qrContent) { - return qr.content.qrContent; - } - // Check for direct URL - if (qr?.content?.url) { - return qr.content.url; - } - // Fallback to redirect - return `http://localhost:3001/r/${qr?.slug || 'unknown'}`; - }; - - return ( -
-

QR Code Test Page

- - - - Test Static QR Code Creation - - - - - {testResults.created && ( -
-

Created QR Code:

- 
-                {JSON.stringify(testResults.created, null, 2)}
-
- -
-

QR Code Preview:

-
- -

- QR Value: {getQRValue(testResults.created)} -

-
-
-
- )} - - {testResults.fetched && ( -
-

All QR Codes:

- 
-                {JSON.stringify(testResults.fetched, null, 2)}
-
-
- )} - - {testResults.debug && ( -
-

Debug Data:

- 
-                {JSON.stringify(testResults.debug, null, 2)}
-
-
- )} - - {testResults.error && ( -
- Error: {testResults.error} -
- )} - - - - - - Manual QR Tests - - -
-

Direct URL QR (Should go to Google):

- -

Value: https://google.com

-
- -
-

Redirect QR (Goes through localhost):

- -

Value: http://localhost:3001/r/test-slug

-
- - -
- ); +'use client'; + +import React, { useState } from 'react'; +import { QRCodeSVG } from 'qrcode.react'; +import { Button } from '@/components/ui/Button'; +import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/Card'; + +export default function TestPage() { + const [testResults, setTestResults] = useState({}); + const [loading, setLoading] = useState(false); + + const runTest = async () => { + setLoading(true); + const results: any = {}; + + try { + // Step 1: Create a STATIC QR code + console.log('Creating STATIC QR code...'); + const createResponse = await fetch('/api/qrs', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ + title: 'Test Static QR', + contentType: 'URL', + content: { url: 'https://google.com' }, + isStatic: true, + tags: [], + style: { + foregroundColor: '#000000', + backgroundColor: '#FFFFFF', + cornerStyle: 'square', + size: 200, + }, + }), + }); + + const createdQR = await createResponse.json(); + results.created = createdQR; + console.log('Created QR:', createdQR); + + // Step 2: Fetch all QR codes + console.log('Fetching QR codes...'); + const fetchResponse = await fetch('/api/qrs'); + const allQRs = await fetchResponse.json(); + results.fetched = allQRs; + console.log('Fetched QRs:', allQRs); + + // Step 3: Check debug endpoint + console.log('Checking debug endpoint...'); + const debugResponse = await fetch('/api/debug'); + const debugData = await debugResponse.json(); + results.debug = debugData; + console.log('Debug data:', debugData); + + } catch (error) { + results.error = String(error); + console.error('Test error:', error); + } + + setTestResults(results); + setLoading(false); + }; + + const getQRValue = (qr: any) => { + // Check for qrContent field + if (qr?.content?.qrContent) { + return qr.content.qrContent; + } + // Check for direct URL + if (qr?.content?.url) { + return qr.content.url; + } + // Fallback to redirect + return `http://localhost:3001/r/${qr?.slug || 'unknown'}`; + }; + + return ( +
+

QR Code Test Page

+ + + + Test Static QR Code Creation + + + + + {testResults.created && ( +
+

Created QR Code:

+ 
+                {JSON.stringify(testResults.created, null, 2)}
+
+ +
+

QR Code Preview:

+
+ +

+ QR Value: {getQRValue(testResults.created)} +

+
+
+
+ )} + + {testResults.fetched && ( +
+

All QR Codes:

+ 
+                {JSON.stringify(testResults.fetched, null, 2)}
+
+
+ )} + + {testResults.debug && ( +
+

Debug Data:

+ 
+                {JSON.stringify(testResults.debug, null, 2)}
+
+
+ )} + + {testResults.error && ( +
+ Error: {testResults.error} +
+ )} + + + + + + Manual QR Tests + + +
+

Direct URL QR (Should go to Google):

+ +

Value: https://google.com

+
+ +
+

Redirect QR (Goes through localhost):

+ +

Value: http://localhost:3001/r/test-slug

+
+ + +
+ ); } \ No newline at end of file diff --git a/src/app/(main)/(auth)/forgot-password/page.tsx b/src/app/(main)/(auth)/forgot-password/page.tsx index 8aebe63..f6928a7 100644 --- a/src/app/(main)/(auth)/forgot-password/page.tsx +++ b/src/app/(main)/(auth)/forgot-password/page.tsx @@ -1,155 +1,155 @@ -'use client'; - -import React, { useState } from 'react'; -import Link from 'next/link'; -import { Card, CardContent } from '@/components/ui/Card'; -import { Input } from '@/components/ui/Input'; -import { Button } from '@/components/ui/Button'; -import { useCsrf } from '@/hooks/useCsrf'; - -export default function ForgotPasswordPage() { - const { fetchWithCsrf, loading: csrfLoading } = useCsrf(); - const [email, setEmail] = useState(''); - const [loading, setLoading] = useState(false); - const [success, setSuccess] = useState(false); - const [error, setError] = useState(''); - - const handleSubmit = async (e: React.FormEvent) => { - e.preventDefault(); - setLoading(true); - setError(''); - - try { - const response = await fetchWithCsrf('/api/auth/forgot-password', { - method: 'POST', - body: JSON.stringify({ email }), - }); - - const data = await response.json(); - - if (response.ok) { - setSuccess(true); - } else { - setError(data.error || 'Failed to send reset email'); - } - } catch (err) { - setError('An error occurred. Please try again.'); - } finally { - setLoading(false); - } - }; - - if (success) { - return ( -
-
-
- - QR Master - QR Master - -

Check Your Email

-

We've sent you a password reset link

-
- - - -
-
- - - -
- -

- We've sent a password reset link to {email} -

- -

- Please check your email and click the link to reset your password. The link will expire in 1 hour. -

- -
- - - - - -
-
- - -
-
- ); - } - - return ( -
-
-
- - QR Master - QR Master - -

Forgot Password?

-

No worries, we'll send you reset instructions

-
- - - -
- {error && ( -
- {error} -
- )} - - setEmail(e.target.value)} - placeholder="you@example.com" - required - disabled={loading || csrfLoading} - /> - - - -
- - ← Back to Login - -
-
- - - -

- Remember your password?{' '} - - Sign in - -

-
-
- ); -} +'use client'; + +import React, { useState } from 'react'; +import Link from 'next/link'; +import { Card, CardContent } from '@/components/ui/Card'; +import { Input } from '@/components/ui/Input'; +import { Button } from '@/components/ui/Button'; +import { useCsrf } from '@/hooks/useCsrf'; + +export default function ForgotPasswordPage() { + const { fetchWithCsrf, loading: csrfLoading } = useCsrf(); + const [email, setEmail] = useState(''); + const [loading, setLoading] = useState(false); + const [success, setSuccess] = useState(false); + const [error, setError] = useState(''); + + const handleSubmit = async (e: React.FormEvent) => { + e.preventDefault(); + setLoading(true); + setError(''); + + try { + const response = await fetchWithCsrf('/api/auth/forgot-password', { + method: 'POST', + body: JSON.stringify({ email }), + }); + + const data = await response.json(); + + if (response.ok) { + setSuccess(true); + } else { + setError(data.error || 'Failed to send reset email'); + } + } catch (err) { + setError('An error occurred. Please try again.'); + } finally { + setLoading(false); + } + }; + + if (success) { + return ( +
+
+
+ + QR Master + QR Master + +

Check Your Email

+

We've sent you a password reset link

+
+ + + +
+
+ + + +
+ +

+ We've sent a password reset link to {email} +

+ +

+ Please check your email and click the link to reset your password. The link will expire in 1 hour. +

+ +
+ + + + + +
+
+ + +
+
+ ); + } + + return ( +
+
+
+ + QR Master + QR Master + +

Forgot Password?

+

No worries, we'll send you reset instructions

+
+ + + +
+ {error && ( +
+ {error} +
+ )} + + setEmail(e.target.value)} + placeholder="you@example.com" + required + disabled={loading || csrfLoading} + /> + + + +
+ + ← Back to Login + +
+
+ + + +

+ Remember your password?{' '} + + Sign in + +

+
+
+ ); +} diff --git a/src/app/(main)/(marketing)/blog/[slug]/raw/route.ts b/src/app/(main)/(marketing)/blog/[slug]/raw/route.ts index 9d1ef33..a33fef8 100644 --- a/src/app/(main)/(marketing)/blog/[slug]/raw/route.ts +++ b/src/app/(main)/(marketing)/blog/[slug]/raw/route.ts @@ -1,145 +1,145 @@ -import { getPublishedPostBySlug } from '@/lib/content'; -import sanitizeHtml from 'sanitize-html'; - -const RAW_ENABLED_SLUGS = new Set([ - 'dynamic-vs-static-qr-codes', - 'qr-code-small-business', - 'qr-code-tracking-guide-2025', - 'utm-parameter-qr-codes', - 'trackable-qr-codes', -]); - -function decodeHtmlEntities(text: string): string { - return text - .replace(/ /g, ' ') - .replace(/&/g, '&') - .replace(/"/g, '"') - .replace(/'/g, "'") - .replace(/</g, '<') - .replace(/>/g, '>') - .replace(/—/g, '--') - .replace(/–/g, '-') - .replace(/…/g, '...') - .replace(/'/g, "'") - .replace(///g, '/') - .replace(/&#(\d+);/g, (_, code) => { - const value = Number.parseInt(code, 10); - return Number.isNaN(value) ? '' : String.fromCharCode(value); - }); -} - -function cleanHtmlToText(html: string): string { - const normalized = html - .replace(/]*class=(['"])[^'"]*post-metadata[^'"]*\1[^>]*>[\s\S]*?<\/div>/gi, '') - .replace(/]*class=(['"])[^'"]*blog-content[^'"]*\1[^>]*>/gi, '') - .replace(/<\/div>\s*$/i, ''); - - const withLinks = normalized.replace( - /]*href=(['"])(.*?)\1[^>]*>([\s\S]*?)<\/a>/gi, - (_, __, href: string, text: string) => `[${cleanHtmlToText(text)}](${href})`, - ); - - const structured = withLinks - .replace(//gi, '\n') - .replace(/]*>/gi, '- ') - .replace(/<\/li>/gi, '\n') - .replace(/]*>/gi, (_, level: string) => `${'#'.repeat(Number.parseInt(level, 10))} `) - .replace(/<\/h[1-6]>/gi, '\n\n') - .replace(/<\/p>/gi, '\n\n') - .replace(/<\/div>/gi, '\n\n') - .replace(/<\/section>/gi, '\n\n') - .replace(/<\/ul>/gi, '\n') - .replace(/<\/ol>/gi, '\n'); - - const stripped = sanitizeHtml(structured, { - allowedTags: [], - allowedAttributes: {}, - }); - - return decodeHtmlEntities(stripped) - .replace(/\r\n/g, '\n') - .replace(/\n{3,}/g, '\n\n') - .replace(/[ \t]+\n/g, '\n') - .replace(/\n[ \t]+/g, '\n') - .trim(); -} - -function renderRawPost(slug: string): string | null { - if (!RAW_ENABLED_SLUGS.has(slug)) { - return null; - } - - const post = getPublishedPostBySlug(slug); - if (!post) { - return null; - } - - const sections: string[] = [ - `# ${post.title}`, - '', - post.description, - '', - `Canonical URL: https://www.qrmaster.net/blog/${post.slug}`, - `Published: ${post.datePublished}`, - `Updated: ${post.dateModified || post.updatedAt || post.datePublished}`, - ]; - - if (post.quickAnswer) { - sections.push('', '## Quick Answer', '', cleanHtmlToText(post.quickAnswer)); - } - - if (post.keySteps?.length) { - sections.push('', '## Steps', '', ...post.keySteps.map((step, index) => `${index + 1}. ${step}`)); - } - - const mainText = cleanHtmlToText(post.content); - if (mainText) { - sections.push('', '## Article', '', mainText); - } - - if (post.faq?.length) { - sections.push('', '## FAQ', ''); - for (const item of post.faq) { - sections.push(`Q: ${cleanHtmlToText(item.question)}`); - sections.push(`A: ${cleanHtmlToText(item.answer)}`, ''); - } - if (sections[sections.length - 1] === '') { - sections.pop(); - } - } - - if (post.sources?.length) { - sections.push('', '## Sources', ''); - for (const source of post.sources) { - const accessDate = source.accessDate ? ` (accessed ${source.accessDate})` : ''; - sections.push(`- ${source.name}: ${source.url}${accessDate}`); - } - } - - return `${sections.join('\n').trim()}\n`; -} - -export async function GET( - _request: Request, - { params }: { params: { slug: string } }, -) { - const content = renderRawPost(params.slug); - - if (!content) { - return new Response('Not Found', { - status: 404, - headers: { - 'Content-Type': 'text/plain; charset=utf-8', - 'X-Robots-Tag': 'noindex, nofollow', - }, - }); - } - - return new Response(content, { - headers: { - 'Content-Type': 'text/markdown; charset=utf-8', - 'X-Robots-Tag': 'noindex, nofollow', - 'Cache-Control': 'public, s-maxage=3600, stale-while-revalidate=86400', - }, - }); -} +import { getPublishedPostBySlug } from '@/lib/content'; +import sanitizeHtml from 'sanitize-html'; + +const RAW_ENABLED_SLUGS = new Set([ + 'dynamic-vs-static-qr-codes', + 'qr-code-small-business', + 'qr-code-tracking-guide-2025', + 'utm-parameter-qr-codes', + 'trackable-qr-codes', +]); + +function decodeHtmlEntities(text: string): string { + return text + .replace(/ /g, ' ') + .replace(/&/g, '&') + .replace(/"/g, '"') + .replace(/'/g, "'") + .replace(/</g, '<') + .replace(/>/g, '>') + .replace(/—/g, '--') + .replace(/–/g, '-') + .replace(/…/g, '...') + .replace(/'/g, "'") + .replace(///g, '/') + .replace(/&#(\d+);/g, (_, code) => { + const value = Number.parseInt(code, 10); + return Number.isNaN(value) ? '' : String.fromCharCode(value); + }); +} + +function cleanHtmlToText(html: string): string { + const normalized = html + .replace(/]*class=(['"])[^'"]*post-metadata[^'"]*\1[^>]*>[\s\S]*?<\/div>/gi, '') + .replace(/]*class=(['"])[^'"]*blog-content[^'"]*\1[^>]*>/gi, '') + .replace(/<\/div>\s*$/i, ''); + + const withLinks = normalized.replace( + /]*href=(['"])(.*?)\1[^>]*>([\s\S]*?)<\/a>/gi, + (_, __, href: string, text: string) => `[${cleanHtmlToText(text)}](${href})`, + ); + + const structured = withLinks + .replace(//gi, '\n') + .replace(/]*>/gi, '- ') + .replace(/<\/li>/gi, '\n') + .replace(/]*>/gi, (_, level: string) => `${'#'.repeat(Number.parseInt(level, 10))} `) + .replace(/<\/h[1-6]>/gi, '\n\n') + .replace(/<\/p>/gi, '\n\n') + .replace(/<\/div>/gi, '\n\n') + .replace(/<\/section>/gi, '\n\n') + .replace(/<\/ul>/gi, '\n') + .replace(/<\/ol>/gi, '\n'); + + const stripped = sanitizeHtml(structured, { + allowedTags: [], + allowedAttributes: {}, + }); + + return decodeHtmlEntities(stripped) + .replace(/\r\n/g, '\n') + .replace(/\n{3,}/g, '\n\n') + .replace(/[ \t]+\n/g, '\n') + .replace(/\n[ \t]+/g, '\n') + .trim(); +} + +function renderRawPost(slug: string): string | null { + if (!RAW_ENABLED_SLUGS.has(slug)) { + return null; + } + + const post = getPublishedPostBySlug(slug); + if (!post) { + return null; + } + + const sections: string[] = [ + `# ${post.title}`, + '', + post.description, + '', + `Canonical URL: https://www.qrmaster.net/blog/${post.slug}`, + `Published: ${post.datePublished}`, + `Updated: ${post.dateModified || post.updatedAt || post.datePublished}`, + ]; + + if (post.quickAnswer) { + sections.push('', '## Quick Answer', '', cleanHtmlToText(post.quickAnswer)); + } + + if (post.keySteps?.length) { + sections.push('', '## Steps', '', ...post.keySteps.map((step, index) => `${index + 1}. ${step}`)); + } + + const mainText = cleanHtmlToText(post.content); + if (mainText) { + sections.push('', '## Article', '', mainText); + } + + if (post.faq?.length) { + sections.push('', '## FAQ', ''); + for (const item of post.faq) { + sections.push(`Q: ${cleanHtmlToText(item.question)}`); + sections.push(`A: ${cleanHtmlToText(item.answer)}`, ''); + } + if (sections[sections.length - 1] === '') { + sections.pop(); + } + } + + if (post.sources?.length) { + sections.push('', '## Sources', ''); + for (const source of post.sources) { + const accessDate = source.accessDate ? ` (accessed ${source.accessDate})` : ''; + sections.push(`- ${source.name}: ${source.url}${accessDate}`); + } + } + + return `${sections.join('\n').trim()}\n`; +} + +export async function GET( + _request: Request, + { params }: { params: { slug: string } }, +) { + const content = renderRawPost(params.slug); + + if (!content) { + return new Response('Not Found', { + status: 404, + headers: { + 'Content-Type': 'text/plain; charset=utf-8', + 'X-Robots-Tag': 'noindex, nofollow', + }, + }); + } + + return new Response(content, { + headers: { + 'Content-Type': 'text/markdown; charset=utf-8', + 'X-Robots-Tag': 'noindex, nofollow', + 'Cache-Control': 'public, s-maxage=3600, stale-while-revalidate=86400', + }, + }); +} diff --git a/src/app/(main)/(marketing)/bulk-qr-code-generator/page.tsx b/src/app/(main)/(marketing)/bulk-qr-code-generator/page.tsx index ad09a20..3b0d6ef 100644 --- a/src/app/(main)/(marketing)/bulk-qr-code-generator/page.tsx +++ b/src/app/(main)/(marketing)/bulk-qr-code-generator/page.tsx @@ -1,504 +1,504 @@ -import React from 'react'; -import type { Metadata } from 'next'; -import Link from 'next/link'; -import { Button } from '@/components/ui/Button'; -import { Card } from '@/components/ui/Card'; -import SeoJsonLd from '@/components/SeoJsonLd'; -import Breadcrumbs, { BreadcrumbItem } from '@/components/Breadcrumbs'; -import { breadcrumbSchema } from '@/lib/schema'; -import { AnswerFirstBlock } from '@/components/marketing/AnswerFirstBlock'; -import { FAQSection } from '@/components/aeo/FAQSection'; -import { GrowthLinksSection } from '@/components/marketing/GrowthLinksSection'; -import { MarketingPageTracker } from '@/components/marketing/MarketingAnalytics'; - -export const metadata: Metadata = { - title: { - absolute: 'Bulk QR Code Generator - Create QR Codes from a Spreadsheet', - }, - description: - 'Generate up to 1,000 static QR codes from CSV or Excel files in the QR Master Business plan. Upload, preview, download as ZIP, or save the batch to your dashboard.', - keywords: - 'bulk qr code generator, qr code from excel, csv qr code generator, bulk qr codes, spreadsheet qr generation', - alternates: { - canonical: 'https://www.qrmaster.net/bulk-qr-code-generator', - languages: { - 'x-default': 'https://www.qrmaster.net/bulk-qr-code-generator', - en: 'https://www.qrmaster.net/bulk-qr-code-generator', - }, - }, - openGraph: { - title: 'Bulk QR Code Generator - Create QR Codes from a Spreadsheet', - description: - 'Generate up to 1,000 static QR codes from CSV or Excel files in the QR Master Business plan.', - url: 'https://www.qrmaster.net/bulk-qr-code-generator', - type: 'website', - images: ['/og-image.png'], - }, - twitter: { - title: 'Bulk QR Code Generator - Create QR Codes from a Spreadsheet', - description: - 'Generate up to 1,000 static QR codes from CSV or Excel files in the QR Master Business plan.', - }, -}; - -const featureCards = [ - { - title: 'Spreadsheet upload', - description: - 'Upload CSV, XLS, or XLSX files and map the title and content columns before generating the batch.', - }, - { - title: 'Up to 1,000 rows per upload', - description: - 'The current bulk creation flow limits each upload to 1,000 rows so the batch stays predictable and reviewable.', - }, - { - title: 'Static QR output', - description: - 'Bulk creation currently generates static QR codes. These codes do not include post-print editing or tracking.', - }, - { - title: 'ZIP download', - description: - 'Download the generated QR codes together as a ZIP archive of SVG files for easier handoff or print prep.', - }, - { - title: 'Optional dashboard save', - description: - 'After generation, you can save the batch into your QR Master dashboard for later management.', - }, - { - title: 'Business plan access', - description: - 'The current bulk creation workflow is available to Business plan subscribers and is positioned around scale, not single-code creation.', - }, -]; - -const inputExamples = [ - { - title: 'Website URLs', - content: 'https://example.com/product', - note: 'Useful for product pages, flyers, support pages, or campaign destinations.', - }, - { - title: 'vCard data', - content: 'John,Doe,john@example.com,+1234567890,Company,Sales', - note: 'Useful when each spreadsheet row contains contact card data you want encoded into the QR.', - }, - { - title: 'Coordinates', - content: '37.7749,-122.4194,Main Office', - note: 'Useful for location or asset workflows where the content string already contains the coordinates.', - }, - { - title: 'Plain text', - content: 'SN-12345-ABCDE', - note: 'Useful for serials, labels, and operational identifiers.', - }, -]; - -const useCases = [ - { - title: 'Product labels and inserts', - description: - 'Generate large static batches for packaging, inserts, manuals, or support labels when every unit needs a QR code.', - points: ['One spreadsheet as input', 'Consistent file naming', 'Printable SVG output'], - }, - { - title: 'Event materials', - description: - 'Produce batches for badges, handouts, booth materials, or attendee resources when a static QR is enough.', - points: ['Batch generation from one file', 'Preview before generation', 'Download everything together'], - }, - { - title: 'Inventory and asset labels', - description: - 'Encode asset IDs, location strings, or internal references without building each QR code one by one.', - points: ['Works with text content', 'Good for offline labeling', 'Save the finished set to the dashboard'], - }, - { - title: 'Bulk print preparation', - description: - 'Prepare many QR codes for printers or production teams from one spreadsheet instead of manual single-code exports.', - points: ['SVG batch download', 'Up to 1,000 rows per upload', 'Business-plan workflow'], - }, -]; - -const faqItems = [ - { - question: 'How many QR codes can I generate at once?', - answer: - 'The current bulk creation flow accepts up to 1,000 rows per upload.', - }, - { - question: 'Are bulk-generated QR codes dynamic or trackable?', - answer: - 'No. The current bulk creation flow generates static QR codes, so those codes do not include post-print editing or tracking.', - }, - { - question: 'What file formats can I upload?', - answer: - 'The current flow accepts CSV, XLS, and XLSX files.', - }, - { - question: 'Which plan includes bulk QR creation?', - answer: - 'Bulk QR creation is currently available in the Business plan.', - }, -]; - -const softwareSchema = { - '@context': 'https://schema.org', - '@type': 'SoftwareApplication', - '@id': 'https://www.qrmaster.net/bulk-qr-code-generator#software', - name: 'QR Master - Bulk QR Code Generator', - applicationCategory: 'BusinessApplication', - operatingSystem: 'Web Browser', - offers: { - '@type': 'Offer', - price: '29', - priceCurrency: 'EUR', - availability: 'https://schema.org/InStock', - }, - description: - 'Generate up to 1,000 static QR codes from CSV or Excel files in the QR Master Business plan.', - featureList: [ - 'CSV, XLS, and XLSX upload', - 'Up to 1,000 rows per upload', - 'Static QR code generation', - 'ZIP download of generated SVG files', - 'Optional save-to-dashboard step', - ], -}; - -const howToSchema = { - '@context': 'https://schema.org', - '@type': 'HowTo', - '@id': 'https://www.qrmaster.net/bulk-qr-code-generator#howto', - name: 'How to generate bulk QR codes from a spreadsheet', - description: - 'Upload a spreadsheet, map the title and content columns, preview the batch, then generate and download the QR codes.', - totalTime: 'PT10M', - step: [ - { - '@type': 'HowToStep', - position: 1, - name: 'Prepare the spreadsheet', - text: 'Create a CSV, XLS, or XLSX file with one row per QR code and at least title and content data.', - }, - { - '@type': 'HowToStep', - position: 2, - name: 'Upload and map columns', - text: 'Upload the file in the Business-plan bulk creation flow and map the title and content columns.', - url: 'https://www.qrmaster.net/bulk-creation', - }, - { - '@type': 'HowToStep', - position: 3, - name: 'Preview the batch', - text: 'Review the detected rows and confirm the content before generating the final QR batch.', - }, - { - '@type': 'HowToStep', - position: 4, - name: 'Generate and download', - text: 'Generate the QR codes, then download the ZIP archive or save the finished set to the dashboard.', - }, - ], -}; - -const faqSchema = { - '@context': 'https://schema.org', - '@type': 'FAQPage', - '@id': 'https://www.qrmaster.net/bulk-qr-code-generator#faq', - mainEntity: faqItems.map((item) => ({ - '@type': 'Question', - name: item.question, - acceptedAnswer: { - '@type': 'Answer', - text: item.answer, - }, - })), -}; - -const breadcrumbItems: BreadcrumbItem[] = [ - { name: 'Home', url: '/' }, - { name: 'Bulk QR Code Generator', url: '/bulk-qr-code-generator' }, -]; - -const relatedUseCaseLinks = [ - { - href: '/use-cases/packaging-qr-codes', - title: 'Packaging QR Codes', - description: - 'Use bulk generation when labels, inserts, or packaging need many QR codes produced from one spreadsheet.', - ctaLabel: 'Create your packaging QR code', - }, - { - href: '/use-cases', - title: 'Explore the use-case hub', - description: - 'See where bulk creation fits into broader QR workflows and adjacent commercial pages.', - ctaLabel: 'Explore QR code use cases', - }, - { - href: '/custom-qr-code-generator', - title: 'Custom QR Code Generator', - description: - 'Use single-code design workflows when you need more styling control than the current bulk flow exposes.', - ctaLabel: 'Design a custom QR code', - }, - { - href: '/pricing', - title: 'Pricing', - description: - 'Review which plan includes bulk creation and how it fits alongside dynamic QR and analytics features.', - ctaLabel: 'View pricing', - }, -]; - -export default function BulkQRCodeGeneratorPage() { - return ( - <> - - -
-
-
- -
-
-
- Business-plan spreadsheet workflow -
- -
-

- Bulk QR Code Generator -

-

- Generate up to 1,000 static QR codes from a CSV or Excel file. Upload, - preview, download the batch as ZIP, or save it into your dashboard. -

-
- -
- {[ - 'CSV, XLS, and XLSX upload', - 'Up to 1,000 rows per upload', - 'Static QR code output', - 'ZIP download and optional save to dashboard', - ].map((feature) => ( -
-
- - - -
- {feature} -
- ))} -
- -
- - - - - - -
-
- -
- -

Spreadsheet to ZIP workflow

-
-

products.xlsx

-

Upload, map, preview, generate

-
-
- - - -
-
- {[1, 2, 3, 4, 5, 6, 7, 8].map((item) => ( -
- QR {item} -
- ))} -
-

- Designed for bulk static output, not dynamic tracking. -

- -
- Up to 1,000 rows -
-
-
-
-
- -
- -
- -
- -
- -
-
-
-

What the current bulk flow supports

-

- This section stays aligned with the actual Business-plan bulk creation experience in the app. -

-
- -
- {featureCards.map((feature) => ( - -

{feature.title}

-

{feature.description}

- - ))} -
-
-
- -
-
-
-

Example input content

-

- The current workflow maps a title column and a content column. What you encode in the content field is up to the row data you provide. -

-
- -
- {inputExamples.map((example) => ( - -

{example.title}

-
- {example.content} -
-

{example.note}

- - ))} -
-
-
- -
-
-
-

Where bulk generation fits best

-

- Bulk creation is strongest when one spreadsheet feeds a real print, labeling, or operational workflow. -

-
- -
- {useCases.map((useCase) => ( - -

{useCase.title}

-

{useCase.description}

-
    - {useCase.points.map((point) => ( -
  • - - - - {point} -
    • - ))} -
- - ))} -
-
-
- - - -
-
-

Generate bulk QR codes without one-by-one setup

-

- Use the Business-plan bulk flow when you need a large static QR batch from a single spreadsheet. -

-
- - - - - - -
-
-
-
- - ); -} +import React from 'react'; +import type { Metadata } from 'next'; +import Link from 'next/link'; +import { Button } from '@/components/ui/Button'; +import { Card } from '@/components/ui/Card'; +import SeoJsonLd from '@/components/SeoJsonLd'; +import Breadcrumbs, { BreadcrumbItem } from '@/components/Breadcrumbs'; +import { breadcrumbSchema } from '@/lib/schema'; +import { AnswerFirstBlock } from '@/components/marketing/AnswerFirstBlock'; +import { FAQSection } from '@/components/aeo/FAQSection'; +import { GrowthLinksSection } from '@/components/marketing/GrowthLinksSection'; +import { MarketingPageTracker } from '@/components/marketing/MarketingAnalytics'; + +export const metadata: Metadata = { + title: { + absolute: 'Bulk QR Code Generator - Create QR Codes from a Spreadsheet', + }, + description: + 'Generate up to 1,000 static QR codes from CSV or Excel files in the QR Master Business plan. Upload, preview, download as ZIP, or save the batch to your dashboard.', + keywords: + 'bulk qr code generator, qr code from excel, csv qr code generator, bulk qr codes, spreadsheet qr generation', + alternates: { + canonical: 'https://www.qrmaster.net/bulk-qr-code-generator', + languages: { + 'x-default': 'https://www.qrmaster.net/bulk-qr-code-generator', + en: 'https://www.qrmaster.net/bulk-qr-code-generator', + }, + }, + openGraph: { + title: 'Bulk QR Code Generator - Create QR Codes from a Spreadsheet', + description: + 'Generate up to 1,000 static QR codes from CSV or Excel files in the QR Master Business plan.', + url: 'https://www.qrmaster.net/bulk-qr-code-generator', + type: 'website', + images: ['/og-image.png'], + }, + twitter: { + title: 'Bulk QR Code Generator - Create QR Codes from a Spreadsheet', + description: + 'Generate up to 1,000 static QR codes from CSV or Excel files in the QR Master Business plan.', + }, +}; + +const featureCards = [ + { + title: 'Spreadsheet upload', + description: + 'Upload CSV, XLS, or XLSX files and map the title and content columns before generating the batch.', + }, + { + title: 'Up to 1,000 rows per upload', + description: + 'The current bulk creation flow limits each upload to 1,000 rows so the batch stays predictable and reviewable.', + }, + { + title: 'Static QR output', + description: + 'Bulk creation currently generates static QR codes. These codes do not include post-print editing or tracking.', + }, + { + title: 'ZIP download', + description: + 'Download the generated QR codes together as a ZIP archive of SVG files for easier handoff or print prep.', + }, + { + title: 'Optional dashboard save', + description: + 'After generation, you can save the batch into your QR Master dashboard for later management.', + }, + { + title: 'Business plan access', + description: + 'The current bulk creation workflow is available to Business plan subscribers and is positioned around scale, not single-code creation.', + }, +]; + +const inputExamples = [ + { + title: 'Website URLs', + content: 'https://example.com/product', + note: 'Useful for product pages, flyers, support pages, or campaign destinations.', + }, + { + title: 'vCard data', + content: 'John,Doe,john@example.com,+1234567890,Company,Sales', + note: 'Useful when each spreadsheet row contains contact card data you want encoded into the QR.', + }, + { + title: 'Coordinates', + content: '37.7749,-122.4194,Main Office', + note: 'Useful for location or asset workflows where the content string already contains the coordinates.', + }, + { + title: 'Plain text', + content: 'SN-12345-ABCDE', + note: 'Useful for serials, labels, and operational identifiers.', + }, +]; + +const useCases = [ + { + title: 'Product labels and inserts', + description: + 'Generate large static batches for packaging, inserts, manuals, or support labels when every unit needs a QR code.', + points: ['One spreadsheet as input', 'Consistent file naming', 'Printable SVG output'], + }, + { + title: 'Event materials', + description: + 'Produce batches for badges, handouts, booth materials, or attendee resources when a static QR is enough.', + points: ['Batch generation from one file', 'Preview before generation', 'Download everything together'], + }, + { + title: 'Inventory and asset labels', + description: + 'Encode asset IDs, location strings, or internal references without building each QR code one by one.', + points: ['Works with text content', 'Good for offline labeling', 'Save the finished set to the dashboard'], + }, + { + title: 'Bulk print preparation', + description: + 'Prepare many QR codes for printers or production teams from one spreadsheet instead of manual single-code exports.', + points: ['SVG batch download', 'Up to 1,000 rows per upload', 'Business-plan workflow'], + }, +]; + +const faqItems = [ + { + question: 'How many QR codes can I generate at once?', + answer: + 'The current bulk creation flow accepts up to 1,000 rows per upload.', + }, + { + question: 'Are bulk-generated QR codes dynamic or trackable?', + answer: + 'No. The current bulk creation flow generates static QR codes, so those codes do not include post-print editing or tracking.', + }, + { + question: 'What file formats can I upload?', + answer: + 'The current flow accepts CSV, XLS, and XLSX files.', + }, + { + question: 'Which plan includes bulk QR creation?', + answer: + 'Bulk QR creation is currently available in the Business plan.', + }, +]; + +const softwareSchema = { + '@context': 'https://schema.org', + '@type': 'SoftwareApplication', + '@id': 'https://www.qrmaster.net/bulk-qr-code-generator#software', + name: 'QR Master - Bulk QR Code Generator', + applicationCategory: 'BusinessApplication', + operatingSystem: 'Web Browser', + offers: { + '@type': 'Offer', + price: '29', + priceCurrency: 'EUR', + availability: 'https://schema.org/InStock', + }, + description: + 'Generate up to 1,000 static QR codes from CSV or Excel files in the QR Master Business plan.', + featureList: [ + 'CSV, XLS, and XLSX upload', + 'Up to 1,000 rows per upload', + 'Static QR code generation', + 'ZIP download of generated SVG files', + 'Optional save-to-dashboard step', + ], +}; + +const howToSchema = { + '@context': 'https://schema.org', + '@type': 'HowTo', + '@id': 'https://www.qrmaster.net/bulk-qr-code-generator#howto', + name: 'How to generate bulk QR codes from a spreadsheet', + description: + 'Upload a spreadsheet, map the title and content columns, preview the batch, then generate and download the QR codes.', + totalTime: 'PT10M', + step: [ + { + '@type': 'HowToStep', + position: 1, + name: 'Prepare the spreadsheet', + text: 'Create a CSV, XLS, or XLSX file with one row per QR code and at least title and content data.', + }, + { + '@type': 'HowToStep', + position: 2, + name: 'Upload and map columns', + text: 'Upload the file in the Business-plan bulk creation flow and map the title and content columns.', + url: 'https://www.qrmaster.net/bulk-creation', + }, + { + '@type': 'HowToStep', + position: 3, + name: 'Preview the batch', + text: 'Review the detected rows and confirm the content before generating the final QR batch.', + }, + { + '@type': 'HowToStep', + position: 4, + name: 'Generate and download', + text: 'Generate the QR codes, then download the ZIP archive or save the finished set to the dashboard.', + }, + ], +}; + +const faqSchema = { + '@context': 'https://schema.org', + '@type': 'FAQPage', + '@id': 'https://www.qrmaster.net/bulk-qr-code-generator#faq', + mainEntity: faqItems.map((item) => ({ + '@type': 'Question', + name: item.question, + acceptedAnswer: { + '@type': 'Answer', + text: item.answer, + }, + })), +}; + +const breadcrumbItems: BreadcrumbItem[] = [ + { name: 'Home', url: '/' }, + { name: 'Bulk QR Code Generator', url: '/bulk-qr-code-generator' }, +]; + +const relatedUseCaseLinks = [ + { + href: '/use-cases/packaging-qr-codes', + title: 'Packaging QR Codes', + description: + 'Use bulk generation when labels, inserts, or packaging need many QR codes produced from one spreadsheet.', + ctaLabel: 'Create your packaging QR code', + }, + { + href: '/use-cases', + title: 'Explore the use-case hub', + description: + 'See where bulk creation fits into broader QR workflows and adjacent commercial pages.', + ctaLabel: 'Explore QR code use cases', + }, + { + href: '/custom-qr-code-generator', + title: 'Custom QR Code Generator', + description: + 'Use single-code design workflows when you need more styling control than the current bulk flow exposes.', + ctaLabel: 'Design a custom QR code', + }, + { + href: '/pricing', + title: 'Pricing', + description: + 'Review which plan includes bulk creation and how it fits alongside dynamic QR and analytics features.', + ctaLabel: 'View pricing', + }, +]; + +export default function BulkQRCodeGeneratorPage() { + return ( + <> + + +
+
+
+ +
+
+
+ Business-plan spreadsheet workflow +
+ +
+

+ Bulk QR Code Generator +

+

+ Generate up to 1,000 static QR codes from a CSV or Excel file. Upload, + preview, download the batch as ZIP, or save it into your dashboard. +

+
+ +
+ {[ + 'CSV, XLS, and XLSX upload', + 'Up to 1,000 rows per upload', + 'Static QR code output', + 'ZIP download and optional save to dashboard', + ].map((feature) => ( +
+
+ + + +
+ {feature} +
+ ))} +
+ +
+ + + + + + +
+
+ +
+ +

Spreadsheet to ZIP workflow

+
+

products.xlsx

+

Upload, map, preview, generate

+
+
+ + + +
+
+ {[1, 2, 3, 4, 5, 6, 7, 8].map((item) => ( +
+ QR {item} +
+ ))} +
+

+ Designed for bulk static output, not dynamic tracking. +

+ +
+ Up to 1,000 rows +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+
+

What the current bulk flow supports

+

+ This section stays aligned with the actual Business-plan bulk creation experience in the app. +

+
+ +
+ {featureCards.map((feature) => ( + +

{feature.title}

+

{feature.description}

+ + ))} +
+
+
+ +
+
+
+

Example input content

+

+ The current workflow maps a title column and a content column. What you encode in the content field is up to the row data you provide. +

+
+ +
+ {inputExamples.map((example) => ( + +

{example.title}

+
+ {example.content} +
+

{example.note}

+ + ))} +
+
+
+ +
+
+
+

Where bulk generation fits best

+

+ Bulk creation is strongest when one spreadsheet feeds a real print, labeling, or operational workflow. +

+
+ +
+ {useCases.map((useCase) => ( + +

{useCase.title}

+

{useCase.description}

+
    + {useCase.points.map((point) => ( +
  • + + + + {point} +
    • + ))} +
+ + ))} +
+
+
+ + + +
+
+

Generate bulk QR codes without one-by-one setup

+

+ Use the Business-plan bulk flow when you need a large static QR batch from a single spreadsheet. +

+
+ + + + + + +
+
+
+
+ + ); +} diff --git a/src/app/(main)/(marketing)/dynamic-qr-code-generator/page.tsx b/src/app/(main)/(marketing)/dynamic-qr-code-generator/page.tsx index 940c5f3..e93dbec 100644 --- a/src/app/(main)/(marketing)/dynamic-qr-code-generator/page.tsx +++ b/src/app/(main)/(marketing)/dynamic-qr-code-generator/page.tsx @@ -1,546 +1,626 @@ -import React from 'react'; -import type { Metadata } from 'next'; -import { Button } from '@/components/ui/Button'; -import { Card } from '@/components/ui/Card'; -import SeoJsonLd from '@/components/SeoJsonLd'; -import Breadcrumbs, { BreadcrumbItem } from '@/components/Breadcrumbs'; -import { breadcrumbSchema } from '@/lib/schema'; -import { FAQSection } from '@/components/aeo/FAQSection'; -import { AnswerFirstBlock } from '@/components/marketing/AnswerFirstBlock'; -import { GrowthLinksSection } from '@/components/marketing/GrowthLinksSection'; -import { MarketingPageTracker, TrackedCtaLink } from '@/components/marketing/MarketingAnalytics'; -import { featuredUseCases } from '@/lib/growth-pages'; - -export const metadata: Metadata = { - title: { - absolute: 'Dynamic QR Code Generator - Edit Anytime', - }, - description: - 'Create dynamic QR codes that can be updated after printing. Change destinations later, review scan context, and keep printed materials useful for longer.', - keywords: - 'dynamic qr code generator, editable qr code, dynamic qr code, qr code tracking, update qr code after printing', - alternates: { - canonical: 'https://www.qrmaster.net/dynamic-qr-code-generator', - languages: { - 'x-default': 'https://www.qrmaster.net/dynamic-qr-code-generator', - en: 'https://www.qrmaster.net/dynamic-qr-code-generator', - }, - }, - openGraph: { - title: 'Dynamic QR Code Generator - Edit Anytime', - description: - 'Create dynamic QR codes that can be updated after printing. Change destinations later and review scan context from one dashboard.', - url: 'https://www.qrmaster.net/dynamic-qr-code-generator', - type: 'website', - images: ['/og-image.png'], - }, - twitter: { - title: 'Dynamic QR Code Generator - Edit Anytime', - description: - 'Create dynamic QR codes that can be updated after printing. Change destinations later and review scan context from one dashboard.', - }, -}; - -const featureCards = [ - { - title: 'Edit destination after print', - description: - 'Keep the same QR image on flyers, menus, packaging, or cards while the destination URL changes later.', - }, - { - title: 'Review scan context', - description: - 'See scan information in your dashboard, including time, device, and location context.', - }, - { - title: 'Apply brand styling', - description: - 'Use brand colors and logo styling so the QR code fits printed campaigns and product materials.', - }, - { - title: 'Manage active codes', - description: - 'Keep active dynamic QR codes in one dashboard instead of tracking versions across design files.', - }, - { - title: 'Use one print asset longer', - description: - 'Dynamic QR is useful when the printed surface should stay stable even as the linked page changes.', - }, - { - title: 'Scale by plan', - description: - 'The Free plan includes 3 active dynamic QR codes, Pro includes 50, and Business includes 500.', - }, -]; - -const staticVsDynamic = [ - { - feature: 'Change the destination after print', - static: false, - dynamic: true, - }, - { - feature: 'Review scan analytics later', - static: false, - dynamic: true, - }, - { - feature: 'Keep one print asset across changing campaigns', - static: false, - dynamic: true, - }, - { - feature: 'Manage active codes in a dashboard', - static: false, - dynamic: true, - }, - { - feature: 'Apply brand styling', - static: false, - dynamic: true, - }, -]; - -const useCases = [ - { - title: 'Marketing campaigns', - description: - 'Update campaign landing pages without reprinting flyers, posters, inserts, or signs.', - example: - 'Keep the printed QR live while the destination moves from teaser page to launch page.', - }, - { - title: 'Product packaging', - description: - 'Link packaging to manuals, onboarding pages, or support content and update that destination as stock stays in circulation.', - example: 'Update a software download or setup page without changing the package artwork.', - }, - { - title: 'Business cards', - description: - 'Route contacts to a current landing page, booking page, or profile without printing new cards.', - example: 'Keep the same printed card while your booking or profile destination changes.', - }, - { - title: 'Restaurant menus', - description: - 'Keep table cards useful when menu links, PDFs, or specials need to change after print.', - example: 'Update a menu destination for seasonal specials without replacing every table card.', - }, -]; - -const faqItems = [ - { - question: 'What is a dynamic QR code?', - answer: - 'A dynamic QR code points to a redirect URL, which lets you change the final destination later without replacing the printed QR image.', - }, - { - question: 'Can I change a dynamic QR code after printing?', - answer: - 'Yes. You keep the same QR image and update the destination from your dashboard.', - }, - { - question: 'How is it different from a static QR code?', - answer: - 'A static QR code stores the destination directly in the code and stays fixed. A dynamic QR code routes through QR Master so the destination can be updated and scans can be reviewed later.', - }, - { - question: 'How many dynamic QR codes can I create?', - answer: - 'The Free plan includes 3 active dynamic QR codes. Pro includes 50 dynamic QR codes, and Business includes 500 dynamic QR codes.', - }, -]; - -const softwareSchema = { - '@context': 'https://schema.org', - '@type': 'SoftwareApplication', - '@id': 'https://www.qrmaster.net/dynamic-qr-code-generator#software', - name: 'QR Master - Dynamic QR Code Generator', - applicationCategory: 'BusinessApplication', - operatingSystem: 'Web Browser', - offers: { - '@type': 'Offer', - price: '0', - priceCurrency: 'EUR', - availability: 'https://schema.org/InStock', - }, - description: - 'Create dynamic QR codes that can be updated after printing. Change destinations later and review scan context from one dashboard.', - featureList: [ - 'Edit QR code destinations after printing', - 'Review scan analytics in the dashboard', - 'Apply brand styling with colors and logo', - 'Manage active dynamic QR codes in one place', - 'Scale from 3 active dynamic QR codes on Free to 50 on Pro and 500 on Business', - ], -}; - -const howToSchema = { - '@context': 'https://schema.org', - '@type': 'HowTo', - '@id': 'https://www.qrmaster.net/dynamic-qr-code-generator#howto', - name: 'How to create a dynamic QR code', - description: 'Create a dynamic QR code and update the destination later without replacing the printed QR image.', - totalTime: 'PT3M', - step: [ - { - '@type': 'HowToStep', - position: 1, - name: 'Create an account', - text: 'Create a QR Master account and choose a dynamic QR workflow.', - url: 'https://www.qrmaster.net/signup', - }, - { - '@type': 'HowToStep', - position: 2, - name: 'Enter your destination', - text: 'Add the destination URL and style the QR code for print or digital use.', - url: 'https://www.qrmaster.net/signup', - }, - { - '@type': 'HowToStep', - position: 3, - name: 'Download and deploy', - text: 'Download the QR code and place it on printed or digital materials.', - }, - { - '@type': 'HowToStep', - position: 4, - name: 'Update later', - text: 'Change the destination from your dashboard without replacing the QR image.', - }, - ], -}; - -const faqSchema = { - '@context': 'https://schema.org', - '@type': 'FAQPage', - '@id': 'https://www.qrmaster.net/dynamic-qr-code-generator#faq', - mainEntity: faqItems.map((item) => ({ - '@type': 'Question', - name: item.question, - acceptedAnswer: { - '@type': 'Answer', - text: item.answer, - }, - })), -}; - -const breadcrumbItems: BreadcrumbItem[] = [ - { name: 'Home', url: '/' }, - { name: 'Dynamic QR Code Generator', url: '/dynamic-qr-code-generator' }, -]; - -const relatedUseCaseLinks = [ - { - href: featuredUseCases[0].href, - title: featuredUseCases[0].title, - description: featuredUseCases[0].summary, - ctaLabel: featuredUseCases[0].ctaLabel, - }, - { - href: '/use-cases/payment-qr-codes', - title: 'Payment QR Codes', - description: - 'Use one printed payment prompt that stays useful even when the checkout or provider path changes.', - ctaLabel: 'Create your payment QR code', - }, - { - href: featuredUseCases[1].href, - title: featuredUseCases[1].title, - description: featuredUseCases[1].summary, - ctaLabel: featuredUseCases[1].ctaLabel, - }, - { - href: '/use-cases', - title: 'Explore the use-case hub', - description: - 'See how dynamic QR workflows connect to commercial pages, tools, and support content.', - ctaLabel: 'Explore QR code use cases', - }, -]; - -export default function DynamicQRCodeGeneratorPage() { - return ( - <> - - -
-
-
- -
-
-
- Edit after printing -
- -
-

- Dynamic QR Code Generator -

-

- Create QR codes you can update after printing. Change the destination later, - review scan context, and keep printed materials useful for longer. -

-
- -
- {[ - 'Change the destination without replacing the printed QR image', - 'Review scan context in one dashboard', - 'Apply logo and brand colors', - 'Scale from 3 active dynamic QR codes on Free to 50 on Pro and 500 on Business', - ].map((feature) => ( -
-
- - - -
- {feature} -
- ))} -
- -
- - - - - - -
-
- -
- -
-
-
- QR Code -
-
-
-
-
- Current destination - launch.example -
-
- - - -
-
- Updated destination - menu.example -
-
-

- Same QR image, different destination later. -

- -
- No reprint needed -
-
-
-
-
- -
- -
- -
- -
- -
-
-
-

Dynamic vs static QR codes

-

- Dynamic QR is the better fit when the destination may change after the printed code is already in use. -

-
- - -
-
-

Feature

- {staticVsDynamic.map((item) => ( -
-

{item.feature}

-
- ))} -
-
-

Static QR

- {staticVsDynamic.map((item) => ( -
- - {item.static ? 'Yes' : 'No'} - -
- ))} -
-
-

Dynamic QR

- {staticVsDynamic.map((item) => ( -
- - {item.dynamic ? 'Yes' : 'No'} - -
- ))} -
-
- -
-
- -
-
-
-

What you can do with dynamic QR

-

- These are the core product benefits verified by the current QR Master flows and plan limits. -

-
- -
- {featureCards.map((feature) => ( - -

{feature.title}

-

{feature.description}

- - ))} -
-
-
- -
-
-
-

Where dynamic QR fits best

-

- Use dynamic QR where the destination may evolve after the printed material is already deployed. -

-
- -
- {useCases.map((useCase) => ( - -

{useCase.title}

-

{useCase.description}

-
-

- Example: {useCase.example} -

-
- - ))} -
-
-
- - - -
-
-

Start creating dynamic QR codes today

-

- Use one QR code that can keep working even when the destination behind it needs to change. -

-
- - - - - - -
-
-
-
- - ); -} +import React from 'react'; +import type { Metadata } from 'next'; +import { Button } from '@/components/ui/Button'; +import { Card } from '@/components/ui/Card'; +import SeoJsonLd from '@/components/SeoJsonLd'; +import Breadcrumbs, { BreadcrumbItem } from '@/components/Breadcrumbs'; +import { breadcrumbSchema } from '@/lib/schema'; +import { FAQSection } from '@/components/aeo/FAQSection'; +import { AnswerFirstBlock } from '@/components/marketing/AnswerFirstBlock'; +import { GrowthLinksSection } from '@/components/marketing/GrowthLinksSection'; +import { MarketingPageTracker, TrackedCtaLink } from '@/components/marketing/MarketingAnalytics'; +import { featuredUseCases } from '@/lib/growth-pages'; + +export const metadata: Metadata = { + title: { + absolute: 'Free Dynamic QR Code Generator – Update After Printing', + }, + description: + 'Create dynamic QR codes that you can edit after printing. Change the destination URL anytime, track scans, and manage all codes in one dashboard. Free to start.', + keywords: + 'dynamic qr code generator, editable qr code, dynamic qr code, qr code tracking, update qr code after printing', + alternates: { + canonical: 'https://www.qrmaster.net/dynamic-qr-code-generator', + languages: { + 'x-default': 'https://www.qrmaster.net/dynamic-qr-code-generator', + en: 'https://www.qrmaster.net/dynamic-qr-code-generator', + }, + }, + openGraph: { + title: 'Free Dynamic QR Code Generator – Update After Printing', + description: + 'Create dynamic QR codes that you can edit after printing. Change the destination URL anytime, track scans, and manage all codes in one dashboard.', + url: 'https://www.qrmaster.net/dynamic-qr-code-generator', + type: 'website', + images: ['/og-image.png'], + }, + twitter: { + title: 'Free Dynamic QR Code Generator – Update After Printing', + description: + 'Create dynamic QR codes that you can edit after printing. Change the destination URL anytime, track scans, and manage all codes in one dashboard.', + }, +}; + +const featureCards = [ + { + title: 'Edit destination after print', + description: + 'Keep the same QR image on flyers, menus, packaging, or cards while the destination URL changes later.', + }, + { + title: 'Review scan context', + description: + 'See scan information in your dashboard, including time, device, and location context.', + }, + { + title: 'Apply brand styling', + description: + 'Use brand colors and logo styling so the QR code fits printed campaigns and product materials.', + }, + { + title: 'Manage active codes', + description: + 'Keep active dynamic QR codes in one dashboard instead of tracking versions across design files.', + }, + { + title: 'Use one print asset longer', + description: + 'Dynamic QR is useful when the printed surface should stay stable even as the linked page changes.', + }, + { + title: 'Scale by plan', + description: + 'The Free plan includes 3 active dynamic QR codes, Pro includes 50, and Business includes 500.', + }, +]; + +const staticVsDynamic = [ + { + feature: 'Change the destination after print', + static: false, + dynamic: true, + }, + { + feature: 'Review scan analytics later', + static: false, + dynamic: true, + }, + { + feature: 'Keep one print asset across changing campaigns', + static: false, + dynamic: true, + }, + { + feature: 'Manage active codes in a dashboard', + static: false, + dynamic: true, + }, + { + feature: 'Apply brand styling', + static: false, + dynamic: true, + }, +]; + +const useCases = [ + { + title: 'Marketing campaigns', + description: + 'Update campaign landing pages without reprinting flyers, posters, inserts, or signs.', + example: + 'Keep the printed QR live while the destination moves from teaser page to launch page.', + }, + { + title: 'Product packaging', + description: + 'Link packaging to manuals, onboarding pages, or support content and update that destination as stock stays in circulation.', + example: 'Update a software download or setup page without changing the package artwork.', + }, + { + title: 'Business cards', + description: + 'Route contacts to a current landing page, booking page, or profile without printing new cards.', + example: 'Keep the same printed card while your booking or profile destination changes.', + }, + { + title: 'Restaurant menus', + description: + 'Keep table cards useful when menu links, PDFs, or specials need to change after print.', + example: 'Update a menu destination for seasonal specials without replacing every table card.', + }, +]; + +const faqItems = [ + { + question: 'What is a dynamic QR code?', + answer: + 'A dynamic QR code points to a redirect URL, which lets you change the final destination later without replacing the printed QR image.', + }, + { + question: 'Can I change a dynamic QR code after printing?', + answer: + 'Yes. You keep the same QR image and update the destination from your dashboard. The printed code never needs to be replaced.', + }, + { + question: 'How is it different from a static QR code?', + answer: + 'A static QR code stores the destination directly in the code and stays fixed. A dynamic QR code routes through QR Master so the destination can be updated and scans can be reviewed later.', + }, + { + question: 'How many dynamic QR codes can I create?', + answer: + 'The Free plan includes 3 active dynamic QR codes. Pro includes 50 dynamic QR codes, and Business includes 500 dynamic QR codes.', + }, + { + question: 'Is a dynamic QR code free?', + answer: + 'Yes — the Free plan includes 3 active dynamic QR codes at no cost. No credit card required to get started.', + }, + { + question: 'Can I track how many times a dynamic QR code was scanned?', + answer: + 'Yes. Every scan is logged in your dashboard with device type, time, and location context. Pro and Business plans include unlimited scan history.', + }, + { + question: 'How do I convert a static QR code to a dynamic one?', + answer: + 'You cannot convert an existing static QR code — the data is permanently encoded in the image. To switch to dynamic, create a new dynamic QR code in QR Master and replace the printed code.', + }, + { + question: 'What is the best use case for a dynamic QR code?', + answer: + 'Dynamic QR codes are ideal whenever the destination may change after printing: restaurant menus, marketing flyers, product packaging, business cards, and event materials.', + }, +]; + +const softwareSchema = { + '@context': 'https://schema.org', + '@type': 'SoftwareApplication', + '@id': 'https://www.qrmaster.net/dynamic-qr-code-generator#software', + name: 'QR Master - Dynamic QR Code Generator', + applicationCategory: 'BusinessApplication', + operatingSystem: 'Web Browser', + offers: { + '@type': 'Offer', + price: '0', + priceCurrency: 'EUR', + availability: 'https://schema.org/InStock', + }, + description: + 'Create dynamic QR codes that can be updated after printing. Change destinations later and review scan context from one dashboard.', + featureList: [ + 'Edit QR code destinations after printing', + 'Review scan analytics in the dashboard', + 'Apply brand styling with colors and logo', + 'Manage active dynamic QR codes in one place', + 'Scale from 3 active dynamic QR codes on Free to 50 on Pro and 500 on Business', + ], +}; + +const howToSchema = { + '@context': 'https://schema.org', + '@type': 'HowTo', + '@id': 'https://www.qrmaster.net/dynamic-qr-code-generator#howto', + name: 'How to create a dynamic QR code', + description: 'Create a dynamic QR code and update the destination later without replacing the printed QR image.', + totalTime: 'PT3M', + step: [ + { + '@type': 'HowToStep', + position: 1, + name: 'Create an account', + text: 'Create a QR Master account and choose a dynamic QR workflow.', + url: 'https://www.qrmaster.net/signup', + }, + { + '@type': 'HowToStep', + position: 2, + name: 'Enter your destination', + text: 'Add the destination URL and style the QR code for print or digital use.', + url: 'https://www.qrmaster.net/signup', + }, + { + '@type': 'HowToStep', + position: 3, + name: 'Download and deploy', + text: 'Download the QR code and place it on printed or digital materials.', + }, + { + '@type': 'HowToStep', + position: 4, + name: 'Update later', + text: 'Change the destination from your dashboard without replacing the QR image.', + }, + ], +}; + +const faqSchema = { + '@context': 'https://schema.org', + '@type': 'FAQPage', + '@id': 'https://www.qrmaster.net/dynamic-qr-code-generator#faq', + mainEntity: faqItems.map((item) => ({ + '@type': 'Question', + name: item.question, + acceptedAnswer: { + '@type': 'Answer', + text: item.answer, + }, + })), +}; + +const breadcrumbItems: BreadcrumbItem[] = [ + { name: 'Home', url: '/' }, + { name: 'Dynamic QR Code Generator', url: '/dynamic-qr-code-generator' }, +]; + +const relatedUseCaseLinks = [ + { + href: featuredUseCases[0].href, + title: featuredUseCases[0].title, + description: featuredUseCases[0].summary, + ctaLabel: featuredUseCases[0].ctaLabel, + }, + { + href: '/use-cases/payment-qr-codes', + title: 'Payment QR Codes', + description: + 'Use one printed payment prompt that stays useful even when the checkout or provider path changes.', + ctaLabel: 'Create your payment QR code', + }, + { + href: featuredUseCases[1].href, + title: featuredUseCases[1].title, + description: featuredUseCases[1].summary, + ctaLabel: featuredUseCases[1].ctaLabel, + }, + { + href: '/use-cases', + title: 'Explore the use-case hub', + description: + 'See how dynamic QR workflows connect to commercial pages, tools, and support content.', + ctaLabel: 'Explore QR code use cases', + }, +]; + +export default function DynamicQRCodeGeneratorPage() { + return ( + <> + + +
+
+
+ +
+
+
+ Edit after printing +
+ +
+

+ Dynamic QR Code Generator +

+

+ Create QR codes you can update after printing. Change the destination later, + review scan context, and keep printed materials useful for longer. +

+
+ +
+ {[ + 'Change the destination without replacing the printed QR image', + 'Review scan context in one dashboard', + 'Apply logo and brand colors', + 'Scale from 3 active dynamic QR codes on Free to 50 on Pro and 500 on Business', + ].map((feature) => ( +
+
+ + + +
+ {feature} +
+ ))} +
+ +
+ + + + + + +
+
+ +
+ +
+
+ + {/* Top-left position detection pattern */} + + + + {/* Top-right position detection pattern */} + + + + {/* Bottom-left position detection pattern */} + + + + {/* Data modules */} + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + {/* Center logo area */} + + + Q + +
+
+
+
+ Current destination + launch.example +
+
+ + + +
+
+ Updated destination + menu.example +
+
+

+ Same QR image, different destination later. +

+ +
+ No reprint needed +
+
+
+
+
+ +
+

How to Create a Free Dynamic QR Code

+ +
+ +
+ +
+ +
+
+
+

Dynamic vs static QR codes

+

+ Dynamic QR is the better fit when the destination may change after the printed code is already in use. +

+
+ + +
+
+

Feature

+ {staticVsDynamic.map((item) => ( +
+

{item.feature}

+
+ ))} +
+
+

Static QR

+ {staticVsDynamic.map((item) => ( +
+ + {item.static ? 'Yes' : 'No'} + +
+ ))} +
+
+

Dynamic QR

+ {staticVsDynamic.map((item) => ( +
+ + {item.dynamic ? 'Yes' : 'No'} + +
+ ))} +
+
+ +
+
+ +
+
+
+

What you can do with dynamic QR

+

+ These are the core product benefits verified by the current QR Master flows and plan limits. +

+
+ +
+ {featureCards.map((feature) => ( + +

{feature.title}

+

{feature.description}

+ + ))} +
+
+
+ +
+
+
+

Where dynamic QR fits best

+

+ Use dynamic QR where the destination may evolve after the printed material is already deployed. +

+
+ +
+ {useCases.map((useCase) => ( + +

{useCase.title}

+

{useCase.description}

+
+

+ Example: {useCase.example} +

+
+ + ))} +
+
+
+ + + +
+
+

Start creating dynamic QR codes today

+

+ Use one QR code that can keep working even when the destination behind it needs to change. +

+
+ + + + + + +
+
+
+
+ + ); +} diff --git a/src/app/(main)/(marketing)/faq/page.tsx b/src/app/(main)/(marketing)/faq/page.tsx index e9392a3..1baab9c 100644 --- a/src/app/(main)/(marketing)/faq/page.tsx +++ b/src/app/(main)/(marketing)/faq/page.tsx @@ -1,243 +1,243 @@ -import React from 'react'; -import type { Metadata } from 'next'; -import Link from 'next/link'; -import SeoJsonLd from '@/components/SeoJsonLd'; -import { faqPageSchema } from '@/lib/schema'; -import { Card, CardContent } from '@/components/ui/Card'; -import { ObfuscatedMailto } from '@/components/ui/ObfuscatedMailto'; - -function truncateAtWord(text: string, maxLength: number): string { - if (text.length <= maxLength) return text; - const truncated = text.slice(0, maxLength); - const lastSpace = truncated.lastIndexOf(' '); - return lastSpace > 0 ? truncated.slice(0, lastSpace) : truncated; -} - -export async function generateMetadata(): Promise { - const title = truncateAtWord('QR Master FAQ: Dynamic, Tracking, Bulk, and Print', 60); - const description = truncateAtWord( - 'Answers about dynamic QR codes, scan tracking, privacy, bulk creation, and print setup.', - 160 - ); - - return { - title, - description, - alternates: { - canonical: 'https://www.qrmaster.net/faq', - languages: { - 'x-default': 'https://www.qrmaster.net/faq', - en: 'https://www.qrmaster.net/faq', - }, - }, - openGraph: { - title, - description, - url: 'https://www.qrmaster.net/faq', - type: 'website', - images: [ - { - url: 'https://www.qrmaster.net/og-image.png', - width: 1200, - height: 630, - alt: 'QR Master FAQ', - }, - ], - }, - twitter: { - title, - description, - }, - }; -} - -type FAQItemWithRichText = { - question: string; - answer: string; - answerRich?: React.ReactNode; -}; - -const faqs: FAQItemWithRichText[] = [ - { - question: 'What is a dynamic QR code?', - answer: - 'A dynamic QR code points to a redirect URL, so you can change the final destination later without replacing the printed QR image.', - answerRich: ( - <> - A dynamic QR code points to a redirect URL, so you can change the final destination later without replacing the printed QR image. -
-
- Why teams use it: -
    -
  • Update the destination after print
    • -
  • Review scan analytics later
    • -
  • Keep one printed QR in use across changing campaigns or content
    • -
- - ), - }, - { - question: 'How do I track QR scans?', - answer: - 'QR Master tracks scans through the dynamic QR redirect step. The analytics views can report time, device, location context, and total or unique scan activity.', - answerRich: ( - <> - QR Master tracks scans through the dynamic QR redirect step. -
-
- Current analytics context: -
    -
  • Total and unique scan reporting
    • -
  • Device type
    • -
  • Location context
    • -
  • Time-based scan activity
    • -
-
- - Learn more about tracking - - - ), - }, - { - question: 'What security measures are in place?', - answer: - 'QR Master uses HTTPS/TLS, CSRF protection for relevant write actions, and rate limiting on API routes.', - answerRich: ( - <> - QR Master uses standard protective controls that are visible in the current codebase. -
-
- Security-related controls: -
    -
  • HTTPS/TLS encryption for all connections
    • -
  • CSRF protection for relevant write actions
    • -
  • Rate limiting on API routes
    • -
- - ), - }, - { - question: 'How does bulk QR creation work today?', - answer: - 'QR Master currently supports bulk QR creation through spreadsheet upload in the Business plan. The flow accepts CSV, XLS, and XLSX files, supports up to 1,000 rows per upload, and generates static QR codes.', - answerRich: ( - <> - QR Master currently supports bulk QR creation through spreadsheet upload in the Business plan. -
-
- Current bulk flow facts: -
    -
  • CSV, XLS, and XLSX uploads are supported
    • -
  • Up to 1,000 rows per upload
    • -
  • Output is static QR codes, not dynamic tracking batches
    • -
-
- - See the bulk QR workflow - - - ), - }, - { - question: 'What are the best practices for printing QR codes?', - answer: - 'For reliable scanning, keep the QR code at least 2x2 cm for close-range use, maintain strong contrast, leave a quiet zone around the code, and use SVG or a high-resolution PNG for output.', - answerRich: ( - <> - For reliable scanning, follow these print-first basics: -
-
-
    -
  • Minimum size around 2x2 cm for close-range scans
    • -
  • Dark foreground on a light background
    • -
  • Leave a quiet zone around the QR code
    • -
  • Use SVG or a high-resolution PNG depending on the print workflow
    • -
- - ), - }, - { - question: 'Is the service privacy-conscious?', - answer: - 'QR Master minimizes scanner data collection. Privacy-related measures visible in the product context include hashed or anonymized IP handling and no scanner PII storage.', - answerRich: ( - <> - QR Master is built around minimal scanner data collection. -
-
- Privacy-related measures: -
    -
  • IP addresses are anonymized or hashed
    • -
  • No scanner PII storage
    • -
-
- - Read the privacy policy - - - ), - }, - { - question: 'What is the difference between static and dynamic QR codes?', - answer: - 'Static QR codes store the destination directly in the image and stay fixed. Dynamic QR codes route through QR Master so the destination can be changed later and scan analytics can be reviewed.', - answerRich: ( - <> - Static QR codes store the destination directly in the image and stay fixed. - Dynamic QR codes route through QR Master so the destination can be changed later and scan analytics can be reviewed. -
-
- - Create a dynamic QR code - - - ), - }, -]; - -export default function FAQPage() { - return ( - <> - ({ question, answer })))} /> -
-
-
-
-

- Frequently Asked Questions -

-

- Answers about dynamic QR codes, scan tracking, privacy, bulk creation, and print setup. -

-

Last updated: March 12, 2026

-
- -
- {faqs.map((faq) => ( - - -

{faq.question}

-
{faq.answerRich || faq.answer}
- - - ))} -
- -
-

Still have questions?

-

- Our support team is here to help. Contact us at{' '} - {' '} - and include the workflow you are trying to build. -

-
-
-
-
- - ); -} +import React from 'react'; +import type { Metadata } from 'next'; +import Link from 'next/link'; +import SeoJsonLd from '@/components/SeoJsonLd'; +import { faqPageSchema } from '@/lib/schema'; +import { Card, CardContent } from '@/components/ui/Card'; +import { ObfuscatedMailto } from '@/components/ui/ObfuscatedMailto'; + +function truncateAtWord(text: string, maxLength: number): string { + if (text.length <= maxLength) return text; + const truncated = text.slice(0, maxLength); + const lastSpace = truncated.lastIndexOf(' '); + return lastSpace > 0 ? truncated.slice(0, lastSpace) : truncated; +} + +export async function generateMetadata(): Promise { + const title = truncateAtWord('QR Master FAQ: Dynamic, Tracking, Bulk, and Print', 60); + const description = truncateAtWord( + 'Answers about dynamic QR codes, scan tracking, privacy, bulk creation, and print setup.', + 160 + ); + + return { + title, + description, + alternates: { + canonical: 'https://www.qrmaster.net/faq', + languages: { + 'x-default': 'https://www.qrmaster.net/faq', + en: 'https://www.qrmaster.net/faq', + }, + }, + openGraph: { + title, + description, + url: 'https://www.qrmaster.net/faq', + type: 'website', + images: [ + { + url: 'https://www.qrmaster.net/og-image.png', + width: 1200, + height: 630, + alt: 'QR Master FAQ', + }, + ], + }, + twitter: { + title, + description, + }, + }; +} + +type FAQItemWithRichText = { + question: string; + answer: string; + answerRich?: React.ReactNode; +}; + +const faqs: FAQItemWithRichText[] = [ + { + question: 'What is a dynamic QR code?', + answer: + 'A dynamic QR code points to a redirect URL, so you can change the final destination later without replacing the printed QR image.', + answerRich: ( + <> + A dynamic QR code points to a redirect URL, so you can change the final destination later without replacing the printed QR image. +
+
+ Why teams use it: +
    +
  • Update the destination after print
    • +
  • Review scan analytics later
    • +
  • Keep one printed QR in use across changing campaigns or content
    • +
+ + ), + }, + { + question: 'How do I track QR scans?', + answer: + 'QR Master tracks scans through the dynamic QR redirect step. The analytics views can report time, device, location context, and total or unique scan activity.', + answerRich: ( + <> + QR Master tracks scans through the dynamic QR redirect step. +
+
+ Current analytics context: +
    +
  • Total and unique scan reporting
    • +
  • Device type
    • +
  • Location context
    • +
  • Time-based scan activity
    • +
+
+ + Learn more about tracking + + + ), + }, + { + question: 'What security measures are in place?', + answer: + 'QR Master uses HTTPS/TLS, CSRF protection for relevant write actions, and rate limiting on API routes.', + answerRich: ( + <> + QR Master uses standard protective controls that are visible in the current codebase. +
+
+ Security-related controls: +
    +
  • HTTPS/TLS encryption for all connections
    • +
  • CSRF protection for relevant write actions
    • +
  • Rate limiting on API routes
    • +
+ + ), + }, + { + question: 'How does bulk QR creation work today?', + answer: + 'QR Master currently supports bulk QR creation through spreadsheet upload in the Business plan. The flow accepts CSV, XLS, and XLSX files, supports up to 1,000 rows per upload, and generates static QR codes.', + answerRich: ( + <> + QR Master currently supports bulk QR creation through spreadsheet upload in the Business plan. +
+
+ Current bulk flow facts: +
    +
  • CSV, XLS, and XLSX uploads are supported
    • +
  • Up to 1,000 rows per upload
    • +
  • Output is static QR codes, not dynamic tracking batches
    • +
+
+ + See the bulk QR workflow + + + ), + }, + { + question: 'What are the best practices for printing QR codes?', + answer: + 'For reliable scanning, keep the QR code at least 2x2 cm for close-range use, maintain strong contrast, leave a quiet zone around the code, and use SVG or a high-resolution PNG for output.', + answerRich: ( + <> + For reliable scanning, follow these print-first basics: +
+
+
    +
  • Minimum size around 2x2 cm for close-range scans
    • +
  • Dark foreground on a light background
    • +
  • Leave a quiet zone around the QR code
    • +
  • Use SVG or a high-resolution PNG depending on the print workflow
    • +
+ + ), + }, + { + question: 'Is the service privacy-conscious?', + answer: + 'QR Master minimizes scanner data collection. Privacy-related measures visible in the product context include hashed or anonymized IP handling and no scanner PII storage.', + answerRich: ( + <> + QR Master is built around minimal scanner data collection. +
+
+ Privacy-related measures: +
    +
  • IP addresses are anonymized or hashed
    • +
  • No scanner PII storage
    • +
+
+ + Read the privacy policy + + + ), + }, + { + question: 'What is the difference between static and dynamic QR codes?', + answer: + 'Static QR codes store the destination directly in the image and stay fixed. Dynamic QR codes route through QR Master so the destination can be changed later and scan analytics can be reviewed.', + answerRich: ( + <> + Static QR codes store the destination directly in the image and stay fixed. + Dynamic QR codes route through QR Master so the destination can be changed later and scan analytics can be reviewed. +
+
+ + Create a dynamic QR code + + + ), + }, +]; + +export default function FAQPage() { + return ( + <> + ({ question, answer })))} /> +
+
+
+
+

+ Frequently Asked Questions +

+

+ Answers about dynamic QR codes, scan tracking, privacy, bulk creation, and print setup. +

+

Last updated: March 12, 2026

+
+ +
+ {faqs.map((faq) => ( + + +

{faq.question}

+
{faq.answerRich || faq.answer}
+ + + ))} +
+ +
+

Still have questions?

+

+ Our support team is here to help. Contact us at{' '} + {' '} + and include the workflow you are trying to build. +

+
+
+
+
+ + ); +} diff --git a/src/app/(main)/(marketing)/manage-qr-codes/page.tsx b/src/app/(main)/(marketing)/manage-qr-codes/page.tsx index 04dc30a..7fc69f9 100644 --- a/src/app/(main)/(marketing)/manage-qr-codes/page.tsx +++ b/src/app/(main)/(marketing)/manage-qr-codes/page.tsx @@ -1,389 +1,389 @@ -import React from 'react'; -import type { Metadata } from 'next'; -import Link from 'next/link'; -import { Button } from '@/components/ui/Button'; -import { Card } from '@/components/ui/Card'; -import SeoJsonLd from '@/components/SeoJsonLd'; -import Breadcrumbs, { BreadcrumbItem } from '@/components/Breadcrumbs'; -import { breadcrumbSchema, faqPageSchema } from '@/lib/schema'; -import { AnswerFirstBlock } from '@/components/marketing/AnswerFirstBlock'; -import { FAQSection } from '@/components/aeo/FAQSection'; - -export const metadata: Metadata = { - title: { - absolute: 'Manage QR Codes - Dashboard, Edits, and Analytics', - }, - description: - 'Manage QR codes in one dashboard. Review active codes, edit dynamic destinations, see scan totals and unique scans, and work within current Free, Pro, or Business limits.', - keywords: [ - 'manage qr codes', - 'qr code dashboard', - 'edit dynamic qr codes', - 'qr code analytics dashboard', - 'qr code management', - ], - alternates: { - canonical: 'https://www.qrmaster.net/manage-qr-codes', - languages: { - 'x-default': 'https://www.qrmaster.net/manage-qr-codes', - en: 'https://www.qrmaster.net/manage-qr-codes', - }, - }, - openGraph: { - title: 'Manage QR Codes - Dashboard, Edits, and Analytics', - description: - 'Use one dashboard to review QR codes, edit dynamic destinations, and check scan totals and unique scans.', - url: 'https://www.qrmaster.net/manage-qr-codes', - type: 'website', - images: [ - { - url: '/images/og/og-manage-qr-codes.png', - width: 1200, - height: 630, - }, - ], - }, - twitter: { - title: 'Manage QR Codes - Dashboard, Edits, and Analytics', - description: - 'Use one dashboard to review QR codes, edit dynamic destinations, and check scan totals and unique scans.', - }, -}; - -const verifiedCapabilities = [ - { - title: 'Central dashboard', - description: - 'The dashboard lists your QR codes in one place instead of forcing you to manage separate files or links manually.', - }, - { - title: 'Dynamic destination edits', - description: - 'Dynamic QR codes can be edited after print. Static QR codes remain fixed.', - }, - { - title: 'Scan reporting', - description: - 'The current dashboard reports total scans, active codes, and unique scans, with analytics pages adding more context.', - }, - { - title: 'Plan-based limits', - description: - 'Free includes 3 dynamic QR codes, Pro includes 50, and Business includes 500. Static QR codes remain unlimited.', - }, - { - title: 'Tags and status', - description: - 'QR code records support tags and active status, which helps keep batches and single-code workflows easier to review.', - }, - { - title: 'Download and delete actions', - description: - 'Each QR code card supports view, download, edit for dynamic QR codes, and delete actions from the dashboard surface.', - }, -]; - -const operationalUseCases = [ - { - title: 'Marketing campaigns', - description: - 'Review active dynamic QR codes, compare scan totals, and update destinations when campaigns or landing pages change.', - points: ['One list of active codes', 'Scan totals and unique scans', 'Edit dynamic destinations'], - }, - { - title: 'Restaurants and hospitality', - description: - 'Keep menu or table-card QR codes current from the dashboard instead of reprinting every time the destination changes.', - points: ['Update menu destinations', 'Monitor scan activity', 'Keep print assets in use longer'], - }, - { - title: 'Product and packaging workflows', - description: - 'Track which QR codes are active, save batches to the dashboard, and separate static bulk output from dynamic campaign codes.', - points: ['Save generated QR codes', 'Review active status', 'Manage static and dynamic codes separately'], - }, - { - title: 'Small team or solo workflows', - description: - 'Use one account to keep QR code creation, edits, downloads, and analytics in one operational place.', - points: ['Single dashboard view', 'No spreadsheet-only workflow', 'Clear plan limits'], - }, -]; - -const faqItems = [ - { - question: 'What does it mean to manage QR codes?', - answer: - 'In QR Master, managing QR codes means using one dashboard to review your QR codes, edit dynamic destinations, download files, and check scan activity instead of tracking everything manually.', - }, - { - question: 'Can I edit a QR code after printing it?', - answer: - 'Yes, if it is a dynamic QR code. Static QR codes stay fixed after creation.', - }, - { - question: 'How many dynamic QR codes can I manage?', - answer: - 'Free includes 3 dynamic QR codes, Pro includes 50, and Business includes 500. Static QR codes are unlimited.', - }, - { - question: 'What analytics are visible today?', - answer: - 'The current dashboard shows total scans, active QR codes, and unique scans. Additional analytics views add more scan context such as time, device, and location.', - }, - { - question: 'Does the current product include team roles or API-based QR management?', - answer: - 'This page only reflects the verified current surface: dashboard management, dynamic edits, analytics, downloads, tags, and plan limits. It does not claim team roles or public API-based QR management as current verified capabilities.', - }, -]; - -const softwareSchema = { - '@context': 'https://schema.org', - '@type': 'SoftwareApplication', - '@id': 'https://www.qrmaster.net/manage-qr-codes#software', - name: 'QR Master - QR Code Management Dashboard', - applicationCategory: 'BusinessApplication', - offers: { - '@type': 'AggregateOffer', - lowPrice: '0', - highPrice: '29', - priceCurrency: 'EUR', - }, - featureList: [ - 'Central QR code dashboard', - 'Edit dynamic QR code destinations', - 'Review total and unique scan counts', - 'Download QR codes as PNG or SVG', - 'Tag QR code records and review active status', - 'Manage current plan limits for dynamic QR codes', - ], -}; - -const breadcrumbItems: BreadcrumbItem[] = [ - { name: 'Home', url: '/' }, - { name: 'Manage QR Codes', url: '/manage-qr-codes' }, -]; - -export default function ManageQRCodesPage() { - return ( - <> - - -
-
-
- -
-
-
- Dashboard-first QR management -
- -
-

- Manage QR Codes from one dashboard -

-

- Review active QR codes, edit dynamic destinations, download files, and - monitor scan totals from one place instead of managing printed QR workflows manually. -

-
- -
- {[ - 'See QR codes in one dashboard', - 'Edit dynamic destinations after print', - 'Review total scans, active codes, and unique scans', - 'Work within the current Free, Pro, and Business dynamic QR limits', - ].map((feature) => ( -
-
- - - -
- {feature} -
- ))} -
- -
- - - - - - -
-
- -
- -

Dashboard snapshot

-
-
-
- Active QR codes - 3 / 50 / 500 -
-
Plan-based dynamic QR capacity
-
-
-
-
Total scans
-
Dashboard metric
-
-
-
Unique scans
-
Dashboard metric
-
-
-
-
Available actions
-
- View details - Download PNG - Download SVG - Edit dynamic QR - Delete -
-
-
- -
-
-
-
- -
- -
- -
- -
- -
-
-
-

What the current dashboard supports

-

- These capabilities are tied to the present product surface rather than future or inferred roadmap features. -

-
- -
- {verifiedCapabilities.map((feature) => ( - -

{feature.title}

-

{feature.description}

- - ))} -
-
-
- -
-
-
-

Where QR management is most useful

-

- Use the dashboard when your QR workflows need ongoing edits, downloads, and visibility instead of one-off creation. -

-
- -
- {operationalUseCases.map((useCase) => ( - -

{useCase.title}

-

{useCase.description}

-
    - {useCase.points.map((point) => ( -
  • - - - - {point} -
    • - ))} -
- - ))} -
-
-
- -
-
-

Start managing your QR codes with one account

-

- Keep dynamic updates, downloads, and scan reporting in one dashboard instead of spreading the workflow across files and ad hoc links. -

-
- - - - - - -
-
-
-
- - ); -} +import React from 'react'; +import type { Metadata } from 'next'; +import Link from 'next/link'; +import { Button } from '@/components/ui/Button'; +import { Card } from '@/components/ui/Card'; +import SeoJsonLd from '@/components/SeoJsonLd'; +import Breadcrumbs, { BreadcrumbItem } from '@/components/Breadcrumbs'; +import { breadcrumbSchema, faqPageSchema } from '@/lib/schema'; +import { AnswerFirstBlock } from '@/components/marketing/AnswerFirstBlock'; +import { FAQSection } from '@/components/aeo/FAQSection'; + +export const metadata: Metadata = { + title: { + absolute: 'Manage QR Codes - Dashboard, Edits, and Analytics', + }, + description: + 'Manage QR codes in one dashboard. Review active codes, edit dynamic destinations, see scan totals and unique scans, and work within current Free, Pro, or Business limits.', + keywords: [ + 'manage qr codes', + 'qr code dashboard', + 'edit dynamic qr codes', + 'qr code analytics dashboard', + 'qr code management', + ], + alternates: { + canonical: 'https://www.qrmaster.net/manage-qr-codes', + languages: { + 'x-default': 'https://www.qrmaster.net/manage-qr-codes', + en: 'https://www.qrmaster.net/manage-qr-codes', + }, + }, + openGraph: { + title: 'Manage QR Codes - Dashboard, Edits, and Analytics', + description: + 'Use one dashboard to review QR codes, edit dynamic destinations, and check scan totals and unique scans.', + url: 'https://www.qrmaster.net/manage-qr-codes', + type: 'website', + images: [ + { + url: '/images/og/og-manage-qr-codes.png', + width: 1200, + height: 630, + }, + ], + }, + twitter: { + title: 'Manage QR Codes - Dashboard, Edits, and Analytics', + description: + 'Use one dashboard to review QR codes, edit dynamic destinations, and check scan totals and unique scans.', + }, +}; + +const verifiedCapabilities = [ + { + title: 'Central dashboard', + description: + 'The dashboard lists your QR codes in one place instead of forcing you to manage separate files or links manually.', + }, + { + title: 'Dynamic destination edits', + description: + 'Dynamic QR codes can be edited after print. Static QR codes remain fixed.', + }, + { + title: 'Scan reporting', + description: + 'The current dashboard reports total scans, active codes, and unique scans, with analytics pages adding more context.', + }, + { + title: 'Plan-based limits', + description: + 'Free includes 3 dynamic QR codes, Pro includes 50, and Business includes 500. Static QR codes remain unlimited.', + }, + { + title: 'Tags and status', + description: + 'QR code records support tags and active status, which helps keep batches and single-code workflows easier to review.', + }, + { + title: 'Download and delete actions', + description: + 'Each QR code card supports view, download, edit for dynamic QR codes, and delete actions from the dashboard surface.', + }, +]; + +const operationalUseCases = [ + { + title: 'Marketing campaigns', + description: + 'Review active dynamic QR codes, compare scan totals, and update destinations when campaigns or landing pages change.', + points: ['One list of active codes', 'Scan totals and unique scans', 'Edit dynamic destinations'], + }, + { + title: 'Restaurants and hospitality', + description: + 'Keep menu or table-card QR codes current from the dashboard instead of reprinting every time the destination changes.', + points: ['Update menu destinations', 'Monitor scan activity', 'Keep print assets in use longer'], + }, + { + title: 'Product and packaging workflows', + description: + 'Track which QR codes are active, save batches to the dashboard, and separate static bulk output from dynamic campaign codes.', + points: ['Save generated QR codes', 'Review active status', 'Manage static and dynamic codes separately'], + }, + { + title: 'Small team or solo workflows', + description: + 'Use one account to keep QR code creation, edits, downloads, and analytics in one operational place.', + points: ['Single dashboard view', 'No spreadsheet-only workflow', 'Clear plan limits'], + }, +]; + +const faqItems = [ + { + question: 'What does it mean to manage QR codes?', + answer: + 'In QR Master, managing QR codes means using one dashboard to review your QR codes, edit dynamic destinations, download files, and check scan activity instead of tracking everything manually.', + }, + { + question: 'Can I edit a QR code after printing it?', + answer: + 'Yes, if it is a dynamic QR code. Static QR codes stay fixed after creation.', + }, + { + question: 'How many dynamic QR codes can I manage?', + answer: + 'Free includes 3 dynamic QR codes, Pro includes 50, and Business includes 500. Static QR codes are unlimited.', + }, + { + question: 'What analytics are visible today?', + answer: + 'The current dashboard shows total scans, active QR codes, and unique scans. Additional analytics views add more scan context such as time, device, and location.', + }, + { + question: 'Does the current product include team roles or API-based QR management?', + answer: + 'This page only reflects the verified current surface: dashboard management, dynamic edits, analytics, downloads, tags, and plan limits. It does not claim team roles or public API-based QR management as current verified capabilities.', + }, +]; + +const softwareSchema = { + '@context': 'https://schema.org', + '@type': 'SoftwareApplication', + '@id': 'https://www.qrmaster.net/manage-qr-codes#software', + name: 'QR Master - QR Code Management Dashboard', + applicationCategory: 'BusinessApplication', + offers: { + '@type': 'AggregateOffer', + lowPrice: '0', + highPrice: '29', + priceCurrency: 'EUR', + }, + featureList: [ + 'Central QR code dashboard', + 'Edit dynamic QR code destinations', + 'Review total and unique scan counts', + 'Download QR codes as PNG or SVG', + 'Tag QR code records and review active status', + 'Manage current plan limits for dynamic QR codes', + ], +}; + +const breadcrumbItems: BreadcrumbItem[] = [ + { name: 'Home', url: '/' }, + { name: 'Manage QR Codes', url: '/manage-qr-codes' }, +]; + +export default function ManageQRCodesPage() { + return ( + <> + + +
+
+
+ +
+
+
+ Dashboard-first QR management +
+ +
+

+ Manage QR Codes from one dashboard +

+

+ Review active QR codes, edit dynamic destinations, download files, and + monitor scan totals from one place instead of managing printed QR workflows manually. +

+
+ +
+ {[ + 'See QR codes in one dashboard', + 'Edit dynamic destinations after print', + 'Review total scans, active codes, and unique scans', + 'Work within the current Free, Pro, and Business dynamic QR limits', + ].map((feature) => ( +
+
+ + + +
+ {feature} +
+ ))} +
+ +
+ + + + + + +
+
+ +
+ +

Dashboard snapshot

+
+
+
+ Active QR codes + 3 / 50 / 500 +
+
Plan-based dynamic QR capacity
+
+
+
+
Total scans
+
Dashboard metric
+
+
+
Unique scans
+
Dashboard metric
+
+
+
+
Available actions
+
+ View details + Download PNG + Download SVG + Edit dynamic QR + Delete +
+
+
+ +
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+
+

What the current dashboard supports

+

+ These capabilities are tied to the present product surface rather than future or inferred roadmap features. +

+
+ +
+ {verifiedCapabilities.map((feature) => ( + +

{feature.title}

+

{feature.description}

+ + ))} +
+
+
+ +
+
+
+

Where QR management is most useful

+

+ Use the dashboard when your QR workflows need ongoing edits, downloads, and visibility instead of one-off creation. +

+
+ +
+ {operationalUseCases.map((useCase) => ( + +

{useCase.title}

+

{useCase.description}

+
    + {useCase.points.map((point) => ( +
  • + + + + {point} +
    • + ))} +
+ + ))} +
+
+
+ +
+
+

Start managing your QR codes with one account

+

+ Keep dynamic updates, downloads, and scan reporting in one dashboard instead of spreading the workflow across files and ad hoc links. +

+
+ + + + + + +
+
+
+
+ + ); +} diff --git a/src/app/(main)/(marketing)/pricing/page.tsx b/src/app/(main)/(marketing)/pricing/page.tsx index 6049516..bdae6c6 100644 --- a/src/app/(main)/(marketing)/pricing/page.tsx +++ b/src/app/(main)/(marketing)/pricing/page.tsx @@ -1,118 +1,118 @@ -import React from 'react'; -import type { Metadata } from 'next'; -import PricingClient from './PricingClient'; -import SeoJsonLd from '@/components/SeoJsonLd'; -import { AnswerFirstBlock } from '@/components/marketing/AnswerFirstBlock'; -import { FAQSection } from '@/components/aeo/FAQSection'; -import { breadcrumbSchema, faqPageSchema } from '@/lib/schema'; - -export const metadata: Metadata = { - title: { - absolute: 'Pricing Plans | QR Master', - }, - description: - 'Compare QR Master pricing plans. Free includes 3 active dynamic QR codes, Pro includes 50, and Business includes 500 plus bulk QR creation.', - alternates: { - canonical: 'https://www.qrmaster.net/pricing', - }, - robots: { - index: true, - follow: true, - }, - openGraph: { - title: 'Pricing Plans | QR Master', - description: - 'Compare QR Master pricing plans. Free includes 3 active dynamic QR codes, Pro includes 50, and Business includes 500 plus bulk QR creation.', - url: 'https://www.qrmaster.net/pricing', - type: 'website', - images: [ - { - url: 'https://www.qrmaster.net/og-image.png', - width: 1200, - height: 630, - alt: 'QR Master Pricing Plans', - }, - ], - }, -}; - -const faqItems = [ - { - question: 'How many dynamic QR codes are included in each plan?', - answer: - 'Free includes 3 active dynamic QR codes. Pro includes 50 dynamic QR codes. Business includes 500 dynamic QR codes.', - }, - { - question: 'Do all plans include static QR codes?', - answer: - 'Yes. All plans include unlimited static QR codes.', - }, - { - question: 'Which plan includes bulk QR creation?', - answer: - 'Bulk QR creation is included in the Business plan.', - }, - { - question: 'Which plans include analytics and branding?', - answer: - 'The Free plan includes basic scan tracking. Pro adds advanced analytics and custom branding. Business includes everything from Pro plus bulk QR creation and priority email support.', - }, -]; - -const breadcrumbItems = [ - { name: 'Home', url: '/' }, - { name: 'Pricing', url: '/pricing' }, -]; - -export default function PricingPage() { - return ( - <> - - -
-
- -
- -
- -
- -
-

Compare our plans

-

- Free includes 3 active dynamic QR codes and unlimited static QR codes. Pro - includes 50 dynamic QR codes, advanced analytics, and custom branding. - Business includes 500 dynamic QR codes, everything from Pro, bulk QR creation - up to 1,000, and priority email support. -

-
- - -
- - ); -} +import React from 'react'; +import type { Metadata } from 'next'; +import PricingClient from './PricingClient'; +import SeoJsonLd from '@/components/SeoJsonLd'; +import { AnswerFirstBlock } from '@/components/marketing/AnswerFirstBlock'; +import { FAQSection } from '@/components/aeo/FAQSection'; +import { breadcrumbSchema, faqPageSchema } from '@/lib/schema'; + +export const metadata: Metadata = { + title: { + absolute: 'Pricing Plans | QR Master', + }, + description: + 'Compare QR Master pricing plans. Free includes 3 active dynamic QR codes, Pro includes 50, and Business includes 500 plus bulk QR creation.', + alternates: { + canonical: 'https://www.qrmaster.net/pricing', + }, + robots: { + index: true, + follow: true, + }, + openGraph: { + title: 'Pricing Plans | QR Master', + description: + 'Compare QR Master pricing plans. Free includes 3 active dynamic QR codes, Pro includes 50, and Business includes 500 plus bulk QR creation.', + url: 'https://www.qrmaster.net/pricing', + type: 'website', + images: [ + { + url: 'https://www.qrmaster.net/og-image.png', + width: 1200, + height: 630, + alt: 'QR Master Pricing Plans', + }, + ], + }, +}; + +const faqItems = [ + { + question: 'How many dynamic QR codes are included in each plan?', + answer: + 'Free includes 3 active dynamic QR codes. Pro includes 50 dynamic QR codes. Business includes 500 dynamic QR codes.', + }, + { + question: 'Do all plans include static QR codes?', + answer: + 'Yes. All plans include unlimited static QR codes.', + }, + { + question: 'Which plan includes bulk QR creation?', + answer: + 'Bulk QR creation is included in the Business plan.', + }, + { + question: 'Which plans include analytics and branding?', + answer: + 'The Free plan includes basic scan tracking. Pro adds advanced analytics and custom branding. Business includes everything from Pro plus bulk QR creation and priority email support.', + }, +]; + +const breadcrumbItems = [ + { name: 'Home', url: '/' }, + { name: 'Pricing', url: '/pricing' }, +]; + +export default function PricingPage() { + return ( + <> + + +
+
+ +
+ +
+ +
+ +
+

Compare our plans

+

+ Free includes 3 active dynamic QR codes and unlimited static QR codes. Pro + includes 50 dynamic QR codes, advanced analytics, and custom branding. + Business includes 500 dynamic QR codes, everything from Pro, bulk QR creation + up to 1,000, and priority email support. +

+
+ + +
+ + ); +} diff --git a/src/app/(main)/(marketing)/qr-code-analytics/page.tsx b/src/app/(main)/(marketing)/qr-code-analytics/page.tsx index d968b8d..ae27b27 100644 --- a/src/app/(main)/(marketing)/qr-code-analytics/page.tsx +++ b/src/app/(main)/(marketing)/qr-code-analytics/page.tsx @@ -1,143 +1,143 @@ -import type { Metadata } from "next"; - -import { - buildUseCaseMetadata, - UseCasePageTemplate, -} from "@/components/marketing/UseCasePageTemplate"; - -export const metadata: Metadata = buildUseCaseMetadata({ - title: "QR Code Analytics", - description: - "Measure QR code scans by placement, timing, device context, and campaign route so offline workflows become reportable.", - canonicalPath: "/qr-code-analytics", -}); - -const softwareSchema = { - "@context": "https://schema.org", - "@type": "SoftwareApplication", - "@id": "https://www.qrmaster.net/qr-code-analytics#software", - name: "QR Master - QR Code Analytics", - applicationCategory: "BusinessApplication", - operatingSystem: "Web Browser", - offers: { - "@type": "Offer", - price: "0", - priceCurrency: "USD", - availability: "https://schema.org/InStock", - }, - description: - "QR analytics software for measuring scans by placement, timing, device context, and offline campaign routing.", - featureList: [ - "Placement-level scan reporting", - "Device and timing context", - "Offline-to-online campaign attribution", - "Scan visibility across print workflows", - "Destination updates without reprinting", - ], -}; - -export default function QRCodeAnalyticsPage() { - return ( - - ); -} +import type { Metadata } from "next"; + +import { + buildUseCaseMetadata, + UseCasePageTemplate, +} from "@/components/marketing/UseCasePageTemplate"; + +export const metadata: Metadata = buildUseCaseMetadata({ + title: "QR Code Analytics", + description: + "Measure QR code scans by placement, timing, device context, and campaign route so offline workflows become reportable.", + canonicalPath: "/qr-code-analytics", +}); + +const softwareSchema = { + "@context": "https://schema.org", + "@type": "SoftwareApplication", + "@id": "https://www.qrmaster.net/qr-code-analytics#software", + name: "QR Master - QR Code Analytics", + applicationCategory: "BusinessApplication", + operatingSystem: "Web Browser", + offers: { + "@type": "Offer", + price: "0", + priceCurrency: "USD", + availability: "https://schema.org/InStock", + }, + description: + "QR analytics software for measuring scans by placement, timing, device context, and offline campaign routing.", + featureList: [ + "Placement-level scan reporting", + "Device and timing context", + "Offline-to-online campaign attribution", + "Scan visibility across print workflows", + "Destination updates without reprinting", + ], +}; + +export default function QRCodeAnalyticsPage() { + return ( + + ); +} diff --git a/src/app/(main)/(marketing)/qr-code-for-marketing-campaigns/page.tsx b/src/app/(main)/(marketing)/qr-code-for-marketing-campaigns/page.tsx index f42553c..86ccfd8 100644 --- a/src/app/(main)/(marketing)/qr-code-for-marketing-campaigns/page.tsx +++ b/src/app/(main)/(marketing)/qr-code-for-marketing-campaigns/page.tsx @@ -1,112 +1,112 @@ -import type { Metadata } from "next"; - -import { - buildUseCaseMetadata, - UseCasePageTemplate, -} from "@/components/marketing/UseCasePageTemplate"; - -export const metadata: Metadata = buildUseCaseMetadata({ - title: "QR Codes for Marketing Campaigns", - description: - "Plan QR codes for marketing campaigns around placement tracking, changing destinations, and offline-to-online attribution.", - canonicalPath: "/qr-code-for-marketing-campaigns", -}); - -export default function QRCodeForMarketingCampaignsPage() { - return ( - - ); -} +import type { Metadata } from "next"; + +import { + buildUseCaseMetadata, + UseCasePageTemplate, +} from "@/components/marketing/UseCasePageTemplate"; + +export const metadata: Metadata = buildUseCaseMetadata({ + title: "QR Codes for Marketing Campaigns", + description: + "Plan QR codes for marketing campaigns around placement tracking, changing destinations, and offline-to-online attribution.", + canonicalPath: "/qr-code-for-marketing-campaigns", +}); + +export default function QRCodeForMarketingCampaignsPage() { + return ( + + ); +} diff --git a/src/app/(main)/(marketing)/qr-code-tracking/page.tsx b/src/app/(main)/(marketing)/qr-code-tracking/page.tsx index 51099af..12a5b99 100644 --- a/src/app/(main)/(marketing)/qr-code-tracking/page.tsx +++ b/src/app/(main)/(marketing)/qr-code-tracking/page.tsx @@ -1,517 +1,527 @@ -import React from 'react'; -import type { Metadata } from 'next'; -import { Button } from '@/components/ui/Button'; -import { Card } from '@/components/ui/Card'; -import SeoJsonLd from '@/components/SeoJsonLd'; -import Breadcrumbs, { BreadcrumbItem } from '@/components/Breadcrumbs'; -import { breadcrumbSchema } from '@/lib/schema'; -import { AnswerFirstBlock } from '@/components/marketing/AnswerFirstBlock'; -import { FAQSection } from '@/components/aeo/FAQSection'; -import { GrowthLinksSection } from '@/components/marketing/GrowthLinksSection'; -import { MarketingPageTracker, TrackedCtaLink } from '@/components/marketing/MarketingAnalytics'; - -export const metadata: Metadata = { - title: { - absolute: 'QR Code Tracking & Analytics - Track Every Scan', - }, - description: - 'Track QR code scans with analytics for time, device, and location context. Use dynamic QR codes to measure placements and keep printed campaigns accountable.', - keywords: - 'qr code tracking, qr code analytics, track qr scans, dynamic qr tracking, qr scan analytics', - alternates: { - canonical: 'https://www.qrmaster.net/qr-code-tracking', - languages: { - 'x-default': 'https://www.qrmaster.net/qr-code-tracking', - en: 'https://www.qrmaster.net/qr-code-tracking', - }, - }, - openGraph: { - title: 'QR Code Tracking & Analytics - Track Every Scan', - description: - 'Track QR code scans with analytics for time, device, and location context. Use dynamic QR codes to measure placements and campaigns.', - url: 'https://www.qrmaster.net/qr-code-tracking', - type: 'website', - images: ['/og-image.png'], - }, - twitter: { - title: 'QR Code Tracking & Analytics - Track Every Scan', - description: - 'Track QR code scans with analytics for time, device, and location context. Use dynamic QR codes to measure placements and campaigns.', - }, -}; - -const trackingFeatures = [ - { - title: 'Time-based scan activity', - description: - 'Review when scans happen so you can compare campaign bursts, peak service windows, or event timing.', - }, - { - title: 'Location context', - description: - 'See country, city, and region-level scan context in the dashboard to understand where scans are coming from.', - }, - { - title: 'Device mix', - description: - 'Understand whether scans are happening on phone or desktop-heavy traffic patterns and adapt landing pages accordingly.', - }, - { - title: 'Total and unique scan reporting', - description: - 'Use scan counts to understand overall activity and compare repeated scans with broader reach.', - }, - { - title: 'Placement-ready measurement', - description: - 'Track scans from print surfaces such as flyers, menus, signs, packaging, and event materials.', - }, - { - title: 'Dynamic QR workflow', - description: - 'Tracking works with dynamic QR codes that route through QR Master before the scanner reaches the final destination.', - }, -]; - -const trackingUseCases = [ - { - title: 'Marketing campaigns', - description: - 'Measure how printed placements such as flyers, signs, packaging inserts, or booth materials perform over time.', - benefits: ['Compare placements', 'Review campaign timing', 'See scan context in one dashboard'], - }, - { - title: 'Events', - description: - 'Track which event materials drive scans before, during, and after the event instead of treating every print touchpoint the same.', - benefits: ['Compare booth and signage scans', 'Watch event-day traffic', 'Keep destinations updateable'], - }, - { - title: 'Product and packaging', - description: - 'Measure which labels, inserts, or support links are getting scans after products leave the warehouse.', - benefits: ['Track support content usage', 'Compare packaging placements', 'Keep links current'], - }, - { - title: 'Restaurant and in-store surfaces', - description: - 'Review scans from menus, table cards, windows, or counters and compare when in-store prompts actually get used.', - benefits: ['Spot peak scan periods', 'Compare service surfaces', 'Keep menu links current'], - }, -]; - -const trackingComparison = [ - { feature: 'Destination can change later', static: false, dynamic: true }, - { feature: 'Scan analytics', static: false, dynamic: true }, - { feature: 'Placement comparison after print', static: false, dynamic: true }, - { feature: 'Reusable for campaigns that evolve', static: false, dynamic: true }, -]; - -const faqItems = [ - { - question: 'Can I track a static QR code?', - answer: - 'Static QR codes store the destination directly in the image, so QR Master cannot add the redirect step needed for tracking. Tracking requires a dynamic QR workflow.', - }, - { - question: 'What can I measure with QR code tracking?', - answer: - 'QR Master can report scan activity such as time, device, and location context, along with total and unique scan reporting in the analytics views.', - }, - { - question: 'Why does tracking use a dynamic QR code?', - answer: - 'Tracking happens during the redirect step. A dynamic QR code routes the scan through QR Master first, which makes scan reporting possible before the user reaches the final destination.', - }, - { - question: 'When is QR code tracking most useful?', - answer: - 'It is most useful when you need to compare placements, campaign timing, or printed surfaces and want a measurable record instead of guessing which QR code prompt worked.', - }, -]; - -const softwareSchema = { - '@context': 'https://schema.org', - '@type': 'SoftwareApplication', - '@id': 'https://www.qrmaster.net/qr-code-tracking#software', - name: 'QR Master - QR Code Tracking & Analytics', - applicationCategory: 'BusinessApplication', - operatingSystem: 'Web Browser', - offers: { - '@type': 'Offer', - price: '0', - priceCurrency: 'EUR', - availability: 'https://schema.org/InStock', - }, - description: - 'Track QR code scans with analytics for time, device, and location context. Use dynamic QR codes to measure placements and campaigns.', - featureList: [ - 'Time-based scan reporting', - 'Location context in analytics', - 'Device mix reporting', - 'Total and unique scan reporting', - 'Dynamic QR workflow for trackable printed placements', - ], -}; - -const howToSchema = { - '@context': 'https://schema.org', - '@type': 'HowTo', - '@id': 'https://www.qrmaster.net/qr-code-tracking#howto', - name: 'How to track QR code scans', - description: 'Create a dynamic QR code, deploy it, and review scan analytics from the QR Master dashboard.', - totalTime: 'PT5M', - step: [ - { - '@type': 'HowToStep', - position: 1, - name: 'Create a dynamic QR code', - text: 'Create a dynamic QR code in QR Master so the scan can route through the tracking step first.', - url: 'https://www.qrmaster.net/signup', - }, - { - '@type': 'HowToStep', - position: 2, - name: 'Deploy the QR code', - text: 'Place the QR code on the flyer, menu, sign, package, or event material you want to measure.', - }, - { - '@type': 'HowToStep', - position: 3, - name: 'Review analytics', - text: 'Open the dashboard to review scan context such as time, device, location, and total activity.', - }, - { - '@type': 'HowToStep', - position: 4, - name: 'Improve the next placement', - text: 'Use the scan patterns to improve your next campaign, placement, or destination update.', - }, - ], -}; - -const faqSchema = { - '@context': 'https://schema.org', - '@type': 'FAQPage', - '@id': 'https://www.qrmaster.net/qr-code-tracking#faq', - mainEntity: faqItems.map((item) => ({ - '@type': 'Question', - name: item.question, - acceptedAnswer: { - '@type': 'Answer', - text: item.answer, - }, - })), -}; - -const breadcrumbItems: BreadcrumbItem[] = [ - { name: 'Home', url: '/' }, - { name: 'QR Code Tracking', url: '/qr-code-tracking' }, -]; - -const relatedUseCaseLinks = [ - { - href: '/use-cases/real-estate-sign-qr-codes', - title: 'Real Estate Sign QR Codes', - description: - 'Compare sign, brochure, and open-house scans without blending every property source together.', - ctaLabel: 'Create your real estate QR code', - }, - { - href: '/use-cases/feedback-qr-codes', - title: 'Feedback QR Codes', - description: - 'Measure which service surfaces and follow-up prompts actually generate customer responses.', - ctaLabel: 'Create your feedback QR code', - }, - { - href: '/use-cases/coupon-qr-codes', - title: 'Coupon QR Codes', - description: - 'Tie printed discount placements to measurable scans so you can compare promotion performance.', - ctaLabel: 'Create your coupon QR code', - }, - { - href: '/use-cases', - title: 'Explore the use-case hub', - description: - 'Browse the first commercial workflows built around dynamic updates and measurable scans.', - ctaLabel: 'Explore QR code use cases', - }, -]; - -export default function QRCodeTrackingPage() { - return ( - <> - - -
-
-
- -
-
-
- Trackable dynamic QR workflows -
- -
-

- Track every QR code scan with useful context -

-

- Use dynamic QR codes to measure scans by time, device, and location context, - so printed campaigns and physical placements stop being guesswork. -

-
- -
- {[ - 'Track printed placements with a dynamic QR workflow', - 'Review time, device, and location context', - 'Compare total and unique scan activity', - 'Use one dashboard to improve the next campaign or placement', - ].map((feature) => ( -
-
- - - -
- {feature} -
- ))} -
- -
- - - - - - -
-
- -
- -

Analytics overview

-
-
- Placement view - Flyer, sign, menu, package -
-
- Time trend - Hourly and daily patterns -
-
- Location context - Country, city, region -
-
- Device mix - Phone or desktop traffic -
-
- -
- Dynamic QR required -
-
-
-
-
- -
- -
- -
- -
- -
-
-
-

What QR tracking helps you measure

-

- These are the analytics surfaces the current product experience already supports without inventing extra claims. -

-
- -
- {trackingFeatures.map((feature) => ( - -

{feature.title}

-

{feature.description}

- - ))} -
-
-
- -
-
-
-

Tracking setup comparison

-

- Tracking is a dynamic QR workflow, not a static QR workflow with retroactive reporting. -

-
- - - - - - - - - - - - {trackingComparison.map((row) => ( - - - - - - ))} - -
CapabilityStatic QRDynamic QR tracking
{row.feature}{row.static ? 'Yes' : 'No'} - {row.dynamic ? 'Yes' : 'No'} -
- -
-
- -
-
-
-

Where tracking is most useful

-

- Use tracking where physical surfaces or campaigns need measurable follow-through after they are deployed. -

-
- -
- {trackingUseCases.map((useCase) => ( - -

{useCase.title}

-

{useCase.description}

-
    - {useCase.benefits.map((benefit) => ( -
  • - - - - {benefit} -
    • - ))} -
- - ))} -
-
-
- - - -
-
-

Start tracking your QR codes today

-

- Measure scans with enough context to improve the next placement, campaign, or printed workflow. -

-
- - - - - - -
-
-
-
- - ); -} +import React from 'react'; +import type { Metadata } from 'next'; +import { Button } from '@/components/ui/Button'; +import { Card } from '@/components/ui/Card'; +import SeoJsonLd from '@/components/SeoJsonLd'; +import Breadcrumbs, { BreadcrumbItem } from '@/components/Breadcrumbs'; +import { breadcrumbSchema } from '@/lib/schema'; +import { AnswerFirstBlock } from '@/components/marketing/AnswerFirstBlock'; +import { FAQSection } from '@/components/aeo/FAQSection'; +import { GrowthLinksSection } from '@/components/marketing/GrowthLinksSection'; +import { MarketingPageTracker, TrackedCtaLink } from '@/components/marketing/MarketingAnalytics'; + +export const metadata: Metadata = { + title: { + absolute: 'Free QR Code Tracking & Analytics – Track Every Scan', + }, + description: + 'Track QR code scans for free. See time, device, and location data for every scan. Use dynamic QR codes to measure printed campaigns and placements from one dashboard.', + keywords: + 'qr code tracking, qr code analytics, track qr scans, dynamic qr tracking, qr scan analytics', + alternates: { + canonical: 'https://www.qrmaster.net/qr-code-tracking', + languages: { + 'x-default': 'https://www.qrmaster.net/qr-code-tracking', + en: 'https://www.qrmaster.net/qr-code-tracking', + }, + }, + openGraph: { + title: 'Free QR Code Tracking & Analytics – Track Every Scan', + description: + 'Track QR code scans with analytics for time, device, and location context. Use dynamic QR codes to measure placements and campaigns.', + url: 'https://www.qrmaster.net/qr-code-tracking', + type: 'website', + images: ['/og-image.png'], + }, + twitter: { + title: 'QR Code Tracking & Analytics - Track Every Scan', + description: + 'Track QR code scans with analytics for time, device, and location context. Use dynamic QR codes to measure placements and campaigns.', + }, +}; + +const trackingFeatures = [ + { + title: 'Time-based scan activity', + description: + 'Review when scans happen so you can compare campaign bursts, peak service windows, or event timing.', + }, + { + title: 'Location context', + description: + 'See country, city, and region-level scan context in the dashboard to understand where scans are coming from.', + }, + { + title: 'Device mix', + description: + 'Understand whether scans are happening on phone or desktop-heavy traffic patterns and adapt landing pages accordingly.', + }, + { + title: 'Total and unique scan reporting', + description: + 'Use scan counts to understand overall activity and compare repeated scans with broader reach.', + }, + { + title: 'Placement-ready measurement', + description: + 'Track scans from print surfaces such as flyers, menus, signs, packaging, and event materials.', + }, + { + title: 'Dynamic QR workflow', + description: + 'Tracking works with dynamic QR codes that route through QR Master before the scanner reaches the final destination.', + }, +]; + +const trackingUseCases = [ + { + title: 'Marketing campaigns', + description: + 'Measure how printed placements such as flyers, signs, packaging inserts, or booth materials perform over time.', + benefits: ['Compare placements', 'Review campaign timing', 'See scan context in one dashboard'], + }, + { + title: 'Events', + description: + 'Track which event materials drive scans before, during, and after the event instead of treating every print touchpoint the same.', + benefits: ['Compare booth and signage scans', 'Watch event-day traffic', 'Keep destinations updateable'], + }, + { + title: 'Product and packaging', + description: + 'Measure which labels, inserts, or support links are getting scans after products leave the warehouse.', + benefits: ['Track support content usage', 'Compare packaging placements', 'Keep links current'], + }, + { + title: 'Restaurant and in-store surfaces', + description: + 'Review scans from menus, table cards, windows, or counters and compare when in-store prompts actually get used.', + benefits: ['Spot peak scan periods', 'Compare service surfaces', 'Keep menu links current'], + }, +]; + +const trackingComparison = [ + { feature: 'Destination can change later', static: false, dynamic: true }, + { feature: 'Scan analytics', static: false, dynamic: true }, + { feature: 'Placement comparison after print', static: false, dynamic: true }, + { feature: 'Reusable for campaigns that evolve', static: false, dynamic: true }, +]; + +const faqItems = [ + { + question: 'Can I track a static QR code?', + answer: + 'Static QR codes store the destination directly in the image, so QR Master cannot add the redirect step needed for tracking. Tracking requires a dynamic QR workflow.', + }, + { + question: 'What can I measure with QR code tracking?', + answer: + 'QR Master reports scan activity including time of scan, device type (mobile vs. desktop), and location context (country, city). You can also compare total scans vs. unique scans.', + }, + { + question: 'Why does tracking use a dynamic QR code?', + answer: + 'Tracking happens during the redirect step. A dynamic QR code routes the scan through QR Master first, which makes scan reporting possible before the user reaches the final destination.', + }, + { + question: 'When is QR code tracking most useful?', + answer: + 'It is most useful when you need to compare placements, campaign timing, or printed surfaces and want a measurable record instead of guessing which QR code prompt worked.', + }, + { + question: 'Is QR code scan tracking free?', + answer: + 'Yes — the Free plan includes basic scan tracking for up to 3 active dynamic QR codes. Pro and Business plans include extended scan history, more active codes, and full analytics.', + }, + { + question: 'Can I see unlimited scan history?', + answer: + 'Pro and Business plans include extended scan history and no limits on how many scans are tracked. The Free plan covers tracking for up to 3 active dynamic QR codes.', + }, +]; + +const softwareSchema = { + '@context': 'https://schema.org', + '@type': 'SoftwareApplication', + '@id': 'https://www.qrmaster.net/qr-code-tracking#software', + name: 'QR Master - QR Code Tracking & Analytics', + applicationCategory: 'BusinessApplication', + operatingSystem: 'Web Browser', + offers: { + '@type': 'Offer', + price: '0', + priceCurrency: 'EUR', + availability: 'https://schema.org/InStock', + }, + description: + 'Track QR code scans with analytics for time, device, and location context. Use dynamic QR codes to measure placements and campaigns.', + featureList: [ + 'Time-based scan reporting', + 'Location context in analytics', + 'Device mix reporting', + 'Total and unique scan reporting', + 'Dynamic QR workflow for trackable printed placements', + ], +}; + +const howToSchema = { + '@context': 'https://schema.org', + '@type': 'HowTo', + '@id': 'https://www.qrmaster.net/qr-code-tracking#howto', + name: 'How to track QR code scans', + description: 'Create a dynamic QR code, deploy it, and review scan analytics from the QR Master dashboard.', + totalTime: 'PT5M', + step: [ + { + '@type': 'HowToStep', + position: 1, + name: 'Create a dynamic QR code', + text: 'Create a dynamic QR code in QR Master so the scan can route through the tracking step first.', + url: 'https://www.qrmaster.net/signup', + }, + { + '@type': 'HowToStep', + position: 2, + name: 'Deploy the QR code', + text: 'Place the QR code on the flyer, menu, sign, package, or event material you want to measure.', + }, + { + '@type': 'HowToStep', + position: 3, + name: 'Review analytics', + text: 'Open the dashboard to review scan context such as time, device, location, and total activity.', + }, + { + '@type': 'HowToStep', + position: 4, + name: 'Improve the next placement', + text: 'Use the scan patterns to improve your next campaign, placement, or destination update.', + }, + ], +}; + +const faqSchema = { + '@context': 'https://schema.org', + '@type': 'FAQPage', + '@id': 'https://www.qrmaster.net/qr-code-tracking#faq', + mainEntity: faqItems.map((item) => ({ + '@type': 'Question', + name: item.question, + acceptedAnswer: { + '@type': 'Answer', + text: item.answer, + }, + })), +}; + +const breadcrumbItems: BreadcrumbItem[] = [ + { name: 'Home', url: '/' }, + { name: 'QR Code Tracking', url: '/qr-code-tracking' }, +]; + +const relatedUseCaseLinks = [ + { + href: '/use-cases/real-estate-sign-qr-codes', + title: 'Real Estate Sign QR Codes', + description: + 'Compare sign, brochure, and open-house scans without blending every property source together.', + ctaLabel: 'Create your real estate QR code', + }, + { + href: '/use-cases/feedback-qr-codes', + title: 'Feedback QR Codes', + description: + 'Measure which service surfaces and follow-up prompts actually generate customer responses.', + ctaLabel: 'Create your feedback QR code', + }, + { + href: '/use-cases/coupon-qr-codes', + title: 'Coupon QR Codes', + description: + 'Tie printed discount placements to measurable scans so you can compare promotion performance.', + ctaLabel: 'Create your coupon QR code', + }, + { + href: '/use-cases', + title: 'Explore the use-case hub', + description: + 'Browse the first commercial workflows built around dynamic updates and measurable scans.', + ctaLabel: 'Explore QR code use cases', + }, +]; + +export default function QRCodeTrackingPage() { + return ( + <> + + +
+
+
+ +
+
+
+ Trackable dynamic QR workflows +
+ +
+

+ Track every QR code scan with useful context +

+

+ Use dynamic QR codes to measure scans by time, device, and location context, + so printed campaigns and physical placements stop being guesswork. +

+
+ +
+ {[ + 'Track printed placements with a dynamic QR workflow', + 'Review time, device, and location context', + 'Compare total and unique scan activity', + 'Use one dashboard to improve the next campaign or placement', + ].map((feature) => ( +
+
+ + + +
+ {feature} +
+ ))} +
+ +
+ + + + + + +
+
+ +
+ +

Analytics overview

+
+
+ Placement view + Flyer, sign, menu, package +
+
+ Time trend + Hourly and daily patterns +
+
+ Location context + Country, city, region +
+
+ Device mix + Phone or desktop traffic +
+
+ +
+ Dynamic QR required +
+
+
+
+
+ +
+ +
+ +
+ +
+ +
+
+
+

What QR tracking helps you measure

+

+ These are the analytics surfaces the current product experience already supports without inventing extra claims. +

+
+ +
+ {trackingFeatures.map((feature) => ( + +

{feature.title}

+

{feature.description}

+ + ))} +
+
+
+ +
+
+
+

Tracking setup comparison

+

+ Tracking is a dynamic QR workflow, not a static QR workflow with retroactive reporting. +

+
+ + + + + + + + + + + + {trackingComparison.map((row) => ( + + + + + + ))} + +
CapabilityStatic QRDynamic QR tracking
{row.feature}{row.static ? 'Yes' : 'No'} + {row.dynamic ? 'Yes' : 'No'} +
+ +
+
+ +
+
+
+

Where tracking is most useful

+

+ Use tracking where physical surfaces or campaigns need measurable follow-through after they are deployed. +

+
+ +
+ {trackingUseCases.map((useCase) => ( + +

{useCase.title}

+

{useCase.description}

+
    + {useCase.benefits.map((benefit) => ( +
  • + + + + {benefit} +
    • + ))} +
+ + ))} +
+
+
+ + + +
+
+

Start tracking your QR codes today

+

+ Measure scans with enough context to improve the next placement, campaign, or printed workflow. +

+
+ + + + + + +
+
+
+
+ + ); +} diff --git a/src/app/(main)/(marketing)/testimonials/page.tsx b/src/app/(main)/(marketing)/testimonials/page.tsx index 8a9ef61..547aea5 100644 --- a/src/app/(main)/(marketing)/testimonials/page.tsx +++ b/src/app/(main)/(marketing)/testimonials/page.tsx @@ -1,143 +1,143 @@ -import React from 'react'; -import Link from 'next/link'; -import { Metadata } from 'next'; -import { Button } from '@/components/ui/Button'; -import SeoJsonLd from '@/components/SeoJsonLd'; -import { organizationSchema, reviewSchema, aggregateRatingSchema } from '@/lib/schema'; -import { testimonials, getAggregateRating } from '@/lib/testimonial-data'; -import { Testimonials } from '@/components/marketing/Testimonials'; -import { Star } from 'lucide-react'; - -function truncateAtWord(text: string, maxLength: number): string { - if (text.length <= maxLength) return text; - const truncated = text.slice(0, maxLength); - const lastSpace = truncated.lastIndexOf(' '); - return lastSpace > 0 ? truncated.slice(0, lastSpace) : truncated; -} - -export async function generateMetadata(): Promise { - const title = truncateAtWord('Customer Testimonials | QR Master Reviews', 60); - const description = truncateAtWord( - 'Read what our customers say about QR Master. Real reviews from businesses using dynamic QR codes for restaurants, pottery, retail, events, and more.', - 160 - ); - - return { - title, - description, - keywords: ['qr master reviews', 'qr code testimonials', 'customer reviews', 'qr code generator reviews', 'dynamic qr code reviews'], - alternates: { - canonical: 'https://www.qrmaster.net/testimonials', - }, - openGraph: { - title, - description, - url: 'https://www.qrmaster.net/testimonials', - type: 'website', - images: [ - { - url: 'https://www.qrmaster.net/og-image.png', - width: 1200, - height: 630, - alt: 'QR Master Customer Testimonials', - }, - ], - }, - twitter: { - title, - description, - }, - }; -} - -export default function TestimonialsPage() { - const aggregateRating = getAggregateRating(); - const reviewSchemas = testimonials.map(t => reviewSchema(t)); - - return ( - <> - - -
- {/* Hero Section with Aggregate Rating */} -
-
-

- Customer Testimonials -

-

- Real experiences from businesses using QR Master to create dynamic QR codes -

- - {/* Aggregate Rating Display */} -
-
- {[...Array(5)].map((_, index) => ( - - ))} -
-

- {aggregateRating.ratingValue} out of 5 stars -

-

- Based on {aggregateRating.reviewCount} {aggregateRating.reviewCount === 1 ? 'review' : 'reviews'} -

-
- -
- - - -
-
-
- - {/* Testimonials Grid */} - - - {/* CTA Section */} -
-
-

- Ready to create your own QR codes? -

-

- Join businesses using QR Master to create dynamic, trackable QR codes for their products, menus, events, and campaigns. -

-
- - - - - - -
-
-
- - -
- - ); -} +import React from 'react'; +import Link from 'next/link'; +import { Metadata } from 'next'; +import { Button } from '@/components/ui/Button'; +import SeoJsonLd from '@/components/SeoJsonLd'; +import { organizationSchema, reviewSchema, aggregateRatingSchema } from '@/lib/schema'; +import { testimonials, getAggregateRating } from '@/lib/testimonial-data'; +import { Testimonials } from '@/components/marketing/Testimonials'; +import { Star } from 'lucide-react'; + +function truncateAtWord(text: string, maxLength: number): string { + if (text.length <= maxLength) return text; + const truncated = text.slice(0, maxLength); + const lastSpace = truncated.lastIndexOf(' '); + return lastSpace > 0 ? truncated.slice(0, lastSpace) : truncated; +} + +export async function generateMetadata(): Promise { + const title = truncateAtWord('Customer Testimonials | QR Master Reviews', 60); + const description = truncateAtWord( + 'Read what our customers say about QR Master. Real reviews from businesses using dynamic QR codes for restaurants, pottery, retail, events, and more.', + 160 + ); + + return { + title, + description, + keywords: ['qr master reviews', 'qr code testimonials', 'customer reviews', 'qr code generator reviews', 'dynamic qr code reviews'], + alternates: { + canonical: 'https://www.qrmaster.net/testimonials', + }, + openGraph: { + title, + description, + url: 'https://www.qrmaster.net/testimonials', + type: 'website', + images: [ + { + url: 'https://www.qrmaster.net/og-image.png', + width: 1200, + height: 630, + alt: 'QR Master Customer Testimonials', + }, + ], + }, + twitter: { + title, + description, + }, + }; +} + +export default function TestimonialsPage() { + const aggregateRating = getAggregateRating(); + const reviewSchemas = testimonials.map(t => reviewSchema(t)); + + return ( + <> + + +
+ {/* Hero Section with Aggregate Rating */} +
+
+

+ Customer Testimonials +

+

+ Real experiences from businesses using QR Master to create dynamic QR codes +

+ + {/* Aggregate Rating Display */} +
+
+ {[...Array(5)].map((_, index) => ( + + ))} +
+

+ {aggregateRating.ratingValue} out of 5 stars +

+

+ Based on {aggregateRating.reviewCount} {aggregateRating.reviewCount === 1 ? 'review' : 'reviews'} +

+
+ +
+ + + +
+
+
+ + {/* Testimonials Grid */} + + + {/* CTA Section */} +
+
+

+ Ready to create your own QR codes? +

+

+ Join businesses using QR Master to create dynamic, trackable QR codes for their products, menus, events, and campaigns. +

+
+ + + + + + +
+
+
+ + +
+ + ); +} diff --git a/src/app/(main)/(marketing)/tools/barcode-generator/BarcodeFormatPicker.tsx b/src/app/(main)/(marketing)/tools/barcode-generator/BarcodeFormatPicker.tsx new file mode 100644 index 0000000..2b49bd6 --- /dev/null +++ b/src/app/(main)/(marketing)/tools/barcode-generator/BarcodeFormatPicker.tsx @@ -0,0 +1,179 @@ +"use client"; + +import { useState } from 'react'; + +type Step = 'use-case' | 'region' | 'result'; + +type Result = { + format: string; + label: string; + description: string; + example: string; + color: string; +}; + +const RESULTS: Record = { + 'ean13': { + format: 'EAN-13', + label: 'EAN-13', + description: 'The global retail standard. Used on consumer products sold in supermarkets, pharmacies, and online shops worldwide.', + example: '4006381333931 (a common product barcode)', + color: 'blue', + }, + 'upca': { + format: 'UPC-A', + label: 'UPC-A', + description: 'The North American retail standard. Functionally equivalent to EAN-13 but with 12 digits. Required by US and Canadian retailers.', + example: '012345678905', + color: 'indigo', + }, + 'code128': { + format: 'Code 128', + label: 'Code 128', + description: 'The most versatile barcode. Supports letters, numbers, and special characters. Used in shipping labels, inventory systems, and internal tracking.', + example: 'SHIP-2026-ABC-001', + color: 'emerald', + }, + 'code39': { + format: 'Code 39', + label: 'Code 39', + description: 'A legacy alphanumeric format still widely used in automotive, defense, and industrial environments. Simpler than Code 128 but less compact.', + example: 'PART-7734-A', + color: 'orange', + }, + 'msi': { + format: 'MSI', + label: 'MSI', + description: 'Designed for inventory and shelf labeling in retail warehouses. Numeric-only. Used for bin locations, shelf tags, and stockroom management.', + example: '123456', + color: 'purple', + }, + 'pharmacode': { + format: 'Pharmacode', + label: 'Pharmacode', + description: 'A pharmaceutical packaging standard used to verify correct product packaging. Encodes a single numeric value (3–131071).', + example: '12345', + color: 'red', + }, +}; + +const colorMap: Record = { + blue: 'bg-blue-50 border-blue-300 text-blue-900', + indigo: 'bg-indigo-50 border-indigo-300 text-indigo-900', + emerald: 'bg-emerald-50 border-emerald-300 text-emerald-900', + orange: 'bg-orange-50 border-orange-300 text-orange-900', + purple: 'bg-purple-50 border-purple-300 text-purple-900', + red: 'bg-red-50 border-red-300 text-red-900', +}; + +const badgeMap: Record = { + blue: 'bg-blue-100 text-blue-800', + indigo: 'bg-indigo-100 text-indigo-800', + emerald: 'bg-emerald-100 text-emerald-800', + orange: 'bg-orange-100 text-orange-800', + purple: 'bg-purple-100 text-purple-800', + red: 'bg-red-100 text-red-800', +}; + +export function BarcodeFormatPicker() { + const [step, setStep] = useState('use-case'); + const [useCase, setUseCase] = useState(''); + const [result, setResult] = useState(''); + + const selectUseCase = (value: string) => { + setUseCase(value); + if (value === 'retail') { + setStep('region'); + } else { + const map: Record = { + logistics: 'code128', + inventory: 'code128', + industrial: 'code39', + warehouse: 'msi', + pharma: 'pharmacode', + }; + setResult(map[value] ?? 'code128'); + setStep('result'); + } + }; + + const selectRegion = (region: string) => { + setResult(region === 'us' ? 'upca' : 'ean13'); + setStep('result'); + }; + + const reset = () => { + setStep('use-case'); + setUseCase(''); + setResult(''); + }; + + const res = result ? RESULTS[result] : null; + + return ( +
+

Which barcode format do I need?

+

Answer two quick questions to find the right format for your use case.

+ + {step === 'use-case' && ( +
+

What will you use the barcode for?

+
+ {[ + { value: 'retail', label: 'Retail products', sub: 'Selling in stores or online' }, + { value: 'logistics', label: 'Shipping & logistics', sub: 'Parcel labels, supply chain' }, + { value: 'inventory', label: 'Inventory tracking', sub: 'Internal stock management' }, + { value: 'industrial', label: 'Industrial / automotive', sub: 'Manufacturing, defense' }, + { value: 'warehouse', label: 'Shelf & bin labeling', sub: 'Warehouse locations' }, + { value: 'pharma', label: 'Pharmaceutical packaging', sub: 'Medication packaging control' }, + ].map((opt) => ( + + ))} +
+
+ )} + + {step === 'region' && ( +
+

Where will you primarily sell?

+
+ + +
+ +
+ )} + + {step === 'result' && res && ( +
+
+ Recommended + {res.label} +
+

{res.description}

+

Example: {res.example}

+ +
+ )} +
+ ); +} diff --git a/src/app/(main)/(marketing)/tools/barcode-generator/BarcodeGuide.tsx b/src/app/(main)/(marketing)/tools/barcode-generator/BarcodeGuide.tsx index 61be67e..760db5e 100644 --- a/src/app/(main)/(marketing)/tools/barcode-generator/BarcodeGuide.tsx +++ b/src/app/(main)/(marketing)/tools/barcode-generator/BarcodeGuide.tsx @@ -1,5 +1,7 @@ -import { BookOpen, CheckCircle, HelpCircle, Layers, Settings, ShoppingCart, Tag, Activity, Factory } from 'lucide-react'; +import { BookOpen, CheckCircle, Layers, Settings, ShoppingCart, Tag, Activity, Factory } from 'lucide-react'; import Link from 'next/link'; +import { FAQSection } from '@/components/aeo/FAQSection'; +import { BarcodeFormatPicker } from './BarcodeFormatPicker'; export function BarcodeGuide() { return ( @@ -87,100 +89,59 @@ export function BarcodeGuide() { Different barcode formats are used for different purposes. Choosing the right one is important for compatibility and scanning accuracy.

-
- {/* EAN-13 Card */} -
-
- -

EAN-13

-
-
Retail • Europe
-
- EAN-13 Barcode Sample for International Products -
-

- EAN-13 is widely used in retail, especially in Europe. It is designed for consumer products sold in stores and supermarkets. -

-
- - {/* UPC-A Card */} -
-
- -

UPC-A

-
-
Retail • USA/Canada
-
- UPC-A Barcode Example for Retail Products in USA -
-

- UPC-A is similar to EAN-13 but is mainly used in the United States and Canada for retail products. -

-
- - {/* Code 128 Card */} -
-
- -

Code 128

-
-
Logistics • Universal
-
- Code 128 Barcode for Inventory and Shipping Labels -
-

- Code 128 is a flexible barcode format that supports letters and numbers. It is commonly used in logistics, shipping, and internal tracking systems. -

-
- - {/* Code 39 Card */} -
-
- -

Code 39

-
-
Industrial • Military
-
- Code 39 Barcode for Industrial Use -
-

- The first alphanumeric barcode, Code 39 is still widely used in automotive and defense industries. It supports numbers and uppercase letters. -

-
- - {/* MSI Card */} -
-
- -

MSI

-
-
Inventory • Shelves
-
- MSI Barcode for Inventory Management -
-

- MSI (Modified Plessey) is often used for inventory control in retail environments, such as labeling shelves in supermarkets and warehouses. -

-
- - {/* Pharmacode Card */} -
-
- -

Pharmacode

-
-
Pharma • Packaging
-
- Pharmacode for Pharmaceutical Packaging -
-

- Pharmacode is a specialized barcode standard used in the pharmaceutical industry for packaging control to prevent medication errors. -

-
- - +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FormatUse CaseDigits / CharsRegion
EAN-13Retail products, supermarkets13 numericEurope / Global
UPC-ARetail products (North America)12 numericUSA / Canada
Code 128Shipping, logistics, inventoryVariable alphanumericUniversal
Code 39Industrial, automotive, defenseVariable alphanumericIndustrial
MSIShelf / bin labeling, warehouseVariable numericRetail / Warehouse
PharmacodePharmaceutical packaging3–131071 numericPharma
+ +

Why Use a Barcode Generator?

Using a Barcode Generator offers several advantages:

@@ -244,8 +205,20 @@ export function BarcodeGuide() {

A reliable Barcode Generator helps streamline these processes and improves efficiency. + For tracking QR codes alongside your barcodes, see our QR code tracking guide.

+

Barcode Generator for Amazon Sellers

+

+ If you sell on Amazon, you will encounter two types of barcodes: GTINs (Global Trade Item Numbers, such as EAN-13 or UPC-A) required by Amazon to list products, and FNSKU barcodes that Amazon assigns to your specific seller account for FBA fulfillment. +

+

+ Our barcode generator can create the image of an EAN-13 or UPC-A barcode if you already have a valid number. However, it cannot issue official GS1-registered numbers. To sell on Amazon with retail barcodes, you need to obtain a legitimate EAN or UPC number from GS1 (the official barcode standards organization). Purchasing unofficial or recycled barcodes from third-party resellers often leads to listing suppression on Amazon. +

+
+ Important for Amazon sellers: GS1 is the only authorized source for EAN/UPC numbers recognized by Amazon. Visit gs1.org to purchase official barcodes for your products. Use this generator to create barcode images once you have a valid number. +
+

Understanding Check Digits

Most barcodes (like EAN and UPC) include a "Check Digit"—the last number in the sequence. This digit is calculated mathematically from the other numbers to ensure the barcode is scanned correctly. Even if a barcode is slightly damaged or scratched, the scanner uses the check digit to verify the integrity of the data. @@ -264,48 +237,44 @@ export function BarcodeGuide() {

-
- -

Frequently Asked Questions (FAQ)

-
- -
-
-
❓ What is a Barcode Generator?
-

A Barcode Generator is an online tool that converts numbers or text into scannable barcode images that can be used for products, labels, and inventory systems.

-
-
-
❓ Is this barcode generator free to use?
-

Yes, our online barcode generator is completely free to use with no hidden costs or sign-ups required. You can generate, download, and print barcodes instantly.

-
-
-
❓ Which barcode format should I use?
-

- EAN-13: Standard for retail products in Europe and globally.
- UPC-A: Standard for retail products in USA/Canada.
- Code 128: Best for logistics, shipping, and internal tracking (supports letters & numbers). -

-
-
-
❓ Can I download barcodes in vector format (SVG)?
-

Yes! We offer SVG downloads. SVG files are vector-based, meaning they can be scaled to any size without losing quality—perfect for professional product packaging.

-
-
-
❓ How do I generate a barcode online?
-

To generate a barcode online, enter your product number or text, select the desired barcode format (such as EAN-13 or Code 128), and click the generate button. The barcode will be created instantly.

-
-
-
❓ Are generated barcodes scannable?
-

Yes, barcodes generated with a proper barcode generator are fully scannable. We generate standard-compliant barcodes readable by any standard optical or laser barcode scanner.

-
-
-
❓ Can I use these barcodes for Amazon (EAN/UPC)?
-

You can generate the image for Amazon here if you already have your EAN/UPC number. However, you cannot "create" a valid global EAN number here—you must purchase those official numbers from GS1 to sell on major platforms like Amazon.

-
-
-
❓ What is the difference between a barcode and a QR code?
-

A barcode stores data horizontally (1D) and is mainly used for product IDs. A QR code stores data in 2D (matrix) and can hold much more information, such as URLs, vCards, or WiFi credentials.

-
+
+
diff --git a/src/app/(main)/(marketing)/tools/barcode-generator/page.tsx b/src/app/(main)/(marketing)/tools/barcode-generator/page.tsx index 9f300fb..ff6f28b 100644 --- a/src/app/(main)/(marketing)/tools/barcode-generator/page.tsx +++ b/src/app/(main)/(marketing)/tools/barcode-generator/page.tsx @@ -11,9 +11,9 @@ import { generateSoftwareAppSchema, generateFaqSchema } from '@/lib/schema-utils // SEO Optimized Metadata export const metadata: Metadata = { title: { - absolute: 'Barcode Generator – Create Barcodes Online for Free', + absolute: 'Free Barcode Generator Online – EAN, UPC, Code 128', }, - description: 'Use a free Barcode Generator to create scannable barcodes online. Supports EAN, UPC and Code 128 for products, labels and inventory.', + description: 'Free online barcode generator. Create EAN-13, UPC-A and Code 128 barcodes instantly. Download PNG or SVG. No signup required.', keywords: ['barcode generator', 'online barcode maker', 'create barcode free', 'ean-13 generator', 'upc-a generator', 'code 128 generator', 'barcode creator', 'printable barcodes'], alternates: { canonical: 'https://www.qrmaster.net/tools/barcode-generator', diff --git a/src/app/(main)/(marketing)/use-cases/[slug]/page.tsx b/src/app/(main)/(marketing)/use-cases/[slug]/page.tsx index 86fc11a..ec1d709 100644 --- a/src/app/(main)/(marketing)/use-cases/[slug]/page.tsx +++ b/src/app/(main)/(marketing)/use-cases/[slug]/page.tsx @@ -1,78 +1,78 @@ -import { notFound } from "next/navigation"; - -import { - buildUseCaseMetadata, - UseCasePageTemplate, -} from "@/components/marketing/UseCasePageTemplate"; -import { - allUseCases, - getUseCasePage, -} from "@/lib/growth-pages"; - -export function generateStaticParams() { - return allUseCases.map((item) => ({ - slug: item.slug, - })); -} - -export function generateMetadata({ params }: { params: { slug: string } }) { - const page = getUseCasePage(params.slug); - - if (!page) { - return {}; - } - - return buildUseCaseMetadata({ - title: page.title, - description: page.metaDescription, - canonicalPath: page.href, - }); -} - -export default function UseCaseDetailPage({ - params, -}: { - params: { slug: string }; -}) { - const page = getUseCasePage(params.slug); - - if (!page) { - notFound(); - } - - return ( - - ); -} +import { notFound } from "next/navigation"; + +import { + buildUseCaseMetadata, + UseCasePageTemplate, +} from "@/components/marketing/UseCasePageTemplate"; +import { + allUseCases, + getUseCasePage, +} from "@/lib/growth-pages"; + +export function generateStaticParams() { + return allUseCases.map((item) => ({ + slug: item.slug, + })); +} + +export function generateMetadata({ params }: { params: { slug: string } }) { + const page = getUseCasePage(params.slug); + + if (!page) { + return {}; + } + + return buildUseCaseMetadata({ + title: page.title, + description: page.metaDescription, + canonicalPath: page.href, + }); +} + +export default function UseCaseDetailPage({ + params, +}: { + params: { slug: string }; +}) { + const page = getUseCasePage(params.slug); + + if (!page) { + notFound(); + } + + return ( + + ); +} diff --git a/src/app/(main)/(marketing)/use-cases/page.tsx b/src/app/(main)/(marketing)/use-cases/page.tsx index 4957f8d..0aae7de 100644 --- a/src/app/(main)/(marketing)/use-cases/page.tsx +++ b/src/app/(main)/(marketing)/use-cases/page.tsx @@ -1,304 +1,304 @@ -import type { Metadata } from "next"; - -import Link from "next/link"; -import { - ArrowRight, - Compass, - LibraryBig, - Link2, - Route, - Sparkles, -} from "lucide-react"; - -import Breadcrumbs, { BreadcrumbItem } from "@/components/Breadcrumbs"; -import SeoJsonLd from "@/components/SeoJsonLd"; -import { - MarketingPageTracker, - TrackedCtaLink, -} from "@/components/marketing/MarketingAnalytics"; -import { Button } from "@/components/ui/Button"; -import { Card } from "@/components/ui/Card"; -import { - allUseCases, - commercialPages, - featuredUseCases, - supportResources, - upcomingUseCaseIdeas, -} from "@/lib/growth-pages"; -import { breadcrumbSchema } from "@/lib/schema"; - -export const metadata: Metadata = { - title: { - absolute: "QR Code Use Cases for Business | QR Master", - }, - description: - "Explore QR code use cases for restaurants, events, business cards, and campaign workflows built around dynamic updates and tracking.", - alternates: { - canonical: "https://www.qrmaster.net/use-cases", - languages: { - "x-default": "https://www.qrmaster.net/use-cases", - en: "https://www.qrmaster.net/use-cases", - }, - }, - openGraph: { - title: "QR Code Use Cases for Business | QR Master", - description: - "Explore QR code use cases for restaurants, events, business cards, and campaign workflows built around dynamic updates and tracking.", - url: "https://www.qrmaster.net/use-cases", - type: "website", - images: ["/og-image.png"], - }, - twitter: { - title: "QR Code Use Cases for Business | QR Master", - description: - "Explore QR code use cases for restaurants, events, business cards, and campaign workflows built around dynamic updates and tracking.", - }, -}; - -export default function UseCasesHubPage() { - const breadcrumbItems: BreadcrumbItem[] = [ - { name: "Home", url: "/" }, - { name: "Use Cases", url: "/use-cases" }, - ]; - - return ( - <> - - - -
-
-
-
- - -
-
-
- - Commercial use-case hub -
- -
-

- QR code use cases that fit real business workflows -

-

- This hub focuses on workflows where dynamic updates and - measurement matter. It is not a list of random QR ideas. It - is the commercial layer between QR Master's product pages, - tools, and editorial content. -

-
- -
- {[ - "Use-case pages map back to a clear commercial parent.", - "Each workflow is written for practical deployment, not filler traffic.", - "Support resources reinforce the wedge around dynamic and trackable QR flows.", - "The next cluster expansion will build on measurable routing and internal links.", - ].map((line) => ( -
- - {line} -
- ))} -
- -
- - - - - - - -
-
- - -
-
- -

How to use this hub

-
-
-

- Start with the workflow problem, not the QR format. If the - printed code needs to survive destination changes or you - need proof of performance, begin with the use case that - matches that job. -

-

- Each page below links back to the best product parent, - forward to related workflows, and sideways to educational - resources that help you deploy the QR well. -

-
-
- -
-
-
- -
-
-
-
- All live use cases -
-

- Every currently published workflow route -

-

- These are all currently published use-case routes in the growth - layer. Each one maps back to a clear commercial parent and a - measurable print or post-scan workflow. -

-
- -
- {allUseCases.map((page) => ( - - -
- {page.cluster} -
-

- {page.title} -

-

- {page.summary} -

-
- Primary parent: {page.parentTitle} - -
- - - ))} -
-
-
- -
-
-
- -
- -

- Commercial pages that anchor the hub -

-
-
- {commercialPages.map((page) => ( - -
-
- {page.title} -
-

- {page.description} -

- - ))} -
- - - -
- -

Support resources

-
-
- {supportResources.map((resource) => ( - -
- {resource.title} -
-

- {resource.description} -

- - ))} -
- -
-
-
- -
-
-
-
- Next cluster candidates -
-

- What follows after the first use-case wave -

-

- These are not published use-case routes yet. They are the next - practical cluster expansions once the first hub and CTA layer are - established. -

-
- -
- {upcomingUseCaseIdeas.map((item) => ( - -
- {item.title} -
-

- {item.description} -

-
- Anchored by {item.href.replace("/", "")} -
- - ))} -
-
-
-
- - ); -} +import type { Metadata } from "next"; + +import Link from "next/link"; +import { + ArrowRight, + Compass, + LibraryBig, + Link2, + Route, + Sparkles, +} from "lucide-react"; + +import Breadcrumbs, { BreadcrumbItem } from "@/components/Breadcrumbs"; +import SeoJsonLd from "@/components/SeoJsonLd"; +import { + MarketingPageTracker, + TrackedCtaLink, +} from "@/components/marketing/MarketingAnalytics"; +import { Button } from "@/components/ui/Button"; +import { Card } from "@/components/ui/Card"; +import { + allUseCases, + commercialPages, + featuredUseCases, + supportResources, + upcomingUseCaseIdeas, +} from "@/lib/growth-pages"; +import { breadcrumbSchema } from "@/lib/schema"; + +export const metadata: Metadata = { + title: { + absolute: "QR Code Use Cases for Business | QR Master", + }, + description: + "Explore QR code use cases for restaurants, events, business cards, and campaign workflows built around dynamic updates and tracking.", + alternates: { + canonical: "https://www.qrmaster.net/use-cases", + languages: { + "x-default": "https://www.qrmaster.net/use-cases", + en: "https://www.qrmaster.net/use-cases", + }, + }, + openGraph: { + title: "QR Code Use Cases for Business | QR Master", + description: + "Explore QR code use cases for restaurants, events, business cards, and campaign workflows built around dynamic updates and tracking.", + url: "https://www.qrmaster.net/use-cases", + type: "website", + images: ["/og-image.png"], + }, + twitter: { + title: "QR Code Use Cases for Business | QR Master", + description: + "Explore QR code use cases for restaurants, events, business cards, and campaign workflows built around dynamic updates and tracking.", + }, +}; + +export default function UseCasesHubPage() { + const breadcrumbItems: BreadcrumbItem[] = [ + { name: "Home", url: "/" }, + { name: "Use Cases", url: "/use-cases" }, + ]; + + return ( + <> + + + +
+
+
+
+ + +
+
+
+ + Commercial use-case hub +
+ +
+

+ QR code use cases that fit real business workflows +

+

+ This hub focuses on workflows where dynamic updates and + measurement matter. It is not a list of random QR ideas. It + is the commercial layer between QR Master's product pages, + tools, and editorial content. +

+
+ +
+ {[ + "Use-case pages map back to a clear commercial parent.", + "Each workflow is written for practical deployment, not filler traffic.", + "Support resources reinforce the wedge around dynamic and trackable QR flows.", + "The next cluster expansion will build on measurable routing and internal links.", + ].map((line) => ( +
+ + {line} +
+ ))} +
+ +
+ + + + + + + +
+
+ + +
+
+ +

How to use this hub

+
+
+

+ Start with the workflow problem, not the QR format. If the + printed code needs to survive destination changes or you + need proof of performance, begin with the use case that + matches that job. +

+

+ Each page below links back to the best product parent, + forward to related workflows, and sideways to educational + resources that help you deploy the QR well. +

+
+
+ +
+
+
+ +
+
+
+
+ All live use cases +
+

+ Every currently published workflow route +

+

+ These are all currently published use-case routes in the growth + layer. Each one maps back to a clear commercial parent and a + measurable print or post-scan workflow. +

+
+ +
+ {allUseCases.map((page) => ( + + +
+ {page.cluster} +
+

+ {page.title} +

+

+ {page.summary} +

+
+ Primary parent: {page.parentTitle} + +
+ + + ))} +
+
+
+ +
+
+
+ +
+ +

+ Commercial pages that anchor the hub +

+
+
+ {commercialPages.map((page) => ( + +
+
+ {page.title} +
+

+ {page.description} +

+ + ))} +
+ + + +
+ +

Support resources

+
+
+ {supportResources.map((resource) => ( + +
+ {resource.title} +
+

+ {resource.description} +

+ + ))} +
+ +
+
+
+ +
+
+
+
+ Next cluster candidates +
+

+ What follows after the first use-case wave +

+

+ These are not published use-case routes yet. They are the next + practical cluster expansions once the first hub and CTA layer are + established. +

+
+ +
+ {upcomingUseCaseIdeas.map((item) => ( + +
+ {item.title} +
+

+ {item.description} +

+
+ Anchored by {item.href.replace("/", "")} +
+ + ))} +
+
+
+
+ + ); +} diff --git a/src/app/(main)/api/auth/[...nextauth]/route.ts b/src/app/(main)/api/auth/[...nextauth]/route.ts index 0cd4a74..1e29620 100644 --- a/src/app/(main)/api/auth/[...nextauth]/route.ts +++ b/src/app/(main)/api/auth/[...nextauth]/route.ts @@ -1,6 +1,6 @@ -import NextAuth from 'next-auth'; -import { authOptions } from '@/lib/auth'; - -const handler = NextAuth(authOptions); - +import NextAuth from 'next-auth'; +import { authOptions } from '@/lib/auth'; + +const handler = NextAuth(authOptions); + export { handler as GET, handler as POST }; \ No newline at end of file diff --git a/src/app/(main)/api/auth/forgot-password/route.ts b/src/app/(main)/api/auth/forgot-password/route.ts index 1e8a3dc..ea7e87e 100644 --- a/src/app/(main)/api/auth/forgot-password/route.ts +++ b/src/app/(main)/api/auth/forgot-password/route.ts @@ -1,89 +1,89 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { db } from '@/lib/db'; -import { csrfProtection } from '@/lib/csrf'; -import { sendPasswordResetEmail } from '@/lib/email'; -import crypto from 'crypto'; - -export async function POST(req: NextRequest) { - try { - // Verify CSRF token - const csrfCheck = csrfProtection(req); - if (!csrfCheck.valid) { - return NextResponse.json( - { error: csrfCheck.error || 'Invalid CSRF token' }, - { status: 403 } - ); - } - - const body = await req.json(); - const { email } = body; - - if (!email) { - return NextResponse.json( - { error: 'Email is required' }, - { status: 400 } - ); - } - - // Validate email format - const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/; - if (!emailRegex.test(email)) { - return NextResponse.json( - { error: 'Invalid email format' }, - { status: 400 } - ); - } - - // Find user by email - const user = await db.user.findUnique({ - where: { email: email.toLowerCase() }, - }); - - // For security, always return success even if email doesn't exist - // This prevents email enumeration attacks - if (!user) { - console.log('Password reset requested for non-existent email:', email); - return NextResponse.json( - { message: 'If an account with that email exists, a password reset link has been sent.' }, - { status: 200 } - ); - } - - // Generate secure random token - const resetToken = crypto.randomBytes(32).toString('hex'); - - // Set token expiration to 1 hour from now - const resetExpires = new Date(Date.now() + 3600000); // 1 hour - - // Save token and expiration to database - await db.user.update({ - where: { id: user.id }, - data: { - resetPasswordToken: resetToken, - resetPasswordExpires: resetExpires, - }, - }); - - // Send password reset email - try { - await sendPasswordResetEmail(email, resetToken); - } catch (emailError) { - console.error('Error sending password reset email:', emailError); - return NextResponse.json( - { error: 'Failed to send reset email. Please try again later.' }, - { status: 500 } - ); - } - - return NextResponse.json( - { message: 'Password reset email sent successfully' }, - { status: 200 } - ); - } catch (error) { - console.error('Error in forgot-password route:', error); - return NextResponse.json( - { error: 'An error occurred. Please try again.' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { db } from '@/lib/db'; +import { csrfProtection } from '@/lib/csrf'; +import { sendPasswordResetEmail } from '@/lib/email'; +import crypto from 'crypto'; + +export async function POST(req: NextRequest) { + try { + // Verify CSRF token + const csrfCheck = csrfProtection(req); + if (!csrfCheck.valid) { + return NextResponse.json( + { error: csrfCheck.error || 'Invalid CSRF token' }, + { status: 403 } + ); + } + + const body = await req.json(); + const { email } = body; + + if (!email) { + return NextResponse.json( + { error: 'Email is required' }, + { status: 400 } + ); + } + + // Validate email format + const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/; + if (!emailRegex.test(email)) { + return NextResponse.json( + { error: 'Invalid email format' }, + { status: 400 } + ); + } + + // Find user by email + const user = await db.user.findUnique({ + where: { email: email.toLowerCase() }, + }); + + // For security, always return success even if email doesn't exist + // This prevents email enumeration attacks + if (!user) { + console.log('Password reset requested for non-existent email:', email); + return NextResponse.json( + { message: 'If an account with that email exists, a password reset link has been sent.' }, + { status: 200 } + ); + } + + // Generate secure random token + const resetToken = crypto.randomBytes(32).toString('hex'); + + // Set token expiration to 1 hour from now + const resetExpires = new Date(Date.now() + 3600000); // 1 hour + + // Save token and expiration to database + await db.user.update({ + where: { id: user.id }, + data: { + resetPasswordToken: resetToken, + resetPasswordExpires: resetExpires, + }, + }); + + // Send password reset email + try { + await sendPasswordResetEmail(email, resetToken); + } catch (emailError) { + console.error('Error sending password reset email:', emailError); + return NextResponse.json( + { error: 'Failed to send reset email. Please try again later.' }, + { status: 500 } + ); + } + + return NextResponse.json( + { message: 'Password reset email sent successfully' }, + { status: 200 } + ); + } catch (error) { + console.error('Error in forgot-password route:', error); + return NextResponse.json( + { error: 'An error occurred. Please try again.' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/auth/google/route.ts b/src/app/(main)/api/auth/google/route.ts index 79c053a..c379ff7 100644 --- a/src/app/(main)/api/auth/google/route.ts +++ b/src/app/(main)/api/auth/google/route.ts @@ -1,165 +1,165 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { db } from '@/lib/db'; -import { cookies } from 'next/headers'; -import { getAuthCookieOptions } from '@/lib/cookieConfig'; - -export async function GET(request: NextRequest) { - const { searchParams } = new URL(request.url); - const code = searchParams.get('code'); - - // If no code, redirect to Google OAuth - if (!code) { - const googleClientId = process.env.GOOGLE_CLIENT_ID; - - if (!googleClientId) { - return NextResponse.json( - { error: 'Google Client ID not configured' }, - { status: 500 } - ); - } - - const redirectUri = `${process.env.NEXT_PUBLIC_APP_URL}/api/auth/google`; - const scope = 'openid email profile'; - - const googleAuthUrl = `https://accounts.google.com/o/oauth2/v2/auth?client_id=${googleClientId}&redirect_uri=${redirectUri}&response_type=code&scope=${scope}`; - - return NextResponse.redirect(googleAuthUrl); - } - - // Handle callback with code - try { - const googleClientId = process.env.GOOGLE_CLIENT_ID; - const googleClientSecret = process.env.GOOGLE_CLIENT_SECRET; - - if (!googleClientId || !googleClientSecret) { - return NextResponse.json( - { error: 'Google OAuth not configured' }, - { status: 500 } - ); - } - - const redirectUri = `${process.env.NEXT_PUBLIC_APP_URL}/api/auth/google`; - - // Exchange code for tokens - const tokenResponse = await fetch('https://oauth2.googleapis.com/token', { - method: 'POST', - headers: { - 'Content-Type': 'application/x-www-form-urlencoded', - }, - body: new URLSearchParams({ - code, - client_id: googleClientId, - client_secret: googleClientSecret, - redirect_uri: redirectUri, - grant_type: 'authorization_code', - }), - }); - - if (!tokenResponse.ok) { - throw new Error('Failed to exchange code for tokens'); - } - - const tokens = await tokenResponse.json(); - - // Get user info from Google - const userInfoResponse = await fetch('https://www.googleapis.com/oauth2/v2/userinfo', { - headers: { - Authorization: `Bearer ${tokens.access_token}`, - }, - }); - - if (!userInfoResponse.ok) { - throw new Error('Failed to get user info'); - } - - const userInfo = await userInfoResponse.json(); - - // Check if user exists in database - let user = await db.user.findUnique({ - where: { email: userInfo.email }, - }); - - const isNewUser = !user; - - // Create user if they don't exist - if (!user) { - user = await db.user.create({ - data: { - email: userInfo.email, - name: userInfo.name || userInfo.email.split('@')[0], - image: userInfo.picture, - emailVerified: new Date(), // Google already verified the email - password: null, // OAuth users don't need a password - }, - }); - - // Create Account entry for the OAuth provider - await db.account.create({ - data: { - userId: user.id, - type: 'oauth', - provider: 'google', - providerAccountId: userInfo.sub || userInfo.id, - access_token: tokens.access_token, - refresh_token: tokens.refresh_token, - expires_at: tokens.expires_in ? Math.floor(Date.now() / 1000) + tokens.expires_in : null, - token_type: tokens.token_type, - scope: tokens.scope, - id_token: tokens.id_token, - }, - }); - } else { - // Update existing account tokens - const existingAccount = await db.account.findUnique({ - where: { - provider_providerAccountId: { - provider: 'google', - providerAccountId: userInfo.sub || userInfo.id, - }, - }, - }); - - if (existingAccount) { - await db.account.update({ - where: { id: existingAccount.id }, - data: { - access_token: tokens.access_token, - refresh_token: tokens.refresh_token, - expires_at: tokens.expires_in ? Math.floor(Date.now() / 1000) + tokens.expires_in : null, - }, - }); - } else { - // Create Account entry if it doesn't exist - await db.account.create({ - data: { - userId: user.id, - type: 'oauth', - provider: 'google', - providerAccountId: userInfo.sub || userInfo.id, - access_token: tokens.access_token, - refresh_token: tokens.refresh_token, - expires_at: tokens.expires_in ? Math.floor(Date.now() / 1000) + tokens.expires_in : null, - token_type: tokens.token_type, - scope: tokens.scope, - id_token: tokens.id_token, - }, - }); - } - } - - // Set authentication cookie - cookies().set('userId', user.id, getAuthCookieOptions()); - - // Redirect to dashboard with tracking params - const redirectUrl = new URL(`${process.env.NEXT_PUBLIC_APP_URL}/dashboard`); - redirectUrl.searchParams.set('authMethod', 'google'); - redirectUrl.searchParams.set('isNewUser', isNewUser.toString()); - - return NextResponse.redirect(redirectUrl.toString()); - } catch (error) { - console.error('Google OAuth error:', error); - return NextResponse.redirect( - `${process.env.NEXT_PUBLIC_APP_URL}/login?error=google-signin-failed` - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { db } from '@/lib/db'; +import { cookies } from 'next/headers'; +import { getAuthCookieOptions } from '@/lib/cookieConfig'; + +export async function GET(request: NextRequest) { + const { searchParams } = new URL(request.url); + const code = searchParams.get('code'); + + // If no code, redirect to Google OAuth + if (!code) { + const googleClientId = process.env.GOOGLE_CLIENT_ID; + + if (!googleClientId) { + return NextResponse.json( + { error: 'Google Client ID not configured' }, + { status: 500 } + ); + } + + const redirectUri = `${process.env.NEXT_PUBLIC_APP_URL}/api/auth/google`; + const scope = 'openid email profile'; + + const googleAuthUrl = `https://accounts.google.com/o/oauth2/v2/auth?client_id=${googleClientId}&redirect_uri=${redirectUri}&response_type=code&scope=${scope}`; + + return NextResponse.redirect(googleAuthUrl); + } + + // Handle callback with code + try { + const googleClientId = process.env.GOOGLE_CLIENT_ID; + const googleClientSecret = process.env.GOOGLE_CLIENT_SECRET; + + if (!googleClientId || !googleClientSecret) { + return NextResponse.json( + { error: 'Google OAuth not configured' }, + { status: 500 } + ); + } + + const redirectUri = `${process.env.NEXT_PUBLIC_APP_URL}/api/auth/google`; + + // Exchange code for tokens + const tokenResponse = await fetch('https://oauth2.googleapis.com/token', { + method: 'POST', + headers: { + 'Content-Type': 'application/x-www-form-urlencoded', + }, + body: new URLSearchParams({ + code, + client_id: googleClientId, + client_secret: googleClientSecret, + redirect_uri: redirectUri, + grant_type: 'authorization_code', + }), + }); + + if (!tokenResponse.ok) { + throw new Error('Failed to exchange code for tokens'); + } + + const tokens = await tokenResponse.json(); + + // Get user info from Google + const userInfoResponse = await fetch('https://www.googleapis.com/oauth2/v2/userinfo', { + headers: { + Authorization: `Bearer ${tokens.access_token}`, + }, + }); + + if (!userInfoResponse.ok) { + throw new Error('Failed to get user info'); + } + + const userInfo = await userInfoResponse.json(); + + // Check if user exists in database + let user = await db.user.findUnique({ + where: { email: userInfo.email }, + }); + + const isNewUser = !user; + + // Create user if they don't exist + if (!user) { + user = await db.user.create({ + data: { + email: userInfo.email, + name: userInfo.name || userInfo.email.split('@')[0], + image: userInfo.picture, + emailVerified: new Date(), // Google already verified the email + password: null, // OAuth users don't need a password + }, + }); + + // Create Account entry for the OAuth provider + await db.account.create({ + data: { + userId: user.id, + type: 'oauth', + provider: 'google', + providerAccountId: userInfo.sub || userInfo.id, + access_token: tokens.access_token, + refresh_token: tokens.refresh_token, + expires_at: tokens.expires_in ? Math.floor(Date.now() / 1000) + tokens.expires_in : null, + token_type: tokens.token_type, + scope: tokens.scope, + id_token: tokens.id_token, + }, + }); + } else { + // Update existing account tokens + const existingAccount = await db.account.findUnique({ + where: { + provider_providerAccountId: { + provider: 'google', + providerAccountId: userInfo.sub || userInfo.id, + }, + }, + }); + + if (existingAccount) { + await db.account.update({ + where: { id: existingAccount.id }, + data: { + access_token: tokens.access_token, + refresh_token: tokens.refresh_token, + expires_at: tokens.expires_in ? Math.floor(Date.now() / 1000) + tokens.expires_in : null, + }, + }); + } else { + // Create Account entry if it doesn't exist + await db.account.create({ + data: { + userId: user.id, + type: 'oauth', + provider: 'google', + providerAccountId: userInfo.sub || userInfo.id, + access_token: tokens.access_token, + refresh_token: tokens.refresh_token, + expires_at: tokens.expires_in ? Math.floor(Date.now() / 1000) + tokens.expires_in : null, + token_type: tokens.token_type, + scope: tokens.scope, + id_token: tokens.id_token, + }, + }); + } + } + + // Set authentication cookie + cookies().set('userId', user.id, getAuthCookieOptions()); + + // Redirect to dashboard with tracking params + const redirectUrl = new URL(`${process.env.NEXT_PUBLIC_APP_URL}/dashboard`); + redirectUrl.searchParams.set('authMethod', 'google'); + redirectUrl.searchParams.set('isNewUser', isNewUser.toString()); + + return NextResponse.redirect(redirectUrl.toString()); + } catch (error) { + console.error('Google OAuth error:', error); + return NextResponse.redirect( + `${process.env.NEXT_PUBLIC_APP_URL}/login?error=google-signin-failed` + ); + } +} diff --git a/src/app/(main)/api/auth/reset-password/route.ts b/src/app/(main)/api/auth/reset-password/route.ts index 800caca..9dd7a28 100644 --- a/src/app/(main)/api/auth/reset-password/route.ts +++ b/src/app/(main)/api/auth/reset-password/route.ts @@ -1,90 +1,90 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { db } from '@/lib/db'; -import { csrfProtection } from '@/lib/csrf'; -import bcrypt from 'bcryptjs'; - -export async function POST(req: NextRequest) { - try { - // Verify CSRF token - const csrfCheck = csrfProtection(req); - if (!csrfCheck.valid) { - return NextResponse.json( - { error: csrfCheck.error || 'Invalid CSRF token' }, - { status: 403 } - ); - } - - const body = await req.json(); - const { token, password } = body; - - if (!token || !password) { - return NextResponse.json( - { error: 'Token and password are required' }, - { status: 400 } - ); - } - - // Validate password length - if (password.length < 8) { - return NextResponse.json( - { error: 'Password must be at least 8 characters long' }, - { status: 400 } - ); - } - - // Find user with this reset token - const user = await db.user.findUnique({ - where: { resetPasswordToken: token }, - }); - - if (!user) { - return NextResponse.json( - { error: 'Invalid or expired reset token' }, - { status: 400 } - ); - } - - // Check if token has expired - if (!user.resetPasswordExpires || user.resetPasswordExpires < new Date()) { - // Clear expired token - await db.user.update({ - where: { id: user.id }, - data: { - resetPasswordToken: null, - resetPasswordExpires: null, - }, - }); - - return NextResponse.json( - { error: 'Reset token has expired. Please request a new password reset link.' }, - { status: 400 } - ); - } - - // Hash the new password - const hashedPassword = await bcrypt.hash(password, 10); - - // Update user's password and clear reset token - await db.user.update({ - where: { id: user.id }, - data: { - password: hashedPassword, - resetPasswordToken: null, - resetPasswordExpires: null, - }, - }); - - console.log('Password successfully reset for user:', user.email); - - return NextResponse.json( - { message: 'Password reset successfully' }, - { status: 200 } - ); - } catch (error) { - console.error('Error in reset-password route:', error); - return NextResponse.json( - { error: 'An error occurred. Please try again.' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { db } from '@/lib/db'; +import { csrfProtection } from '@/lib/csrf'; +import bcrypt from 'bcryptjs'; + +export async function POST(req: NextRequest) { + try { + // Verify CSRF token + const csrfCheck = csrfProtection(req); + if (!csrfCheck.valid) { + return NextResponse.json( + { error: csrfCheck.error || 'Invalid CSRF token' }, + { status: 403 } + ); + } + + const body = await req.json(); + const { token, password } = body; + + if (!token || !password) { + return NextResponse.json( + { error: 'Token and password are required' }, + { status: 400 } + ); + } + + // Validate password length + if (password.length < 8) { + return NextResponse.json( + { error: 'Password must be at least 8 characters long' }, + { status: 400 } + ); + } + + // Find user with this reset token + const user = await db.user.findUnique({ + where: { resetPasswordToken: token }, + }); + + if (!user) { + return NextResponse.json( + { error: 'Invalid or expired reset token' }, + { status: 400 } + ); + } + + // Check if token has expired + if (!user.resetPasswordExpires || user.resetPasswordExpires < new Date()) { + // Clear expired token + await db.user.update({ + where: { id: user.id }, + data: { + resetPasswordToken: null, + resetPasswordExpires: null, + }, + }); + + return NextResponse.json( + { error: 'Reset token has expired. Please request a new password reset link.' }, + { status: 400 } + ); + } + + // Hash the new password + const hashedPassword = await bcrypt.hash(password, 10); + + // Update user's password and clear reset token + await db.user.update({ + where: { id: user.id }, + data: { + password: hashedPassword, + resetPasswordToken: null, + resetPasswordExpires: null, + }, + }); + + console.log('Password successfully reset for user:', user.email); + + return NextResponse.json( + { message: 'Password reset successfully' }, + { status: 200 } + ); + } catch (error) { + console.error('Error in reset-password route:', error); + return NextResponse.json( + { error: 'An error occurred. Please try again.' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/auth/simple-login/route.ts b/src/app/(main)/api/auth/simple-login/route.ts index 009ad82..5f5951d 100644 --- a/src/app/(main)/api/auth/simple-login/route.ts +++ b/src/app/(main)/api/auth/simple-login/route.ts @@ -1,85 +1,85 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { db } from '@/lib/db'; -import bcrypt from 'bcryptjs'; -import { cookies } from 'next/headers'; -import { csrfProtection } from '@/lib/csrf'; -import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; -import { getAuthCookieOptions } from '@/lib/cookieConfig'; -import { loginSchema, validateRequest } from '@/lib/validationSchemas'; - -export async function POST(request: NextRequest) { - try { - // CSRF Protection - const csrfCheck = csrfProtection(request); - if (!csrfCheck.valid) { - return NextResponse.json( - { error: csrfCheck.error }, - { status: 403 } - ); - } - - // Rate Limiting - const clientId = getClientIdentifier(request); - const rateLimitResult = rateLimit(clientId, RateLimits.LOGIN); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many login attempts. Please try again later.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) - }, - { - status: 429, - headers: { - 'X-RateLimit-Limit': rateLimitResult.limit.toString(), - 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), - 'X-RateLimit-Reset': rateLimitResult.reset.toString(), - } - } - ); - } - - const body = await request.json(); - - // Validate request body - const validation = await validateRequest(loginSchema, body); - if (!validation.success) { - return NextResponse.json(validation.error, { status: 400 }); - } - - const { email, password } = validation.data; - - // Find user - const user = await db.user.findUnique({ - where: { email }, - }); - - if (!user) { - return NextResponse.json( - { error: 'Invalid email or password' }, - { status: 401 } - ); - } - - // Verify password - const isValid = await bcrypt.compare(password, user.password || ''); - - if (!isValid) { - return NextResponse.json( - { error: 'Invalid email or password' }, - { status: 401 } - ); - } - - // Set cookie - cookies().set('userId', user.id, getAuthCookieOptions()); - - return NextResponse.json({ - success: true, - user: { id: user.id, email: user.email, name: user.name, plan: user.plan || 'FREE' } - }); - } catch (error) { - console.error('Login error:', error); - return NextResponse.json({ error: 'Internal server error' }, { status: 500 }); - } +import { NextRequest, NextResponse } from 'next/server'; +import { db } from '@/lib/db'; +import bcrypt from 'bcryptjs'; +import { cookies } from 'next/headers'; +import { csrfProtection } from '@/lib/csrf'; +import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; +import { getAuthCookieOptions } from '@/lib/cookieConfig'; +import { loginSchema, validateRequest } from '@/lib/validationSchemas'; + +export async function POST(request: NextRequest) { + try { + // CSRF Protection + const csrfCheck = csrfProtection(request); + if (!csrfCheck.valid) { + return NextResponse.json( + { error: csrfCheck.error }, + { status: 403 } + ); + } + + // Rate Limiting + const clientId = getClientIdentifier(request); + const rateLimitResult = rateLimit(clientId, RateLimits.LOGIN); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many login attempts. Please try again later.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': rateLimitResult.limit.toString(), + 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), + 'X-RateLimit-Reset': rateLimitResult.reset.toString(), + } + } + ); + } + + const body = await request.json(); + + // Validate request body + const validation = await validateRequest(loginSchema, body); + if (!validation.success) { + return NextResponse.json(validation.error, { status: 400 }); + } + + const { email, password } = validation.data; + + // Find user + const user = await db.user.findUnique({ + where: { email }, + }); + + if (!user) { + return NextResponse.json( + { error: 'Invalid email or password' }, + { status: 401 } + ); + } + + // Verify password + const isValid = await bcrypt.compare(password, user.password || ''); + + if (!isValid) { + return NextResponse.json( + { error: 'Invalid email or password' }, + { status: 401 } + ); + } + + // Set cookie + cookies().set('userId', user.id, getAuthCookieOptions()); + + return NextResponse.json({ + success: true, + user: { id: user.id, email: user.email, name: user.name, plan: user.plan || 'FREE' } + }); + } catch (error) { + console.error('Login error:', error); + return NextResponse.json({ error: 'Internal server error' }, { status: 500 }); + } } \ No newline at end of file diff --git a/src/app/(main)/api/csrf/route.ts b/src/app/(main)/api/csrf/route.ts index 083dfc8..49464c9 100644 --- a/src/app/(main)/api/csrf/route.ts +++ b/src/app/(main)/api/csrf/route.ts @@ -1,14 +1,14 @@ -import { NextResponse } from 'next/server'; -import { getOrCreateCsrfToken } from '@/lib/csrf'; - -export const dynamic = 'force-dynamic'; - -/** - * GET /api/csrf - * Returns a CSRF token for the current session - */ -export async function GET() { - const token = getOrCreateCsrfToken(); - - return NextResponse.json({ csrfToken: token }); -} +import { NextResponse } from 'next/server'; +import { getOrCreateCsrfToken } from '@/lib/csrf'; + +export const dynamic = 'force-dynamic'; + +/** + * GET /api/csrf + * Returns a CSRF token for the current session + */ +export async function GET() { + const token = getOrCreateCsrfToken(); + + return NextResponse.json({ csrfToken: token }); +} diff --git a/src/app/(main)/api/newsletter/admin-login/route.ts b/src/app/(main)/api/newsletter/admin-login/route.ts index e9bba29..cb9ad02 100644 --- a/src/app/(main)/api/newsletter/admin-login/route.ts +++ b/src/app/(main)/api/newsletter/admin-login/route.ts @@ -1,59 +1,59 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import bcrypt from 'bcryptjs'; -import { db } from '@/lib/db'; -import { getAuthCookieOptions } from '@/lib/cookieConfig'; - -/** - * POST /api/newsletter/admin-login - * Simple admin login for newsletter management (no CSRF required) - */ -export async function POST(request: NextRequest) { - try { - const body = await request.json(); - const { email, password } = body; - - // Validate input - if (!email || !password) { - return NextResponse.json( - { error: 'Email and password are required' }, - { status: 400 } - ); - } - - // SECURITY: Only allow support@qrmaster.net to access newsletter admin - const ALLOWED_ADMIN_EMAIL = 'support@qrmaster.net'; - const ALLOWED_ADMIN_PASSWORD = 'Timo.16092005'; - - if (email.toLowerCase() !== ALLOWED_ADMIN_EMAIL) { - return NextResponse.json( - { error: 'Access denied. Only authorized accounts can access this area.' }, - { status: 403 } - ); - } - - // Verify password with hardcoded value - if (password !== ALLOWED_ADMIN_PASSWORD) { - return NextResponse.json( - { error: 'Invalid credentials' }, - { status: 401 } - ); - } - - // Set auth cookie with a simple session identifier - const response = NextResponse.json({ - success: true, - message: 'Login successful', - }); - - response.cookies.set('newsletter-admin', 'authenticated', getAuthCookieOptions()); - - return response; - } catch (error) { - console.error('Newsletter admin login error:', error); - return NextResponse.json( - { error: 'Login failed. Please try again.' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import bcrypt from 'bcryptjs'; +import { db } from '@/lib/db'; +import { getAuthCookieOptions } from '@/lib/cookieConfig'; + +/** + * POST /api/newsletter/admin-login + * Simple admin login for newsletter management (no CSRF required) + */ +export async function POST(request: NextRequest) { + try { + const body = await request.json(); + const { email, password } = body; + + // Validate input + if (!email || !password) { + return NextResponse.json( + { error: 'Email and password are required' }, + { status: 400 } + ); + } + + // SECURITY: Only allow support@qrmaster.net to access newsletter admin + const ALLOWED_ADMIN_EMAIL = 'support@qrmaster.net'; + const ALLOWED_ADMIN_PASSWORD = 'Timo.16092005'; + + if (email.toLowerCase() !== ALLOWED_ADMIN_EMAIL) { + return NextResponse.json( + { error: 'Access denied. Only authorized accounts can access this area.' }, + { status: 403 } + ); + } + + // Verify password with hardcoded value + if (password !== ALLOWED_ADMIN_PASSWORD) { + return NextResponse.json( + { error: 'Invalid credentials' }, + { status: 401 } + ); + } + + // Set auth cookie with a simple session identifier + const response = NextResponse.json({ + success: true, + message: 'Login successful', + }); + + response.cookies.set('newsletter-admin', 'authenticated', getAuthCookieOptions()); + + return response; + } catch (error) { + console.error('Newsletter admin login error:', error); + return NextResponse.json( + { error: 'Login failed. Please try again.' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/newsletter/broadcast/route.ts b/src/app/(main)/api/newsletter/broadcast/route.ts index a06d65d..5a2c328 100644 --- a/src/app/(main)/api/newsletter/broadcast/route.ts +++ b/src/app/(main)/api/newsletter/broadcast/route.ts @@ -1,163 +1,163 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { db } from '@/lib/db'; -import { sendAIFeatureLaunchEmail } from '@/lib/email'; -import { rateLimit, RateLimits } from '@/lib/rateLimit'; - -/** - * POST /api/newsletter/broadcast - * Send AI feature launch email to all subscribed users - * PROTECTED: Only authenticated users can access (you may want to add admin check) - */ -export async function POST(request: NextRequest) { - try { - // Check authentication using newsletter-admin cookie - const adminCookie = cookies().get('newsletter-admin')?.value; - - if (adminCookie !== 'authenticated') { - return NextResponse.json( - { error: 'Unauthorized. Please log in.' }, - { status: 401 } - ); - } - - // Optional: Add admin check here - // const user = await db.user.findUnique({ where: { id: userId } }); - // if (user?.role !== 'ADMIN') { - // return NextResponse.json({ error: 'Forbidden. Admin access required.' }, { status: 403 }); - // } - - // Rate limiting (prevent accidental spam) - const rateLimitResult = rateLimit('newsletter-admin', { - name: 'newsletter-broadcast', - maxRequests: 2, // Only 2 broadcasts per hour - windowSeconds: 60 * 60, - }); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many broadcast attempts. Please wait before trying again.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000), - }, - { status: 429 } - ); - } - - // Get all subscribed users - const subscribers = await db.newsletterSubscription.findMany({ - where: { - status: 'subscribed', - }, - select: { - email: true, - }, - }); - - if (subscribers.length === 0) { - return NextResponse.json({ - success: true, - message: 'No subscribers found', - sent: 0, - }); - } - - // Send emails in batches to avoid overwhelming Resend - const batchSize = 10; - const results = { - sent: 0, - failed: 0, - errors: [] as string[], - }; - - for (let i = 0; i < subscribers.length; i += batchSize) { - const batch = subscribers.slice(i, i + batchSize); - - // Send emails in parallel within batch - const promises = batch.map(async (subscriber) => { - try { - await sendAIFeatureLaunchEmail(subscriber.email); - results.sent++; - } catch (error) { - results.failed++; - results.errors.push(`Failed to send to ${subscriber.email}`); - console.error(`Failed to send to ${subscriber.email}:`, error); - } - }); - - await Promise.allSettled(promises); - - // Small delay between batches to be nice to the email service - if (i + batchSize < subscribers.length) { - await new Promise((resolve) => setTimeout(resolve, 1000)); - } - } - - return NextResponse.json({ - success: true, - message: `Broadcast completed. Sent to ${results.sent} subscribers.`, - sent: results.sent, - failed: results.failed, - total: subscribers.length, - errors: results.errors.length > 0 ? results.errors : undefined, - }); - } catch (error) { - console.error('Newsletter broadcast error:', error); - return NextResponse.json( - { - error: 'Failed to send broadcast emails. Please try again.', - }, - { status: 500 } - ); - } -} - -/** - * GET /api/newsletter/broadcast - * Get subscriber count and preview - * PROTECTED: Only authenticated users - */ -export async function GET(request: NextRequest) { - try { - // Check authentication using newsletter-admin cookie - const adminCookie = cookies().get('newsletter-admin')?.value; - - if (adminCookie !== 'authenticated') { - return NextResponse.json( - { error: 'Unauthorized. Please log in.' }, - { status: 401 } - ); - } - - const subscriberCount = await db.newsletterSubscription.count({ - where: { - status: 'subscribed', - }, - }); - - const recentSubscribers = await db.newsletterSubscription.findMany({ - where: { - status: 'subscribed', - }, - select: { - email: true, - createdAt: true, - }, - orderBy: { - createdAt: 'desc', - }, - take: 5, - }); - - return NextResponse.json({ - total: subscriberCount, - recent: recentSubscribers, - }); - } catch (error) { - console.error('Error fetching subscriber info:', error); - return NextResponse.json( - { error: 'Failed to fetch subscriber information' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { db } from '@/lib/db'; +import { sendAIFeatureLaunchEmail } from '@/lib/email'; +import { rateLimit, RateLimits } from '@/lib/rateLimit'; + +/** + * POST /api/newsletter/broadcast + * Send AI feature launch email to all subscribed users + * PROTECTED: Only authenticated users can access (you may want to add admin check) + */ +export async function POST(request: NextRequest) { + try { + // Check authentication using newsletter-admin cookie + const adminCookie = cookies().get('newsletter-admin')?.value; + + if (adminCookie !== 'authenticated') { + return NextResponse.json( + { error: 'Unauthorized. Please log in.' }, + { status: 401 } + ); + } + + // Optional: Add admin check here + // const user = await db.user.findUnique({ where: { id: userId } }); + // if (user?.role !== 'ADMIN') { + // return NextResponse.json({ error: 'Forbidden. Admin access required.' }, { status: 403 }); + // } + + // Rate limiting (prevent accidental spam) + const rateLimitResult = rateLimit('newsletter-admin', { + name: 'newsletter-broadcast', + maxRequests: 2, // Only 2 broadcasts per hour + windowSeconds: 60 * 60, + }); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many broadcast attempts. Please wait before trying again.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000), + }, + { status: 429 } + ); + } + + // Get all subscribed users + const subscribers = await db.newsletterSubscription.findMany({ + where: { + status: 'subscribed', + }, + select: { + email: true, + }, + }); + + if (subscribers.length === 0) { + return NextResponse.json({ + success: true, + message: 'No subscribers found', + sent: 0, + }); + } + + // Send emails in batches to avoid overwhelming Resend + const batchSize = 10; + const results = { + sent: 0, + failed: 0, + errors: [] as string[], + }; + + for (let i = 0; i < subscribers.length; i += batchSize) { + const batch = subscribers.slice(i, i + batchSize); + + // Send emails in parallel within batch + const promises = batch.map(async (subscriber) => { + try { + await sendAIFeatureLaunchEmail(subscriber.email); + results.sent++; + } catch (error) { + results.failed++; + results.errors.push(`Failed to send to ${subscriber.email}`); + console.error(`Failed to send to ${subscriber.email}:`, error); + } + }); + + await Promise.allSettled(promises); + + // Small delay between batches to be nice to the email service + if (i + batchSize < subscribers.length) { + await new Promise((resolve) => setTimeout(resolve, 1000)); + } + } + + return NextResponse.json({ + success: true, + message: `Broadcast completed. Sent to ${results.sent} subscribers.`, + sent: results.sent, + failed: results.failed, + total: subscribers.length, + errors: results.errors.length > 0 ? results.errors : undefined, + }); + } catch (error) { + console.error('Newsletter broadcast error:', error); + return NextResponse.json( + { + error: 'Failed to send broadcast emails. Please try again.', + }, + { status: 500 } + ); + } +} + +/** + * GET /api/newsletter/broadcast + * Get subscriber count and preview + * PROTECTED: Only authenticated users + */ +export async function GET(request: NextRequest) { + try { + // Check authentication using newsletter-admin cookie + const adminCookie = cookies().get('newsletter-admin')?.value; + + if (adminCookie !== 'authenticated') { + return NextResponse.json( + { error: 'Unauthorized. Please log in.' }, + { status: 401 } + ); + } + + const subscriberCount = await db.newsletterSubscription.count({ + where: { + status: 'subscribed', + }, + }); + + const recentSubscribers = await db.newsletterSubscription.findMany({ + where: { + status: 'subscribed', + }, + select: { + email: true, + createdAt: true, + }, + orderBy: { + createdAt: 'desc', + }, + take: 5, + }); + + return NextResponse.json({ + total: subscriberCount, + recent: recentSubscribers, + }); + } catch (error) { + console.error('Error fetching subscriber info:', error); + return NextResponse.json( + { error: 'Failed to fetch subscriber information' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/newsletter/subscribe/route.ts b/src/app/(main)/api/newsletter/subscribe/route.ts index 3c284ea..cbcaa24 100644 --- a/src/app/(main)/api/newsletter/subscribe/route.ts +++ b/src/app/(main)/api/newsletter/subscribe/route.ts @@ -1,91 +1,91 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { db } from '@/lib/db'; -import { newsletterSubscribeSchema, validateRequest } from '@/lib/validationSchemas'; -import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; -import { sendNewsletterWelcomeEmail } from '@/lib/email'; - -/** - * POST /api/newsletter/subscribe - * Subscribe to AI features newsletter - * Public endpoint - no authentication required - */ -export async function POST(request: NextRequest) { - try { - // Get client identifier for rate limiting - const clientId = getClientIdentifier(request); - - // Apply rate limiting (5 per hour) - const rateLimitResult = rateLimit(clientId, RateLimits.NEWSLETTER_SUBSCRIBE); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many subscription attempts. Please try again later.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000), - }, - { - status: 429, - headers: { - 'X-RateLimit-Limit': rateLimitResult.limit.toString(), - 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), - 'X-RateLimit-Reset': rateLimitResult.reset.toString(), - 'Retry-After': Math.ceil((rateLimitResult.reset - Date.now()) / 1000).toString(), - }, - } - ); - } - - // Parse and validate request body - const body = await request.json(); - const validation = await validateRequest(newsletterSubscribeSchema, body); - - if (!validation.success) { - return NextResponse.json(validation.error, { status: 400 }); - } - - const { email } = validation.data; - - // Check if email already subscribed - const existing = await db.newsletterSubscription.findUnique({ - where: { email }, - }); - - if (existing) { - // If already subscribed, return success (idempotent) - // Don't reveal if email exists for privacy - return NextResponse.json({ - success: true, - message: 'Successfully subscribed to AI features newsletter!', - alreadySubscribed: true, - }); - } - - // Create new subscription - await db.newsletterSubscription.create({ - data: { - email, - source: 'ai-coming-soon', - status: 'subscribed', - }, - }); - - // Send welcome email (don't block response) - sendNewsletterWelcomeEmail(email).catch((error) => { - console.error('Failed to send welcome email (non-blocking):', error); - }); - - return NextResponse.json({ - success: true, - message: 'Successfully subscribed to AI features newsletter!', - alreadySubscribed: false, - }); - } catch (error) { - console.error('Newsletter subscription error:', error); - return NextResponse.json( - { - error: 'Failed to subscribe to newsletter. Please try again.', - }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { db } from '@/lib/db'; +import { newsletterSubscribeSchema, validateRequest } from '@/lib/validationSchemas'; +import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; +import { sendNewsletterWelcomeEmail } from '@/lib/email'; + +/** + * POST /api/newsletter/subscribe + * Subscribe to AI features newsletter + * Public endpoint - no authentication required + */ +export async function POST(request: NextRequest) { + try { + // Get client identifier for rate limiting + const clientId = getClientIdentifier(request); + + // Apply rate limiting (5 per hour) + const rateLimitResult = rateLimit(clientId, RateLimits.NEWSLETTER_SUBSCRIBE); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many subscription attempts. Please try again later.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000), + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': rateLimitResult.limit.toString(), + 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), + 'X-RateLimit-Reset': rateLimitResult.reset.toString(), + 'Retry-After': Math.ceil((rateLimitResult.reset - Date.now()) / 1000).toString(), + }, + } + ); + } + + // Parse and validate request body + const body = await request.json(); + const validation = await validateRequest(newsletterSubscribeSchema, body); + + if (!validation.success) { + return NextResponse.json(validation.error, { status: 400 }); + } + + const { email } = validation.data; + + // Check if email already subscribed + const existing = await db.newsletterSubscription.findUnique({ + where: { email }, + }); + + if (existing) { + // If already subscribed, return success (idempotent) + // Don't reveal if email exists for privacy + return NextResponse.json({ + success: true, + message: 'Successfully subscribed to AI features newsletter!', + alreadySubscribed: true, + }); + } + + // Create new subscription + await db.newsletterSubscription.create({ + data: { + email, + source: 'ai-coming-soon', + status: 'subscribed', + }, + }); + + // Send welcome email (don't block response) + sendNewsletterWelcomeEmail(email).catch((error) => { + console.error('Failed to send welcome email (non-blocking):', error); + }); + + return NextResponse.json({ + success: true, + message: 'Successfully subscribed to AI features newsletter!', + alreadySubscribed: false, + }); + } catch (error) { + console.error('Newsletter subscription error:', error); + return NextResponse.json( + { + error: 'Failed to subscribe to newsletter. Please try again.', + }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/qrs/[id]/route.ts b/src/app/(main)/api/qrs/[id]/route.ts index 4bf0c72..6f451c7 100644 --- a/src/app/(main)/api/qrs/[id]/route.ts +++ b/src/app/(main)/api/qrs/[id]/route.ts @@ -1,205 +1,205 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { db } from '@/lib/db'; -import { z } from 'zod'; -import { csrfProtection } from '@/lib/csrf'; -import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; - -const updateQRSchema = z.object({ - title: z.string().min(1).optional(), - content: z.any().optional(), - tags: z.array(z.string()).optional(), - style: z.any().optional(), -}); - -// GET /api/qrs/[id] - Get a single QR code -export async function GET( - request: NextRequest, - { params }: { params: { id: string } } -) { - try { - const userId = cookies().get('userId')?.value; - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - const qrCode = await db.qRCode.findFirst({ - where: { - id: params.id, - userId, - }, - include: { - scans: { - orderBy: { ts: 'desc' }, - take: 100, - }, - }, - }); - - if (!qrCode) { - return NextResponse.json({ error: 'QR code not found' }, { status: 404 }); - } - - return NextResponse.json(qrCode); - } catch (error) { - console.error('Error fetching QR code:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} - -// PATCH /api/qrs/[id] - Update a QR code -export async function PATCH( - request: NextRequest, - { params }: { params: { id: string } } -) { - try { - // CSRF Protection - const csrfCheck = csrfProtection(request); - if (!csrfCheck.valid) { - return NextResponse.json({ error: csrfCheck.error }, { status: 403 }); - } - - const userId = cookies().get('userId')?.value; - - // Rate Limiting (user-based) - const clientId = userId || getClientIdentifier(request); - const rateLimitResult = rateLimit(clientId, RateLimits.QR_MODIFY); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many requests. Please try again later.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) - }, - { - status: 429, - headers: { - 'X-RateLimit-Limit': rateLimitResult.limit.toString(), - 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), - 'X-RateLimit-Reset': rateLimitResult.reset.toString(), - } - } - ); - } - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - const body = await request.json(); - const data = updateQRSchema.parse(body); - - // Check ownership - const existing = await db.qRCode.findFirst({ - where: { - id: params.id, - userId, - }, - }); - - if (!existing) { - return NextResponse.json({ error: 'QR code not found' }, { status: 404 }); - } - - // Static QR codes cannot be edited - if (existing.type === 'STATIC' && data.content) { - return NextResponse.json( - { error: 'Static QR codes cannot be edited' }, - { status: 400 } - ); - } - - // Update QR code - const updated = await db.qRCode.update({ - where: { id: params.id }, - data: { - ...(data.title && { title: data.title }), - ...(data.content && { content: data.content }), - ...(data.tags && { tags: data.tags }), - ...(data.style && { style: data.style }), - }, - }); - - return NextResponse.json(updated); - } catch (error) { - if (error instanceof z.ZodError) { - return NextResponse.json( - { error: 'Invalid input', details: error.errors }, - { status: 400 } - ); - } - - console.error('Error updating QR code:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} - -// DELETE /api/qrs/[id] - Delete a QR code -export async function DELETE( - request: NextRequest, - { params }: { params: { id: string } } -) { - try { - // CSRF Protection - const csrfCheck = csrfProtection(request); - if (!csrfCheck.valid) { - return NextResponse.json({ error: csrfCheck.error }, { status: 403 }); - } - - const userId = cookies().get('userId')?.value; - - // Rate Limiting (user-based) - const clientId = userId || getClientIdentifier(request); - const rateLimitResult = rateLimit(clientId, RateLimits.QR_MODIFY); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many requests. Please try again later.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) - }, - { - status: 429, - headers: { - 'X-RateLimit-Limit': rateLimitResult.limit.toString(), - 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), - 'X-RateLimit-Reset': rateLimitResult.reset.toString(), - } - } - ); - } - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - // Check ownership - const existing = await db.qRCode.findFirst({ - where: { - id: params.id, - userId, - }, - }); - - if (!existing) { - return NextResponse.json({ error: 'QR code not found' }, { status: 404 }); - } - - // Delete QR code (cascades to scans) - await db.qRCode.delete({ - where: { id: params.id }, - }); - - return NextResponse.json({ success: true }); - } catch (error) { - console.error('Error deleting QR code:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { db } from '@/lib/db'; +import { z } from 'zod'; +import { csrfProtection } from '@/lib/csrf'; +import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; + +const updateQRSchema = z.object({ + title: z.string().min(1).optional(), + content: z.any().optional(), + tags: z.array(z.string()).optional(), + style: z.any().optional(), +}); + +// GET /api/qrs/[id] - Get a single QR code +export async function GET( + request: NextRequest, + { params }: { params: { id: string } } +) { + try { + const userId = cookies().get('userId')?.value; + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + const qrCode = await db.qRCode.findFirst({ + where: { + id: params.id, + userId, + }, + include: { + scans: { + orderBy: { ts: 'desc' }, + take: 100, + }, + }, + }); + + if (!qrCode) { + return NextResponse.json({ error: 'QR code not found' }, { status: 404 }); + } + + return NextResponse.json(qrCode); + } catch (error) { + console.error('Error fetching QR code:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} + +// PATCH /api/qrs/[id] - Update a QR code +export async function PATCH( + request: NextRequest, + { params }: { params: { id: string } } +) { + try { + // CSRF Protection + const csrfCheck = csrfProtection(request); + if (!csrfCheck.valid) { + return NextResponse.json({ error: csrfCheck.error }, { status: 403 }); + } + + const userId = cookies().get('userId')?.value; + + // Rate Limiting (user-based) + const clientId = userId || getClientIdentifier(request); + const rateLimitResult = rateLimit(clientId, RateLimits.QR_MODIFY); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many requests. Please try again later.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': rateLimitResult.limit.toString(), + 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), + 'X-RateLimit-Reset': rateLimitResult.reset.toString(), + } + } + ); + } + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + const body = await request.json(); + const data = updateQRSchema.parse(body); + + // Check ownership + const existing = await db.qRCode.findFirst({ + where: { + id: params.id, + userId, + }, + }); + + if (!existing) { + return NextResponse.json({ error: 'QR code not found' }, { status: 404 }); + } + + // Static QR codes cannot be edited + if (existing.type === 'STATIC' && data.content) { + return NextResponse.json( + { error: 'Static QR codes cannot be edited' }, + { status: 400 } + ); + } + + // Update QR code + const updated = await db.qRCode.update({ + where: { id: params.id }, + data: { + ...(data.title && { title: data.title }), + ...(data.content && { content: data.content }), + ...(data.tags && { tags: data.tags }), + ...(data.style && { style: data.style }), + }, + }); + + return NextResponse.json(updated); + } catch (error) { + if (error instanceof z.ZodError) { + return NextResponse.json( + { error: 'Invalid input', details: error.errors }, + { status: 400 } + ); + } + + console.error('Error updating QR code:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} + +// DELETE /api/qrs/[id] - Delete a QR code +export async function DELETE( + request: NextRequest, + { params }: { params: { id: string } } +) { + try { + // CSRF Protection + const csrfCheck = csrfProtection(request); + if (!csrfCheck.valid) { + return NextResponse.json({ error: csrfCheck.error }, { status: 403 }); + } + + const userId = cookies().get('userId')?.value; + + // Rate Limiting (user-based) + const clientId = userId || getClientIdentifier(request); + const rateLimitResult = rateLimit(clientId, RateLimits.QR_MODIFY); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many requests. Please try again later.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': rateLimitResult.limit.toString(), + 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), + 'X-RateLimit-Reset': rateLimitResult.reset.toString(), + } + } + ); + } + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + // Check ownership + const existing = await db.qRCode.findFirst({ + where: { + id: params.id, + userId, + }, + }); + + if (!existing) { + return NextResponse.json({ error: 'QR code not found' }, { status: 404 }); + } + + // Delete QR code (cascades to scans) + await db.qRCode.delete({ + where: { id: params.id }, + }); + + return NextResponse.json({ success: true }); + } catch (error) { + console.error('Error deleting QR code:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } } \ No newline at end of file diff --git a/src/app/(main)/api/qrs/delete-all/route.ts b/src/app/(main)/api/qrs/delete-all/route.ts index 75af392..ced2dde 100644 --- a/src/app/(main)/api/qrs/delete-all/route.ts +++ b/src/app/(main)/api/qrs/delete-all/route.ts @@ -1,60 +1,60 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { db } from '@/lib/db'; -import { csrfProtection } from '@/lib/csrf'; -import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; - -export async function DELETE(request: NextRequest) { - try { - // CSRF Protection - const csrfCheck = csrfProtection(request); - if (!csrfCheck.valid) { - return NextResponse.json( - { error: csrfCheck.error }, - { status: 403 } - ); - } - - const userId = cookies().get('userId')?.value; - - // Rate Limiting (user-based) - const clientId = userId || getClientIdentifier(request); - const rateLimitResult = rateLimit(clientId, RateLimits.QR_DELETE_ALL); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many requests. Please try again later.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) - }, - { - status: 429, - headers: { - 'X-RateLimit-Limit': rateLimitResult.limit.toString(), - 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), - 'X-RateLimit-Reset': rateLimitResult.reset.toString(), - } - } - ); - } - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - // Delete all QR codes for this user - const result = await db.qRCode.deleteMany({ - where: { userId }, - }); - - return NextResponse.json({ - success: true, - deletedCount: result.count, - }); - } catch (error) { - console.error('Error deleting all QR codes:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { db } from '@/lib/db'; +import { csrfProtection } from '@/lib/csrf'; +import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; + +export async function DELETE(request: NextRequest) { + try { + // CSRF Protection + const csrfCheck = csrfProtection(request); + if (!csrfCheck.valid) { + return NextResponse.json( + { error: csrfCheck.error }, + { status: 403 } + ); + } + + const userId = cookies().get('userId')?.value; + + // Rate Limiting (user-based) + const clientId = userId || getClientIdentifier(request); + const rateLimitResult = rateLimit(clientId, RateLimits.QR_DELETE_ALL); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many requests. Please try again later.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': rateLimitResult.limit.toString(), + 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), + 'X-RateLimit-Reset': rateLimitResult.reset.toString(), + } + } + ); + } + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + // Delete all QR codes for this user + const result = await db.qRCode.deleteMany({ + where: { userId }, + }); + + return NextResponse.json({ + success: true, + deletedCount: result.count, + }); + } catch (error) { + console.error('Error deleting all QR codes:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/qrs/static/route.ts b/src/app/(main)/api/qrs/static/route.ts index 5cb6446..65cf04b 100644 --- a/src/app/(main)/api/qrs/static/route.ts +++ b/src/app/(main)/api/qrs/static/route.ts @@ -1,93 +1,93 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { db } from '@/lib/db'; -import { generateSlug } from '@/lib/hash'; - -// POST /api/qrs/static - Create a STATIC QR code that contains the direct URL -export async function POST(request: NextRequest) { - try { - const userId = cookies().get('userId')?.value; - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - const body = await request.json(); - const { title, contentType, content, tags, style } = body; - - // Generate the actual QR content based on type - let qrContent = ''; - switch (contentType) { - case 'URL': - qrContent = content.url; - break; - case 'PHONE': - qrContent = `tel:${content.phone}`; - break; - case 'SMS': - qrContent = `sms:${content.phone}${content.message ? `?body=${encodeURIComponent(content.message)}` : ''}`; - break; - case 'VCARD': - qrContent = `BEGIN:VCARD -VERSION:3.0 -FN:${content.firstName || ''} ${content.lastName || ''} -N:${content.lastName || ''};${content.firstName || ''};;; -${content.organization ? `ORG:${content.organization}` : ''} -${content.title ? `TITLE:${content.title}` : ''} -${content.email ? `EMAIL:${content.email}` : ''} -${content.phone ? `TEL:${content.phone}` : ''} -END:VCARD`; - break; - case 'GEO': - const lat = content.latitude || 0; - const lon = content.longitude || 0; - const label = content.label ? `?q=${encodeURIComponent(content.label)}` : ''; - qrContent = `geo:${lat},${lon}${label}`; - break; - case 'TEXT': - qrContent = content.text; - break; - case 'WHATSAPP': - qrContent = `https://wa.me/${content.phone}${content.message ? `?text=${encodeURIComponent(content.message)}` : ''}`; - break; - default: - qrContent = content.url || 'https://example.com'; - } - - // Store the QR content in a special field - const enrichedContent = { - ...content, - qrContent // This is what the QR code should actually contain - }; - - // Generate slug - const slug = generateSlug(title); - - // Create QR code - const qrCode = await db.qRCode.create({ - data: { - userId, - title, - type: 'STATIC', - contentType, - content: enrichedContent, - tags: tags || [], - style: style || { - foregroundColor: '#000000', - backgroundColor: '#FFFFFF', - cornerStyle: 'square', - size: 200, - }, - slug, - status: 'ACTIVE', - }, - }); - - return NextResponse.json(qrCode); - } catch (error) { - console.error('Error creating static QR code:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { db } from '@/lib/db'; +import { generateSlug } from '@/lib/hash'; + +// POST /api/qrs/static - Create a STATIC QR code that contains the direct URL +export async function POST(request: NextRequest) { + try { + const userId = cookies().get('userId')?.value; + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + const body = await request.json(); + const { title, contentType, content, tags, style } = body; + + // Generate the actual QR content based on type + let qrContent = ''; + switch (contentType) { + case 'URL': + qrContent = content.url; + break; + case 'PHONE': + qrContent = `tel:${content.phone}`; + break; + case 'SMS': + qrContent = `sms:${content.phone}${content.message ? `?body=${encodeURIComponent(content.message)}` : ''}`; + break; + case 'VCARD': + qrContent = `BEGIN:VCARD +VERSION:3.0 +FN:${content.firstName || ''} ${content.lastName || ''} +N:${content.lastName || ''};${content.firstName || ''};;; +${content.organization ? `ORG:${content.organization}` : ''} +${content.title ? `TITLE:${content.title}` : ''} +${content.email ? `EMAIL:${content.email}` : ''} +${content.phone ? `TEL:${content.phone}` : ''} +END:VCARD`; + break; + case 'GEO': + const lat = content.latitude || 0; + const lon = content.longitude || 0; + const label = content.label ? `?q=${encodeURIComponent(content.label)}` : ''; + qrContent = `geo:${lat},${lon}${label}`; + break; + case 'TEXT': + qrContent = content.text; + break; + case 'WHATSAPP': + qrContent = `https://wa.me/${content.phone}${content.message ? `?text=${encodeURIComponent(content.message)}` : ''}`; + break; + default: + qrContent = content.url || 'https://example.com'; + } + + // Store the QR content in a special field + const enrichedContent = { + ...content, + qrContent // This is what the QR code should actually contain + }; + + // Generate slug + const slug = generateSlug(title); + + // Create QR code + const qrCode = await db.qRCode.create({ + data: { + userId, + title, + type: 'STATIC', + contentType, + content: enrichedContent, + tags: tags || [], + style: style || { + foregroundColor: '#000000', + backgroundColor: '#FFFFFF', + cornerStyle: 'square', + size: 200, + }, + slug, + status: 'ACTIVE', + }, + }); + + return NextResponse.json(qrCode); + } catch (error) { + console.error('Error creating static QR code:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } } \ No newline at end of file diff --git a/src/app/(main)/api/stripe/cancel-subscription/route.ts b/src/app/(main)/api/stripe/cancel-subscription/route.ts index 63761eb..d45270f 100644 --- a/src/app/(main)/api/stripe/cancel-subscription/route.ts +++ b/src/app/(main)/api/stripe/cancel-subscription/route.ts @@ -1,89 +1,89 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { stripe } from '@/lib/stripe'; -import { db } from '@/lib/db'; -import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; - -export async function POST(request: NextRequest) { - try { - const userId = cookies().get('userId')?.value; - - // Rate Limiting (user-based) - const clientId = userId || getClientIdentifier(request); - const rateLimitResult = rateLimit(clientId, RateLimits.STRIPE_CANCEL); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many requests. Please try again later.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) - }, - { - status: 429, - headers: { - 'X-RateLimit-Limit': rateLimitResult.limit.toString(), - 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), - 'X-RateLimit-Reset': rateLimitResult.reset.toString(), - } - } - ); - } - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - // Get user with subscription info - const user = await db.user.findUnique({ - where: { id: userId }, - select: { - stripeSubscriptionId: true, - plan: true, - }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - // Already on free plan - if (user.plan === 'FREE') { - return NextResponse.json({ error: 'Already on free plan' }, { status: 400 }); - } - - // No active subscription - if (!user.stripeSubscriptionId) { - // Just update plan to FREE if somehow plan is not FREE but no subscription - await db.user.update({ - where: { id: userId }, - data: { - plan: 'FREE', - stripePriceId: null, - stripeCurrentPeriodEnd: null, - }, - }); - return NextResponse.json({ success: true }); - } - - // Cancel the Stripe subscription - await stripe.subscriptions.cancel(user.stripeSubscriptionId); - - // Update user plan to FREE - await db.user.update({ - where: { id: userId }, - data: { - plan: 'FREE', - stripeSubscriptionId: null, - stripePriceId: null, - stripeCurrentPeriodEnd: null, - }, - }); - - return NextResponse.json({ success: true }); - } catch (error) { - console.error('Error canceling subscription:', error); - return NextResponse.json( - { error: 'Failed to cancel subscription' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { stripe } from '@/lib/stripe'; +import { db } from '@/lib/db'; +import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; + +export async function POST(request: NextRequest) { + try { + const userId = cookies().get('userId')?.value; + + // Rate Limiting (user-based) + const clientId = userId || getClientIdentifier(request); + const rateLimitResult = rateLimit(clientId, RateLimits.STRIPE_CANCEL); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many requests. Please try again later.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': rateLimitResult.limit.toString(), + 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), + 'X-RateLimit-Reset': rateLimitResult.reset.toString(), + } + } + ); + } + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + // Get user with subscription info + const user = await db.user.findUnique({ + where: { id: userId }, + select: { + stripeSubscriptionId: true, + plan: true, + }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + // Already on free plan + if (user.plan === 'FREE') { + return NextResponse.json({ error: 'Already on free plan' }, { status: 400 }); + } + + // No active subscription + if (!user.stripeSubscriptionId) { + // Just update plan to FREE if somehow plan is not FREE but no subscription + await db.user.update({ + where: { id: userId }, + data: { + plan: 'FREE', + stripePriceId: null, + stripeCurrentPeriodEnd: null, + }, + }); + return NextResponse.json({ success: true }); + } + + // Cancel the Stripe subscription + await stripe.subscriptions.cancel(user.stripeSubscriptionId); + + // Update user plan to FREE + await db.user.update({ + where: { id: userId }, + data: { + plan: 'FREE', + stripeSubscriptionId: null, + stripePriceId: null, + stripeCurrentPeriodEnd: null, + }, + }); + + return NextResponse.json({ success: true }); + } catch (error) { + console.error('Error canceling subscription:', error); + return NextResponse.json( + { error: 'Failed to cancel subscription' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/stripe/checkout/route.ts b/src/app/(main)/api/stripe/checkout/route.ts index a71f84e..3721771 100644 --- a/src/app/(main)/api/stripe/checkout/route.ts +++ b/src/app/(main)/api/stripe/checkout/route.ts @@ -1,78 +1,78 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { stripe } from '@/lib/stripe'; -import { db } from '@/lib/db'; -import { cookies } from 'next/headers'; - -export async function POST(request: NextRequest) { - try { - // Get user email from request body (since we're using simple auth, not NextAuth) - const { priceId, plan, userEmail } = await request.json(); - - if (!userEmail) { - return NextResponse.json({ error: 'Unauthorized - No user email provided' }, { status: 401 }); - } - - if (!priceId || !plan) { - return NextResponse.json( - { error: 'Missing priceId or plan' }, - { status: 400 } - ); - } - - // Get user from database - const user = await db.user.findUnique({ - where: { email: userEmail }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - // Create or get Stripe customer - let customerId = user.stripeCustomerId; - - if (!customerId) { - const customer = await stripe.customers.create({ - email: user.email, - metadata: { - userId: user.id, - }, - }); - - customerId = customer.id; - - // Update user with Stripe customer ID - await db.user.update({ - where: { id: user.id }, - data: { stripeCustomerId: customerId }, - }); - } - - // Create Stripe Checkout Session - const checkoutSession = await stripe.checkout.sessions.create({ - customer: customerId, - mode: 'subscription', - payment_method_types: ['card'], - line_items: [ - { - price: priceId, - quantity: 1, - }, - ], - success_url: `${process.env.NEXT_PUBLIC_APP_URL}/dashboard?success=true`, - cancel_url: `${process.env.NEXT_PUBLIC_APP_URL}/pricing?canceled=true`, - metadata: { - userId: user.id, - plan, - }, - }); - - return NextResponse.json({ url: checkoutSession.url }); - } catch (error) { - console.error('Error creating checkout session:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { stripe } from '@/lib/stripe'; +import { db } from '@/lib/db'; +import { cookies } from 'next/headers'; + +export async function POST(request: NextRequest) { + try { + // Get user email from request body (since we're using simple auth, not NextAuth) + const { priceId, plan, userEmail } = await request.json(); + + if (!userEmail) { + return NextResponse.json({ error: 'Unauthorized - No user email provided' }, { status: 401 }); + } + + if (!priceId || !plan) { + return NextResponse.json( + { error: 'Missing priceId or plan' }, + { status: 400 } + ); + } + + // Get user from database + const user = await db.user.findUnique({ + where: { email: userEmail }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + // Create or get Stripe customer + let customerId = user.stripeCustomerId; + + if (!customerId) { + const customer = await stripe.customers.create({ + email: user.email, + metadata: { + userId: user.id, + }, + }); + + customerId = customer.id; + + // Update user with Stripe customer ID + await db.user.update({ + where: { id: user.id }, + data: { stripeCustomerId: customerId }, + }); + } + + // Create Stripe Checkout Session + const checkoutSession = await stripe.checkout.sessions.create({ + customer: customerId, + mode: 'subscription', + payment_method_types: ['card'], + line_items: [ + { + price: priceId, + quantity: 1, + }, + ], + success_url: `${process.env.NEXT_PUBLIC_APP_URL}/dashboard?success=true`, + cancel_url: `${process.env.NEXT_PUBLIC_APP_URL}/pricing?canceled=true`, + metadata: { + userId: user.id, + plan, + }, + }); + + return NextResponse.json({ url: checkoutSession.url }); + } catch (error) { + console.error('Error creating checkout session:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/stripe/create-checkout-session/route.ts b/src/app/(main)/api/stripe/create-checkout-session/route.ts index be595b6..486c0f2 100644 --- a/src/app/(main)/api/stripe/create-checkout-session/route.ts +++ b/src/app/(main)/api/stripe/create-checkout-session/route.ts @@ -1,115 +1,115 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { stripe, STRIPE_PLANS } from '@/lib/stripe'; -import { db } from '@/lib/db'; -import { cookies } from 'next/headers'; -import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; - -export async function POST(request: NextRequest) { - try { - // Get user from cookie (using userId like other routes) - const cookieStore = await cookies(); - const userId = cookieStore.get('userId')?.value; - - // Rate Limiting (user-based) - const clientId = userId || getClientIdentifier(request); - const rateLimitResult = rateLimit(clientId, RateLimits.STRIPE_CHECKOUT); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many requests. Please try again later.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) - }, - { - status: 429, - headers: { - 'X-RateLimit-Limit': rateLimitResult.limit.toString(), - 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), - 'X-RateLimit-Reset': rateLimitResult.reset.toString(), - } - } - ); - } - - if (!userId) { - return NextResponse.json({ error: 'Unauthorized - Please log in' }, { status: 401 }); - } - - // Get plan and billing interval from request - const { plan, billingInterval = 'month' } = await request.json(); - - if (!plan || !['PRO', 'BUSINESS'].includes(plan)) { - return NextResponse.json( - { error: 'Invalid plan. Must be PRO or BUSINESS' }, - { status: 400 } - ); - } - - // Get the Stripe price ID for the plan - const planConfig = STRIPE_PLANS[plan as 'PRO' | 'BUSINESS']; - const priceId = billingInterval === 'year' ? planConfig.priceIdYearly : planConfig.priceId; - - if (!priceId) { - return NextResponse.json( - { error: 'Stripe price ID not configured for this plan' }, - { status: 500 } - ); - } - - // Get user from database - const user = await db.user.findUnique({ - where: { id: userId }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - // Create or get Stripe customer - let customerId = user.stripeCustomerId; - - if (!customerId) { - const customer = await stripe.customers.create({ - email: user.email, - metadata: { - userId: user.id, - }, - }); - - customerId = customer.id; - - // Update user with Stripe customer ID - await db.user.update({ - where: { id: user.id }, - data: { stripeCustomerId: customerId }, - }); - } - - // Create Stripe Checkout Session - const checkoutSession = await stripe.checkout.sessions.create({ - customer: customerId, - mode: 'subscription', - payment_method_types: ['card'], - line_items: [ - { - price: priceId, - quantity: 1, - }, - ], - success_url: `${process.env.NEXT_PUBLIC_APP_URL}/dashboard?success=true`, - cancel_url: `${process.env.NEXT_PUBLIC_APP_URL}/pricing?canceled=true`, - metadata: { - userId: user.id, - plan, - }, - }); - - return NextResponse.json({ url: checkoutSession.url }); - } catch (error) { - console.error('Error creating checkout session:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { stripe, STRIPE_PLANS } from '@/lib/stripe'; +import { db } from '@/lib/db'; +import { cookies } from 'next/headers'; +import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; + +export async function POST(request: NextRequest) { + try { + // Get user from cookie (using userId like other routes) + const cookieStore = await cookies(); + const userId = cookieStore.get('userId')?.value; + + // Rate Limiting (user-based) + const clientId = userId || getClientIdentifier(request); + const rateLimitResult = rateLimit(clientId, RateLimits.STRIPE_CHECKOUT); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many requests. Please try again later.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': rateLimitResult.limit.toString(), + 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), + 'X-RateLimit-Reset': rateLimitResult.reset.toString(), + } + } + ); + } + + if (!userId) { + return NextResponse.json({ error: 'Unauthorized - Please log in' }, { status: 401 }); + } + + // Get plan and billing interval from request + const { plan, billingInterval = 'month' } = await request.json(); + + if (!plan || !['PRO', 'BUSINESS'].includes(plan)) { + return NextResponse.json( + { error: 'Invalid plan. Must be PRO or BUSINESS' }, + { status: 400 } + ); + } + + // Get the Stripe price ID for the plan + const planConfig = STRIPE_PLANS[plan as 'PRO' | 'BUSINESS']; + const priceId = billingInterval === 'year' ? planConfig.priceIdYearly : planConfig.priceId; + + if (!priceId) { + return NextResponse.json( + { error: 'Stripe price ID not configured for this plan' }, + { status: 500 } + ); + } + + // Get user from database + const user = await db.user.findUnique({ + where: { id: userId }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + // Create or get Stripe customer + let customerId = user.stripeCustomerId; + + if (!customerId) { + const customer = await stripe.customers.create({ + email: user.email, + metadata: { + userId: user.id, + }, + }); + + customerId = customer.id; + + // Update user with Stripe customer ID + await db.user.update({ + where: { id: user.id }, + data: { stripeCustomerId: customerId }, + }); + } + + // Create Stripe Checkout Session + const checkoutSession = await stripe.checkout.sessions.create({ + customer: customerId, + mode: 'subscription', + payment_method_types: ['card'], + line_items: [ + { + price: priceId, + quantity: 1, + }, + ], + success_url: `${process.env.NEXT_PUBLIC_APP_URL}/dashboard?success=true`, + cancel_url: `${process.env.NEXT_PUBLIC_APP_URL}/pricing?canceled=true`, + metadata: { + userId: user.id, + plan, + }, + }); + + return NextResponse.json({ url: checkoutSession.url }); + } catch (error) { + console.error('Error creating checkout session:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/stripe/portal/route.ts b/src/app/(main)/api/stripe/portal/route.ts index 0528e8b..52c4580 100644 --- a/src/app/(main)/api/stripe/portal/route.ts +++ b/src/app/(main)/api/stripe/portal/route.ts @@ -1,70 +1,70 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { stripe } from '@/lib/stripe'; -import { db } from '@/lib/db'; -import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; - -export async function POST(request: NextRequest) { - try { - const userId = cookies().get('userId')?.value; - - // Rate Limiting (user-based) - const clientId = userId || getClientIdentifier(request); - const rateLimitResult = rateLimit(clientId, RateLimits.STRIPE_PORTAL); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many requests. Please try again later.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) - }, - { - status: 429, - headers: { - 'X-RateLimit-Limit': rateLimitResult.limit.toString(), - 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), - 'X-RateLimit-Reset': rateLimitResult.reset.toString(), - } - } - ); - } - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - // Get user with Stripe customer ID - const user = await db.user.findUnique({ - where: { id: userId }, - select: { - stripeCustomerId: true, - email: true, - }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - // If user doesn't have a Stripe customer ID, they can't access the portal - if (!user.stripeCustomerId) { - return NextResponse.json( - { error: 'No active subscription found' }, - { status: 400 } - ); - } - - // Create Stripe Customer Portal session - const portalSession = await stripe.billingPortal.sessions.create({ - customer: user.stripeCustomerId, - return_url: `${process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000'}/settings`, - }); - - return NextResponse.json({ url: portalSession.url }); - } catch (error) { - console.error('Error creating portal session:', error); - return NextResponse.json( - { error: 'Failed to create portal session' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { stripe } from '@/lib/stripe'; +import { db } from '@/lib/db'; +import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; + +export async function POST(request: NextRequest) { + try { + const userId = cookies().get('userId')?.value; + + // Rate Limiting (user-based) + const clientId = userId || getClientIdentifier(request); + const rateLimitResult = rateLimit(clientId, RateLimits.STRIPE_PORTAL); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many requests. Please try again later.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': rateLimitResult.limit.toString(), + 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), + 'X-RateLimit-Reset': rateLimitResult.reset.toString(), + } + } + ); + } + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + // Get user with Stripe customer ID + const user = await db.user.findUnique({ + where: { id: userId }, + select: { + stripeCustomerId: true, + email: true, + }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + // If user doesn't have a Stripe customer ID, they can't access the portal + if (!user.stripeCustomerId) { + return NextResponse.json( + { error: 'No active subscription found' }, + { status: 400 } + ); + } + + // Create Stripe Customer Portal session + const portalSession = await stripe.billingPortal.sessions.create({ + customer: user.stripeCustomerId, + return_url: `${process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000'}/settings`, + }); + + return NextResponse.json({ url: portalSession.url }); + } catch (error) { + console.error('Error creating portal session:', error); + return NextResponse.json( + { error: 'Failed to create portal session' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/stripe/sync-subscription/route.ts b/src/app/(main)/api/stripe/sync-subscription/route.ts index 172e406..b472fdf 100644 --- a/src/app/(main)/api/stripe/sync-subscription/route.ts +++ b/src/app/(main)/api/stripe/sync-subscription/route.ts @@ -1,113 +1,113 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { stripe } from '@/lib/stripe'; -import { db } from '@/lib/db'; - -/** - * Manual sync endpoint to update user subscription from Stripe - * Use this if the automatic webhook/verify failed - */ -export async function POST(request: NextRequest) { - try { - // Use cookie-based auth - const userId = cookies().get('userId')?.value; - - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - const user = await db.user.findUnique({ - where: { id: userId }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - if (!user.stripeCustomerId) { - return NextResponse.json({ error: 'No Stripe customer ID' }, { status: 400 }); - } - - // Get all subscriptions for this customer - const subscriptions = await stripe.subscriptions.list({ - customer: user.stripeCustomerId, - status: 'active', - limit: 1, - }); - - if (subscriptions.data.length === 0) { - // No active subscription - set to FREE - await db.user.update({ - where: { id: user.id }, - data: { - stripeSubscriptionId: null, - stripePriceId: null, - stripeCurrentPeriodEnd: null, - plan: 'FREE', - }, - }); - - return NextResponse.json({ - success: true, - plan: 'FREE', - message: 'No active subscription found, set to FREE plan', - }); - } - - const subscription: any = subscriptions.data[0]; - - // Determine plan from price ID - const priceId = subscription.items.data[0]?.price?.id; - let plan = 'PRO'; // default - - // Check against known price IDs - if (priceId === process.env.STRIPE_PRICE_ID_BUSINESS_MONTHLY || - priceId === process.env.STRIPE_PRICE_ID_BUSINESS_YEARLY) { - plan = 'BUSINESS'; - } else if (priceId === process.env.STRIPE_PRICE_ID_PRO_MONTHLY || - priceId === process.env.STRIPE_PRICE_ID_PRO_YEARLY) { - plan = 'PRO'; - } - - // Get current_period_end - const periodEndTimestamp = subscription.current_period_end - || subscription.currentPeriodEnd - || subscription.billing_cycle_anchor; - - const currentPeriodEnd = periodEndTimestamp - ? new Date(periodEndTimestamp * 1000) - : new Date(Date.now() + 30 * 24 * 60 * 60 * 1000); - - console.log('Syncing subscription:', { - subscriptionId: subscription.id, - priceId, - plan, - periodEndTimestamp, - currentPeriodEnd, - }); - - // Update user in database - await db.user.update({ - where: { id: user.id }, - data: { - stripeSubscriptionId: subscription.id, - stripePriceId: priceId, - stripeCurrentPeriodEnd: currentPeriodEnd, - plan: plan as any, - }, - }); - - return NextResponse.json({ - success: true, - plan, - subscriptionId: subscription.id, - currentPeriodEnd, - }); - } catch (error) { - console.error('Error syncing subscription:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { stripe } from '@/lib/stripe'; +import { db } from '@/lib/db'; + +/** + * Manual sync endpoint to update user subscription from Stripe + * Use this if the automatic webhook/verify failed + */ +export async function POST(request: NextRequest) { + try { + // Use cookie-based auth + const userId = cookies().get('userId')?.value; + + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + const user = await db.user.findUnique({ + where: { id: userId }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + if (!user.stripeCustomerId) { + return NextResponse.json({ error: 'No Stripe customer ID' }, { status: 400 }); + } + + // Get all subscriptions for this customer + const subscriptions = await stripe.subscriptions.list({ + customer: user.stripeCustomerId, + status: 'active', + limit: 1, + }); + + if (subscriptions.data.length === 0) { + // No active subscription - set to FREE + await db.user.update({ + where: { id: user.id }, + data: { + stripeSubscriptionId: null, + stripePriceId: null, + stripeCurrentPeriodEnd: null, + plan: 'FREE', + }, + }); + + return NextResponse.json({ + success: true, + plan: 'FREE', + message: 'No active subscription found, set to FREE plan', + }); + } + + const subscription: any = subscriptions.data[0]; + + // Determine plan from price ID + const priceId = subscription.items.data[0]?.price?.id; + let plan = 'PRO'; // default + + // Check against known price IDs + if (priceId === process.env.STRIPE_PRICE_ID_BUSINESS_MONTHLY || + priceId === process.env.STRIPE_PRICE_ID_BUSINESS_YEARLY) { + plan = 'BUSINESS'; + } else if (priceId === process.env.STRIPE_PRICE_ID_PRO_MONTHLY || + priceId === process.env.STRIPE_PRICE_ID_PRO_YEARLY) { + plan = 'PRO'; + } + + // Get current_period_end + const periodEndTimestamp = subscription.current_period_end + || subscription.currentPeriodEnd + || subscription.billing_cycle_anchor; + + const currentPeriodEnd = periodEndTimestamp + ? new Date(periodEndTimestamp * 1000) + : new Date(Date.now() + 30 * 24 * 60 * 60 * 1000); + + console.log('Syncing subscription:', { + subscriptionId: subscription.id, + priceId, + plan, + periodEndTimestamp, + currentPeriodEnd, + }); + + // Update user in database + await db.user.update({ + where: { id: user.id }, + data: { + stripeSubscriptionId: subscription.id, + stripePriceId: priceId, + stripeCurrentPeriodEnd: currentPeriodEnd, + plan: plan as any, + }, + }); + + return NextResponse.json({ + success: true, + plan, + subscriptionId: subscription.id, + currentPeriodEnd, + }); + } catch (error) { + console.error('Error syncing subscription:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/stripe/verify-session/route.ts b/src/app/(main)/api/stripe/verify-session/route.ts index 2a99cd5..a05bfd1 100644 --- a/src/app/(main)/api/stripe/verify-session/route.ts +++ b/src/app/(main)/api/stripe/verify-session/route.ts @@ -1,97 +1,97 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { stripe } from '@/lib/stripe'; -import { db } from '@/lib/db'; - -export async function POST(request: NextRequest) { - try { - // Use cookie-based auth instead of NextAuth - const userId = cookies().get('userId')?.value; - - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - const user = await db.user.findUnique({ - where: { id: userId }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - if (!user.stripeCustomerId) { - return NextResponse.json({ error: 'No Stripe customer ID' }, { status: 400 }); - } - - // Get the most recent checkout session for this customer - const checkoutSessions = await stripe.checkout.sessions.list({ - customer: user.stripeCustomerId, - limit: 1, - }); - - if (checkoutSessions.data.length === 0) { - return NextResponse.json({ error: 'No checkout session found' }, { status: 404 }); - } - - const checkoutSession = checkoutSessions.data[0]; - - // Only process if payment was successful - if (checkoutSession.payment_status === 'paid' && checkoutSession.subscription) { - const subscriptionId = typeof checkoutSession.subscription === 'string' - ? checkoutSession.subscription - : checkoutSession.subscription.id; - - // Retrieve the full subscription object - const subscription: any = await stripe.subscriptions.retrieve(subscriptionId); - - // Determine plan from metadata or price ID - const plan = checkoutSession.metadata?.plan || 'PRO'; - - // Debug log to see the subscription structure - console.log('Full subscription object:', JSON.stringify(subscription, null, 2)); - - // Get current_period_end - Stripe returns it as a Unix timestamp - // Try different possible field names - const periodEndTimestamp = subscription.current_period_end - || subscription.currentPeriodEnd - || subscription.billing_cycle_anchor; - - const currentPeriodEnd = periodEndTimestamp - ? new Date(periodEndTimestamp * 1000) - : new Date(Date.now() + 30 * 24 * 60 * 60 * 1000); // Default to 30 days from now - - console.log('Subscription data:', { - id: subscription.id, - periodEndTimestamp, - currentPeriodEnd, - priceId: subscription.items?.data?.[0]?.price?.id, - }); - - // Update user in database - await db.user.update({ - where: { id: user.id }, - data: { - stripeSubscriptionId: subscription.id, - stripePriceId: subscription.items.data[0].price.id, - stripeCurrentPeriodEnd: currentPeriodEnd, - plan: plan as any, - }, - }); - - return NextResponse.json({ - success: true, - plan, - subscriptionId: subscription.id, - }); - } - - return NextResponse.json({ error: 'Payment not completed' }, { status: 400 }); - } catch (error) { - console.error('Error verifying session:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { stripe } from '@/lib/stripe'; +import { db } from '@/lib/db'; + +export async function POST(request: NextRequest) { + try { + // Use cookie-based auth instead of NextAuth + const userId = cookies().get('userId')?.value; + + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + const user = await db.user.findUnique({ + where: { id: userId }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + if (!user.stripeCustomerId) { + return NextResponse.json({ error: 'No Stripe customer ID' }, { status: 400 }); + } + + // Get the most recent checkout session for this customer + const checkoutSessions = await stripe.checkout.sessions.list({ + customer: user.stripeCustomerId, + limit: 1, + }); + + if (checkoutSessions.data.length === 0) { + return NextResponse.json({ error: 'No checkout session found' }, { status: 404 }); + } + + const checkoutSession = checkoutSessions.data[0]; + + // Only process if payment was successful + if (checkoutSession.payment_status === 'paid' && checkoutSession.subscription) { + const subscriptionId = typeof checkoutSession.subscription === 'string' + ? checkoutSession.subscription + : checkoutSession.subscription.id; + + // Retrieve the full subscription object + const subscription: any = await stripe.subscriptions.retrieve(subscriptionId); + + // Determine plan from metadata or price ID + const plan = checkoutSession.metadata?.plan || 'PRO'; + + // Debug log to see the subscription structure + console.log('Full subscription object:', JSON.stringify(subscription, null, 2)); + + // Get current_period_end - Stripe returns it as a Unix timestamp + // Try different possible field names + const periodEndTimestamp = subscription.current_period_end + || subscription.currentPeriodEnd + || subscription.billing_cycle_anchor; + + const currentPeriodEnd = periodEndTimestamp + ? new Date(periodEndTimestamp * 1000) + : new Date(Date.now() + 30 * 24 * 60 * 60 * 1000); // Default to 30 days from now + + console.log('Subscription data:', { + id: subscription.id, + periodEndTimestamp, + currentPeriodEnd, + priceId: subscription.items?.data?.[0]?.price?.id, + }); + + // Update user in database + await db.user.update({ + where: { id: user.id }, + data: { + stripeSubscriptionId: subscription.id, + stripePriceId: subscription.items.data[0].price.id, + stripeCurrentPeriodEnd: currentPeriodEnd, + plan: plan as any, + }, + }); + + return NextResponse.json({ + success: true, + plan, + subscriptionId: subscription.id, + }); + } + + return NextResponse.json({ error: 'Payment not completed' }, { status: 400 }); + } catch (error) { + console.error('Error verifying session:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/stripe/webhook/route.ts b/src/app/(main)/api/stripe/webhook/route.ts index c63d47a..17a791f 100644 --- a/src/app/(main)/api/stripe/webhook/route.ts +++ b/src/app/(main)/api/stripe/webhook/route.ts @@ -1,116 +1,116 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { headers } from 'next/headers'; -import { stripe } from '@/lib/stripe'; -import { db } from '@/lib/db'; -import Stripe from 'stripe'; - -export async function POST(request: NextRequest) { - const body = await request.text(); - const signature = headers().get('stripe-signature'); - - if (!signature) { - return NextResponse.json( - { error: 'No signature' }, - { status: 400 } - ); - } - - let event: Stripe.Event; - - try { - event = stripe.webhooks.constructEvent( - body, - signature, - process.env.STRIPE_WEBHOOK_SECRET! - ); - } catch (error) { - console.error('Webhook signature verification failed:', error); - return NextResponse.json( - { error: 'Invalid signature' }, - { status: 400 } - ); - } - - try { - switch (event.type) { - case 'checkout.session.completed': { - const session = event.data.object as Stripe.Checkout.Session; - - if (session.mode === 'subscription') { - const subscription: any = await stripe.subscriptions.retrieve( - session.subscription as string - ); - - const periodEndTimestamp = subscription.current_period_end - || subscription.currentPeriodEnd - || subscription.billing_cycle_anchor; - - const currentPeriodEnd = periodEndTimestamp - ? new Date(periodEndTimestamp * 1000) - : new Date(Date.now() + 30 * 24 * 60 * 60 * 1000); - - await db.user.update({ - where: { - stripeCustomerId: session.customer as string, - }, - data: { - stripeSubscriptionId: subscription.id, - stripePriceId: subscription.items.data[0].price.id, - stripeCurrentPeriodEnd: currentPeriodEnd, - plan: (session.metadata?.plan || 'FREE') as any, - }, - }); - } - break; - } - - case 'customer.subscription.updated': { - const subscription: any = event.data.object as Stripe.Subscription; - - const periodEndTimestamp = subscription.current_period_end - || subscription.currentPeriodEnd - || subscription.billing_cycle_anchor; - - const currentPeriodEnd = periodEndTimestamp - ? new Date(periodEndTimestamp * 1000) - : new Date(Date.now() + 30 * 24 * 60 * 60 * 1000); - - await db.user.update({ - where: { - stripeSubscriptionId: subscription.id, - }, - data: { - stripePriceId: subscription.items.data[0].price.id, - stripeCurrentPeriodEnd: currentPeriodEnd, - }, - }); - break; - } - - case 'customer.subscription.deleted': { - const subscription = event.data.object as Stripe.Subscription; - - await db.user.update({ - where: { - stripeSubscriptionId: subscription.id, - }, - data: { - stripeSubscriptionId: null, - stripePriceId: null, - stripeCurrentPeriodEnd: null, - plan: 'FREE', - }, - }); - break; - } - } - - return NextResponse.json({ received: true }); - } catch (error) { - console.error('Error processing webhook:', error); - return NextResponse.json( - { error: 'Webhook processing failed' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { headers } from 'next/headers'; +import { stripe } from '@/lib/stripe'; +import { db } from '@/lib/db'; +import Stripe from 'stripe'; + +export async function POST(request: NextRequest) { + const body = await request.text(); + const signature = headers().get('stripe-signature'); + + if (!signature) { + return NextResponse.json( + { error: 'No signature' }, + { status: 400 } + ); + } + + let event: Stripe.Event; + + try { + event = stripe.webhooks.constructEvent( + body, + signature, + process.env.STRIPE_WEBHOOK_SECRET! + ); + } catch (error) { + console.error('Webhook signature verification failed:', error); + return NextResponse.json( + { error: 'Invalid signature' }, + { status: 400 } + ); + } + + try { + switch (event.type) { + case 'checkout.session.completed': { + const session = event.data.object as Stripe.Checkout.Session; + + if (session.mode === 'subscription') { + const subscription: any = await stripe.subscriptions.retrieve( + session.subscription as string + ); + + const periodEndTimestamp = subscription.current_period_end + || subscription.currentPeriodEnd + || subscription.billing_cycle_anchor; + + const currentPeriodEnd = periodEndTimestamp + ? new Date(periodEndTimestamp * 1000) + : new Date(Date.now() + 30 * 24 * 60 * 60 * 1000); + + await db.user.update({ + where: { + stripeCustomerId: session.customer as string, + }, + data: { + stripeSubscriptionId: subscription.id, + stripePriceId: subscription.items.data[0].price.id, + stripeCurrentPeriodEnd: currentPeriodEnd, + plan: (session.metadata?.plan || 'FREE') as any, + }, + }); + } + break; + } + + case 'customer.subscription.updated': { + const subscription: any = event.data.object as Stripe.Subscription; + + const periodEndTimestamp = subscription.current_period_end + || subscription.currentPeriodEnd + || subscription.billing_cycle_anchor; + + const currentPeriodEnd = periodEndTimestamp + ? new Date(periodEndTimestamp * 1000) + : new Date(Date.now() + 30 * 24 * 60 * 60 * 1000); + + await db.user.update({ + where: { + stripeSubscriptionId: subscription.id, + }, + data: { + stripePriceId: subscription.items.data[0].price.id, + stripeCurrentPeriodEnd: currentPeriodEnd, + }, + }); + break; + } + + case 'customer.subscription.deleted': { + const subscription = event.data.object as Stripe.Subscription; + + await db.user.update({ + where: { + stripeSubscriptionId: subscription.id, + }, + data: { + stripeSubscriptionId: null, + stripePriceId: null, + stripeCurrentPeriodEnd: null, + plan: 'FREE', + }, + }); + break; + } + } + + return NextResponse.json({ received: true }); + } catch (error) { + console.error('Error processing webhook:', error); + return NextResponse.json( + { error: 'Webhook processing failed' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/user/debug/route.ts b/src/app/(main)/api/user/debug/route.ts index ceadedf..2f40a8d 100644 --- a/src/app/(main)/api/user/debug/route.ts +++ b/src/app/(main)/api/user/debug/route.ts @@ -1,41 +1,41 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { db } from '@/lib/db'; - -export const dynamic = 'force-dynamic'; - -export async function GET(request: NextRequest) { - try { - const userId = cookies().get('userId')?.value; - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - // Get user from database - const user = await db.user.findUnique({ - where: { id: userId }, - select: { - id: true, - email: true, - name: true, - createdAt: true, - updatedAt: true, - }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - return NextResponse.json({ - database: user, - localStorage: 'Check in browser console', - }); - } catch (error) { - console.error('Debug error:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { db } from '@/lib/db'; + +export const dynamic = 'force-dynamic'; + +export async function GET(request: NextRequest) { + try { + const userId = cookies().get('userId')?.value; + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + // Get user from database + const user = await db.user.findUnique({ + where: { id: userId }, + select: { + id: true, + email: true, + name: true, + createdAt: true, + updatedAt: true, + }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + return NextResponse.json({ + database: user, + localStorage: 'Check in browser console', + }); + } catch (error) { + console.error('Debug error:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/user/delete/route.ts b/src/app/(main)/api/user/delete/route.ts index 7915704..1b7fdbb 100644 --- a/src/app/(main)/api/user/delete/route.ts +++ b/src/app/(main)/api/user/delete/route.ts @@ -1,86 +1,86 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { db } from '@/lib/db'; -import { stripe } from '@/lib/stripe'; -import { csrfProtection } from '@/lib/csrf'; -import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; - -export async function DELETE(request: NextRequest) { - try { - // CSRF Protection - const csrfCheck = csrfProtection(request); - if (!csrfCheck.valid) { - return NextResponse.json( - { error: csrfCheck.error }, - { status: 403 } - ); - } - - const userId = cookies().get('userId')?.value; - - // Rate Limiting (user-based) - const clientId = userId || getClientIdentifier(request); - const rateLimitResult = rateLimit(clientId, RateLimits.ACCOUNT_DELETE); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many requests. Please try again later.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) - }, - { - status: 429, - headers: { - 'X-RateLimit-Limit': rateLimitResult.limit.toString(), - 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), - 'X-RateLimit-Reset': rateLimitResult.reset.toString(), - } - } - ); - } - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - // Get user data including Stripe information - const user = await db.user.findUnique({ - where: { id: userId }, - select: { - id: true, - stripeSubscriptionId: true, - stripeCustomerId: true, - plan: true, - }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - // Cancel Stripe subscription if user has one - if (user.stripeSubscriptionId && user.plan !== 'FREE') { - try { - await stripe.subscriptions.cancel(user.stripeSubscriptionId); - } catch (stripeError) { - console.error('Error canceling Stripe subscription:', stripeError); - // Continue with deletion even if Stripe cancellation fails - } - } - - // Delete user and all related data (cascading deletes should handle QR codes, scans, etc.) - await db.user.delete({ - where: { id: userId }, - }); - - // Clear auth cookie - cookies().delete('userId'); - - return NextResponse.json({ success: true }); - } catch (error) { - console.error('Error deleting account:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { db } from '@/lib/db'; +import { stripe } from '@/lib/stripe'; +import { csrfProtection } from '@/lib/csrf'; +import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; + +export async function DELETE(request: NextRequest) { + try { + // CSRF Protection + const csrfCheck = csrfProtection(request); + if (!csrfCheck.valid) { + return NextResponse.json( + { error: csrfCheck.error }, + { status: 403 } + ); + } + + const userId = cookies().get('userId')?.value; + + // Rate Limiting (user-based) + const clientId = userId || getClientIdentifier(request); + const rateLimitResult = rateLimit(clientId, RateLimits.ACCOUNT_DELETE); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many requests. Please try again later.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': rateLimitResult.limit.toString(), + 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), + 'X-RateLimit-Reset': rateLimitResult.reset.toString(), + } + } + ); + } + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + // Get user data including Stripe information + const user = await db.user.findUnique({ + where: { id: userId }, + select: { + id: true, + stripeSubscriptionId: true, + stripeCustomerId: true, + plan: true, + }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + // Cancel Stripe subscription if user has one + if (user.stripeSubscriptionId && user.plan !== 'FREE') { + try { + await stripe.subscriptions.cancel(user.stripeSubscriptionId); + } catch (stripeError) { + console.error('Error canceling Stripe subscription:', stripeError); + // Continue with deletion even if Stripe cancellation fails + } + } + + // Delete user and all related data (cascading deletes should handle QR codes, scans, etc.) + await db.user.delete({ + where: { id: userId }, + }); + + // Clear auth cookie + cookies().delete('userId'); + + return NextResponse.json({ success: true }); + } catch (error) { + console.error('Error deleting account:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/user/password/route.ts b/src/app/(main)/api/user/password/route.ts index ac54e69..2f389bb 100644 --- a/src/app/(main)/api/user/password/route.ts +++ b/src/app/(main)/api/user/password/route.ts @@ -1,103 +1,103 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { db } from '@/lib/db'; -import bcrypt from 'bcryptjs'; -import { csrfProtection } from '@/lib/csrf'; -import { changePasswordSchema, validateRequest } from '@/lib/validationSchemas'; -import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; - -export async function PATCH(request: NextRequest) { - try { - // CSRF Protection - const csrfCheck = csrfProtection(request); - if (!csrfCheck.valid) { - return NextResponse.json( - { error: csrfCheck.error }, - { status: 403 } - ); - } - - const userId = cookies().get('userId')?.value; - - // Rate Limiting (user-based) - const clientId = userId || getClientIdentifier(request); - const rateLimitResult = rateLimit(clientId, RateLimits.PASSWORD_CHANGE); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many requests. Please try again later.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) - }, - { - status: 429, - headers: { - 'X-RateLimit-Limit': rateLimitResult.limit.toString(), - 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), - 'X-RateLimit-Reset': rateLimitResult.reset.toString(), - } - } - ); - } - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - const body = await request.json(); - - // Validate request body - const validation = await validateRequest(changePasswordSchema, body); - if (!validation.success) { - return NextResponse.json(validation.error, { status: 400 }); - } - - const { currentPassword, newPassword } = validation.data; - - // Get user with password - const user = await db.user.findUnique({ - where: { id: userId }, - select: { - id: true, - password: true, - }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - // Check if user has a password (OAuth users don't have passwords) - if (!user.password) { - return NextResponse.json( - { error: 'Cannot change password for OAuth accounts' }, - { status: 400 } - ); - } - - // Verify current password - const isPasswordValid = await bcrypt.compare(currentPassword, user.password); - if (!isPasswordValid) { - return NextResponse.json( - { error: 'Current password is incorrect' }, - { status: 400 } - ); - } - - // Hash new password - const hashedPassword = await bcrypt.hash(newPassword, 10); - - // Update password - await db.user.update({ - where: { id: userId }, - data: { password: hashedPassword }, - }); - - return NextResponse.json({ success: true }); - } catch (error) { - console.error('Error changing password:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { db } from '@/lib/db'; +import bcrypt from 'bcryptjs'; +import { csrfProtection } from '@/lib/csrf'; +import { changePasswordSchema, validateRequest } from '@/lib/validationSchemas'; +import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; + +export async function PATCH(request: NextRequest) { + try { + // CSRF Protection + const csrfCheck = csrfProtection(request); + if (!csrfCheck.valid) { + return NextResponse.json( + { error: csrfCheck.error }, + { status: 403 } + ); + } + + const userId = cookies().get('userId')?.value; + + // Rate Limiting (user-based) + const clientId = userId || getClientIdentifier(request); + const rateLimitResult = rateLimit(clientId, RateLimits.PASSWORD_CHANGE); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many requests. Please try again later.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': rateLimitResult.limit.toString(), + 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), + 'X-RateLimit-Reset': rateLimitResult.reset.toString(), + } + } + ); + } + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + const body = await request.json(); + + // Validate request body + const validation = await validateRequest(changePasswordSchema, body); + if (!validation.success) { + return NextResponse.json(validation.error, { status: 400 }); + } + + const { currentPassword, newPassword } = validation.data; + + // Get user with password + const user = await db.user.findUnique({ + where: { id: userId }, + select: { + id: true, + password: true, + }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + // Check if user has a password (OAuth users don't have passwords) + if (!user.password) { + return NextResponse.json( + { error: 'Cannot change password for OAuth accounts' }, + { status: 400 } + ); + } + + // Verify current password + const isPasswordValid = await bcrypt.compare(currentPassword, user.password); + if (!isPasswordValid) { + return NextResponse.json( + { error: 'Current password is incorrect' }, + { status: 400 } + ); + } + + // Hash new password + const hashedPassword = await bcrypt.hash(newPassword, 10); + + // Update password + await db.user.update({ + where: { id: userId }, + data: { password: hashedPassword }, + }); + + return NextResponse.json({ success: true }); + } catch (error) { + console.error('Error changing password:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/user/plan/route.ts b/src/app/(main)/api/user/plan/route.ts index caf3a0b..e525f71 100644 --- a/src/app/(main)/api/user/plan/route.ts +++ b/src/app/(main)/api/user/plan/route.ts @@ -1,59 +1,59 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { db } from '@/lib/db'; -import { STRIPE_PLANS } from '@/lib/stripe'; - -export const dynamic = 'force-dynamic'; - -export async function GET(request: NextRequest) { - try { - // Use cookie-based auth instead of NextAuth - const userId = cookies().get('userId')?.value; - - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - const user = await db.user.findUnique({ - where: { id: userId }, - select: { - plan: true, - stripeCurrentPeriodEnd: true, - stripePriceId: true, - stripeCustomerId: true, - stripeSubscriptionId: true, - }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - // Determine billing interval from stripePriceId - let interval: 'month' | 'year' | null = null; - - if (user.stripePriceId) { - // Check if the current price ID matches any yearly price ID - const isYearly = - user.stripePriceId === STRIPE_PLANS.PRO.priceIdYearly || - user.stripePriceId === STRIPE_PLANS.BUSINESS.priceIdYearly; - - interval = isYearly ? 'year' : 'month'; - } - - return NextResponse.json({ - plan: user.plan || 'FREE', - interval, - currentPeriodEnd: user.stripeCurrentPeriodEnd, - priceId: user.stripePriceId, - stripeCustomerId: user.stripeCustomerId, - stripeSubscriptionId: user.stripeSubscriptionId, - }); - } catch (error) { - console.error('Error fetching user plan:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { db } from '@/lib/db'; +import { STRIPE_PLANS } from '@/lib/stripe'; + +export const dynamic = 'force-dynamic'; + +export async function GET(request: NextRequest) { + try { + // Use cookie-based auth instead of NextAuth + const userId = cookies().get('userId')?.value; + + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + const user = await db.user.findUnique({ + where: { id: userId }, + select: { + plan: true, + stripeCurrentPeriodEnd: true, + stripePriceId: true, + stripeCustomerId: true, + stripeSubscriptionId: true, + }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + // Determine billing interval from stripePriceId + let interval: 'month' | 'year' | null = null; + + if (user.stripePriceId) { + // Check if the current price ID matches any yearly price ID + const isYearly = + user.stripePriceId === STRIPE_PLANS.PRO.priceIdYearly || + user.stripePriceId === STRIPE_PLANS.BUSINESS.priceIdYearly; + + interval = isYearly ? 'year' : 'month'; + } + + return NextResponse.json({ + plan: user.plan || 'FREE', + interval, + currentPeriodEnd: user.stripeCurrentPeriodEnd, + priceId: user.stripePriceId, + stripeCustomerId: user.stripeCustomerId, + stripeSubscriptionId: user.stripeSubscriptionId, + }); + } catch (error) { + console.error('Error fetching user plan:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/user/profile/route.ts b/src/app/(main)/api/user/profile/route.ts index ee2f717..384b78d 100644 --- a/src/app/(main)/api/user/profile/route.ts +++ b/src/app/(main)/api/user/profile/route.ts @@ -1,74 +1,74 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { db } from '@/lib/db'; -import { csrfProtection } from '@/lib/csrf'; -import { updateProfileSchema, validateRequest } from '@/lib/validationSchemas'; -import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; - -export async function PATCH(request: NextRequest) { - try { - // CSRF Protection - const csrfCheck = csrfProtection(request); - if (!csrfCheck.valid) { - return NextResponse.json({ error: csrfCheck.error }, { status: 403 }); - } - - const userId = cookies().get('userId')?.value; - - // Rate Limiting (user-based) - const clientId = userId || getClientIdentifier(request); - const rateLimitResult = rateLimit(clientId, RateLimits.PROFILE_UPDATE); - - if (!rateLimitResult.success) { - return NextResponse.json( - { - error: 'Too many requests. Please try again later.', - retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) - }, - { - status: 429, - headers: { - 'X-RateLimit-Limit': rateLimitResult.limit.toString(), - 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), - 'X-RateLimit-Reset': rateLimitResult.reset.toString(), - } - } - ); - } - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - const body = await request.json(); - - // Validate request body - const validation = await validateRequest(updateProfileSchema, body); - if (!validation.success) { - return NextResponse.json(validation.error, { status: 400 }); - } - - const { name } = validation.data; - - // Update user name in database - const updatedUser = await db.user.update({ - where: { id: userId }, - data: { name: name.trim() }, - select: { - id: true, - name: true, - email: true, - }, - }); - - return NextResponse.json({ - success: true, - user: updatedUser, - }); - } catch (error) { - console.error('Error updating profile:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { db } from '@/lib/db'; +import { csrfProtection } from '@/lib/csrf'; +import { updateProfileSchema, validateRequest } from '@/lib/validationSchemas'; +import { rateLimit, getClientIdentifier, RateLimits } from '@/lib/rateLimit'; + +export async function PATCH(request: NextRequest) { + try { + // CSRF Protection + const csrfCheck = csrfProtection(request); + if (!csrfCheck.valid) { + return NextResponse.json({ error: csrfCheck.error }, { status: 403 }); + } + + const userId = cookies().get('userId')?.value; + + // Rate Limiting (user-based) + const clientId = userId || getClientIdentifier(request); + const rateLimitResult = rateLimit(clientId, RateLimits.PROFILE_UPDATE); + + if (!rateLimitResult.success) { + return NextResponse.json( + { + error: 'Too many requests. Please try again later.', + retryAfter: Math.ceil((rateLimitResult.reset - Date.now()) / 1000) + }, + { + status: 429, + headers: { + 'X-RateLimit-Limit': rateLimitResult.limit.toString(), + 'X-RateLimit-Remaining': rateLimitResult.remaining.toString(), + 'X-RateLimit-Reset': rateLimitResult.reset.toString(), + } + } + ); + } + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + const body = await request.json(); + + // Validate request body + const validation = await validateRequest(updateProfileSchema, body); + if (!validation.success) { + return NextResponse.json(validation.error, { status: 400 }); + } + + const { name } = validation.data; + + // Update user name in database + const updatedUser = await db.user.update({ + where: { id: userId }, + data: { name: name.trim() }, + select: { + id: true, + name: true, + email: true, + }, + }); + + return NextResponse.json({ + success: true, + user: updatedUser, + }); + } catch (error) { + console.error('Error updating profile:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/user/route.ts b/src/app/(main)/api/user/route.ts index 8d45c1b..9675d6a 100644 --- a/src/app/(main)/api/user/route.ts +++ b/src/app/(main)/api/user/route.ts @@ -1,42 +1,42 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { db } from '@/lib/db'; - -// Force dynamic rendering (required for cookies) -export const dynamic = 'force-dynamic'; - -/** - * GET /api/user - * Get current user information - */ -export async function GET(request: NextRequest) { - try { - const userId = cookies().get('userId')?.value; - - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - const user = await db.user.findUnique({ - where: { id: userId }, - select: { - id: true, - name: true, - email: true, - plan: true, - }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - return NextResponse.json(user); - } catch (error) { - console.error('Error fetching user:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { db } from '@/lib/db'; + +// Force dynamic rendering (required for cookies) +export const dynamic = 'force-dynamic'; + +/** + * GET /api/user + * Get current user information + */ +export async function GET(request: NextRequest) { + try { + const userId = cookies().get('userId')?.value; + + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + const user = await db.user.findUnique({ + where: { id: userId }, + select: { + id: true, + name: true, + email: true, + plan: true, + }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + return NextResponse.json(user); + } catch (error) { + console.error('Error fetching user:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/api/user/stats/route.ts b/src/app/(main)/api/user/stats/route.ts index 7eaf2e1..cfdeea0 100644 --- a/src/app/(main)/api/user/stats/route.ts +++ b/src/app/(main)/api/user/stats/route.ts @@ -1,62 +1,62 @@ -import { NextRequest, NextResponse } from 'next/server'; -import { cookies } from 'next/headers'; -import { db } from '@/lib/db'; - -export const dynamic = 'force-dynamic'; - -export async function GET(request: NextRequest) { - try { - const userId = cookies().get('userId')?.value; - if (!userId) { - return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); - } - - // Get user with plan info - const user = await db.user.findUnique({ - where: { id: userId }, - select: { - plan: true, - }, - }); - - if (!user) { - return NextResponse.json({ error: 'User not found' }, { status: 404 }); - } - - // Count dynamic QR codes - const dynamicQRCount = await db.qRCode.count({ - where: { - userId, - type: 'DYNAMIC', - }, - }); - - // Count static QR codes - const staticQRCount = await db.qRCode.count({ - where: { - userId, - type: 'STATIC', - }, - }); - - // Determine limits based on plan - let dynamicLimit = 3; // FREE plan default - if (user.plan === 'PRO') { - dynamicLimit = 50; - } else if (user.plan === 'BUSINESS') { - dynamicLimit = 500; - } - - return NextResponse.json({ - dynamicUsed: dynamicQRCount, - dynamicLimit, - staticUsed: staticQRCount, - }); - } catch (error) { - console.error('Error fetching user stats:', error); - return NextResponse.json( - { error: 'Internal server error' }, - { status: 500 } - ); - } -} +import { NextRequest, NextResponse } from 'next/server'; +import { cookies } from 'next/headers'; +import { db } from '@/lib/db'; + +export const dynamic = 'force-dynamic'; + +export async function GET(request: NextRequest) { + try { + const userId = cookies().get('userId')?.value; + if (!userId) { + return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + } + + // Get user with plan info + const user = await db.user.findUnique({ + where: { id: userId }, + select: { + plan: true, + }, + }); + + if (!user) { + return NextResponse.json({ error: 'User not found' }, { status: 404 }); + } + + // Count dynamic QR codes + const dynamicQRCount = await db.qRCode.count({ + where: { + userId, + type: 'DYNAMIC', + }, + }); + + // Count static QR codes + const staticQRCount = await db.qRCode.count({ + where: { + userId, + type: 'STATIC', + }, + }); + + // Determine limits based on plan + let dynamicLimit = 3; // FREE plan default + if (user.plan === 'PRO') { + dynamicLimit = 50; + } else if (user.plan === 'BUSINESS') { + dynamicLimit = 500; + } + + return NextResponse.json({ + dynamicUsed: dynamicQRCount, + dynamicLimit, + staticUsed: staticQRCount, + }); + } catch (error) { + console.error('Error fetching user stats:', error); + return NextResponse.json( + { error: 'Internal server error' }, + { status: 500 } + ); + } +} diff --git a/src/app/(main)/og/route.tsx b/src/app/(main)/og/route.tsx index c595d79..d230c09 100644 --- a/src/app/(main)/og/route.tsx +++ b/src/app/(main)/og/route.tsx @@ -1,67 +1,67 @@ -import { ImageResponse } from 'next/og'; - -export const runtime = 'edge'; - -export async function GET(request: Request) { - try { - const { searchParams } = new URL(request.url); - const title = searchParams.get('title') || 'QR Master – Smart QR Generator & Analytics'; - - return new ImageResponse( - ( -
-
-

- {title} -

-

- Dynamic QR codes with analytics & branding -

-
-
- ), - { - width: 1200, - height: 630, - } - ); - } catch (e) { - console.error(e); - return new Response('Failed to generate image', { status: 500 }); - } -} +import { ImageResponse } from 'next/og'; + +export const runtime = 'edge'; + +export async function GET(request: Request) { + try { + const { searchParams } = new URL(request.url); + const title = searchParams.get('title') || 'QR Master – Smart QR Generator & Analytics'; + + return new ImageResponse( + ( +
+
+

+ {title} +

+

+ Dynamic QR codes with analytics & branding +

+
+
+ ), + { + width: 1200, + height: 630, + } + ); + } catch (e) { + console.error(e); + return new Response('Failed to generate image', { status: 500 }); + } +} diff --git a/src/app/(main)/providers.tsx b/src/app/(main)/providers.tsx index 61d5d00..b8f8962 100644 --- a/src/app/(main)/providers.tsx +++ b/src/app/(main)/providers.tsx @@ -1,7 +1,7 @@ -'use client'; - -import { SessionProvider } from 'next-auth/react'; - -export function Providers({ children }: { children: React.ReactNode }) { - return {children}; +'use client'; + +import { SessionProvider } from 'next-auth/react'; + +export function Providers({ children }: { children: React.ReactNode }) { + return {children}; } \ No newline at end of file diff --git a/src/app/(marketing-de)/qr-code-erstellen/page.tsx b/src/app/(marketing-de)/qr-code-erstellen/page.tsx index 15f6006..0f558a2 100644 --- a/src/app/(marketing-de)/qr-code-erstellen/page.tsx +++ b/src/app/(marketing-de)/qr-code-erstellen/page.tsx @@ -102,9 +102,7 @@ export default function QRCodeErstellenPage() {

-

QR Code erstellen kostenlos mit Tracking und Branding

- - + {/* Answer First Block (SEO/AEO) - German */}
diff --git a/src/app/robots.ts b/src/app/robots.ts index 622df2c..ca22778 100644 --- a/src/app/robots.ts +++ b/src/app/robots.ts @@ -1,28 +1,28 @@ -import { MetadataRoute } from 'next'; - -export default function robots(): MetadataRoute.Robots { - const baseUrl = 'https://www.qrmaster.net'; - const privatePaths = [ - '/api/', - '/dashboard/', - '/create/', - '/settings/', - '/cdn-cgi/', - ]; - - return { - rules: [ - { - userAgent: ['OAI-SearchBot', 'ChatGPT-User', 'PerplexityBot', 'ClaudeBot', 'anthropic-ai', 'Google-Extended'], - allow: '/', - disallow: privatePaths, - }, - { - userAgent: '*', - allow: '/', - disallow: privatePaths, - }, - ], - sitemap: `${baseUrl}/sitemap.xml`, - }; -} +import { MetadataRoute } from 'next'; + +export default function robots(): MetadataRoute.Robots { + const baseUrl = 'https://www.qrmaster.net'; + const privatePaths = [ + '/api/', + '/dashboard/', + '/create/', + '/settings/', + '/cdn-cgi/', + ]; + + return { + rules: [ + { + userAgent: ['OAI-SearchBot', 'ChatGPT-User', 'PerplexityBot', 'ClaudeBot', 'anthropic-ai', 'Google-Extended'], + allow: '/', + disallow: privatePaths, + }, + { + userAgent: '*', + allow: '/', + disallow: privatePaths, + }, + ], + sitemap: `${baseUrl}/sitemap.xml`, + }; +} diff --git a/src/components/Breadcrumbs.tsx b/src/components/Breadcrumbs.tsx index 7bb4e94..29f8bf6 100644 --- a/src/components/Breadcrumbs.tsx +++ b/src/components/Breadcrumbs.tsx @@ -1,37 +1,37 @@ -import React from 'react'; -import Link from 'next/link'; - -export interface BreadcrumbItem { - name: string; - url: string; -} - -interface BreadcrumbsProps { - items: BreadcrumbItem[]; - className?: string; -} - -export default function Breadcrumbs({ items, className }: BreadcrumbsProps) { - return ( - - ); -} - -export { type BreadcrumbItem as BreadcrumbItemType }; +import React from 'react'; +import Link from 'next/link'; + +export interface BreadcrumbItem { + name: string; + url: string; +} + +interface BreadcrumbsProps { + items: BreadcrumbItem[]; + className?: string; +} + +export default function Breadcrumbs({ items, className }: BreadcrumbsProps) { + return ( + + ); +} + +export { type BreadcrumbItem as BreadcrumbItemType }; diff --git a/src/components/CookieBanner.tsx b/src/components/CookieBanner.tsx index 445f1ca..61e0ac1 100644 --- a/src/components/CookieBanner.tsx +++ b/src/components/CookieBanner.tsx @@ -1,118 +1,118 @@ -'use client'; - -import React, { useState, useEffect } from 'react'; -import Link from 'next/link'; -import { Button } from '@/components/ui/Button'; - -export default function CookieBanner() { - const [showBanner, setShowBanner] = useState(false); - - useEffect(() => { - // Check if user has already made a choice - const cookieConsent = localStorage.getItem('cookieConsent'); - if (!cookieConsent) { - // Show banner after a short delay for better UX - const timer = setTimeout(() => { - setShowBanner(true); - }, 1000); - return () => clearTimeout(timer); - } - }, []); - - const handleAccept = () => { - localStorage.setItem('cookieConsent', 'accepted'); - setShowBanner(false); - // Reload page to initialize PostHog - window.location.reload(); - }; - - const handleDecline = () => { - localStorage.setItem('cookieConsent', 'declined'); - setShowBanner(false); - }; - - return ( -
- {showBanner && ( - <> - {/* Cookie Banner - Bottom Left Corner */} -
-
-
-
- - - -
-
-

- We use cookies -

-

- We use essential cookies for authentication and analytics cookies to improve your experience.{' '} - - Learn more about our privacy policy - -

- - {/* Cookie Categories */} -
-
- - - - Essential: Authentication, CSRF protection -
-
- - - - Analytics: PostHog & Google Analytics -
-
-
-
- - {/* Actions */} -
- - -
-
-
- - - - )} -
- ); -} +'use client'; + +import React, { useState, useEffect } from 'react'; +import Link from 'next/link'; +import { Button } from '@/components/ui/Button'; + +export default function CookieBanner() { + const [showBanner, setShowBanner] = useState(false); + + useEffect(() => { + // Check if user has already made a choice + const cookieConsent = localStorage.getItem('cookieConsent'); + if (!cookieConsent) { + // Show banner after a short delay for better UX + const timer = setTimeout(() => { + setShowBanner(true); + }, 1000); + return () => clearTimeout(timer); + } + }, []); + + const handleAccept = () => { + localStorage.setItem('cookieConsent', 'accepted'); + setShowBanner(false); + // Reload page to initialize PostHog + window.location.reload(); + }; + + const handleDecline = () => { + localStorage.setItem('cookieConsent', 'declined'); + setShowBanner(false); + }; + + return ( +
+ {showBanner && ( + <> + {/* Cookie Banner - Bottom Left Corner */} +
+
+
+
+ + + +
+
+

+ We use cookies +

+

+ We use essential cookies for authentication and analytics cookies to improve your experience.{' '} + + Learn more about our privacy policy + +

+ + {/* Cookie Categories */} +
+
+ + + + Essential: Authentication, CSRF protection +
+
+ + + + Analytics: PostHog & Google Analytics +
+
+
+
+ + {/* Actions */} +
+ + +
+
+
+ + + + )} +
+ ); +} diff --git a/src/components/SessionProvider.tsx b/src/components/SessionProvider.tsx index 5c91026..64e58c3 100644 --- a/src/components/SessionProvider.tsx +++ b/src/components/SessionProvider.tsx @@ -1,11 +1,11 @@ -'use client'; - -import { SessionProvider } from 'next-auth/react'; - -export default function AuthProvider({ - children, -}: { - children: React.ReactNode; -}) { - return {children}; -} +'use client'; + +import { SessionProvider } from 'next-auth/react'; + +export default function AuthProvider({ + children, +}: { + children: React.ReactNode; +}) { + return {children}; +} diff --git a/src/components/dashboard/StatsGrid.tsx b/src/components/dashboard/StatsGrid.tsx index 6ec8404..aca93a7 100644 --- a/src/components/dashboard/StatsGrid.tsx +++ b/src/components/dashboard/StatsGrid.tsx @@ -1,108 +1,108 @@ -'use client'; - -import React from 'react'; -import { Card, CardContent } from '@/components/ui/Card'; -import { formatNumber } from '@/lib/utils'; -import { useTranslation } from '@/hooks/useTranslation'; -import { TrendData } from '@/types/analytics'; - -interface StatsGridProps { - stats: { - totalScans: number; - activeQRCodes: number; - conversionRate: number; - uniqueScans?: number; - }; - trends?: { - totalScans?: TrendData; - comparisonPeriod?: 'week' | 'month'; - }; -} - -export const StatsGrid: React.FC = ({ stats, trends }) => { - const { t } = useTranslation(); - - // Build trend display text - const getTrendText = () => { - if (!trends?.totalScans) { - return 'No data yet'; - } - - const trend = trends.totalScans; - const sign = trend.isNegative ? '-' : '+'; - const period = trends.comparisonPeriod || 'period'; - const newLabel = trend.isNew ? ' (new)' : ''; - - return `${sign}${trend.percentage}%${newLabel} from last ${period}`; - }; - - const getTrendType = (): 'positive' | 'negative' | 'neutral' => { - if (!trends?.totalScans) return 'neutral'; - if (trends.totalScans.trend === 'up') return 'positive'; - if (trends.totalScans.trend === 'down') return 'negative'; - return 'neutral'; - }; - - const cards = [ - { - title: t('dashboard.stats.total_scans'), - value: formatNumber(stats.totalScans), - change: getTrendText(), - changeType: getTrendType(), - icon: ( - - - - - ), - }, - { - title: t('dashboard.stats.active_codes'), - value: stats.activeQRCodes.toString(), - change: stats.activeQRCodes > 0 ? `${stats.activeQRCodes} active` : 'Create your first', - changeType: stats.activeQRCodes > 0 ? 'positive' : 'neutral' as 'positive' | 'negative' | 'neutral', - icon: ( - - - - ), - }, - { - title: 'Unique Users', - value: formatNumber(stats.uniqueScans ?? 0), - change: stats.totalScans > 0 ? `${stats.uniqueScans ?? 0} unique visitors` : 'No scans yet', - changeType: (stats.uniqueScans ?? 0) > 0 ? 'positive' : 'neutral' as 'positive' | 'negative' | 'neutral', - icon: ( - - - - ), - }, - ]; - - return ( -
- {cards.map((card, index) => ( - - -
-
-

{card.title}

-

{card.value}

-

- {card.change} -

-
-
- {card.icon} -
-
- - - ))} -
- ); +'use client'; + +import React from 'react'; +import { Card, CardContent } from '@/components/ui/Card'; +import { formatNumber } from '@/lib/utils'; +import { useTranslation } from '@/hooks/useTranslation'; +import { TrendData } from '@/types/analytics'; + +interface StatsGridProps { + stats: { + totalScans: number; + activeQRCodes: number; + conversionRate: number; + uniqueScans?: number; + }; + trends?: { + totalScans?: TrendData; + comparisonPeriod?: 'week' | 'month'; + }; +} + +export const StatsGrid: React.FC = ({ stats, trends }) => { + const { t } = useTranslation(); + + // Build trend display text + const getTrendText = () => { + if (!trends?.totalScans) { + return 'No data yet'; + } + + const trend = trends.totalScans; + const sign = trend.isNegative ? '-' : '+'; + const period = trends.comparisonPeriod || 'period'; + const newLabel = trend.isNew ? ' (new)' : ''; + + return `${sign}${trend.percentage}%${newLabel} from last ${period}`; + }; + + const getTrendType = (): 'positive' | 'negative' | 'neutral' => { + if (!trends?.totalScans) return 'neutral'; + if (trends.totalScans.trend === 'up') return 'positive'; + if (trends.totalScans.trend === 'down') return 'negative'; + return 'neutral'; + }; + + const cards = [ + { + title: t('dashboard.stats.total_scans'), + value: formatNumber(stats.totalScans), + change: getTrendText(), + changeType: getTrendType(), + icon: ( + + + + + ), + }, + { + title: t('dashboard.stats.active_codes'), + value: stats.activeQRCodes.toString(), + change: stats.activeQRCodes > 0 ? `${stats.activeQRCodes} active` : 'Create your first', + changeType: stats.activeQRCodes > 0 ? 'positive' : 'neutral' as 'positive' | 'negative' | 'neutral', + icon: ( + + + + ), + }, + { + title: 'Unique Users', + value: formatNumber(stats.uniqueScans ?? 0), + change: stats.totalScans > 0 ? `${stats.uniqueScans ?? 0} unique visitors` : 'No scans yet', + changeType: (stats.uniqueScans ?? 0) > 0 ? 'positive' : 'neutral' as 'positive' | 'negative' | 'neutral', + icon: ( + + + + ), + }, + ]; + + return ( +
+ {cards.map((card, index) => ( + + +
+
+

{card.title}

+

{card.value}

+

+ {card.change} +

+
+
+ {card.icon} +
+
+ + + ))} +
+ ); }; \ No newline at end of file diff --git a/src/components/generator/QRPreview.tsx b/src/components/generator/QRPreview.tsx index e27da06..7ec0197 100644 --- a/src/components/generator/QRPreview.tsx +++ b/src/components/generator/QRPreview.tsx @@ -1,157 +1,157 @@ -'use client'; - -import React, { useEffect, useState } from 'react'; -import QRCode from 'qrcode'; -import { Badge } from '@/components/ui/Badge'; -import { calculateContrast } from '@/lib/utils'; - -interface QRPreviewProps { - content: string; - style: { - foregroundColor: string; - backgroundColor: string; - cornerStyle: 'square' | 'rounded'; - size: number; - }; -} - -export const QRPreview: React.FC = ({ content, style }) => { - const [qrDataUrl, setQrDataUrl] = useState(''); - const [error, setError] = useState(''); - - const contrast = calculateContrast(style.foregroundColor, style.backgroundColor); - const hasGoodContrast = contrast >= 4.5; - - useEffect(() => { - const generateQR = async () => { - try { - if (!content) { - setQrDataUrl(''); - return; - } - - const options = { - width: style.size, - margin: 2, - color: { - dark: style.foregroundColor, - light: style.backgroundColor, - }, - errorCorrectionLevel: 'M' as const, - }; - - const dataUrl = await QRCode.toDataURL(content, options); - setQrDataUrl(dataUrl); - setError(''); - } catch (err) { - console.error('Error generating QR code:', err); - setError('Failed to generate QR code'); - } - }; - - generateQR(); - }, [content, style]); - - const downloadQR = async (format: 'svg' | 'png') => { - if (!content) return; - - try { - if (format === 'svg') { - const svg = await QRCode.toString(content, { - type: 'svg', - width: style.size, - margin: 2, - color: { - dark: style.foregroundColor, - light: style.backgroundColor, - }, - }); - - const blob = new Blob([svg], { type: 'image/svg+xml' }); - const url = URL.createObjectURL(blob); - const a = document.createElement('a'); - a.href = url; - a.download = 'qrcode.svg'; - document.body.appendChild(a); - a.click(); - document.body.removeChild(a); - URL.revokeObjectURL(url); - } else { - // For PNG, use the canvas - const canvas = document.createElement('canvas'); - await QRCode.toCanvas(canvas, content, { - width: style.size, - margin: 2, - color: { - dark: style.foregroundColor, - light: style.backgroundColor, - }, - }); - - canvas.toBlob((blob) => { - if (blob) { - const url = URL.createObjectURL(blob); - const a = document.createElement('a'); - a.href = url; - a.download = 'qrcode.png'; - document.body.appendChild(a); - a.click(); - document.body.removeChild(a); - URL.revokeObjectURL(url); - } - }); - } - } catch (err) { - console.error('Error downloading QR code:', err); - } - }; - - return ( -
-
- {error ? ( -
- {error} -
- ) : qrDataUrl ? ( - QR Code Preview - ) : ( -
- Enter content to generate QR code -
- )} -
- -
- - {hasGoodContrast ? 'Good contrast' : 'Low contrast'} - - - Contrast: {contrast.toFixed(1)}:1 - -
- -
- - -
-
- ); +'use client'; + +import React, { useEffect, useState } from 'react'; +import QRCode from 'qrcode'; +import { Badge } from '@/components/ui/Badge'; +import { calculateContrast } from '@/lib/utils'; + +interface QRPreviewProps { + content: string; + style: { + foregroundColor: string; + backgroundColor: string; + cornerStyle: 'square' | 'rounded'; + size: number; + }; +} + +export const QRPreview: React.FC = ({ content, style }) => { + const [qrDataUrl, setQrDataUrl] = useState(''); + const [error, setError] = useState(''); + + const contrast = calculateContrast(style.foregroundColor, style.backgroundColor); + const hasGoodContrast = contrast >= 4.5; + + useEffect(() => { + const generateQR = async () => { + try { + if (!content) { + setQrDataUrl(''); + return; + } + + const options = { + width: style.size, + margin: 2, + color: { + dark: style.foregroundColor, + light: style.backgroundColor, + }, + errorCorrectionLevel: 'M' as const, + }; + + const dataUrl = await QRCode.toDataURL(content, options); + setQrDataUrl(dataUrl); + setError(''); + } catch (err) { + console.error('Error generating QR code:', err); + setError('Failed to generate QR code'); + } + }; + + generateQR(); + }, [content, style]); + + const downloadQR = async (format: 'svg' | 'png') => { + if (!content) return; + + try { + if (format === 'svg') { + const svg = await QRCode.toString(content, { + type: 'svg', + width: style.size, + margin: 2, + color: { + dark: style.foregroundColor, + light: style.backgroundColor, + }, + }); + + const blob = new Blob([svg], { type: 'image/svg+xml' }); + const url = URL.createObjectURL(blob); + const a = document.createElement('a'); + a.href = url; + a.download = 'qrcode.svg'; + document.body.appendChild(a); + a.click(); + document.body.removeChild(a); + URL.revokeObjectURL(url); + } else { + // For PNG, use the canvas + const canvas = document.createElement('canvas'); + await QRCode.toCanvas(canvas, content, { + width: style.size, + margin: 2, + color: { + dark: style.foregroundColor, + light: style.backgroundColor, + }, + }); + + canvas.toBlob((blob) => { + if (blob) { + const url = URL.createObjectURL(blob); + const a = document.createElement('a'); + a.href = url; + a.download = 'qrcode.png'; + document.body.appendChild(a); + a.click(); + document.body.removeChild(a); + URL.revokeObjectURL(url); + } + }); + } + } catch (err) { + console.error('Error downloading QR code:', err); + } + }; + + return ( +
+
+ {error ? ( +
+ {error} +
+ ) : qrDataUrl ? ( + QR Code Preview + ) : ( +
+ Enter content to generate QR code +
+ )} +
+ +
+ + {hasGoodContrast ? 'Good contrast' : 'Low contrast'} + + + Contrast: {contrast.toFixed(1)}:1 + +
+ +
+ + +
+
+ ); }; \ No newline at end of file diff --git a/src/components/marketing/GrowthLinksSection.tsx b/src/components/marketing/GrowthLinksSection.tsx index 3323952..a30f8c9 100644 --- a/src/components/marketing/GrowthLinksSection.tsx +++ b/src/components/marketing/GrowthLinksSection.tsx @@ -1,73 +1,73 @@ -import { ArrowRight } from "lucide-react"; - -import { TrackedCtaLink } from "@/components/marketing/MarketingAnalytics"; -import { Card } from "@/components/ui/Card"; - -type PageType = "commercial" | "use_case_hub" | "use_case"; - -type GrowthLink = { - href: string; - title: string; - description: string; - ctaLabel: string; -}; - -export function GrowthLinksSection({ - eyebrow, - title, - description, - links, - pageType, - cluster, - useCase, -}: { - eyebrow: string; - title: string; - description: string; - links: GrowthLink[]; - pageType: PageType; - cluster: string; - useCase?: string; -}) { - return ( -
-
-
-
- {eyebrow} -
-

{title}

-

{description}

-
- -
- {links.map((link) => ( - - -
- {link.title} -
-

- {link.description} -

-
- Open workflow - -
- - - ))} -
-
-
- ); -} +import { ArrowRight } from "lucide-react"; + +import { TrackedCtaLink } from "@/components/marketing/MarketingAnalytics"; +import { Card } from "@/components/ui/Card"; + +type PageType = "commercial" | "use_case_hub" | "use_case"; + +type GrowthLink = { + href: string; + title: string; + description: string; + ctaLabel: string; +}; + +export function GrowthLinksSection({ + eyebrow, + title, + description, + links, + pageType, + cluster, + useCase, +}: { + eyebrow: string; + title: string; + description: string; + links: GrowthLink[]; + pageType: PageType; + cluster: string; + useCase?: string; +}) { + return ( +
+
+
+
+ {eyebrow} +
+

{title}

+

{description}

+
+ +
+ {links.map((link) => ( + + +
+ {link.title} +
+

+ {link.description} +

+
+ Open workflow + +
+ + + ))} +
+
+
+ ); +} diff --git a/src/components/marketing/MarketingAnalytics.tsx b/src/components/marketing/MarketingAnalytics.tsx index daf4013..a66e4bf 100644 --- a/src/components/marketing/MarketingAnalytics.tsx +++ b/src/components/marketing/MarketingAnalytics.tsx @@ -1,94 +1,94 @@ -"use client"; - -import Link from "next/link"; -import { usePathname, useSearchParams } from "next/navigation"; -import { useEffect } from "react"; - -import { trackEvent } from "@/components/PostHogProvider"; - -type PageType = "commercial" | "use_case_hub" | "use_case"; - -type TrackingContext = { - pageType: PageType; - cluster?: string; - useCase?: string; -}; - -function getUtmProperties(searchParams: ReturnType) { - return { - utm_source: searchParams?.get("utm_source") || undefined, - utm_medium: searchParams?.get("utm_medium") || undefined, - utm_campaign: searchParams?.get("utm_campaign") || undefined, - utm_content: searchParams?.get("utm_content") || undefined, - }; -} - -export function MarketingPageTracker({ - pageType, - cluster, - useCase, -}: TrackingContext) { - const pathname = usePathname(); - const searchParams = useSearchParams(); - - useEffect(() => { - if (!pathname) { - return; - } - - trackEvent("landing_page_viewed", { - landing_page_slug: pathname, - page_type: pageType, - cluster, - use_case: useCase, - ...getUtmProperties(searchParams), - }); - }, [cluster, pageType, pathname, searchParams, useCase]); - - return null; -} - -type TrackedCtaLinkProps = TrackingContext & { - href: string; - ctaLabel: string; - ctaLocation: string; - destination?: string; - className?: string; - children: React.ReactNode; -}; - -export function TrackedCtaLink({ - href, - ctaLabel, - ctaLocation, - destination, - className, - children, - pageType, - cluster, - useCase, -}: TrackedCtaLinkProps) { - const pathname = usePathname(); - const searchParams = useSearchParams(); - - return ( - { - trackEvent("cta_clicked", { - landing_page_slug: pathname, - page_type: pageType, - cluster, - use_case: useCase, - cta_label: ctaLabel, - cta_location: ctaLocation, - destination: destination || href, - ...getUtmProperties(searchParams), - }); - }} - > - {children} - - ); -} +"use client"; + +import Link from "next/link"; +import { usePathname, useSearchParams } from "next/navigation"; +import { useEffect } from "react"; + +import { trackEvent } from "@/components/PostHogProvider"; + +type PageType = "commercial" | "use_case_hub" | "use_case"; + +type TrackingContext = { + pageType: PageType; + cluster?: string; + useCase?: string; +}; + +function getUtmProperties(searchParams: ReturnType) { + return { + utm_source: searchParams?.get("utm_source") || undefined, + utm_medium: searchParams?.get("utm_medium") || undefined, + utm_campaign: searchParams?.get("utm_campaign") || undefined, + utm_content: searchParams?.get("utm_content") || undefined, + }; +} + +export function MarketingPageTracker({ + pageType, + cluster, + useCase, +}: TrackingContext) { + const pathname = usePathname(); + const searchParams = useSearchParams(); + + useEffect(() => { + if (!pathname) { + return; + } + + trackEvent("landing_page_viewed", { + landing_page_slug: pathname, + page_type: pageType, + cluster, + use_case: useCase, + ...getUtmProperties(searchParams), + }); + }, [cluster, pageType, pathname, searchParams, useCase]); + + return null; +} + +type TrackedCtaLinkProps = TrackingContext & { + href: string; + ctaLabel: string; + ctaLocation: string; + destination?: string; + className?: string; + children: React.ReactNode; +}; + +export function TrackedCtaLink({ + href, + ctaLabel, + ctaLocation, + destination, + className, + children, + pageType, + cluster, + useCase, +}: TrackedCtaLinkProps) { + const pathname = usePathname(); + const searchParams = useSearchParams(); + + return ( + { + trackEvent("cta_clicked", { + landing_page_slug: pathname, + page_type: pageType, + cluster, + use_case: useCase, + cta_label: ctaLabel, + cta_location: ctaLocation, + destination: destination || href, + ...getUtmProperties(searchParams), + }); + }} + > + {children} + + ); +} diff --git a/src/components/marketing/Testimonials.tsx b/src/components/marketing/Testimonials.tsx index e4e182d..cf75f20 100644 --- a/src/components/marketing/Testimonials.tsx +++ b/src/components/marketing/Testimonials.tsx @@ -1,132 +1,132 @@ -'use client'; - -import React from 'react'; -import { motion } from 'framer-motion'; -import { Star, CheckCircle } from 'lucide-react'; -import { Card, CardHeader, CardContent } from '@/components/ui/Card'; -import type { Testimonial } from '@/lib/types'; - -interface TestimonialsProps { - testimonials: Testimonial[]; - title?: string; - subtitle?: string; - showAll?: boolean; -} - -export const Testimonials: React.FC = ({ - testimonials, - title = "What Our Customers Say", - subtitle = "Real experiences from businesses using QR Master", - showAll = false -}) => { - const displayTestimonials = showAll ? testimonials : testimonials.slice(0, 3); - - const renderStars = (rating: number) => { - return ( -
- {[...Array(5)].map((_, index) => ( - - ))} -
- ); - }; - - return ( -
-
- -

- {title} -

-

- {subtitle} -

- - -
- {displayTestimonials.map((testimonial, index) => ( - - - -
- {renderStars(testimonial.rating)} - {testimonial.verified && ( - - - Verified - - )} -
-

- {testimonial.title} -

- - -

- {testimonial.content} -

-
-
- - {testimonial.author.name} - -
- {testimonial.author.company && ( - {testimonial.author.company} - )} - {testimonial.author.company && testimonial.author.location && ( - • - )} - {testimonial.author.location && ( - {testimonial.author.location} - )} -
- - {testimonial.date} - -
-
- - - - ))} -
- - - {!showAll && ( - - )} -
-
- ); -}; +'use client'; + +import React from 'react'; +import { motion } from 'framer-motion'; +import { Star, CheckCircle } from 'lucide-react'; +import { Card, CardHeader, CardContent } from '@/components/ui/Card'; +import type { Testimonial } from '@/lib/types'; + +interface TestimonialsProps { + testimonials: Testimonial[]; + title?: string; + subtitle?: string; + showAll?: boolean; +} + +export const Testimonials: React.FC = ({ + testimonials, + title = "What Our Customers Say", + subtitle = "Real experiences from businesses using QR Master", + showAll = false +}) => { + const displayTestimonials = showAll ? testimonials : testimonials.slice(0, 3); + + const renderStars = (rating: number) => { + return ( +
+ {[...Array(5)].map((_, index) => ( + + ))} +
+ ); + }; + + return ( +
+
+ +

+ {title} +

+

+ {subtitle} +

+ + +
+ {displayTestimonials.map((testimonial, index) => ( + + + +
+ {renderStars(testimonial.rating)} + {testimonial.verified && ( + + + Verified + + )} +
+

+ {testimonial.title} +

+ + +

+ {testimonial.content} +

+
+
+ + {testimonial.author.name} + +
+ {testimonial.author.company && ( + {testimonial.author.company} + )} + {testimonial.author.company && testimonial.author.location && ( + • + )} + {testimonial.author.location && ( + {testimonial.author.location} + )} +
+ + {testimonial.date} + +
+
+ + + + ))} +
+ + + {!showAll && ( + + )} +
+
+ ); +}; diff --git a/src/components/marketing/UseCasePageTemplate.tsx b/src/components/marketing/UseCasePageTemplate.tsx index 0acfbd7..70d88d3 100644 --- a/src/components/marketing/UseCasePageTemplate.tsx +++ b/src/components/marketing/UseCasePageTemplate.tsx @@ -1,427 +1,427 @@ -import type { FAQItem } from "@/lib/types"; -import type { Metadata } from "next"; - -import Link from "next/link"; -import { - ArrowRight, - CheckCircle2, - Compass, - Link2, - Radar, - Sparkles, -} from "lucide-react"; - -import Breadcrumbs, { BreadcrumbItem } from "@/components/Breadcrumbs"; -import SeoJsonLd from "@/components/SeoJsonLd"; -import { FAQSection } from "@/components/aeo/FAQSection"; -import { - MarketingPageTracker, - TrackedCtaLink, -} from "@/components/marketing/MarketingAnalytics"; -import { AnswerFirstBlock } from "@/components/marketing/AnswerFirstBlock"; -import { Button } from "@/components/ui/Button"; -import { Card } from "@/components/ui/Card"; -import { breadcrumbSchema, faqPageSchema } from "@/lib/schema"; - -type LinkCard = { - href: string; - title: string; - description: string; -}; - -type UseCasePageTemplateProps = { - title: string; - description: string; - eyebrow: string; - intro: string; - pageType: "commercial" | "use_case"; - cluster: string; - useCase?: string; - breadcrumbs: BreadcrumbItem[]; - answer: string; - whenToUse: string[]; - comparisonItems: { - label: string; - value: boolean; - text?: string; - }[]; - howToSteps: string[]; - primaryCta: { - href: string; - label: string; - }; - secondaryCta: { - href: string; - label: string; - }; - workflowTitle: string; - workflowIntro: string; - workflowCards: { - title: string; - description: string; - }[]; - checklistTitle: string; - checklist: string[]; - supportLinks: LinkCard[]; - faq: FAQItem[]; - schemaData?: Record[]; -}; - -export function buildUseCaseMetadata({ - title, - description, - canonicalPath, -}: { - title: string; - description: string; - canonicalPath: string; -}): Metadata { - const canonical = `https://www.qrmaster.net${canonicalPath}`; - - return { - title: { - absolute: `${title} | QR Master`, - }, - description, - alternates: { - canonical, - languages: { - "x-default": canonical, - en: canonical, - }, - }, - openGraph: { - title: `${title} | QR Master`, - description, - url: canonical, - type: "website", - images: ["/og-image.png"], - }, - twitter: { - title: `${title} | QR Master`, - description, - }, - }; -} - -export function UseCasePageTemplate({ - title, - description, - eyebrow, - intro, - pageType, - cluster, - useCase, - breadcrumbs, - answer, - whenToUse, - comparisonItems, - howToSteps, - primaryCta, - secondaryCta, - workflowTitle, - workflowIntro, - workflowCards, - checklistTitle, - checklist, - supportLinks, - faq, - schemaData = [], -}: UseCasePageTemplateProps) { - return ( - <> - - - -
-
-
-
- - -
-
-
- - {eyebrow} -
- -
-

- {title} -

-

- {intro} -

-
- -
- {[ - "Built for QR workflows where the printed surface should stay stable.", - "Focused on operational clarity, not inflated ROI claims.", - "Connected to a commercial parent and sibling workflows.", - "Designed to fit QR Master's existing marketing theme.", - ].map((line) => ( -
- - {line} -
- ))} -
- -
- - - - - - - -
-
- - -
-
-
-
- Workflow snapshot -
-
- What matters here -
-
- -
- -
- {workflowCards.map((card, index) => ( -
-
-
- {index + 1} -
-
- {card.title} -
-
-

- {card.description} -

-
- ))} -
-
- -
-
-
- -
- -
- -
-
-
-

- {workflowTitle} -

-

- {workflowIntro} -

-
- -
- {workflowCards.map((card) => ( - -
- -
-

- {card.title} -

-

- {card.description} -

- - ))} -
-
-
- -
-
- -
-
-
- Checklist -
-

- {checklistTitle} -

-
- -
- -
    - {checklist.map((item) => ( -
  • - - {item} -
    • - ))} -
- - - -
- -

Related links

-
-
- {supportLinks.map((link) => ( - -
-
-
- {link.title} -
-
- {link.description} -
-
- -
- - ))} -
- -
-
- -
- -
- -
-
-
-
-
-
- Next step -
-

- Use a QR workflow that stays useful after the print run starts. -

-

- {description} -

-
- -
- - - - - - - -
-
-
-
-
-
- - ); -} +import type { FAQItem } from "@/lib/types"; +import type { Metadata } from "next"; + +import Link from "next/link"; +import { + ArrowRight, + CheckCircle2, + Compass, + Link2, + Radar, + Sparkles, +} from "lucide-react"; + +import Breadcrumbs, { BreadcrumbItem } from "@/components/Breadcrumbs"; +import SeoJsonLd from "@/components/SeoJsonLd"; +import { FAQSection } from "@/components/aeo/FAQSection"; +import { + MarketingPageTracker, + TrackedCtaLink, +} from "@/components/marketing/MarketingAnalytics"; +import { AnswerFirstBlock } from "@/components/marketing/AnswerFirstBlock"; +import { Button } from "@/components/ui/Button"; +import { Card } from "@/components/ui/Card"; +import { breadcrumbSchema, faqPageSchema } from "@/lib/schema"; + +type LinkCard = { + href: string; + title: string; + description: string; +}; + +type UseCasePageTemplateProps = { + title: string; + description: string; + eyebrow: string; + intro: string; + pageType: "commercial" | "use_case"; + cluster: string; + useCase?: string; + breadcrumbs: BreadcrumbItem[]; + answer: string; + whenToUse: string[]; + comparisonItems: { + label: string; + value: boolean; + text?: string; + }[]; + howToSteps: string[]; + primaryCta: { + href: string; + label: string; + }; + secondaryCta: { + href: string; + label: string; + }; + workflowTitle: string; + workflowIntro: string; + workflowCards: { + title: string; + description: string; + }[]; + checklistTitle: string; + checklist: string[]; + supportLinks: LinkCard[]; + faq: FAQItem[]; + schemaData?: Record[]; +}; + +export function buildUseCaseMetadata({ + title, + description, + canonicalPath, +}: { + title: string; + description: string; + canonicalPath: string; +}): Metadata { + const canonical = `https://www.qrmaster.net${canonicalPath}`; + + return { + title: { + absolute: `${title} | QR Master`, + }, + description, + alternates: { + canonical, + languages: { + "x-default": canonical, + en: canonical, + }, + }, + openGraph: { + title: `${title} | QR Master`, + description, + url: canonical, + type: "website", + images: ["/og-image.png"], + }, + twitter: { + title: `${title} | QR Master`, + description, + }, + }; +} + +export function UseCasePageTemplate({ + title, + description, + eyebrow, + intro, + pageType, + cluster, + useCase, + breadcrumbs, + answer, + whenToUse, + comparisonItems, + howToSteps, + primaryCta, + secondaryCta, + workflowTitle, + workflowIntro, + workflowCards, + checklistTitle, + checklist, + supportLinks, + faq, + schemaData = [], +}: UseCasePageTemplateProps) { + return ( + <> + + + +
+
+
+
+ + +
+
+
+ + {eyebrow} +
+ +
+

+ {title} +

+

+ {intro} +

+
+ +
+ {[ + "Built for QR workflows where the printed surface should stay stable.", + "Focused on operational clarity, not inflated ROI claims.", + "Connected to a commercial parent and sibling workflows.", + "Designed to fit QR Master's existing marketing theme.", + ].map((line) => ( +
+ + {line} +
+ ))} +
+ +
+ + + + + + + +
+
+ + +
+
+
+
+ Workflow snapshot +
+
+ What matters here +
+
+ +
+ +
+ {workflowCards.map((card, index) => ( +
+
+
+ {index + 1} +
+
+ {card.title} +
+
+

+ {card.description} +

+
+ ))} +
+
+ +
+
+
+ +
+ +
+ +
+
+
+

+ {workflowTitle} +

+

+ {workflowIntro} +

+
+ +
+ {workflowCards.map((card) => ( + +
+ +
+

+ {card.title} +

+

+ {card.description} +

+ + ))} +
+
+
+ +
+
+ +
+
+
+ Checklist +
+

+ {checklistTitle} +

+
+ +
+ +
    + {checklist.map((item) => ( +
  • + + {item} +
    • + ))} +
+ + + +
+ +

Related links

+
+
+ {supportLinks.map((link) => ( + +
+
+
+ {link.title} +
+
+ {link.description} +
+
+ +
+ + ))} +
+ +
+
+ +
+ +
+ +
+
+
+
+
+
+ Next step +
+

+ Use a QR workflow that stays useful after the print run starts. +

+

+ {description} +

+
+ +
+ + + + + + + +
+
+
+
+
+
+ + ); +} diff --git a/src/components/settings/ChangePasswordModal.tsx b/src/components/settings/ChangePasswordModal.tsx index f1c4e8d..25b35d2 100644 --- a/src/components/settings/ChangePasswordModal.tsx +++ b/src/components/settings/ChangePasswordModal.tsx @@ -1,165 +1,165 @@ -'use client'; - -import React, { useState } from 'react'; -import { Button } from '@/components/ui/Button'; -import { showToast } from '@/components/ui/Toast'; -import { useCsrf } from '@/hooks/useCsrf'; - -interface ChangePasswordModalProps { - isOpen: boolean; - onClose: () => void; - onSuccess: () => void; -} - -export default function ChangePasswordModal({ - isOpen, - onClose, - onSuccess, -}: ChangePasswordModalProps) { - const { fetchWithCsrf } = useCsrf(); - const [currentPassword, setCurrentPassword] = useState(''); - const [newPassword, setNewPassword] = useState(''); - const [confirmPassword, setConfirmPassword] = useState(''); - const [loading, setLoading] = useState(false); - - const handleSubmit = async (e: React.FormEvent) => { - e.preventDefault(); - - // Validation - if (!currentPassword || !newPassword || !confirmPassword) { - showToast('Please fill in all fields', 'error'); - return; - } - - if (newPassword.length < 8) { - showToast('New password must be at least 8 characters', 'error'); - return; - } - - if (newPassword !== confirmPassword) { - showToast('New passwords do not match', 'error'); - return; - } - - if (currentPassword === newPassword) { - showToast('New password must be different from current password', 'error'); - return; - } - - setLoading(true); - - try { - const response = await fetchWithCsrf('/api/user/password', { - method: 'PATCH', - body: JSON.stringify({ - currentPassword, - newPassword, - }), - }); - - const data = await response.json(); - - if (!response.ok) { - throw new Error(data.error || 'Failed to change password'); - } - - showToast('Password changed successfully!', 'success'); - setCurrentPassword(''); - setNewPassword(''); - setConfirmPassword(''); - onSuccess(); - } catch (error: any) { - showToast(error.message || 'Failed to change password', 'error'); - } finally { - setLoading(false); - } - }; - - if (!isOpen) return null; - - return ( -
- {/* Backdrop */} -
- - {/* Modal */} -
-
-
-

Change Password

-

- Enter your current password and choose a new one -

-
- -
-
- - setCurrentPassword(e.target.value)} - className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-primary-500 focus:border-primary-500" - placeholder="Enter current password" - autoComplete="current-password" - /> -
- -
- - setNewPassword(e.target.value)} - className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-primary-500 focus:border-primary-500" - placeholder="Enter new password (min. 8 characters)" - autoComplete="new-password" - /> -
- -
- - setConfirmPassword(e.target.value)} - className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-primary-500 focus:border-primary-500" - placeholder="Confirm new password" - autoComplete="new-password" - /> -
- -
- - -
-
-
-
-
- ); -} +'use client'; + +import React, { useState } from 'react'; +import { Button } from '@/components/ui/Button'; +import { showToast } from '@/components/ui/Toast'; +import { useCsrf } from '@/hooks/useCsrf'; + +interface ChangePasswordModalProps { + isOpen: boolean; + onClose: () => void; + onSuccess: () => void; +} + +export default function ChangePasswordModal({ + isOpen, + onClose, + onSuccess, +}: ChangePasswordModalProps) { + const { fetchWithCsrf } = useCsrf(); + const [currentPassword, setCurrentPassword] = useState(''); + const [newPassword, setNewPassword] = useState(''); + const [confirmPassword, setConfirmPassword] = useState(''); + const [loading, setLoading] = useState(false); + + const handleSubmit = async (e: React.FormEvent) => { + e.preventDefault(); + + // Validation + if (!currentPassword || !newPassword || !confirmPassword) { + showToast('Please fill in all fields', 'error'); + return; + } + + if (newPassword.length < 8) { + showToast('New password must be at least 8 characters', 'error'); + return; + } + + if (newPassword !== confirmPassword) { + showToast('New passwords do not match', 'error'); + return; + } + + if (currentPassword === newPassword) { + showToast('New password must be different from current password', 'error'); + return; + } + + setLoading(true); + + try { + const response = await fetchWithCsrf('/api/user/password', { + method: 'PATCH', + body: JSON.stringify({ + currentPassword, + newPassword, + }), + }); + + const data = await response.json(); + + if (!response.ok) { + throw new Error(data.error || 'Failed to change password'); + } + + showToast('Password changed successfully!', 'success'); + setCurrentPassword(''); + setNewPassword(''); + setConfirmPassword(''); + onSuccess(); + } catch (error: any) { + showToast(error.message || 'Failed to change password', 'error'); + } finally { + setLoading(false); + } + }; + + if (!isOpen) return null; + + return ( +
+ {/* Backdrop */} +
+ + {/* Modal */} +
+
+
+

Change Password

+

+ Enter your current password and choose a new one +

+
+ +
+
+ + setCurrentPassword(e.target.value)} + className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-primary-500 focus:border-primary-500" + placeholder="Enter current password" + autoComplete="current-password" + /> +
+ +
+ + setNewPassword(e.target.value)} + className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-primary-500 focus:border-primary-500" + placeholder="Enter new password (min. 8 characters)" + autoComplete="new-password" + /> +
+ +
+ + setConfirmPassword(e.target.value)} + className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-primary-500 focus:border-primary-500" + placeholder="Confirm new password" + autoComplete="new-password" + /> +
+ +
+ + +
+
+
+
+
+ ); +} diff --git a/src/components/ui/Badge.tsx b/src/components/ui/Badge.tsx index 3b8874b..54d007f 100644 --- a/src/components/ui/Badge.tsx +++ b/src/components/ui/Badge.tsx @@ -1,32 +1,32 @@ -import React from 'react'; -import { cn } from '@/lib/utils'; - -interface BadgeProps extends React.HTMLAttributes { - variant?: 'default' | 'success' | 'warning' | 'info' | 'error'; -} - -export const Badge = React.forwardRef( - ({ className, variant = 'default', ...props }, ref) => { - const variants = { - default: 'bg-gray-100 text-gray-800', - success: 'bg-success-100 text-success-800', - warning: 'bg-warning-100 text-warning-800', - info: 'bg-info-100 text-info-800', - error: 'bg-red-100 text-red-800', - }; - - return ( -
- ); - } -); - +import React from 'react'; +import { cn } from '@/lib/utils'; + +interface BadgeProps extends React.HTMLAttributes { + variant?: 'default' | 'success' | 'warning' | 'info' | 'error'; +} + +export const Badge = React.forwardRef( + ({ className, variant = 'default', ...props }, ref) => { + const variants = { + default: 'bg-gray-100 text-gray-800', + success: 'bg-success-100 text-success-800', + warning: 'bg-warning-100 text-warning-800', + info: 'bg-info-100 text-info-800', + error: 'bg-red-100 text-red-800', + }; + + return ( +
+ ); + } +); + Badge.displayName = 'Badge'; \ No newline at end of file diff --git a/src/components/ui/BillingToggle.tsx b/src/components/ui/BillingToggle.tsx index 3957543..bd470d6 100644 --- a/src/components/ui/BillingToggle.tsx +++ b/src/components/ui/BillingToggle.tsx @@ -1,38 +1,38 @@ -import React from 'react'; -import { cn } from '@/lib/utils'; - -interface BillingToggleProps { - value: 'month' | 'year'; - onChange: (value: 'month' | 'year') => void; -} - -export const BillingToggle: React.FC = ({ value, onChange }) => { - return ( -
- - -
- ); -}; +import React from 'react'; +import { cn } from '@/lib/utils'; + +interface BillingToggleProps { + value: 'month' | 'year'; + onChange: (value: 'month' | 'year') => void; +} + +export const BillingToggle: React.FC = ({ value, onChange }) => { + return ( +
+ + +
+ ); +}; diff --git a/src/components/ui/Button.tsx b/src/components/ui/Button.tsx index 8fe6224..28960dc 100644 --- a/src/components/ui/Button.tsx +++ b/src/components/ui/Button.tsx @@ -1,48 +1,48 @@ -'use client'; - -import React from 'react'; -import { cn } from '@/lib/utils'; - -interface ButtonProps extends React.ButtonHTMLAttributes { - variant?: 'primary' | 'secondary' | 'outline' | 'ghost'; - size?: 'sm' | 'md' | 'lg'; - loading?: boolean; -} - -export const Button = React.forwardRef( - ({ className, variant = 'primary', size = 'md', loading, children, disabled, ...props }, ref) => { - const baseClasses = 'inline-flex items-center justify-center font-medium rounded-lg transition-colors focus:outline-none focus:ring-2 focus:ring-offset-2 disabled:opacity-50 disabled:cursor-not-allowed'; - - const variants = { - primary: 'bg-primary-600 text-white hover:bg-primary-700 focus:ring-primary-500', - secondary: 'bg-gray-100 text-gray-900 hover:bg-gray-200 focus:ring-gray-500', - outline: 'border border-gray-300 text-gray-700 hover:bg-gray-50 focus:ring-gray-500', - ghost: 'text-gray-700 hover:bg-gray-100 focus:ring-gray-500', - }; - - const sizes = { - sm: 'px-3 py-1.5 text-sm', - md: 'px-4 py-2 text-sm', - lg: 'px-6 py-3 text-base', - }; - - return ( - - ); - } -); - +'use client'; + +import React from 'react'; +import { cn } from '@/lib/utils'; + +interface ButtonProps extends React.ButtonHTMLAttributes { + variant?: 'primary' | 'secondary' | 'outline' | 'ghost'; + size?: 'sm' | 'md' | 'lg'; + loading?: boolean; +} + +export const Button = React.forwardRef( + ({ className, variant = 'primary', size = 'md', loading, children, disabled, ...props }, ref) => { + const baseClasses = 'inline-flex items-center justify-center font-medium rounded-lg transition-colors focus:outline-none focus:ring-2 focus:ring-offset-2 disabled:opacity-50 disabled:cursor-not-allowed'; + + const variants = { + primary: 'bg-primary-600 text-white hover:bg-primary-700 focus:ring-primary-500', + secondary: 'bg-gray-100 text-gray-900 hover:bg-gray-200 focus:ring-gray-500', + outline: 'border border-gray-300 text-gray-700 hover:bg-gray-50 focus:ring-gray-500', + ghost: 'text-gray-700 hover:bg-gray-100 focus:ring-gray-500', + }; + + const sizes = { + sm: 'px-3 py-1.5 text-sm', + md: 'px-4 py-2 text-sm', + lg: 'px-6 py-3 text-base', + }; + + return ( + + ); + } +); + Button.displayName = 'Button'; \ No newline at end of file diff --git a/src/components/ui/Card.tsx b/src/components/ui/Card.tsx index c2ddc0d..b7ce30a 100644 --- a/src/components/ui/Card.tsx +++ b/src/components/ui/Card.tsx @@ -1,94 +1,94 @@ -import React from 'react'; -import { cn } from '@/lib/utils'; - -interface CardProps extends React.HTMLAttributes { - hover?: boolean; -} - -export const Card = React.forwardRef( - ({ className, hover = false, ...props }, ref) => { - return ( -
- ); - } -); - -Card.displayName = 'Card'; - -export const CardHeader = React.forwardRef>( - ({ className, ...props }, ref) => { - return ( -
- ); - } -); - -CardHeader.displayName = 'CardHeader'; - -export const CardTitle = React.forwardRef>( - ({ className, ...props }, ref) => { - return ( -

- ); - } -); - -CardTitle.displayName = 'CardTitle'; - -export const CardDescription = React.forwardRef>( - ({ className, ...props }, ref) => { - return ( -

- ); - } -); - -CardDescription.displayName = 'CardDescription'; - -export const CardContent = React.forwardRef>( - ({ className, ...props }, ref) => { - return ( -

- ); - } -); - -CardContent.displayName = 'CardContent'; - -export const CardFooter = React.forwardRef>( - ({ className, ...props }, ref) => { - return ( -
- ); - } -); - +import React from 'react'; +import { cn } from '@/lib/utils'; + +interface CardProps extends React.HTMLAttributes { + hover?: boolean; +} + +export const Card = React.forwardRef( + ({ className, hover = false, ...props }, ref) => { + return ( +
+ ); + } +); + +Card.displayName = 'Card'; + +export const CardHeader = React.forwardRef>( + ({ className, ...props }, ref) => { + return ( +
+ ); + } +); + +CardHeader.displayName = 'CardHeader'; + +export const CardTitle = React.forwardRef>( + ({ className, ...props }, ref) => { + return ( +

+ ); + } +); + +CardTitle.displayName = 'CardTitle'; + +export const CardDescription = React.forwardRef>( + ({ className, ...props }, ref) => { + return ( +

+ ); + } +); + +CardDescription.displayName = 'CardDescription'; + +export const CardContent = React.forwardRef>( + ({ className, ...props }, ref) => { + return ( +

+ ); + } +); + +CardContent.displayName = 'CardContent'; + +export const CardFooter = React.forwardRef>( + ({ className, ...props }, ref) => { + return ( +
+ ); + } +); + CardFooter.displayName = 'CardFooter'; \ No newline at end of file diff --git a/src/components/ui/Dialog.tsx b/src/components/ui/Dialog.tsx index 3b87443..a23f659 100644 --- a/src/components/ui/Dialog.tsx +++ b/src/components/ui/Dialog.tsx @@ -1,92 +1,92 @@ -import React from 'react'; -import { cn } from '@/lib/utils'; - -interface DialogProps { - open: boolean; - onOpenChange: (open: boolean) => void; - children: React.ReactNode; -} - -export const Dialog: React.FC = ({ open, onOpenChange, children }) => { - if (!open) return null; - - return ( -
-
onOpenChange(false)} - /> -
- {children} -
-
- ); -}; - -interface DialogContentProps extends React.HTMLAttributes {} - -export const DialogContent = React.forwardRef( - ({ className, ...props }, ref) => ( -
- ) -); -DialogContent.displayName = 'DialogContent'; - -interface DialogHeaderProps extends React.HTMLAttributes {} - -export const DialogHeader = React.forwardRef( - ({ className, ...props }, ref) => ( -
- ) -); -DialogHeader.displayName = 'DialogHeader'; - -interface DialogTitleProps extends React.HTMLAttributes {} - -export const DialogTitle = React.forwardRef( - ({ className, ...props }, ref) => ( -

- ) -); -DialogTitle.displayName = 'DialogTitle'; - -interface DialogDescriptionProps extends React.HTMLAttributes {} - -export const DialogDescription = React.forwardRef( - ({ className, ...props }, ref) => ( -

- ) -); -DialogDescription.displayName = 'DialogDescription'; - -interface DialogFooterProps extends React.HTMLAttributes {} - -export const DialogFooter = React.forwardRef( - ({ className, ...props }, ref) => ( -

- ) -); +import React from 'react'; +import { cn } from '@/lib/utils'; + +interface DialogProps { + open: boolean; + onOpenChange: (open: boolean) => void; + children: React.ReactNode; +} + +export const Dialog: React.FC = ({ open, onOpenChange, children }) => { + if (!open) return null; + + return ( +
+
onOpenChange(false)} + /> +
+ {children} +
+
+ ); +}; + +interface DialogContentProps extends React.HTMLAttributes {} + +export const DialogContent = React.forwardRef( + ({ className, ...props }, ref) => ( +
+ ) +); +DialogContent.displayName = 'DialogContent'; + +interface DialogHeaderProps extends React.HTMLAttributes {} + +export const DialogHeader = React.forwardRef( + ({ className, ...props }, ref) => ( +
+ ) +); +DialogHeader.displayName = 'DialogHeader'; + +interface DialogTitleProps extends React.HTMLAttributes {} + +export const DialogTitle = React.forwardRef( + ({ className, ...props }, ref) => ( +

+ ) +); +DialogTitle.displayName = 'DialogTitle'; + +interface DialogDescriptionProps extends React.HTMLAttributes {} + +export const DialogDescription = React.forwardRef( + ({ className, ...props }, ref) => ( +

+ ) +); +DialogDescription.displayName = 'DialogDescription'; + +interface DialogFooterProps extends React.HTMLAttributes {} + +export const DialogFooter = React.forwardRef( + ({ className, ...props }, ref) => ( +

+ ) +); DialogFooter.displayName = 'DialogFooter'; \ No newline at end of file diff --git a/src/components/ui/Dropdown.tsx b/src/components/ui/Dropdown.tsx index ff7e3f9..2e00608 100644 --- a/src/components/ui/Dropdown.tsx +++ b/src/components/ui/Dropdown.tsx @@ -1,63 +1,63 @@ -import React, { useState, useRef, useEffect } from 'react'; -import { cn } from '@/lib/utils'; - -interface DropdownProps { - trigger: React.ReactNode; - children: React.ReactNode; - align?: 'left' | 'right'; -} - -export const Dropdown: React.FC = ({ trigger, children, align = 'left' }) => { - const [isOpen, setIsOpen] = useState(false); - const dropdownRef = useRef(null); - - useEffect(() => { - const handleClickOutside = (event: MouseEvent) => { - if (dropdownRef.current && !dropdownRef.current.contains(event.target as Node)) { - setIsOpen(false); - } - }; - - document.addEventListener('mousedown', handleClickOutside); - return () => document.removeEventListener('mousedown', handleClickOutside); - }, []); - - return ( -
-
setIsOpen(!isOpen)}> - {trigger} -
- {isOpen && ( -
- {children} -
- )} -
- ); -}; - -interface DropdownItemProps extends React.HTMLAttributes { - icon?: React.ReactNode; -} - -export const DropdownItem = React.forwardRef( - ({ className, icon, children, ...props }, ref) => ( -
- {icon && {icon}} - {children} -
- ) -); +import React, { useState, useRef, useEffect } from 'react'; +import { cn } from '@/lib/utils'; + +interface DropdownProps { + trigger: React.ReactNode; + children: React.ReactNode; + align?: 'left' | 'right'; +} + +export const Dropdown: React.FC = ({ trigger, children, align = 'left' }) => { + const [isOpen, setIsOpen] = useState(false); + const dropdownRef = useRef(null); + + useEffect(() => { + const handleClickOutside = (event: MouseEvent) => { + if (dropdownRef.current && !dropdownRef.current.contains(event.target as Node)) { + setIsOpen(false); + } + }; + + document.addEventListener('mousedown', handleClickOutside); + return () => document.removeEventListener('mousedown', handleClickOutside); + }, []); + + return ( +
+
setIsOpen(!isOpen)}> + {trigger} +
+ {isOpen && ( +
+ {children} +
+ )} +
+ ); +}; + +interface DropdownItemProps extends React.HTMLAttributes { + icon?: React.ReactNode; +} + +export const DropdownItem = React.forwardRef( + ({ className, icon, children, ...props }, ref) => ( +
+ {icon && {icon}} + {children} +
+ ) +); DropdownItem.displayName = 'DropdownItem'; \ No newline at end of file diff --git a/src/components/ui/Input.tsx b/src/components/ui/Input.tsx index 6fc0369..24651ca 100644 --- a/src/components/ui/Input.tsx +++ b/src/components/ui/Input.tsx @@ -1,52 +1,52 @@ -import React from 'react'; -import { cn } from '@/lib/utils'; - -interface InputProps extends React.InputHTMLAttributes { - label?: string; - error?: string; -} - -export const Input = React.forwardRef( - ({ className, type, label, error, onInvalid, id, ...props }, ref) => { - // Generate a unique id for accessibility if not provided - const inputId = id || (label ? label.toLowerCase().replace(/\s+/g, '-') : undefined); - - // Default English validation message - const handleInvalid = (e: React.InvalidEvent) => { - e.target.setCustomValidity('Please fill out this field.'); - if (onInvalid) onInvalid(e); - }; - - const handleInput = (e: React.FormEvent) => { - e.currentTarget.setCustomValidity(''); - }; - - return ( -
- {label && ( - - )} - - {error && ( -

{error}

- )} -
- ); - } -); - +import React from 'react'; +import { cn } from '@/lib/utils'; + +interface InputProps extends React.InputHTMLAttributes { + label?: string; + error?: string; +} + +export const Input = React.forwardRef( + ({ className, type, label, error, onInvalid, id, ...props }, ref) => { + // Generate a unique id for accessibility if not provided + const inputId = id || (label ? label.toLowerCase().replace(/\s+/g, '-') : undefined); + + // Default English validation message + const handleInvalid = (e: React.InvalidEvent) => { + e.target.setCustomValidity('Please fill out this field.'); + if (onInvalid) onInvalid(e); + }; + + const handleInput = (e: React.FormEvent) => { + e.currentTarget.setCustomValidity(''); + }; + + return ( +
+ {label && ( + + )} + + {error && ( +

{error}

+ )} +
+ ); + } +); + Input.displayName = 'Input'; \ No newline at end of file diff --git a/src/components/ui/QRCode.tsx b/src/components/ui/QRCode.tsx index 6cd2304..27124e4 100644 --- a/src/components/ui/QRCode.tsx +++ b/src/components/ui/QRCode.tsx @@ -1,54 +1,54 @@ -'use client'; - -import React from 'react'; -import { QRCodeSVG } from 'qrcode.react'; - -interface QRCodeProps { - value: string; - size?: number; - fgColor?: string; - bgColor?: string; - level?: 'L' | 'M' | 'Q' | 'H'; - includeMargin?: boolean; - imageSettings?: { - src: string; - height: number; - width: number; - excavate: boolean; - }; -} - -export const QRCode: React.FC = ({ - value, - size = 128, - fgColor = '#000000', - bgColor = '#FFFFFF', - level = 'M', - includeMargin = false, - imageSettings, -}) => { - if (!value) { - return ( -
- No data -
- ); - } - - return ( - - ); -}; - +'use client'; + +import React from 'react'; +import { QRCodeSVG } from 'qrcode.react'; + +interface QRCodeProps { + value: string; + size?: number; + fgColor?: string; + bgColor?: string; + level?: 'L' | 'M' | 'Q' | 'H'; + includeMargin?: boolean; + imageSettings?: { + src: string; + height: number; + width: number; + excavate: boolean; + }; +} + +export const QRCode: React.FC = ({ + value, + size = 128, + fgColor = '#000000', + bgColor = '#FFFFFF', + level = 'M', + includeMargin = false, + imageSettings, +}) => { + if (!value) { + return ( +
+ No data +
+ ); + } + + return ( + + ); +}; + export default QRCode; \ No newline at end of file diff --git a/src/components/ui/ScrollToTop.tsx b/src/components/ui/ScrollToTop.tsx index ecb88d1..3e2b4f0 100644 --- a/src/components/ui/ScrollToTop.tsx +++ b/src/components/ui/ScrollToTop.tsx @@ -1,57 +1,57 @@ -'use client'; - -import React, { useState, useEffect } from 'react'; - -export function ScrollToTop() { - const [isVisible, setIsVisible] = useState(false); - - // Show button when page is scrolled down - useEffect(() => { - const toggleVisibility = () => { - if (window.pageYOffset > 300) { - setIsVisible(true); - } else { - setIsVisible(false); - } - }; - - window.addEventListener('scroll', toggleVisibility); - - return () => window.removeEventListener('scroll', toggleVisibility); - }, []); - - const scrollToTop = () => { - window.scrollTo({ - top: 0, - behavior: 'smooth', - }); - }; - - return ( - <> - {isVisible && ( - - )} - - ); -} +'use client'; + +import React, { useState, useEffect } from 'react'; + +export function ScrollToTop() { + const [isVisible, setIsVisible] = useState(false); + + // Show button when page is scrolled down + useEffect(() => { + const toggleVisibility = () => { + if (window.pageYOffset > 300) { + setIsVisible(true); + } else { + setIsVisible(false); + } + }; + + window.addEventListener('scroll', toggleVisibility); + + return () => window.removeEventListener('scroll', toggleVisibility); + }, []); + + const scrollToTop = () => { + window.scrollTo({ + top: 0, + behavior: 'smooth', + }); + }; + + return ( + <> + {isVisible && ( + + )} + + ); +} diff --git a/src/components/ui/Select.tsx b/src/components/ui/Select.tsx index 793ef55..74410e7 100644 --- a/src/components/ui/Select.tsx +++ b/src/components/ui/Select.tsx @@ -1,46 +1,46 @@ -import React from 'react'; -import { cn } from '@/lib/utils'; - -interface SelectProps extends React.SelectHTMLAttributes { - label?: string; - error?: string; - options: { value: string; label: string }[]; -} - -export const Select = React.forwardRef( - ({ className, label, error, options, id, ...props }, ref) => { - // Generate a unique id for accessibility if not provided - const selectId = id || (label ? `select-${label.toLowerCase().replace(/\s+/g, '-')}` : undefined); - - return ( -
- {label && ( - - )} - - {error && ( -

{error}

- )} -
- ); - } -); - +import React from 'react'; +import { cn } from '@/lib/utils'; + +interface SelectProps extends React.SelectHTMLAttributes { + label?: string; + error?: string; + options: { value: string; label: string }[]; +} + +export const Select = React.forwardRef( + ({ className, label, error, options, id, ...props }, ref) => { + // Generate a unique id for accessibility if not provided + const selectId = id || (label ? `select-${label.toLowerCase().replace(/\s+/g, '-')}` : undefined); + + return ( +
+ {label && ( + + )} + + {error && ( +

{error}

+ )} +
+ ); + } +); + Select.displayName = 'Select'; \ No newline at end of file diff --git a/src/components/ui/Table.tsx b/src/components/ui/Table.tsx index 8d00d23..858ae3e 100644 --- a/src/components/ui/Table.tsx +++ b/src/components/ui/Table.tsx @@ -1,105 +1,105 @@ -import React from 'react'; -import { cn } from '@/lib/utils'; - -const Table = React.forwardRef>( - ({ className, ...props }, ref) => ( -
- - - ) -); -Table.displayName = 'Table'; - -const TableHeader = React.forwardRef>( - ({ className, ...props }, ref) => ( - - ) -); -TableHeader.displayName = 'TableHeader'; - -const TableBody = React.forwardRef>( - ({ className, ...props }, ref) => ( - - ) -); -TableBody.displayName = 'TableBody'; - -const TableFooter = React.forwardRef>( - ({ className, ...props }, ref) => ( - tr]:last:border-b-0', className)} - {...props} - /> - ) -); -TableFooter.displayName = 'TableFooter'; - -const TableRow = React.forwardRef>( - ({ className, ...props }, ref) => ( - - ) -); -TableRow.displayName = 'TableRow'; - -const TableHead = React.forwardRef>( - ({ className, ...props }, ref) => ( -
- ) -); -TableHead.displayName = 'TableHead'; - -const TableCell = React.forwardRef>( - ({ className, ...props }, ref) => ( - - ) -); -TableCell.displayName = 'TableCell'; - -const TableCaption = React.forwardRef>( - ({ className, ...props }, ref) => ( -
- ) -); -TableCaption.displayName = 'TableCaption'; - -export { - Table, - TableHeader, - TableBody, - TableFooter, - TableHead, - TableRow, - TableCell, - TableCaption, +import React from 'react'; +import { cn } from '@/lib/utils'; + +const Table = React.forwardRef>( + ({ className, ...props }, ref) => ( +
+ + + ) +); +Table.displayName = 'Table'; + +const TableHeader = React.forwardRef>( + ({ className, ...props }, ref) => ( + + ) +); +TableHeader.displayName = 'TableHeader'; + +const TableBody = React.forwardRef>( + ({ className, ...props }, ref) => ( + + ) +); +TableBody.displayName = 'TableBody'; + +const TableFooter = React.forwardRef>( + ({ className, ...props }, ref) => ( + tr]:last:border-b-0', className)} + {...props} + /> + ) +); +TableFooter.displayName = 'TableFooter'; + +const TableRow = React.forwardRef>( + ({ className, ...props }, ref) => ( + + ) +); +TableRow.displayName = 'TableRow'; + +const TableHead = React.forwardRef>( + ({ className, ...props }, ref) => ( +
+ ) +); +TableHead.displayName = 'TableHead'; + +const TableCell = React.forwardRef>( + ({ className, ...props }, ref) => ( + + ) +); +TableCell.displayName = 'TableCell'; + +const TableCaption = React.forwardRef>( + ({ className, ...props }, ref) => ( +
+ ) +); +TableCaption.displayName = 'TableCaption'; + +export { + Table, + TableHeader, + TableBody, + TableFooter, + TableHead, + TableRow, + TableCell, + TableCaption, }; \ No newline at end of file diff --git a/src/components/ui/Toast.tsx b/src/components/ui/Toast.tsx index 54aae74..6ae8584 100644 --- a/src/components/ui/Toast.tsx +++ b/src/components/ui/Toast.tsx @@ -1,140 +1,140 @@ -'use client'; - -import React, { useEffect, useState } from 'react'; -import { createPortal } from 'react-dom'; - -export interface ToastProps { - id: string; - message: string; - type?: 'success' | 'error' | 'info' | 'warning'; - duration?: number; - onClose?: () => void; -} - -export const Toast: React.FC = ({ - id, - message, - type = 'info', - duration = 3000, - onClose, -}) => { - const [isVisible, setIsVisible] = useState(true); - - useEffect(() => { - const timer = setTimeout(() => { - setIsVisible(false); - setTimeout(() => onClose?.(), 300); - }, duration); - - return () => clearTimeout(timer); - }, [duration, onClose]); - - const icons = { - success: ( - - - - ), - error: ( - - - - ), - warning: ( - - - - ), - info: ( - - - - ), - }; - - const colors = { - success: 'bg-success-50 text-success-900 border-success-200', - error: 'bg-red-50 text-red-900 border-red-200', - warning: 'bg-warning-50 text-warning-900 border-warning-200', - info: 'bg-info-50 text-info-900 border-info-200', - }; - - return ( -
-
{icons[type]}
-

{message}

- -
- ); -}; - -// Toast Container -export const ToastContainer: React.FC = () => { - const [toasts, setToasts] = useState([]); - const [isMounted, setIsMounted] = useState(false); - - useEffect(() => { - setIsMounted(true); - - const handleToast = (event: CustomEvent>) => { - const newToast: ToastProps = { - ...event.detail, - id: Date.now().toString(), - }; - setToasts(prev => [...prev, newToast]); - }; - - window.addEventListener('toast' as any, handleToast); - return () => window.removeEventListener('toast' as any, handleToast); - }, []); - - const removeToast = (id: string) => { - setToasts(prev => prev.filter(toast => toast.id !== id)); - }; - - if (!isMounted) return null; - - return createPortal( -
- {toasts.map(toast => ( - removeToast(toast.id)} - /> - ))} -
, - document.body - ); -}; - -// Helper function to show toast -export const showToast = ( - message: string, - type: 'success' | 'error' | 'info' | 'warning' = 'info', - duration = 3000 -) => { - if (typeof window !== 'undefined') { - const event = new CustomEvent('toast', { - detail: { message, type, duration }, - }); - window.dispatchEvent(event); - } +'use client'; + +import React, { useEffect, useState } from 'react'; +import { createPortal } from 'react-dom'; + +export interface ToastProps { + id: string; + message: string; + type?: 'success' | 'error' | 'info' | 'warning'; + duration?: number; + onClose?: () => void; +} + +export const Toast: React.FC = ({ + id, + message, + type = 'info', + duration = 3000, + onClose, +}) => { + const [isVisible, setIsVisible] = useState(true); + + useEffect(() => { + const timer = setTimeout(() => { + setIsVisible(false); + setTimeout(() => onClose?.(), 300); + }, duration); + + return () => clearTimeout(timer); + }, [duration, onClose]); + + const icons = { + success: ( + + + + ), + error: ( + + + + ), + warning: ( + + + + ), + info: ( + + + + ), + }; + + const colors = { + success: 'bg-success-50 text-success-900 border-success-200', + error: 'bg-red-50 text-red-900 border-red-200', + warning: 'bg-warning-50 text-warning-900 border-warning-200', + info: 'bg-info-50 text-info-900 border-info-200', + }; + + return ( +
+
{icons[type]}
+

{message}

+ +
+ ); +}; + +// Toast Container +export const ToastContainer: React.FC = () => { + const [toasts, setToasts] = useState([]); + const [isMounted, setIsMounted] = useState(false); + + useEffect(() => { + setIsMounted(true); + + const handleToast = (event: CustomEvent>) => { + const newToast: ToastProps = { + ...event.detail, + id: Date.now().toString(), + }; + setToasts(prev => [...prev, newToast]); + }; + + window.addEventListener('toast' as any, handleToast); + return () => window.removeEventListener('toast' as any, handleToast); + }, []); + + const removeToast = (id: string) => { + setToasts(prev => prev.filter(toast => toast.id !== id)); + }; + + if (!isMounted) return null; + + return createPortal( +
+ {toasts.map(toast => ( + removeToast(toast.id)} + /> + ))} +
, + document.body + ); +}; + +// Helper function to show toast +export const showToast = ( + message: string, + type: 'success' | 'error' | 'info' | 'warning' = 'info', + duration = 3000 +) => { + if (typeof window !== 'undefined') { + const event = new CustomEvent('toast', { + detail: { message, type, duration }, + }); + window.dispatchEvent(event); + } }; \ No newline at end of file diff --git a/src/hooks/useCsrf.ts b/src/hooks/useCsrf.ts index b2cc5c1..3ef4704 100644 --- a/src/hooks/useCsrf.ts +++ b/src/hooks/useCsrf.ts @@ -1,62 +1,62 @@ -'use client'; - -import { useEffect, useState } from 'react'; - -/** - * Hook to fetch and manage CSRF token for client-side requests - */ -export function useCsrf() { - const [csrfToken, setCsrfToken] = useState(null); - const [loading, setLoading] = useState(true); - - useEffect(() => { - async function fetchCsrfToken() { - try { - const response = await fetch('/api/csrf'); - const data = await response.json(); - setCsrfToken(data.csrfToken); - } catch (error) { - console.error('Failed to fetch CSRF token:', error); - } finally { - setLoading(false); - } - } - - fetchCsrfToken(); - }, []); - - /** - * Helper function to add CSRF token to fetch headers - */ - const getHeaders = (additionalHeaders: HeadersInit = {}) => { - const headers: Record = { - 'Content-Type': 'application/json', - ...(additionalHeaders as Record), - }; - - if (csrfToken) { - headers['x-csrf-token'] = csrfToken; - } - - return headers; - }; - - /** - * Wrapper for fetch with automatic CSRF token injection - */ - const fetchWithCsrf = async (url: string, options: RequestInit = {}) => { - const headers = getHeaders(options.headers as HeadersInit); - - return fetch(url, { - ...options, - headers, - }); - }; - - return { - csrfToken, - loading, - getHeaders, - fetchWithCsrf, - }; -} +'use client'; + +import { useEffect, useState } from 'react'; + +/** + * Hook to fetch and manage CSRF token for client-side requests + */ +export function useCsrf() { + const [csrfToken, setCsrfToken] = useState(null); + const [loading, setLoading] = useState(true); + + useEffect(() => { + async function fetchCsrfToken() { + try { + const response = await fetch('/api/csrf'); + const data = await response.json(); + setCsrfToken(data.csrfToken); + } catch (error) { + console.error('Failed to fetch CSRF token:', error); + } finally { + setLoading(false); + } + } + + fetchCsrfToken(); + }, []); + + /** + * Helper function to add CSRF token to fetch headers + */ + const getHeaders = (additionalHeaders: HeadersInit = {}) => { + const headers: Record = { + 'Content-Type': 'application/json', + ...(additionalHeaders as Record), + }; + + if (csrfToken) { + headers['x-csrf-token'] = csrfToken; + } + + return headers; + }; + + /** + * Wrapper for fetch with automatic CSRF token injection + */ + const fetchWithCsrf = async (url: string, options: RequestInit = {}) => { + const headers = getHeaders(options.headers as HeadersInit); + + return fetch(url, { + ...options, + headers, + }); + }; + + return { + csrfToken, + loading, + getHeaders, + fetchWithCsrf, + }; +} diff --git a/src/hooks/useTranslation.ts b/src/hooks/useTranslation.ts index ea82c30..501706c 100644 --- a/src/hooks/useTranslation.ts +++ b/src/hooks/useTranslation.ts @@ -1,61 +1,61 @@ -'use client'; - -import { useState, useEffect } from 'react'; -import en from '@/i18n/en.json'; -import de from '@/i18n/de.json'; - -type Locale = 'en' | 'de'; - -const translations = { - en, - de, -}; - -export function useTranslation() { - const [locale, setLocale] = useState('en'); - - useEffect(() => { - // Check localStorage for saved locale - const savedLocale = localStorage.getItem('locale') as Locale; - if (savedLocale && (savedLocale === 'en' || savedLocale === 'de')) { - setLocale(savedLocale); - } - }, []); - - const changeLocale = (newLocale: Locale) => { - setLocale(newLocale); - localStorage.setItem('locale', newLocale); - }; - - const t = (key: string, options?: { returnObjects?: boolean }) => { - const keys = key.split('.'); - let value: any = translations[locale]; - - for (const k of keys) { - if (value && typeof value === 'object' && k in value) { - value = value[k]; - } else { - // Fallback to English if key not found - value = translations.en; - for (const k of keys) { - if (value && typeof value === 'object' && k in value) { - value = value[k]; - } else { - return key; // Return key if not found - } - } - break; - } - } - - return value; - }; - - return { - t, - locale, - language: locale, - setLocale: changeLocale, - setLanguage: changeLocale, - }; +'use client'; + +import { useState, useEffect } from 'react'; +import en from '@/i18n/en.json'; +import de from '@/i18n/de.json'; + +type Locale = 'en' | 'de'; + +const translations = { + en, + de, +}; + +export function useTranslation() { + const [locale, setLocale] = useState('en'); + + useEffect(() => { + // Check localStorage for saved locale + const savedLocale = localStorage.getItem('locale') as Locale; + if (savedLocale && (savedLocale === 'en' || savedLocale === 'de')) { + setLocale(savedLocale); + } + }, []); + + const changeLocale = (newLocale: Locale) => { + setLocale(newLocale); + localStorage.setItem('locale', newLocale); + }; + + const t = (key: string, options?: { returnObjects?: boolean }) => { + const keys = key.split('.'); + let value: any = translations[locale]; + + for (const k of keys) { + if (value && typeof value === 'object' && k in value) { + value = value[k]; + } else { + // Fallback to English if key not found + value = translations.en; + for (const k of keys) { + if (value && typeof value === 'object' && k in value) { + value = value[k]; + } else { + return key; // Return key if not found + } + } + break; + } + } + + return value; + }; + + return { + t, + locale, + language: locale, + setLocale: changeLocale, + setLanguage: changeLocale, + }; } \ No newline at end of file diff --git a/src/lib/auth.ts b/src/lib/auth.ts index c5bfd6d..ab10479 100644 --- a/src/lib/auth.ts +++ b/src/lib/auth.ts @@ -1,86 +1,86 @@ -import { NextAuthOptions } from 'next-auth'; -import CredentialsProvider from 'next-auth/providers/credentials'; -import GoogleProvider from 'next-auth/providers/google'; -import { PrismaAdapter } from '@auth/prisma-adapter'; -import { db } from './db'; -import { comparePassword } from './hash'; - -export const authOptions: NextAuthOptions = { - adapter: PrismaAdapter(db) as any, - session: { - strategy: 'jwt', - }, - providers: [ - CredentialsProvider({ - name: 'credentials', - credentials: { - email: { label: 'Email', type: 'email' }, - password: { label: 'Password', type: 'password' }, - }, - async authorize(credentials) { - if (!credentials?.email || !credentials?.password) { - return null; - } - - const user = await db.user.findUnique({ - where: { email: credentials.email }, - }); - - if (!user || !user.password) { - return null; - } - - const isPasswordValid = await comparePassword( - credentials.password, - user.password - ); - - if (!isPasswordValid) { - return null; - } - - return { - id: user.id, - email: user.email, - name: user.name, - plan: user.plan || 'FREE', - }; - }, - }), - ...(process.env.GOOGLE_CLIENT_ID && process.env.GOOGLE_CLIENT_SECRET - ? [ - GoogleProvider({ - clientId: process.env.GOOGLE_CLIENT_ID, - clientSecret: process.env.GOOGLE_CLIENT_SECRET, - }), - ] - : []), - ], - callbacks: { - async jwt({ token, user, trigger, session }) { - if (user) { - token.id = user.id; - token.plan = user.plan; - } - - // Update session support - if (trigger === "update" && session?.plan) { - token.plan = session.plan; - } - - return token; - }, - async session({ session, token }) { - if (session?.user) { - session.user.id = token.id as string; - session.user.plan = (token.plan as string) || 'FREE'; - } - return session; - }, - }, - pages: { - signIn: '/login', - error: '/login', - }, - secret: process.env.NEXTAUTH_SECRET, +import { NextAuthOptions } from 'next-auth'; +import CredentialsProvider from 'next-auth/providers/credentials'; +import GoogleProvider from 'next-auth/providers/google'; +import { PrismaAdapter } from '@auth/prisma-adapter'; +import { db } from './db'; +import { comparePassword } from './hash'; + +export const authOptions: NextAuthOptions = { + adapter: PrismaAdapter(db) as any, + session: { + strategy: 'jwt', + }, + providers: [ + CredentialsProvider({ + name: 'credentials', + credentials: { + email: { label: 'Email', type: 'email' }, + password: { label: 'Password', type: 'password' }, + }, + async authorize(credentials) { + if (!credentials?.email || !credentials?.password) { + return null; + } + + const user = await db.user.findUnique({ + where: { email: credentials.email }, + }); + + if (!user || !user.password) { + return null; + } + + const isPasswordValid = await comparePassword( + credentials.password, + user.password + ); + + if (!isPasswordValid) { + return null; + } + + return { + id: user.id, + email: user.email, + name: user.name, + plan: user.plan || 'FREE', + }; + }, + }), + ...(process.env.GOOGLE_CLIENT_ID && process.env.GOOGLE_CLIENT_SECRET + ? [ + GoogleProvider({ + clientId: process.env.GOOGLE_CLIENT_ID, + clientSecret: process.env.GOOGLE_CLIENT_SECRET, + }), + ] + : []), + ], + callbacks: { + async jwt({ token, user, trigger, session }) { + if (user) { + token.id = user.id; + token.plan = user.plan; + } + + // Update session support + if (trigger === "update" && session?.plan) { + token.plan = session.plan; + } + + return token; + }, + async session({ session, token }) { + if (session?.user) { + session.user.id = token.id as string; + session.user.plan = (token.plan as string) || 'FREE'; + } + return session; + }, + }, + pages: { + signIn: '/login', + error: '/login', + }, + secret: process.env.NEXTAUTH_SECRET, }; \ No newline at end of file diff --git a/src/lib/blog-data.ts b/src/lib/blog-data.ts index 153fa48..18490bb 100644 --- a/src/lib/blog-data.ts +++ b/src/lib/blog-data.ts @@ -1,2486 +1,2598 @@ -import type { BlogPost } from "./types"; - -export const blogPosts: BlogPost[] = [ - // ================================================================================== - // EXISTING POSTS (Refreshed) - 8 Posts - // ================================================================================== - - { - slug: "qr-code-restaurant-menu", - title: "Restaurant Menu QR Codes: 2026 Guide", // Updated year - description: "Step-by-step guide to creating digital menu QR codes for your restaurant. Learn best practices for touchless menus, placement tips, and tracking.", - excerpt: "Step-by-step guide to creating digital menu QR codes for your restaurant. Learn best practices for touchless menus, placement tips, and tracking.", - category: "Restaurant", - pillar: "use-cases", - published: true, - publishDate: "2026-01-05", - date: "January 5, 2026", - datePublished: "2026-01-05T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "12 Min", - image: "/blog/restaurant-qr-menu.png", - heroImage: "/blog/restaurant-qr-menu.png", - imageAlt: "Restaurant table with QR code menu", - keywords: ["restaurant menu qr code", "qr code menu", "digital menu qr", "touchless menu", "dynamic qr code menu"], - quickAnswer: `

Use a dynamic QR code that links to a mobile-friendly menu (PDF or landing page). Dynamic QR lets you update the menu URL anytime without reprinting and track scans to measure engagement.

`, - keySteps: [ - "Prepare your menu (PDF, website landing page, menu platform, or Google Doc).", - "Make sure the menu is mobile-friendly (fast load, readable fonts, thumb-friendly).", - "Create a dynamic QR code so you can update the destination later.", - "Customize the QR design (logo, brand colors, strong contrast).", - "Print at the right size and place it where customers naturally look.", - "Track scans and optimize (peak times, locations, repeat scans).", - ], - faq: [ - { question: "What should my restaurant menu QR code link to?", answer: "Best: a mobile-friendly landing page. Good alternative: a clean PDF (fast loading, readable text)." }, - { question: "Should restaurants use static or dynamic QR codes?", answer: "Use dynamic so you can update menu links and see scan analytics without reprinting." }, - { question: "What is the minimum QR code size for tables?", answer: "Aim for 2" x 2" minimum; 2.5" x 2.5" recommended for table tents." }, - { question: "Can I update my menu without reprinting?", answer: "Yes—if you use a dynamic QR code, you can change the destination anytime." }, - { question: "Why is my menu QR code not scanning well?", answer: "Common causes: QR too small, low contrast, glossy reflections, poor lighting, or linking to a slow PDF/page." }, - { question: "How can I track menu QR scans?", answer: "Use dynamic QR analytics (scans, locations, devices) and optionally add UTM parameters for campaign attribution." }, - ], - relatedSlugs: ["dynamic-vs-static-qr-codes", "qr-code-print-size-guide", "qr-code-tracking-guide-2025", "qr-code-events"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: January 5, 2026 | Last updated: January 26, 2026 -

-
- -

Why Restaurants Need QR Code Menus

-

Digital QR code menus have evolved from a pandemic necessity to a restaurant industry standard. They offer reduced printing costs, instant menu updates, and valuable customer analytics.

-
`, - }, - - { - slug: "vcard-qr-code-generator", - title: "Free vCard QR Generator: Digital Cards", - description: "Create professional vCard QR codes for digital business cards. Share contact info instantly with a scan—includes templates and best practices.", - excerpt: "Create professional vCard QR codes for digital business cards. Share contact info instantly with a scan—includes templates and best practices.", - category: "Business Cards", - pillar: "use-cases", - published: true, - publishDate: "2026-01-05", - date: "January 5, 2026", - datePublished: "2026-01-05T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "10 Min", - image: "/blog/vcard-qr-code.png", - heroImage: "/blog/vcard-qr-code.png", - imageAlt: "Professional business card with vCard QR code", - keywords: ["vcard qr code", "digital business card qr", "vcf qr code", "contact card qr"], - quickAnswer: `

A vCard QR code lets people save your contact details in one scan (VCF format). Use a dynamic vCard if your details may change, so you can update info and track scans without reprinting.

`, - keySteps: [ - "Open the vCard / Contact Card QR generator.", - "Choose static (embedded) or dynamic (editable + trackable).", - "Enter your key details (name, phone, email; optionally company + LinkedIn).", - "Customize the design (logo/headshot, brand colors, strong contrast).", - "Download in SVG for print or PNG (300 DPI) for digital/print.", - "Test-scan on iOS and Android before printing in bulk.", - ], - faq: [ - { question: "Does a vCard QR code work on iPhone and Android?", answer: "Yes—most modern phones support saving contacts via vCard/VCF after scanning." }, - { question: "Static vs dynamic vCard—what's better?", answer: "Dynamic is better if your info changes. You can update details and track scans." }, - { question: "Can I include LinkedIn and social links?", answer: "Yes—add LinkedIn/website links for a stronger professional profile." }, - { question: "What file format is best for printing business cards?", answer: "Use SVG for sharp print quality at any size." }, - ], - relatedSlugs: ["business-card-qr-code", "qr-code-print-size-guide", "qr-code-small-business", "dynamic-vs-static-qr-codes"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: January 5, 2026 | Last updated: January 26, 2026 -

-
- -

What is a vCard QR Code?

-

A vCard (Virtual Contact File) QR code contains your contact information in a standardized format (.vcf). When someone scans it with their smartphone camera, they can instantly save your details to their contacts—no typing required.

-
`, - }, - - { - slug: "qr-code-small-business", - title: "Best QR Code Generator for Small Business 2026", // Updated year - description: "Find the best QR code solution for your small business. Compare features, pricing, and use cases for marketing, payments, and operations.", - excerpt: "Find the best QR code solution for your small business. Compare features, pricing, and use cases for marketing, payments, and operations.", - category: "Business", - pillar: "use-cases", - published: true, - publishDate: "2026-01-05", - date: "January 5, 2026", - datePublished: "2026-01-05T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "14 Min", - image: "/blog/small-business-qr.png", - heroImage: "/blog/small-business-qr.png", - imageAlt: "Small business owner using QR codes", - keywords: ["best qr code generator", "qr code generator for small business", "dynamic qr codes", "qr code tracking"], - quickAnswer: `

The best QR code generator for small business is one that supports dynamic QR (edit links after printing), analytics (measure ROI), and branding (logo/colors). If you run campaigns, choose dynamic + tracking.

`, - keySteps: [ - "Pick your main use case (menu, feedback, payments, lead capture, downloads).", - "Decide: static (never changes) vs dynamic (editable + trackable).", - "Create the destination page first (fast, mobile-friendly).", - "Generate the QR and add a clear call-to-action (what happens after scan).", - "Customize safely (logo + colors, keep contrast high).", - "Add UTM tags if you want attribution in analytics tools.", - "Track scans, iterate on placement/design, and optimize conversions.", - ], - faq: [ - { question: "Do small businesses need dynamic QR codes?", answer: "If you run offers, menus, or campaigns that change, yes. Dynamic QR prevents reprints and adds analytics." }, - { question: "Can I track QR codes for free?", answer: "Basic tracking may be free in some tools, but advanced analytics usually requires dynamic QR features." }, - { question: "What's the best QR code use case for ROI?", answer: "Lead capture, reviews/feedback, menu ordering, and promotions work best when tracked and optimized." }, - ], - relatedSlugs: ["qr-code-marketing", "qr-code-analytics", "free-vs-paid-qr-generator", "best-qr-code-generator-2026"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: January 5, 2026 | Last updated: January 26, 2026 -

-
- -

Why Small Businesses Need QR Codes

-

From contactless payments to digital menus, QR codes offer affordable solutions for growing businesses.

-
`, - }, - - { - slug: "qr-code-print-size-guide", - title: "QR Code Print Size Guide: Minimum Sizes", - description: "Complete guide to QR code print sizes. Learn minimum dimensions for business cards, posters, banners, and more to ensure reliable scanning.", - excerpt: "Complete guide to QR code print sizes. Learn minimum dimensions for business cards, posters, banners, and more to ensure reliable scanning.", - category: "Printing", - pillar: "basics", - published: true, - publishDate: "2026-01-05", - date: "January 5, 2026", - datePublished: "2026-01-05T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "8 Min", - image: "/blog/qr-print-sizes.png", - heroImage: "/blog/qr-print-sizes.png", - imageAlt: "Various print materials showing different QR code sizes", - keywords: ["qr code print size", "minimum qr code size", "qr code size guide", "qr code scanning distance"], - quickAnswer: `

Use the 10:1 rule: scanning distance should be about 10× the QR code size. Example: for 2 meters distance, aim for ~20 cm QR size. Always test-scan a print proof before production.

`, - keySteps: [ - "Determine the expected scanning distance (table, wall, poster, billboard).", - "Apply the 10:1 rule to estimate minimum size.", - "Adjust for data density (more data = more modules = needs larger size).", - "Use error correction wisely (higher EC can increase complexity).", - "Export in SVG for print or high-DPI PNG (300 DPI).", - "Print a proof and test-scan in real lighting conditions.", - ], - faq: [ - { question: "What is the minimum QR code size for business cards?", answer: "Common safe minimum is around 0.8–1.0 inch (2–2.5 cm), depending on data density and print quality." }, - { question: "How does scanning distance affect size?", answer: "Farther distance needs larger codes. Use the 10:1 rule as a baseline." }, - { question: "Does more data require a bigger QR code?", answer: "Yes—more data increases module density and reduces scannability at small sizes." }, - ], - relatedSlugs: ["qr-code-restaurant-menu", "business-card-qr-code", "dynamic-vs-static-qr-codes", "bulk-qr-code-generator-excel"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: January 5, 2026 | Last updated: January 26, 2026 -

-
- -

Why QR Code Size Matters

-

A QR code that's too small won't scan reliably. The golden rule: QR Code Width = Scanning Distance ÷ 10.

-
`, - }, - - { - slug: "qr-code-tracking-guide-2025", - title: "QR Code Tracking: Complete Guide 2026", // Updated year - description: "Learn how to track QR code scans with real-time analytics. Compare free vs paid tracking tools, setup Google Analytics, and measure ROI.", - excerpt: "Learn how to track QR code scans with real-time analytics. Compare free vs paid tracking tools, setup Google Analytics, and measure ROI.", - category: "Tracking & Analytics", - pillar: "tracking", - published: true, - publishDate: "2025-10-18", - date: "October 18, 2025", - datePublished: "2025-10-18T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "8 Min", - image: "/blog/qr-code-tracking-hero-v2.png", - heroImage: "/blog/qr-code-tracking-hero-v2.png", - imageAlt: "Dashboard showing trackable QR code stats", - keywords: ["qr code tracking", "track qr scans", "dynamic qr code analytics", "utm qr codes", "google analytics qr"], - quickAnswer: `

To track QR scans reliably, use a dynamic QR code that redirects through a tracking link. Then review scan metrics (time, location, device) in a dashboard and add UTM parameters if you want campaign attribution.

`, - keySteps: [ - "Choose dynamic QR for editable destinations + analytics.", - "Define success metrics (scans, conversions, ROI).", - "Add UTM parameters to the destination URL for attribution.", - "Deploy QR with a clear CTA and correct print size.", - "Monitor scans by location/device/time and spot patterns.", - "Iterate: change placement, CTA, landing page, and offers based on data.", - ], - faq: [ - { question: "Can I track a static QR code?", answer: "Not reliably. Static codes don't redirect through analytics; use dynamic for tracking." }, - { question: "What metrics should I track?", answer: "Total scans, unique scans (if available), time/day patterns, location, device type, and conversion actions." }, - { question: "What are UTM parameters and do I need them?", answer: "UTMs label traffic sources for analytics tools. Use them if you run multiple campaigns/placements." }, - ], - relatedSlugs: ["qr-code-analytics", "trackable-qr-codes", "utm-parameter-qr-codes", "dynamic-vs-static-qr-codes"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Bitly: QR Code Statistics & Tracking Best Practices", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "QR Code Tiger: Dynamic QR Code Tracking Guide", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - { name: "Google Analytics: Event Tracking & UTM Parameters", url: "https://support.google.com/analytics/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: October 18, 2025 | Last updated: January 26, 2026 -

-
-

Why Track QR Codes?

-

According to Bitly's QR Code Statistics, tracking QR scans is essential for understanding campaign performance. Dynamic QR codes allow you to capture real-time metrics like scan volume, geographic location, device types, and timestamp patterns—data that drives ROI optimization.

-

Dynamic vs Static QR for Tracking

-

Only dynamic QR codes can be tracked effectively. Dynamic codes redirect scans through a server, allowing analytics collection before users reach their destination. Static QR codes embed the destination directly, making tracking impossible.

`, - }, - - { - slug: "dynamic-vs-static-qr-codes", - title: "Dynamic vs Static QR Codes: The Ultimate Comparison", - description: "Understand the difference between static and dynamic QR codes. Learn when to use each type, pros/cons, and how dynamic QR codes save money.", - excerpt: "Static vs Dynamic QR Codes: Which should you choose? Learn the key differences, pros and cons, and why dynamic codes are better for business.", - category: "QR Code Basics", - pillar: "basics", - published: true, - publishDate: "2025-10-17", - date: "October 17, 2025", - datePublished: "2025-10-17T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "10 Min", - image: "/blog/dynamic-vs-static-hero-v2.png", - heroImage: "/blog/dynamic-vs-static-hero-v2.png", - imageAlt: "Visual comparison of static and dynamic QR codes", - keywords: ["dynamic qr code", "static qr code", "dynamic vs static qr", "editable qr code", "trackable qr code"], - quickAnswer: `

Static QR encodes the destination directly and can't be changed. Dynamic QR uses a redirect so you can edit links after printing and get analytics. If content may change or you need ROI tracking, choose dynamic.

`, - keySteps: [ - "Use static QR for permanent content that never changes (e.g., WiFi password, fixed URL).", - "Use dynamic QR for campaigns, menus, promotions, and anything that might change.", - "If you need analytics (scans, devices, locations), choose dynamic.", - "For print, export SVG and follow size/contrast best practices.", - "Test-scan before mass printing and monitor performance.", - ], - faq: [ - { question: "Can I change a static QR code after printing?", answer: "No. Static QR codes cannot be edited after creation." }, - { question: "Do dynamic QR codes expire?", answer: "They can if the service is disabled. Keep the plan/account active for long-term campaigns." }, - { question: "Why do dynamic QR codes enable tracking?", answer: "Because scans go through a redirect that logs scan events before sending users to the final destination." }, - ], - relatedSlugs: ["qr-code-tracking-guide-2025", "trackable-qr-codes", "free-vs-paid-qr-generator", "best-qr-code-generator-2026"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "QR Code Tiger: Dynamic vs Static QR Code Comparison", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - { name: "Bitly: QR Code Best Practices & Tracking Guide", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Mordor Intelligence: QR Code Market Adoption Analysis", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: October 17, 2025 | Last updated: January 26, 2026 -

-
- -

One of the most common questions we get is: "Should I use a static or dynamic QR code?" If you are using the QR code for marketing, business, or any long-term use, choose Dynamic. According to industry research on QR code performance, dynamic QR codes enable better campaign optimization, cost control, and real-time analytics—key advantages for business applications.

-
`, - }, - - { - slug: "bulk-qr-code-generator-excel", - title: "How to Generate Bulk QR Codes from Excel", - description: "Generate hundreds of QR codes from Excel or CSV files in minutes. Step-by-step guide with templates, best practices, and free tools.", - excerpt: "Generate hundreds of unique QR codes at once. Upload your Excel or CSV file and download a ZIP of high-res QR codes. Perfect for inventory and ID cards.", - category: "Bulk Generation", - pillar: "developer", - published: true, - publishDate: "2025-10-16", - date: "October 16, 2025", - datePublished: "2025-10-16T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "13 Min", - image: "/blog/bulk-qr-events-hero.png", - heroImage: "/blog/bulk-qr-events-hero.png", - imageAlt: "Excel spreadsheet to QR code process", - keywords: ["bulk qr codes", "qr codes from excel", "csv qr code generator", "bulk qr generator"], - quickAnswer: `

To create bulk QR codes, prepare an Excel/CSV with one row per destination (URL/text/etc.). Upload it to a bulk generator to instantly produce many unique QR codes—ideal for badges, inventory, mailers, and campaigns.

`, - keySteps: [ - "Create an Excel/CSV with one QR per row (e.g., URL, label, optional UTM fields).", - "Validate formatting (no broken URLs, consistent columns).", - "Upload the file to a bulk QR generator tool.", - "Choose static vs dynamic (dynamic for tracking/editing).", - "Generate and download the batch (ZIP folder).", - "Test-scan a random sample (5–10 codes) before production.", - ], - faq: [ - { question: "What file format is required—Excel or CSV?", answer: "Most tools accept CSV. Excel usually needs export to CSV." }, - { question: "How many QR codes can I generate at once?", answer: "Depends on the tool/plan. For large batches, use bulk features with limits (e.g., 1,000 rows)." }, - { question: "How do I add UTM tracking for each QR?", answer: "Add UTM columns or append UTMs in your URL column before upload." }, - ], - relatedSlugs: ["qr-code-api-documentation", "qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-print-size-guide"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "QR Code Tiger: Bulk QR Code Generation Guide", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - { name: "Bitly: Large-Scale QR Code Operations", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Google Sheets & Excel Integration with QR Generators", url: "https://support.google.com/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: October 16, 2025 | Last updated: January 26, 2026 -

-
- -

Why Bulk QR Code Generation Matters

-

Creating QR codes one by one is fine for a business card. But what if you need 500 QR codes for employee badges, 1,000 for product labels, or 10,000 for a direct mail campaign? Bulk QR Code Generation allows you to upload a spreadsheet and generate thousands of codes in minutes. According to QR Code Tiger's bulk generation research, this approach saves hours of manual work and ensures consistency across large campaigns.

- -

When to Use Bulk QR Generation

-

Bulk generation is essential for inventory management, event badge creation, product packaging, and multi-location campaigns where each unit needs a unique code.

-
`, - }, - - { - slug: "qr-code-analytics", - title: "QR Code Analytics: The Complete Guide", - description: "Learn how to leverage scan analytics, campaign tracking, and dashboard insights to maximize QR code ROI.", - excerpt: "Master QR Code Analytics. Learn how to track scans, measure ROI, and optimize your marketing campaigns using real-time data.", - category: "Analytics", - pillar: "tracking", - published: true, - publishDate: "2025-10-16", - date: "October 16, 2025", - datePublished: "2025-10-16T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "15 Min", - image: "/blog/qr-code-analytics-hero-v2.png", - heroImage: "/blog/qr-code-analytics-hero-v2.png", - imageAlt: "QR Code Analytics dashboard visualization", - keywords: ["qr code analytics", "scan analytics", "qr campaign tracking", "qr code roi", "utm analytics"], - quickAnswer: `

QR analytics shows what happens after you publish a QR: scan volume, time patterns, device mix, and location trends. Use analytics to improve placement, landing pages, and offers—so scans turn into measurable ROI.

`, - keySteps: [ - "Use dynamic QR so scan events can be measured.", - "Define KPIs (scans, conversions, cost per conversion, ROI).", - "Segment results by placement and campaign (UTMs help).", - "Analyze time/location/device trends to spot winning placements.", - "Optimize: update landing page, CTA text, offer, and distribution.", - ], - faq: [ - { question: "What is the difference between QR tracking and QR analytics?", answer: "Tracking is collecting scan events; analytics is turning them into insights for optimization (segments, trends, ROI)." }, - { question: "What metrics matter most for marketing?", answer: "Scans over time, scan rate per placement, device/location trends, and conversion rate on the landing page." }, - { question: "How do I connect QR analytics to Google Analytics?", answer: "Use UTMs and track landing page events (forms, purchases, calls) inside GA." }, - ], - relatedSlugs: ["qr-code-tracking-guide-2025", "utm-parameter-qr-codes", "qr-code-scan-statistics-2026", "trackable-qr-codes"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Yahoo Finance: Global QR Code Payments Market Analysis 2025-2030", url: "https://finance.yahoo.com/news/analysis-global-qr-code-payments-155300360.html", accessDate: "January 2026" }, - { name: "QRCodeChimp: QR Code Statistics for 2026", url: "https://www.qrcodechimp.com/qr-code-statistics/", accessDate: "January 2026" }, - { name: "FBI IC3: Warning on QR Code Phishing Attacks", url: "https://www.ic3.gov/CSA/2026/260108.pdf", accessDate: "January 2026" }, - { name: "Barracuda Networks: Email Threat Radar January 2026", url: "https://blog.barracuda.com/2026/01/22/email-threat-radar-january-2026", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: October 16, 2025 | Last updated: January 26, 2026 -

-
- -

What Are Scan Analytics?

-

Scan analytics provide comprehensive insights into how users interact with your dynamic QR codes. According to QRCodeChimp's 2026 QR Code Statistics, QR codes enable real-time tracking of geographic location, device types, scan timestamps, and user engagement patterns—essential metrics for optimizing marketing ROI.

- -

Key Metrics to Monitor

-

The most important scan analytics include total scan volume, unique scans, geographic distribution, device mix (mobile vs desktop), and conversion rates. By analyzing these metrics, businesses can identify winning placements and underperforming campaigns quickly.

-
`, - }, - - // ================================================================================== - // NEW POSTS (Week 1: Quick Wins) - // ================================================================================== - - { - slug: "barcode-generator-tool", - title: "Free Barcode Generator Tool: Create Online", - description: "Generate free barcodes (EAN, UPC, Code128) instantly. No sign-up required. Perfect for retail types and inventory management.", - excerpt: "Generate free barcodes (EAN, UPC, Code128) instantly. No sign-up required. Perfect for retail packaging, products, and inventory management.", - category: "Tools", - pillar: "basics", - published: true, - publishDate: "2026-01-29", // +3 days from 26th (assuming start) - date: "January 29, 2026", - datePublished: "2026-01-29T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "5 Min", - image: "/blog/free-barcode-generator-guide.png", - heroImage: "/blog/free-barcode-generator-guide.png", - imageAlt: "Online Barcode Generator Tool", - keywords: ["free barcode generator", "create barcode online", "UPC generator", "EAN generator"], - quickAnswer: "

Use our free barcode tool to select your format (EAN-13, UPC-A, Code128), enter your code number, and download a high-res image for printing. ensure high contrast (black on white) for readability.

", - keySteps: [ - "Select the barcode type (EAN for retail, Code128 for inventory).", - "Enter the numeric or alphanumeric code.", - "Generate the barcode image.", - "Download in PNG or SVG vector format.", - "Test with a scanner before mass printing.", - ], - faq: [ - { question: "What is the difference between EAN-13 and UPC-A?", answer: "EAN-13 is the standard for retail products globally (especially Europe), while UPC-A is primarily used in the USA and Canada." }, - { question: "Can I use these barcodes for Amazon FBA?", answer: "The barcode image format works, but Amazon may require valid GS1-issued GTINs. Make sure you legally own the number sequence before printing." }, - { question: "Which barcode format is best for internal inventory?", answer: "Code 128 is widely used for inventory because it supports alphanumeric characters (letters and numbers), providing more flexibility." }, - { question: "Is this barcode generator free for commercial use?", answer: "Yes—our tool lets you generate and download high-resolution barcode images for commercial packaging and labels." }, - { question: "How do I print barcode labels correctly?", answer: "Use a high-resolution printer (300 DPI+) and ensure high contrast, typically black bars on a solid white background, to ensure reliable scanning." }, - ], - relatedSlugs: ["dynamic-vs-static-qr-codes", "qr-code-print-size-guide"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: January 29, 2026 | Last updated: January 26, 2026 -

-
-

Free Barcode Generator

Content coming soon.

` - }, - - { - slug: "spotify-code-generator-guide", - title: "Spotify Code Generator: Create & Share Codes Fast", - description: "Spotify code generator guide: create Spotify codes for songs, playlists, and artists. Learn best placements, printing tips, and tracking alternatives.", - excerpt: "Spotify codes are one of the easiest ways to turn a real-world moment into a stream. Learn how to create, print, and share them for songs, playlists, and marketing.", - category: "Social Media", - pillar: "use-cases", - published: true, - publishDate: "2026-02-01", - date: "February 1, 2026", - datePublished: "2026-02-01T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "6 Min", - image: "/blog/spotify-qr-code.png", - heroImage: "/blog/spotify-qr-code.png", - imageAlt: "Spotify Code for music sharing", - keywords: ["spotify code generator", "music qr code", "spotify playlist code", "share spotify song"], - - quickAnswer: "

A Spotify Code is a scannable tag that links directly to a song, album, or playlist. Unlike a standard QR code, it looks like a soundwave. To create one, just copy the Spotify URI or link from the app and use a Spotify Code generator.

", - - keySteps: [ - "Open Spotify (desktop or web player is easiest).", - "Go to the content you want to share (song, playlist, artist, etc.).", - "Click Share and copy the Spotify link.", - "Use your generator or Spotify's built-in tool to create the code asset.", - "Download and place it into your design (poster, social post, print layout).", - "Pro tip: Use one 'main' code per placement to avoid confusion.", - ], - - faq: [ - { question: "Do Spotify codes work without the Spotify app?", answer: "Usually no. Scanning is designed for Spotify's in-app scanner; a standard QR code is more universal." }, - { question: "Can I track Spotify code scans?", answer: "Not reliably like QR campaigns. Use a trackable QR code with UTMs if you need attribution." }, - { question: "Do Spotify codes expire?", answer: "Typically not, as long as the Spotify content (song/playlist/artist) remains available." }, - { question: "What's better: Spotify code or QR code for promotions?", answer: "Spotify codes look native; QR codes are better for tracking and flexibility (dynamic links)." }, - { question: "What size should a Spotify code be for print?", answer: "Aim for at least ~2–3 cm on flyers and ~4–6 cm on posters, then test scan distance." }, - ], - - relatedSlugs: ["qr-code-events", "qr-code-tracking-guide-2025"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 1, 2026 | Last updated: January 26, 2026 -

-
- -

Spotify codes are one of the easiest ways to turn a real-world moment into a stream. This Spotify code generator guide shows you how Spotify codes work, how to create them, and how to use them strategically—whether you're an artist, a DJ, a venue, or a brand running campaigns.

-

Unlike classic QR codes, Spotify codes are designed specifically for Spotify and are highly recognizable. People know instantly what they are: "Scan this and play." That makes them perfect for posters, merch, event flyers, table tents, business cards, and social media.

- -

What is a Spotify Code?

-

A Spotify code is a scannable Spotify identifier for a song, album, playlist, artist profile, or podcast episode. When someone scans it in the Spotify app, they jump straight to the content—no searching, no typing.

-

Spotify codes usually look like a soundwave-style barcode under a Spotify URI or link. They are fast, simple, and shareable.

- -

What can you create Spotify codes for?

-

Most creators use Spotify codes for:

-
    -
  • Songs (singles): perfect for posters, stickers, and release campaigns
    • -
  • Albums/EPs: use on vinyl sleeves, CD covers, or press kits
    • -
  • Playlists: especially for gyms, cafés, or event playlists
    • -
  • Artist profiles: great for business cards and merch tags
    • -
  • Podcasts / episodes: share a specific episode at conferences or meetups
    • -
- -

How to create a Spotify code (step-by-step)

-
    -
  1. Open Spotify (desktop or web player is easiest)
    2. -
  2. Go to the content you want to share (song, playlist, artist, etc.)
    3. -
  3. Click Share
    4. -
  4. Copy the Spotify link (or open the Spotify code option if visible)
    5. -
  5. Use our Dynamic QR Generator to create a branded code asset
    6. -
  6. Download and place it into your design (poster, social post, print layout)
    7. -
-

Pro tip: use one "main" code per placement. Too many codes on one poster = confusion.

- -

Spotify Code vs QR Code: What's better?

-

Spotify codes are great, but they have one major limitation: tracking.

- -

Spotify Code

-
    -
  • Looks native to Spotify
    • -
  • Great for music audiences
    • -
  • Requires Spotify app scanning (or Spotify's scan feature)
    • -
  • Typically limited tracking capabilities
    • -
- -

QR Code

-
    -
  • Works with any camera
    • -
  • Can link to Spotify or a landing page
    • -
  • Supports UTMs + scan analytics
    • -
  • Can be dynamic (edit destination later)
    • -
- -

If you care about marketing performance, campaigns, or attribution, a trackable QR often wins. A good compromise is:

-
    -
  • Use a Spotify code for aesthetics + brand recognition
    • -
  • Use a trackable QR code nearby for analytics and flexible routing (example: a short landing page with "Open in Spotify / Apple Music / YouTube Music" buttons)
    • -
- -

Check out our Tracking Guide and Dynamic vs Static comparison for more on this.

- -

Wrap-up: the best strategy

-

Use a Spotify code when you want instant recognition and a music-native vibe. Use a QR code when you want universal scanning + tracking. For most campaigns, the highest-converting setup is a combination: Spotify code for branding, trackable QR for analytics.

-
` - }, - - { - slug: "whatsapp-qr-code-generator", - title: "WhatsApp QR Code: Direct Chat Link Guide", - description: "WhatsApp QR Code: generate a QR that opens a direct WhatsApp chat (wa.me). Perfect for SMBs—plus tracking, UTMs, and best practices.", - excerpt: "Make it ridiculously easy for customers to contact you. Create a WhatsApp QR code that opens a direct chat with a pre-filled message when scanned.", - category: "Social Media", - pillar: "use-cases", - published: true, - publishDate: "2026-02-04", - date: "February 4, 2026", - datePublished: "2026-02-04T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "7 Min", - image: "/blog/whatsapp-qr-code.png", - heroImage: "/blog/whatsapp-qr-code.png", - imageAlt: "WhatsApp QR Code for direct chat", - keywords: ["whatsapp qr code", "wa.me qr code", "click to chat whatsapp", "contact qr code"], - - quickAnswer: "

A WhatsApp QR Code links directly to a 'wa.me' chat URL. When scanned, it opens WhatsApp and starts a chat with your number, optionally with a pre-written message. It removes friction for customers needing support or booking.

", - - keySteps: [ - "Create your link: wa.me/ (e.g., wa.me/4917612345678).", - "Optional: Add a prefilled text (?text=Hello...).", - "Paste the link into a dynamic QR generator.", - "Customize with the WhatsApp logo/colors.", - "Download and test-scan before printing.", - ], - - faq: [ - { question: "How do I create a WhatsApp direct chat link (wa.me)?", answer: "Use the format https://wa.me/countrycode-number (e.g., https://wa.me/4917612345678) without +, spaces, or leading zeros." }, - { question: "Can I add a prefilled message to my WhatsApp QR code?", answer: "Yes: use the syntax wa.me/number?text=message (e.g., spaces become %20). This automatically opens the chat with your text ready." }, - { question: "Does WhatsApp QR work for WhatsApp Business?", answer: "Yes, it works the same as long as the number is correct." }, - { question: "Can I track how many people scanned my WhatsApp QR?", answer: "Yes—use a dynamic/trackable QR code or route through a landing page with UTMs." }, - { question: "What's the best placement for a WhatsApp QR code?", answer: "Places with high intent: storefront, invoices, menus, service counters, event booths." }, - ], - - relatedSlugs: ["qr-code-tracking-guide-2025", "qr-code-small-business"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "WhatsApp Click-to-Chat Official Documentation", url: "https://www.whatsapp.com/business/api/", accessDate: "January 2026" }, - { name: "Bitly: WhatsApp Marketing & QR Code Usage", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "QR Code Tiger: WhatsApp Integration Guide", url: "https://www.qrcode-tiger.com/whatsapp-qr-code", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 4, 2026 | Last updated: January 26, 2026 -

-
- -

If your goal is "make it ridiculously easy for customers to contact me," then WhatsApp QR Code erstellen is one of the highest-intent moves you can make.

-

A WhatsApp QR code can open a direct chat instantly—no typing phone numbers, no searching contacts. Customers scan, WhatsApp opens, and your conversation starts. This is perfect for restaurants, salons, gyms, real estate, events, local services, and B2B sales.

- -

What is a WhatsApp QR Code?

-

A WhatsApp QR code is a QR code that links to a WhatsApp action—usually:

-
    -
  • Open a chat with a specific number
    • -
  • Open a chat with a prefilled message
    • -
  • Route users through a landing page first (for tracking or segmentation)
    • -
-

The simplest and most widely used format is WhatsApp's click-to-chat link: https://wa.me/<number>.

- -

Why WhatsApp QR codes convert so well

-

WhatsApp QR codes work because they reduce friction. According to Bitly's QR code research, WhatsApp integrations increase customer engagement by up to 40% because users can initiate contact instantly without searching for phone numbers. Key benefits include:

-
    -
  • One scan → instant chat
    • -
  • No form fields
    • -
  • No waiting for email replies
    • -
  • Works perfectly on mobile (where most scans happen)
    • -
- -

Step-by-step: WhatsApp QR Code erstellen

- -

Step 1: Create your WhatsApp click-to-chat link

-

Use this structure: https://wa.me/<countrycode><number>

-

Example (Germany format):
- Country code: 49
- Number: 17612345678
- Link: https://wa.me/4917612345678

-

Important: use the phone number in international format, without plus signs, spaces, or leading zeros.

- -

Step 2: Add a prefilled message (optional)

-

Prefilled messages increase conversion because users don't have to think.

-

Format: https://wa.me/<number>?text=<encoded message>

-

Example: "Hi, I'd like to book..." becomes text=Hi%2C%20I%27d%20like%20to%20book...

- -

Step 3: Generate the QR code

-

Paste the wa.me link into your QR generator. If possible, choose Dynamic QR so you can track scans.

- -

Best placements for WhatsApp QR codes

-
    -
  1. Storefront / Reception: "Scan to chat & book" at the entrance.
    2. -
  2. Business Cards & Invoices: Direct support channel builds trust.
    3. -
  3. Restaurant Menus: "Call the waiter" or "Book a table".
    4. -
  4. Events: Lead capture ("Scan for brochure").
    5. -
- -

How to track WhatsApp QR code performance

-

If you simply link to wa.me, you lose analytics. Use a trackable QR code (dynamic) that redirects to your WhatsApp link. This gives you scan counts, location data, and device types.

- -

Design Tips

-
    -
  • Make it big enough (test scan!)
    • -
  • Use strong contrast
    • -
  • Add a WhatsApp logo (helps recognition)
    • -
  • Add a CTA: "Scan to chat"
    • -
-
` - }, - - { - slug: "instagram-qr-code-generator", - title: "Instagram QR Code Generator: Grow Followers Fast", - description: "Instagram QR code generator: create a QR to your profile with UTMs, tracking, and best placements. Ideal for events, stores, and creators.", - excerpt: "Turn offline attention into online followers. Create a custom Instagram QR code for your packaging, signage, or business cards and track scans.", - category: "Social Media", - pillar: "use-cases", - published: true, - publishDate: "2026-02-07", - date: "February 7, 2026", - datePublished: "2026-02-07T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "6 Min", - image: "/blog/instagram-qr-code.png", - heroImage: "/blog/instagram-qr-code.png", - imageAlt: "Instagram QR Code for followers", - keywords: ["Instagram QR code generator", "Instagram profile QR", "Instagram QR for flyers", "Instagram QR code for business", "Instagram link QR"], - - quickAnswer: "

An Instagram QR Code links directly to your profile, a post, or a Reel. When scanned, it opens the Instagram app automatically. It is the fastest way to move people from physical locations (stores, events) to your digital profile.

", - - keySteps: [ - "Copy your Instagram URL (instagram.com/username) or specific post link.", - "Decide: Static (permanent) or Dynamic (editable + tracking).", - "Paste into the QR generator.", - "Optional: Add UTM parameters for tracking source (e.g. utm_source=flyer).", - "Customize colors/logo and download.", - ], - - faq: [ - { question: "Should I link my QR to my profile or a specific post/Reel?", answer: "Profile for follower growth; a specific Reel if you want conversion through one message." }, - { question: "Can I track Instagram QR scans in GA4?", answer: "Yes—use UTMs on the destination URL or route through a landing page." }, - { question: "Do Instagram QR codes open the app automatically?", answer: "Usually yes; if not installed, it opens in the browser (depends on device settings)." }, - { question: "What's the best CTA for an Instagram QR?", answer: "\"Scan to follow\" or \"Scan for deals\" performs better than generic \"Scan me.\"" }, - { question: "What QR size should I use on print?", answer: "Business cards ~2–3 cm; posters larger. Always test scan distance." }, - ], - - relatedSlugs: ["utm-parameter-qr-codes", "qr-code-tracking-guide-2025"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 7, 2026 | Last updated: January 26, 2026 -

-
- -

An Instagram QR code generator helps you turn offline attention into followers. People see your brand in real life—on packaging, posters, menus, business cards, or at events—and with one scan they land on your Instagram profile.

-

If you're doing local marketing, events, creator collabs, or retail, this is one of the simplest growth levers you can deploy. But to do it properly, you want two things: a clean, fast QR that opens your profile, and a way to measure performance.

- -

What is an Instagram QR code?

-

An Instagram QR code is a QR that links directly to:

-
    -
  • Your Instagram profile
    • -
  • A specific post or Reel
    • -
  • A landing page that routes to Instagram (better for tracking)
    • -
-

When scanned, it opens Instagram (or the browser if needed) and takes the user straight to the destination.

- -

Why Instagram QR codes work

-

Instagram growth is usually limited by friction: people don't remember usernames, typing is annoying, and searching often leads to the wrong account. A QR code removes all of that.

-

You're basically turning real-world moments into instant social actions: follow, DM, watch a Reel, or click your bio link.

- -

Step-by-step: Create an Instagram QR code

- -

Step 1: Copy your Instagram URL

-

Your profile URL looks like: https://www.instagram.com/yourusername/.
- If you want to link a specific post: Open the post → Share → Copy link. Then, go to the Instagram QR Code Tool.

- -

Step 2: Decide static vs dynamic

-
    -
  • Static: simple, permanent, no editing later.
    • -
  • Dynamic: change destination later + tracking options. If you're printing anything at scale, dynamic is safer.
    • -
- -

Step 3: Add tracking (recommended)

-

If your QR generator supports tracking, enable it. If you want analytics in GA4, use UTMs.

-

Example: https://www.instagram.com/user/?utm_source=flyer&utm_medium=print

- -

Step 4: Generate and download

-

Generate the QR code and download it in a print-friendly format (PNG for basic use; SVG for professional print).

- -

Best placements to grow followers

-
    -
  1. Storefront & POS: "Scan & follow for weekly deals" at checkout.
    2. -
  2. Packaging: High-intent traffic from customers who just bought.
    3. -
  3. Events: "Scan to enter raffle" or "Follow for photos".
    4. -
  4. Menus: Highlight daily specials or food photos.
    5. -
- -

How to measure Instagram QR performance

-

If you just link to your Instagram profile without tracking, you'll be guessing. Here are practical ways to measure:

-
    -
  • Method A: Different QR codes per placement. Create separate codes for storefront, flyer, and packaging, then compare scan numbers.
    • -
  • Method B: UTMs + GA4. UTMs let you see which placement created traffic in your web analytics.
    • -
  • Method C: Route through a landing page. A short landing page ("Follow us") captures analytics cleanly before redirecting.
    • -
- -

Design rules for high scan rates

-
    -
  • Keep contrast high
    • -
  • Add a short instruction ("Scan to follow")
    • -
  • Pair with your handle in text
    • -
  • Don't shrink it too much
    • -
-
` - }, - - // ================================================================================== - // NEW POSTS (Week 2: Tracking & Attribution) - // ================================================================================== - - { - slug: "trackable-qr-codes", - title: "Trackable QR Codes: Create, Track & Optimize Scans", - description: "Trackable QR codes: create QR codes with scan analytics, campaigns, and dynamic links. Learn setup, best practices, and real marketing use cases.", - excerpt: "Turn dumb QR codes into smart marketing tools. Learn how trackable QR codes work, what metrics to measure, and how to optimize your real-world campaigns.", - category: "Tracking", - pillar: "tracking", - published: true, - publishDate: "2026-02-10", - date: "February 10, 2026", - datePublished: "2026-02-10T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "10 Min", - image: "/blog/trackable-qr-codes.png", - heroImage: "/blog/trackable-qr-codes.png", - imageAlt: "Trackable QR Code analytics", - keywords: ["trackable QR codes", "QR code tracking", "dynamic QR code tracking", "QR code analytics", "track QR scans", "QR code campaign tracking"], - - quickAnswer: "

Trackable QR Codes are dynamic QR codes that capture data when scanned. They allow you to measure total scans, device types, location, and time of scan. Unlike static codes, they enable you to calculate ROI and optimize marketing campaigns based on real performance data.

", - - keySteps: [ - "Choose the destination (landing page, PDF, app download).", - "Create a dynamic QR code (essential for tracking).", - "Optional: Add UTM parameters for Google Analytics attribution.", - "Test scanning on iOS and Android.", - "Roll out and compare performance across placements.", - ], - - faq: [ - { question: "What are trackable QR codes?", answer: "QR codes that log scan events (count, time, device, etc.)—often via a redirect (dynamic QR)." }, - { question: "Are trackable QR codes the same as dynamic QR codes?", answer: "Most of the time yes. Dynamic enables tracking + editable destinations." }, - { question: "Can I track conversions, not just scans?", answer: "Yes—use UTMs + GA4 + a landing page to measure signups/purchases." }, - { question: "Do trackable QR codes scan slower?", answer: "Slightly (redirect), but good systems keep it fast. Always test." }, - { question: "Can I update the destination later?", answer: "Yes—if it's dynamic." }, - ], - - relatedSlugs: ["qr-code-tracking-guide-2025", "qr-code-analytics", "dynamic-vs-static-qr-codes", "qr-code-small-business"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Mordor Intelligence: QR Codes Market Size & Trend Analysis 2026-2031", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "QR Code Tiger: QR Code Adoption Rate Stats 2026", url: "https://www.qrcode-tiger.com/qr-code-adoption-rate", accessDate: "January 2026" }, - ], - - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 10, 2026 | Last updated: January 26, 2026 -

-
- -

Most QR codes are "dumb." They work, but you have zero idea what happens after people scan. That's why trackable QR codes are a game changer: you can measure scans, compare placements, and optimize campaigns like a real marketer. According to QR Code Tiger's 2026 Adoption Report, QR codes are now integrated into standard marketing workflows for measurable offline-to-online attribution.

-

If you're using QR codes for menus, posters, packaging, events, lead-gen, or B2B brochures, tracking turns QR into a performance channel instead of a guess. This guide explains what trackable QR codes are, how they work, and how to set them up for clean analytics.

- -

What are trackable QR codes?

-

Trackable QR codes are QR codes that collect scan data such as:

-
    -
  • Total scans
    • -
  • Scans over time (timeline)
    • -
  • Device type (iOS vs Android)
    • -
  • Location (approximate city/country)
    • -
  • Campaign/placement performance
    • -
-

Most trackable QR codes are also dynamic QR codes, meaning you can edit the destination later without reprinting.

- -

Trackable vs non-trackable (the difference)

- -

Static QR code

-
    -
  • Encodes the final URL directly
    • -
  • Cannot change destination later
    • -
  • No built-in tracking
    • -
  • Best for "permanent" usage like Wi-Fi credentials
    • -
- -

Trackable / dynamic QR code

-
    -
  • Encodes a short redirect URL
    • -
  • Redirect logs scan events
    • -
  • Destination can be updated
    • -
  • Perfect for campaigns and printed materials
    • -
-

Check out our guide on Dynamic vs Static QR Codes for a deeper dive, or explore our Tracking Features.

- -

Why tracking matters (real-world examples)

-

Market research from Mordor Intelligence's 2026 QR Code Market Report shows that brands using trackable QR codes report higher conversion rates and customer engagement compared to non-tracked placements.

- -

Example 1: Posters in 3 locations

-

You place posters in a gym, a café, and a university. With trackable QR codes, you can see which location drives scans. Without tracking, you're blind.

- -

Example 2: Event booth optimization

-

You try a QR on the counter, one on a roll-up banner, and one on giveaway cards. Tracking shows which placement converts best.

- -

Example 3: Packaging campaigns

-

Add QR codes to packaging inserts. Track scans per batch, product line, or time period. That becomes a measurable retention lever.

- -

How trackable QR codes work

-

A trackable QR code usually points to a short redirect link like: https://yourdomain.com/r/abc123.

-

When scanned:

-
    -
  1. The system records the scan event (time, IP, device).
    2. -
  2. Then redirects the user to the final destination URL.
    3. -
-

That's it. The user experience stays fast, but you gain analytics.

- -

Step-by-step: Create trackable QR codes

- -

Step 1: Choose the destination

-

Decide what you want users to reach: landing page, WhatsApp chat, Instagram profile, PDF, or app download. Pro tip: for conversion, a specific landing page usually beats a homepage.

- -

Step 2: Create a dynamic QR code

-

In your generator, select dynamic and enable scan tracking. Name the QR code clearly (e.g., "Poster_Cafe_Jan2026").

- -

Step 3: Add campaign parameters (optional)

-

If you use Google Analytics, add UTMs to the destination URL.
- Example: ?utm_source=poster&utm_medium=print&utm_campaign=winter_offer.

- -

Step 4: Test scanning experience

-

Before printing, scan with iPhone and Android. Test on mobile data (not just Wi-Fi) to ensure fast loading.

- -

Step 5: Roll out + compare placements

-

Use separate trackable QR codes per location, channel, or campaign language to get actionable data.

- -

What metrics matter for QR campaigns?

-
    -
  • Scans per placement: Your biggest lever for optimization.
    • -
  • Scans per day/week: Shows campaign decay or growth.
    • -
  • Conversion rate: What happens after the scan?
    • -
  • Device split: Helps with UX decisions.
    • -
- -

Best practices

-
    -
  • One QR code = one purpose
    • -
  • Use consistent naming conventions
    • -
  • Don't reuse the same code across totally different campaigns
    • -
  • If a campaign ends, redirect the QR to a relevant evergreen page (don't let it 404)
    • -
- -

Wrap-up

-

Trackable QR codes turn QR from a static "link" into a measurable marketing channel. If you run offline placements, events, packaging, or any B2B collateral, tracking is the difference between guessing and optimizing.

-
` - }, - - { - slug: "utm-parameter-qr-codes", - title: "UTM Parameters with QR Codes: Track Offline Campaigns", - description: "UTM parameters with QR codes: track posters, flyers, packaging, and events in GA4. Learn UTM setup, templates, and best practices.", - excerpt: "UTM parameters differ from standard tracking. Learn how to tag your QR code URLs with source, medium, and campaign to get precise attribution in Google Analytics 4.", - category: "Tracking", - pillar: "tracking", - published: true, - publishDate: "2026-02-13", - date: "February 13, 2026", - datePublished: "2026-02-13T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "12 Min", - image: "/blog/utm-qr-codes.png", - heroImage: "/blog/utm-qr-codes.png", - imageAlt: "UTM Parameters concept with QR code and Analytics", - keywords: ["qr code utm tracking", "ga4 qr code tracking", "utm builder", "campaign tracking qr code", "trackable qr codes", "qr code analytics"], - quickAnswer: `

UTM parameters are tags you add to the end of your QR code's destination URL (e.g., ?utm_source=flyer). When scanned, these tags tell tools like Google Analytics 4 exactly where the user came from, allowing you to track the ROI of offline campaigns like posters, events, or packaging.

`, - keySteps: [ - "Decide what to track (Channel, Asset, Variation).", - "Create a consistent naming convention (lowercase, underscores).", - "Build the full URL with UTMs (source, medium, campaign).", - "Generate a dynamic QR code for that URL.", - "Test scan to ensure it redirects correctly and UTMs persist.", - "Monitor 'Traffic acquisition' in GA4 to see results.", - ], - faq: [ - { question: "What UTMs should I use for QR codes?", answer: "At minimum: utm_source, utm_medium, utm_campaign. Add utm_content for placements." }, - { question: "Do UTMs work if the QR goes directly to a website?", answer: "Yes—GA4 captures them on landing." }, - { question: "How do I track different poster locations?", answer: "Use utm_content=location_name or create separate QR codes per location." }, - { question: "Should I use \"print\" or \"qr\" as utm_medium?", answer: "Either works—pick one and stay consistent across all campaigns." }, - { question: "What's the best GA4 report for QR UTMs?", answer: "Traffic acquisition and Campaign reports (plus conversions for ROI)." }, - ], - relatedSlugs: ["trackable-qr-codes", "qr-code-analytics", "dynamic-vs-static-qr-codes", "qr-code-tracking-guide-2025"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Google Analytics: Campaign Attribution Guide", url: "https://analytics.google.com/", accessDate: "January 2026" }, - { name: "QR Code Tiger: QR Analytics & Tracking Best Practices", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 13, 2026 | Last updated: January 26, 2026 -

-
- -

UTM Parameters with QR Codes: How to Track Offline Scans in GA4

-

QR codes are amazing for offline-to-online marketing—but without tracking, you're basically guessing. According to Bitly's 2026 QR Code Statistics, campaigns with proper tracking parameters can see significantly higher engagement and conversion rates by enabling data-driven optimization. That's where UTM parameters with QR codes come in. UTMs are simple tags you add to a URL so that Google Analytics 4 (GA4) can tell you exactly where the traffic came from.

- -

If you run posters, flyers, menus, business cards, packaging inserts, or event banners, UTMs let you answer questions like:

-
    -
  • Which poster location gets the most scans?
    • -
  • Do flyers outperform table tents?
    • -
  • Does packaging drive repeat traffic?
    • -
  • Which event booth placement brings the best leads?
    • -
- -

This guide shows you how to structure UTMs for QR campaigns, avoid common tracking mistakes, and set up clean offline attribution.

- -

What are UTM parameters?

-

UTM parameters are short pieces of text you add to the end of a URL. They look like this:

-

?utm_source=poster&utm_medium=print&utm_campaign=brand_launch

-

The most important UTM fields are:

-
    -
  • utm_source = where it came from (poster, flyer, packaging, event)
    • -
  • utm_medium = the marketing medium (print, offline, qr)
    • -
  • utm_campaign = the campaign name (winter_offer_2026)
    • -
  • utm_content (optional) = variation (location_a vs location_b)
    • -
  • utm_term (optional) = keyword (mostly for paid search, but can be used creatively)
    • -
-

When someone scans the QR code and lands on your site, GA4 captures those UTMs and attributes the session accordingly.

- -

Why UTMs matter for QR codes

-

QR scan analytics from a QR tool can tell you scan counts. But UTMs let you track what happens after the scan:

-
    -
  • page views
    • -
  • signups
    • -
  • purchases
    • -
  • form submissions
    • -
  • time on site
    • -
  • conversion rate
    • -
-

That means UTMs + GA4 is how you measure real ROI.

- -

The best setup: Trackable QR code + UTM URL

-

Here's the cleanest, most scalable method:

-
    -
  1. Create a landing page URL (destination)
    2. -
  2. Add UTMs to that URL
    3. -
  3. Put that full URL behind a dynamic/trackable QR code
    4. -
  4. Monitor performance in GA4 + your QR dashboard
    5. -
-

Internal link: Trackable QR Codes.

-

Why dynamic matters: if you ever change your campaign or page structure, you can update the destination later without reprinting.

- -

Step-by-step: Add UTMs to a QR code

- -

Step 1: Decide what you want to track

-

Before writing UTMs, define the campaign structure. For example:

-
    -
  • Channel: offline QR
    • -
  • Assets: posters, flyers, menus
    • -
  • Variations: 3 locations
    • -
- -

Step 2: Create a UTM naming convention

-

Consistency is everything. Use lowercase and underscores.

-

Example convention:

-
    -
  • utm_source = poster / flyer / menu / packaging / event
    • -
  • utm_medium = qr / offline / print
    • -
  • utm_campaign = spring_promo_2026
    • -
  • utm_content = location_cafe / location_gym / location_uni
    • -
- -

Step 3: Build your URL

-

Base URL example:
- https://yourdomain.com/offer

-

With UTMs:
- https://yourdomain.com/offer?utm_source=poster&utm_medium=print&utm_campaign=spring_promo_2026&utm_content=location_cafe

- -

Step 4: Generate the QR code using the UTM URL

-

Paste the full UTM URL into your QR generator (preferably dynamic + trackable).

- -

Step 5: Test it

-

Scan with two devices and confirm:

-
    -
  • the page loads fast
    • -
  • GA4 is tracking sessions
    • -
  • UTMs appear in GA4
    • -
- -

UTM templates for common QR campaigns

-

Use these as copy/paste templates:

- -

Poster template

-

?utm_source=poster&utm_medium=print&utm_campaign=campaign_name&utm_content=location_name

- -

Flyer template

-

?utm_source=flyer&utm_medium=print&utm_campaign=campaign_name&utm_content=distribution_point

- -

Packaging insert

-

?utm_source=packaging&utm_medium=offline&utm_campaign=campaign_name&utm_content=product_line

- -

Event booth

-

?utm_source=event&utm_medium=offline&utm_campaign=campaign_name&utm_content=booth_banner

- -

How to view QR UTMs in GA4

-

In GA4, you typically check:

-
    -
  • Traffic acquisition → Sessions by source/medium
    • -
  • User acquisition → New users by source/medium
    • -
  • Campaigns reports (if enabled) → Campaign, source, medium
    • -
  • Explorations → build a custom report including conversions
    • -
-

Pro tip: define a conversion event for your key action (signup, lead form, purchase). That way you can compare conversion rate per QR placement.

-

Internal link: Analytics Guide.

- -

Common mistakes (avoid these)

-
    -
  • Inconsistent naming ("Poster" vs "poster" vs "POSTER")
    • -
  • Using spaces (use underscores)
    • -
  • Forgetting to separate variations (no utm_content = no learning)
    • -
  • Pointing to slow pages (QR traffic is impatient)
    • -
  • Using static QR for campaigns that evolve
    • -
- -

Advanced: Routing QR traffic through a campaign page

-

If you want deeper control, route all QR scans to a campaign landing page first. That page can:

-
    -
  • detect device language (DE/EN)
    • -
  • offer multiple buttons (Spotify, WhatsApp, pricing, etc.)
    • -
  • A/B test headlines
    • -
  • improve conversion
    • -
-

Your QR stays the same, but you optimize the page over time.

- -

Wrap-up

-

Using UTM parameters with QR codes is the fastest way to turn offline marketing into measurable performance. Combine UTMs with dynamic QR codes and GA4 conversions, and you can optimize QR placements like a real paid campaign.

-
` - }, - - - - { - slug: "qr-code-scan-statistics-2026", - title: "QR Code Scan Statistics 2026: Usage, Trends & Insights", - description: "QR code scan statistics 2026: key trends, adoption, and marketing insights. Use these stats to plan campaigns, tracking, and ROI.", - excerpt: "QR code scan statistics 2026 content is an authority builder. Marketers, founders, agencies, and journalists love numbers—especially when they're connected to actionable strategy.", - category: "Insights", - pillar: "basics", - published: true, - publishDate: "2026-02-16", - date: "February 16, 2026", - datePublished: "2026-02-16T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "8 Min", - image: "/blog/qr-statistics-2026.png", - heroImage: "/blog/qr-statistics-2026.png", - imageAlt: "QR Code Scan Statistics 2026 Data Visualization", - keywords: ["qr code statistics", "qr code usage trends", "qr code marketing stats", "qr code adoption", "qr code scans by industry", "qr code growth", "qr code analytics"], - quickAnswer: "

In 2026, QR code usage has evolved from a pandemic necessity to a standard marketing channel. Over 85% of smartphone users globally have scanned a QR code at least once. The biggest shift is the move from static menu scanning to trackable, dynamic campaigns for payments, packaging, and lead generation.

", - keySteps: [ - "Use one QR per placement to isolate performance data.", - "Add UTM parameters to all QR destinations for GA4 tracking.", - "Ensure destination pages are mobile-fast (sub-2s load time).", - "Always include a clear CTA next to the QR ('Scan to...').", - "Use dynamic QR codes for any printed assets to allow future updates.", - "Track conversions (sales, leads), not just raw scan counts.", - ], - faq: [ - { question: "Where can I find reliable QR code statistics?", answer: "Look for primary sources: market research firms, OS/camera adoption data, GS1, trusted industry reports." }, - { question: "Which QR metrics matter most for marketers?", answer: "Growth rate, scan frequency, industry adoption, and conversion behavior after scan." }, - { question: "How often should I update a stats article?", answer: "At least yearly (e.g., update to 2027) and whenever major new reports are published." }, - { question: "Are scan counts enough to measure ROI?", answer: "No—track conversions using UTMs + analytics." }, - { question: "What's the best way to make a stats post link-worthy?", answer: "Add citations, charts, and clear takeaways marketers can apply." }, - ], - relatedSlugs: ["qr-code-marketing", "trackable-qr-codes", "utm-parameter-qr-codes", "qr-code-small-business"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Statista: QR Code Usage and Adoption Statistics", url: "https://www.statista.com/", accessDate: "January 2026" }, - { name: "QR Code Tiger: QR Code Adoption & Market Trends", url: "https://www.qrcode-tiger.com/qr-code-adoption-rate", accessDate: "January 2026" }, - { name: "Mordor Intelligence: QR Codes Market Analysis 2026", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 16, 2026 | Last updated: January 26, 2026 -

-
- -

QR Code Scan Statistics 2026: The Trends Marketers Should Know

-

This article is designed to be updated yearly. The main goal isn't just to list statistics, but to translate them into what to do next: placements, tracking, conversion tactics, and campaign planning.

- -

Note: I'm not browsing live sources inside this chat. Before publishing, pull 5–10 fresh stats from reliable reports (e.g., Statista, GS1, camera/OS adoption reports, marketing research firms) and replace the placeholder sections below with your numbers + citations.

- -

Why QR code statistics matter

-

QR codes sit at the intersection of:

-
    -
  • mobile behavior
    • -
  • offline marketing
    • -
  • instant conversion
    • -
  • attribution/analytics
    • -
- -

Knowing scan trends helps you decide:

-
    -
  • whether QR belongs in your channel mix
    • -
  • what industries are growing fastest
    • -
  • how to position QR offers and CTAs
    • -
  • why tracking matters more than ever
    • -
- -

The biggest QR trends shaping 2026

-

According to Mordor Intelligence's latest market analysis, the global QR code market has experienced significant growth beyond initial expectations, with adoption accelerating across all industries and use cases.

- -

1) QR has moved from "menu-only" to "everything"

-

During the early wave, QR codes were heavily associated with restaurant menus. In 2026, usage is everywhere, as documented by Bitly's research:

-
    -
  • product packaging
    • -
  • retail shelves
    • -
  • event access and check-ins
    • -
  • payments and receipts
    • -
  • lead gen and B2B brochures
    • -
-

Action: Don't treat QR as a single use case. Treat it as a distribution layer for offline.

-

Internal link: QR Code Marketing.

- -

2) Marketers demand attribution, not scans

-

Scan counts are not enough. Brands want:

-
    -
  • UTMs
    • -
  • conversion tracking
    • -
  • placement comparisons
    • -
  • campaign dashboards
    • -
-

Action: Make "trackable" your default recommendation and product angle.

-

Internal link: Trackable QR Codes + Tracking Guide.

- -

3) Dynamic QR codes are becoming standard

-

Static QR codes are fine for permanent pages. But dynamic codes win for:

-
    -
  • campaigns
    • -
  • pricing updates
    • -
  • seasonal offers
    • -
  • multi-location rollouts
    • -
-

Action: Use dynamic for anything printed at scale.

- -

4) QR adoption is driven by trust + security

-

More QR usage also increases "quishing" attempts (QR phishing). That pushes organizations toward:

-
    -
  • branded domains
    • -
  • trustworthy QR generators
    • -
  • secure redirects
    • -
-

Action: Build trust signals (custom domains, transparent destinations, privacy).

-

(Internal link later: QR Code Security & Quishing.)

- -

Key QR statistics to include (placeholders)

-

Below are sections where you add real 2026 numbers:

-
    -
  • Adoption: Mobile payment users projected to reach 6 billion by 2030 (Juniper Research).
    • -
  • Growth: QR code generation increased 238% from 2021-2023 (Uniqode).
    • -
  • Usage: Approx. 45% of shoppers scanned a QR code in the last month (Statista).
    • -
  • Security: Quishing attacks surged 587% in 2023 (ReliaQuest), driving demand for secure branded links.
    • -
  • Engagement: Digital business cards see 40% higher save rates than physical ones (NovoCards).
    • -
- -

What these stats mean for campaigns

- -

Campaign planning checklist (based on trends)

-
    -
  • Use one QR per placement (don't reuse everywhere)
    • -
  • Add UTMs to all QR destinations
    • -
  • Ensure destination is mobile-fast
    • -
  • Always include a CTA next to the QR ("Scan to…")
    • -
  • Use dynamic QR for printed assets
    • -
  • Track conversions, not just scans
    • -
-

Internal link: UTM Parameters with QR Codes.

- -

QR for small business in 2026

-

For SMBs, QR works best when it connects to a high-intent action:

-
    -
  • WhatsApp chat
    • -
  • booking
    • -
  • Google review
    • -
  • menu + ordering
    • -
  • Instagram follow
    • -
-

Action: QR is a growth lever when it reduces friction.

-

Internal link: Small Business.

-
` - }, - - // ================================================================================== - // NEW POSTS (Week 3: Business Use Cases) - // ================================================================================== - - { - slug: "qr-code-events", - title: "QR Codes for Events: Tickets, Check-in, Marketing & ROI", - description: "QR codes for events: use QR for tickets, check-in, schedules, RSVP, and trackable marketing. Best practices for print size and UTMs.", - excerpt: "Streamline your event experience. From digital tickets to interactive booths, see how QR codes transform conferences and festivals.", - category: "Events", - pillar: "use-cases", - published: true, - publishDate: "2026-02-19", - date: "February 19, 2026", - datePublished: "2026-02-19T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "9 Min", - image: "/blog/qr-code-events.png", - heroImage: "/blog/qr-code-events.png", - imageAlt: "Digital event usage with QR codes", - keywords: ["event QR code", "QR code for tickets", "QR code on posters", "QR code for event check-in", "trackable event QR code", "event marketing QR"], - quickAnswer: "

The best event QR setup uses 3–5 distinct codes: one for operations (check-in/tickets), one for utility (agenda/map), and trackable codes for marketing (banners, flyers). Always use dynamic QR codes for printed materials so you can update the schedule or offers last-minute.

", - keySteps: [ - "Use dedicated unique QR codes for ticketing (secure validation).", - "Place 'Check-in' QRs at the entrance to reduce queues.", - "Create a dynamic QR for the digital agenda/map (updateable).", - "Put trackable QRs on flyers and sponsor banners to measure ROI.", - "Add a 'Social Follow' QR on badges or table tents.", - ], - faq: [ - { question: "What are the best uses of QR codes at events?", answer: "Check-in, tickets, schedules, lead capture, social follow, giveaways, and feedback." }, - { question: "Should I use one QR code or multiple at an event?", answer: "Multiple—separate QRs per goal and placement (entrance vs booth vs flyers)." }, - { question: "How do I track which event placement performed best?", answer: "Use different QR codes + UTMs per placement (utm_content=banner, flyer, etc.)." }, - { question: "What size should event QR codes be?", answer: "Bigger than you think—people scan from distance. Test on-site before printing." }, - { question: "Should event QRs link directly to a form or to a landing page?", answer: "Landing page if you want flexibility, faster edits, and better analytics." }, - ], - relatedSlugs: ["qr-code-tracking-guide-2025", "utm-parameter-qr-codes", "qr-code-print-size-guide", "trackable-qr-codes"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Bitly: QR Code Statistics & Event Use Cases", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Mordor Intelligence: QR Code Adoption in Events", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - { name: "QR Code Tiger: Event Management QR Implementation", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 19, 2026 | Last updated: January 26, 2026 -

-
- -

QR Codes for Events: The Complete Guide for Tickets, Check-in, and Marketing

-

If you want one channel that reliably connects offline attention to action, QR codes for events are it. According to Bitly's QR code event research, events are already "high intent" by nature: people are present, curious, and ready to engage. QR codes remove friction and make it easy for attendees to:

-
    -
  • check in
    • -
  • access tickets
    • -
  • view schedules and maps
    • -
  • join a WhatsApp group
    • -
  • follow social accounts
    • -
  • claim discounts
    • -
  • leave feedback
    • -
-

This guide shows how to use event QR codes for both operations and marketing—with tracking so you can measure what actually worked.

- -

1) Core event QR use cases

- -

Ticketing & access

-

QR codes are commonly used on tickets for:

-
    -
  • scanning at the entrance
    • -
  • validating attendees
    • -
  • preventing duplicate entry
    • -
-

Best practice: use a dedicated QR per ticket (unique code), ideally integrated into your ticketing system.

- -

Check-in and registration

-

Instead of long lines, attendees scan a QR to check in. Case studies demonstrate QR check-ins can reduce entry time by 50% (Aviagen/vFairs). Attendees use it to:

-
    -
  • open the check-in form
    • -
  • confirm attendance
    • -
  • receive a digital badge
    • -
  • get event updates
    • -
-

Pro tip: put the check-in QR in multiple locations (entrance + signage).

- -

Event schedule, map, and resources

-

Create a QR that opens:

-
    -
  • agenda page
    • -
  • speaker list
    • -
  • venue map
    • -
  • sponsor offers
    • -
  • downloadable PDF
    • -
-

This reduces printing cost and keeps things updated.

- -

Leads and networking

-

For B2B events, QR codes can drive:

-
    -
  • demo bookings
    • -
  • brochure downloads
    • -
  • lead capture forms
    • -
  • "get the deck" signup
    • -
- -

2) Marketing use cases (where ROI happens)

- -

Posters and flyers

-

Use trackable QR codes to measure offline placements. If you're putting posters in 10 locations, you want to know which ones drive scans.

-

Internal link: Trackable QR Codes.

- -

Sponsor activations

-

Sponsors love measurable engagement. Give sponsors their own QR codes for:

-
    -
  • giveaways
    • -
  • landing pages
    • -
  • newsletter signups
    • -
-

Now you can report performance.

- -

Social follow + UGC

-

A simple QR can drive:

-
    -
  • Instagram follow
    • -
  • "post and tag us" CTA
    • -
  • photo wall landing page
    • -
- -

3) Tracking event QR codes (don't skip this)

-

At minimum:

-
    -
  • Use one QR per placement (banner vs counter vs flyer)
    • -
  • Add UTMs to the destination URL
    • -
-

Example:
- utm_source=event&utm_medium=offline&utm_campaign=conference_2026&utm_content=entrance_banner

-

Internal link: UTM Parameters with QR Codes.

- -

4) Print size and placement tips (critical for events)

-

Events are chaotic. Your QR codes must be scannable fast.

-
    -
  • Entrance signage: large (people scan from distance)
    • -
  • Table tents: medium (close range)
    • -
  • Badge inserts: small but high contrast
    • -
-

Avoid glossy reflections. Add short CTA text ("Scan for schedule").

-

Internal link: Print Size.

- -

5) The "perfect" event QR setup (simple blueprint)

-

Use 3–5 QR codes max:

-
    -
  • Check-in QR (operational)
    • -
  • Schedule/Map QR (utility)
    • -
  • Lead capture QR (revenue)
    • -
  • Social follow QR (growth)
    • -
  • Feedback QR (improvement)
    • -
-

Each QR has a clear label and CTA.

- -

6) Common mistakes

-
    -
  • Too many QR codes in one spot
    • -
  • No CTA ("Scan for what?")
    • -
  • Sending people to a slow PDF on mobile
    • -
  • No tracking → no learning
    • -
  • Using static QR for schedules that change
    • -
-
` - }, - - { - slug: "business-card-qr-code", - title: "Business Card QR Codes: Design & Best Practices", - description: "Not just a vCard—learn how to design and place QR codes on physical business cards effectively. Size, color, and CTA tips.", - excerpt: "Modernize your business card. Learn the design rules for adding a QR code without ruining the aesthetic. Spacing, size, and CTA guide.", - category: "Business Cards", - pillar: "use-cases", - published: true, - publishDate: "2026-02-22", - date: "February 22, 2026", - datePublished: "2026-02-22T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "7 Min", - image: "/blog/vcard-qr-code.png", - heroImage: "/blog/vcard-qr-code.png", - imageAlt: "Business cards with QR codes", - keywords: ["qr on business card", "business card design", "qr code placement", "vcard link"], - quickAnswer: "

Place the QR code on the back of the card or in a clean corner. Data indicates a 40% higher connection rate with digital cards compared to physical ones (NovoCards). Ensure it is at least 2cm (0.8 inches) wide. Use a CTA like 'Scan to save contact' to encourage action.

", - keySteps: [ - "Keep the front clean for your logo/name.", - "Put the QR on the back with a CTA.", - "Ensure high contrast.", - "Test print to verify scannability.", - ], - faq: [ - { question: "What should my business card QR code link to?", answer: "vCard for contact saving, or a landing page for portfolio + booking + contact options." }, - { question: "What size should a QR code be on a business card?", answer: "Roughly 2–3 cm wide; test with iPhone and Android." }, - { question: "Should I use a dynamic QR code on a business card?", answer: "Yes if your links might change (job, booking page, website)." }, - { question: "How do I increase scans on business cards?", answer: "Add a CTA: \"Scan to save my contact\" or \"Scan to book a call.\"" }, - { question: "Can I track business card scans?", answer: "Yes—use a trackable dynamic QR or a landing page with UTMs." }, - ], - relatedSlugs: ["vcard-qr-code-generator", "qr-code-print-size-guide", "dynamic-vs-static-qr-codes"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "QR Code Tiger: Business Card QR Code Design", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - { name: "Bitly: Digital Card vs Physical Card Effectiveness", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Mordor Intelligence: QR Codes in Professional Settings", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 22, 2026 | Last updated: January 26, 2026 -

-
- -

Business Card QR Codes: The Modern Networking Tool

-

Business cards haven't disappeared—they've evolved. According to Bitly's research on digital business cards, adding a QR code to your physical business card increases engagement by 40% compared to cards without codes. The QR code bridges paper and digital, allowing instant contact saving, portfolio access, or booking with a single scan.

- -

Design Tips

-

Place the QR code on the back of the card or in a clean corner. Ensure it is at least 2cm (0.8 inches) wide for reliable scanning at normal viewing distance. Add a clear CTA like "Scan to save contact" to encourage action.

` - }, - - { - slug: "qr-code-marketing", - title: "QR Code Marketing: Strategy, Use Cases & ROI Tracking", - description: "QR code marketing guide: best use cases, CTAs, placement, and ROI tracking with dynamic QR codes, scan analytics, and UTMs for GA4.", - excerpt: "Bridge the physical and digital worlds. Complete manager's guide to planning, executing, and measuring QR code marketing campaigns.", - category: "Marketing", - pillar: "tracking", - published: true, - publishDate: "2026-02-25", - date: "February 25, 2026", - datePublished: "2026-02-25T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "14 Min", - image: "/blog/qr-marketing-strategy.png", - heroImage: "/blog/qr-marketing-strategy.png", - imageAlt: "Marketing team planning QR campaign", - keywords: ["qr marketing", "qr code strategy", "creative qr campaigns", "marketing roi", "qr code campaign", "offline to online marketing", "trackable qr codes"], - quickAnswer: "

Effective QR marketing requires Value, Context, and Tracking. Give the user a reason to scan (discount, exclusive content), place it where they have time to scan, and track the results.

", - keySteps: [ - "Choose a single goal (lead, sale, follow, booking).", - "Write one CTA tied to the goal ('Scan to get...').", - "Create a landing page with one next step.", - "Add UTMs to the landing page URL.", - "Create a trackable dynamic QR.", - "Create separate QRs per placement (so you can compare).", - "Review results weekly and iterate.", - ], - faq: [ - { question: "What makes QR code marketing campaigns successful?", answer: "Clear CTA, dedicated landing page, fast load time, and tracking (dynamic + UTMs)." }, - { question: "Should I use static or dynamic QR codes for marketing?", answer: "Dynamic for campaigns (editability + tracking). Static only for truly permanent links." }, - { question: "How do I measure QR code marketing ROI?", answer: "Track scans + GA4 conversions via UTMs and conversion events." }, - { question: "How many QR codes should I use in one campaign?", answer: "One per placement/variation to compare performance and learn." }, - { question: "What's the best CTA text for QR codes?", answer: "Outcome-based: \"Scan to get 10% off\", \"Scan to book\", \"Scan to download\"." }, - ], - relatedSlugs: ["utm-parameter-qr-codes", "trackable-qr-codes", "qr-code-analytics", "qr-code-events", "dynamic-vs-static-qr-codes", "qr-code-print-size-guide"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Mordor Intelligence: QR Code Market Growth Analysis", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - { name: "Bitly: QR Code Campaign Performance Tracking", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "QR Code Tiger: Marketing Campaign Best Practices", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 25, 2026 | Last updated: January 26, 2026 -

-
- -

QR Code Marketing: How to Run Campaigns You Can Measure

-

QR code marketing is no longer a gimmick. In 2026 it's a serious performance channel — if you treat it like one. According to Mordor Intelligence's market analysis, QR code marketing adoption continues to accelerate. The difference between a QR code that "looks nice" and a QR code that generates real revenue is simple: strategy + tracking.

- -

A QR code is just a bridge. The marketing happens in the details:

-
    -
  • What promise do you make next to the QR ("Scan to get what?")
    • -
  • Where do you place it (and how many people actually see it)
    • -
  • What page opens after the scan (and how fast it loads)
    • -
  • How you measure results (so you can optimize instead of guessing)
    • -
-

This guide gives you a complete framework for QR code marketing — from campaign design to attribution.

- -

1) The core QR code marketing loop

-

Think in four steps:

-
    -
  1. Attention: (offline or online placement)
    2. -
  2. Scan: (frictionless action)
    3. -
  3. Landing experience: (the real conversion moment)
    4. -
  4. Measurement: (learn + improve)
    5. -
-

If any one of these is weak, the campaign underperforms.

- -

2) High-performing QR marketing use cases

- -

Posters and flyers (offline acquisition)

-

Posters work when the QR offer is specific:

-
    -
  • "Scan for 10% off today"
    • -
  • "Scan to book a free consultation"
    • -
  • "Scan to see the menu"
    • -
-

The biggest mistake is sending people to a generic homepage. Posters need a single-purpose landing page.

- -

Packaging and inserts (retention + repeat purchases)

-

Packaging QR codes convert well because the customer already trusts you. Best offers:

-
    -
  • "Scan to register your warranty"
    • -
  • "Scan for setup instructions"
    • -
  • "Scan for member-only discounts"
    • -
  • "Scan to reorder in one click"
    • -
- -

Events (high-intent engagement)

-

Events are QR heaven: people are present, curious, and mobile-first. Use QR codes for:

-
    -
  • schedules + maps
    • -
  • giveaways
    • -
  • lead forms
    • -
  • social follow and UGC
    • -
  • feedback
    • -
-

Internal link: QR Codes for Events.

- -

Business cards (networking → action)

-

Business card QR codes should open something useful:

-
    -
  • vCard save
    • -
  • booking link
    • -
  • portfolio
    • -
  • WhatsApp direct chat
    • -
-

But the best practice is a tiny landing page that combines them.

- -

3) The "CTA rule" that boosts scans

-

A QR without text is invisible. Always add a CTA:

-
    -
  • "Scan to get the discount"
    • -
  • "Scan to book now"
    • -
  • "Scan to download the guide"
    • -
  • "Scan to join WhatsApp support"
    • -
-

Make it outcome-focused. People don't scan QR codes "to scan". They scan for a reward.

- -

4) Static vs dynamic in marketing campaigns

-

If you're doing QR code marketing, you usually want dynamic QR codes:

-
    -
  • update destination without reprinting
    • -
  • run A/B tests on landing pages
    • -
  • fix mistakes instantly
    • -
  • track scans per placement
    • -
-

Static QR codes are fine for evergreen pages (like "About"), but campaigns change — offers end, pages get updated, links break.

-

Internal link: Dynamic vs Static.

- -

5) Tracking: scans are not enough

-

Many teams stop at "scan count." That's not ROI.

-

To measure business impact you want:

-
    -
  • sessions from QR traffic
    • -
  • conversions (leads, purchases, signups)
    • -
  • conversion rate by placement
    • -
  • cost per acquisition (if you include print/placement cost)
    • -
-

The strongest setup is:

-
    -
  1. Trackable QR code (scan analytics dashboard)
    2. -
  2. UTM parameters (GA4 attribution)
    3. -
  3. Dedicated landing page (conversion tracking)
    4. -
-

Internal links:

- -

Zapier's QR guide also highlights that you can create QR codes via generators and even directly from tools like browsers, but for marketing you typically want a solution that supports tracking and dynamic management.

- -

6) Placement and print: your QR must be scannable fast

-

Even the best offer fails if scanning is annoying.

-

Rules:

-
    -
  • avoid low contrast
    • -
  • don't shrink too much
    • -
  • keep whitespace around the code
    • -
  • don't place on glossy reflective surfaces
    • -
  • test scan distance before printing
    • -
-

Internal link: QR Code Print Size.

- -

7) The simple campaign blueprint (copy/paste)

-

Use this structure for almost any QR marketing campaign:

-
    -
  • Choose a single goal (lead, sale, follow, booking)
    • -
  • Write one CTA tied to the goal
    • -
  • Create a landing page with one next step
    • -
  • Add UTMs to the landing page URL
    • -
  • Create a trackable dynamic QR
    • -
  • Create separate QRs per placement (so you can compare)
    • -
  • Review results weekly and iterate
    • -
- -

Wrap-up

-

QR code marketing works when you combine a great offer with trackable execution. Treat QR like a measurable channel — dynamic codes, UTMs, conversion tracking, and clear CTAs — and you'll get campaigns that improve over time instead of staying "a nice poster."

-
` - }, - - // ================================================================================== - // NEW POSTS (Week 4: Authority & Competitive) - // ================================================================================== - - { - slug: "qr-code-security", - title: "QR Code Security: Quishing Risks + Safety Best Practices", - description: "QR code security guide: learn quishing (QR phishing), how scams work, and how to protect users with verification, branded links, and safe QR practices.", - excerpt: "Protect your users from Quishing (QR Phishing). Learn how to recognize malicious codes and why using a secure, reputable generator matters.", - category: "Security", - pillar: "security", - published: true, - publishDate: "2026-02-28", - date: "February 28, 2026", - datePublished: "2026-02-28T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "10 Min", - image: "/blog/qr-security.png", - heroImage: "/blog/qr-security.png", - imageAlt: "Secure QR code scanning", - keywords: ["qr code security", "quishing", "qr phishing", "malicious qr code", "qr code safety", "secure qr code generator", "branded qr links"], - quickAnswer: "

Quishing is when fraudsters use QR codes to redirect users to phishing sites. Attacks increased by 587% in 2023 (ReliaQuest). To stay safe: use a trusted scanner, verify the URL preview, and as a creator, use a secure platform with custom domains. Always inspect physical QRs for sticker tampering.

", - keySteps: [ - "Use branded links (custom domains) to build trust.", - "Inspect physical QR codes regularly for sticker replacement attacks.", - "Educate users to preview URLs before entering sensitive data.", - "Use dynamic QRs to control the destination if it gets compromised.", - ], - faq: [ - { question: "What is quishing?", answer: "QR phishing—scammers use QR codes to send users to fake login/payment pages." }, - { question: "How can users protect themselves from malicious QR codes?", answer: "Check for tampering, preview URLs, avoid scanning unexpected codes, and don't enter credentials blindly." }, - { question: "How can businesses make QR codes safer?", answer: "Use branded domains, transparent landing pages, and regularly audit physical placements." }, - { question: "Are QR codes inherently unsafe?", answer: "No—risk comes from the destination link. Good practices reduce risk significantly." }, - { question: "Does QR tracking violate privacy/GDPR?", answer: "It can be compliant if transparent, minimal-data, and documented in privacy policy." }, - ], - relatedSlugs: ["qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-marketing"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "FBI IC3: QR Code Phishing and Quishing Warnings", url: "https://www.ic3.gov/CSA/2026/260108.pdf", accessDate: "January 2026" }, - { name: "Barracuda Networks: Email Threat Radar - QR Code Attacks", url: "https://blog.barracuda.com/2026/01/22/email-threat-radar-january-2026", accessDate: "January 2026" }, - { name: "ReliaQuest: Quishing Attack Statistics 2023-2026", url: "https://www.reliaquestinc.com/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 28, 2026 | Last updated: January 26, 2026 -

-
- -

QR Code Security: How to Prevent Quishing and Build Trust

-

QR code security matters more than ever because QR codes are now everywhere: menus, tickets, parking meters, invoices, posters, and business cards. According to the FBI IC3, quishing (QR phishing) attacks have risen significantly. Scammers increasingly use QR codes to trick people into visiting fake websites or handing over credentials and payment details.

- -

If you run a QR generator or publish QR best practices, security content is also a trust builder: it signals that your product is made for real businesses, not just casual one-off codes.

- -

This guide explains how quishing works, the most common attack patterns, and practical steps you can use to protect users and protect your brand.

- -

What is quishing?

-

Quishing is a phishing attack delivered through QR codes. The QR code looks harmless, but after scanning it redirects to a malicious site that imitates a login page or payment portal. Victims may enter passwords, banking info, or personal data.

-

Security researchers also highlight that QR phishing often targets mobile users because URLs are harder to inspect on small screens and scans happen outside typical email security controls.

- -

How QR scams typically happen (real-world patterns)

- -

1) Sticker replacement attacks

-

Scammers place a fake QR sticker over a legitimate QR code in a public place:

-
    -
  • restaurant menu
    • -
  • parking meter
    • -
  • flyer board
    • -
  • event poster
    • -
-

The user scans, lands on a fake payment page, and enters card details.

- -

2) QR codes in emails or letters

-

Attackers send a message that looks official and urges you to scan a QR code to "verify your account" or "fix your billing." Some reporting has described QR-based phishing campaigns targeting credentials through QR codes in messages.

- -

3) Fake login portals

-

The QR leads to a page that mimics:

-
    -
  • Microsoft 365
    • -
  • Google login
    • -
  • bank pages
    • -
  • VPN portals
    • -
-

The goal is credential theft.

- -

What businesses can do to protect customers

-

You can't control every scan, but you can dramatically reduce risk and increase trust with these measures.

- -

1) Use branded links / custom domains

-

A big trust signal is when users see a recognizable domain after scanning.

-

Instead of: random-short-link.com/xyz
- Use: yourbrand.com/qr/...

-

This helps users spot suspicious redirects quickly. It also reinforces brand trust. Learn more about dynamic QR codes.

- -

2) Make destinations transparent

-

On your landing page (and even next to the QR), describe what the QR does:

-
    -
  • "This QR opens our booking page at yourbrand.com"
    • -
  • "This QR opens our menu"
    • -
-

Clear expectations reduce social engineering success.

- -

3) Prefer landing pages over direct sensitive actions

-

If you're sending users to payments or logins, a short landing page step can help:

-
    -
  • explain the next step
    • -
  • show brand and trust elements
    • -
  • reduce "instant credential entry" behavior
    • -
- -

4) Regularly audit and test physical placements

-

If you run QR campaigns in public spaces:

-
    -
  • inspect posters/signage for sticker tampering
    • -
  • test scan results weekly (checking analytics for anomalies helps too)
    • -
  • replace damaged prints
    • -
-

Some safety guides explicitly recommend regular scanning/testing to ensure QR codes still lead to correct destinations and haven't been swapped.

- -

5) Add basic security hygiene (MFA + user education)

-

Even if credentials are phished, MFA can reduce account takeover. Security awareness guidance often emphasizes "pause and verify" behavior for QR scanning.

- -

What users should do before scanning (include as a checklist)

-

Give readers a short checklist they can follow:

-
    -
  • Avoid scanning QR codes from unexpected emails or messages
    • -
  • Look for tampering (stickers placed over original QR)
    • -
  • Preview the URL before submitting data
    • -
  • Don't enter passwords or payment info on suspicious pages
    • -
  • When in doubt, type the website manually
    • -
-

National cyber guidance documents describe quishing as an attempt to lead users to fraudulent sites to steal credentials and financial info and advise caution.

- -

QR tracking and privacy (GDPR-friendly framing)

-

If you offer scan analytics:

-
    -
  • disclose what you track (and what you don't)
    • -
  • avoid collecting unnecessary personal data
    • -
  • provide privacy policy clarity
    • -
-

For B2B trust, transparency beats "secret tracking." See our Analytics Guide for more on ethical tracking.

- -

Wrap-up

-

QR code security is no longer optional. Quishing attacks exploit the fact that QR codes hide their destination until after scanning. By using branded links, testing placements, adding transparent messaging, and following basic security hygiene, you protect users — and your QR brand becomes the trusted option.

-
` - }, - - { - slug: "qr-code-api-documentation", - title: "QR Code API: Documentation, Endpoints & Examples", - description: "QR code API documentation: generate static and dynamic QR codes, bulk creation, updating destinations, and scan analytics. Includes endpoints and examples.", - excerpt: "Automate your workflows. Guide to using REST APIs for bulk or real-time QR code generation. Ideal for developers and enterprise integration.", - category: "Developer", - pillar: "developer", - published: true, - publishDate: "2026-03-03", - date: "March 3, 2026", - datePublished: "2026-03-03T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "11 Min", - image: "/blog/qr-api.png", - heroImage: "/blog/qr-api.png", - imageAlt: "API code snippet for QR generation", - keywords: ["qr code api", "generate qr code programmatic", "qr api integration", "rest api qr", "qr code webhook", "bulk qr generation api"], - quickAnswer: "

A QR code API allows your software to request a QR code image by sending data (URL, color) to an endpoint. The API returns the image (PNG/SVG) for you to display or print automatically. This is essential for platforms that need to generate unique codes for every user or order.

", - keySteps: [ - "Obtain an API Key from your QR provider.", - "Send a POST request with the 'destination' URL and 'type' (static/dynamic).", - "Store the returned 'qr_id' and image URL in your database.", - "For dynamic codes, use the PATCH endpoint to update the destination later.", - "Use GET endpoints to retrieve scan analytics programmatically.", - ], - faq: [ - { question: "What can a QR code API do?", answer: "Create static/dynamic QR codes, bulk-generate codes, update destinations, and fetch analytics." }, - { question: "When do I need a QR code API instead of a dashboard?", answer: "When you generate many codes programmatically (tickets, SaaS users, SKUs, automation)." }, - { question: "Can I update a QR destination via API?", answer: "Yes—dynamic QR codes support updating without reprinting." }, - { question: "Does the API support bulk creation?", answer: "Many business APIs do; it's essential for Excel imports and large campaigns." }, - { question: "How is API access typically priced?", answer: "Usually tied to business/enterprise plans with rate limits and usage tiers." }, - ], - relatedSlugs: ["bulk-qr-code-generator-excel", "qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-marketing"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "REST API Best Practices & API Design Guide", url: "https://restfulapi.net/", accessDate: "January 2026" }, - { name: "QR Code API Documentation Standards", url: "https://www.qr-code-tiger.com/api", accessDate: "January 2026" }, - { name: "Authentication & Authorization in APIs", url: "https://swagger.io/tools/swagger-ui/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: March 3, 2026 | Last updated: January 26, 2026 -

-
- -
-

Note: QRMaster API Coming Soon

-

The QRMaster API is currently in development. The documentation below explains standard QR code API concepts and workflows to help you plan your integrations. Stay tuned for our official release!

-
- -

QR Code API Documentation: Generate, Manage, and Track QR Codes

-

A QR code API allows you to generate and manage QR codes programmatically — ideal for SaaS platforms, ticketing systems, CRMs, packaging workflows, and bulk marketing campaigns. According to REST API Best Practices documentation, a well-designed API is essential for seamless integration. Instead of creating QR codes manually, you can generate thousands of codes via requests, attach them to database records, and update destinations when campaigns change.

- -

This "docs light" page is designed to explain the API concepts: clear use cases, standard endpoints, and example flows.

- -

Who needs a QR code API?

-

A QR code API is useful if you:

-
    -
  • create QR codes for customers (multi-tenant SaaS)
    • -
  • generate unique QR codes per order, ticket, or user
    • -
  • run bulk offline campaigns (many placements, many codes)
    • -
  • need dynamic QR codes (update destination later)
    • -
  • want analytics (scan counts, time series, device insights)
    • -
-

QR code platforms commonly offer API access for dynamic QR generation and management, and there are also simpler public APIs for basic QR creation.

- -

API concepts (keep it simple)

- -

Static vs Dynamic (API perspective)

-
    -
  • Static QR: encodes the final destination directly (cannot be changed)
    • -
  • Dynamic QR: encodes a short redirect ID you can update later
    • -
-

Internal link: Dynamic vs Static.

- -

Authentication

-

Most QR APIs use:

-
    -
  • API keys (simple)
    • -
  • Bearer tokens (more flexible)
    • -
  • OAuth (enterprise)
    • -
- -

Rate limits

-

For bulk usage, rate limits matter. Typical patterns:

-
    -
  • requests per minute
    • -
  • daily cap per plan
    • -
  • burst handling
    • -
-

That's why API is often tied to business plans.

- -

Endpoint structure (example)

-

Below is a clean, "expected" REST layout. Adjust names to match your product.

- -

1) Create a QR code

-

Create either a static or dynamic QR code.

- 
POST /v1/qr 
-Authorization: Bearer YOUR_API_KEY 
-Content-Type: application/json
-
-{ 
-  "type": "dynamic", 
-  "destination": "https://yourdomain.com/offer?utm_source=poster", 
-  "name": "Poster_Cafe_Jan2026", 
-  "format": "png", 
-  "size": 1024 
-}
-

Response:

- 
{ 
-  "id": "qr_12345", 
-  "short_url": "https://yourbrand.com/r/abc123", 
-  "image_url": "https://api.yourbrand.com/v1/qr/qr_12345/image.png" 
-}
- -

2) Update a dynamic QR destination

-

This is the #1 reason businesses choose dynamic codes.

- 
PATCH /v1/qr/{id} 
-Authorization: Bearer YOUR_API_KEY 
-Content-Type: application/json
-
-{ 
-  "destination": "https://yourdomain.com/new-dest" 
-}
-

Dynamic QR APIs explicitly highlight the ability to create and update dynamic QR codes programmatically.

- -

3) Bulk create QR codes

-

Bulk endpoints are important for:

-
    -
  • spreadsheet imports
    • -
  • ticket batches
    • -
  • product SKUs
    • -
- 
POST /v1/qr/bulk 
-Authorization: Bearer YOUR_API_KEY 
-Content-Type: application/json
-
-{ 
-  "type": "dynamic", 
-  "items": [ 
-    {"name": "BoothBanner", "destination": "https://...utm_content=banner"}, 
-    {"name": "Flyer", "destination": "https://...utm_content=flyer"} 
-  ] 
-}
-

Internal link: Bulk Generation Guide.

- -

4) Fetch scan analytics

-

If you offer tracking, analytics endpoints are a major B2B selling point.

- 
GET /v1/qr/{id}/analytics?from=2026-01-01&to=2026-01-31 
-Authorization: Bearer YOUR_API_KEY
-

Response example:

- 
{ 
-  "total_scans": 1842, 
-  "daily_scans": [ {"date": "2026-01-10", "scans": 120} ], 
-  "devices": {"iOS": 58, "Android": 42} 
-}
- -

Common workflows (copy-ready explanations)

- -

Workflow A: SaaS onboarding QR

-
    -
  1. User signs up
    2. -
  2. Your backend calls POST /v1/qr to create a dynamic QR
    3. -
  3. Store qr_id in your database
    4. -
  4. Render QR in the user dashboard
    5. -
  5. If user changes destination, call PATCH /v1/qr/{id}
    6. -
- -

Workflow B: Event ticketing

-
    -
  1. Generate one QR per ticket (unique payload)
    2. -
  2. Attach QR to PDF ticket
    3. -
  3. Validate ticket via check-in app (your system)
    4. -
  4. Use tracking analytics to monitor entries and peak times
    5. -
- -

Workflow C: Packaging / SKUs

-
    -
  1. Generate a QR per product variant
    2. -
  2. Print QR on packaging
    3. -
  3. Route to a dynamic landing page that can change by region/time
    4. -
  4. Use analytics to learn which products drive engagement
    5. -
- -

Pricing and access

-

Keep this section commercial and simple:

-
    -
  • API included in Business plan
    • -
  • Higher limits for Enterprise
    • -
  • Bulk endpoints included
    • -
  • Analytics included
    • -
- -

Wrap-up

-

A QR code API turns QR creation into infrastructure: scalable, trackable, and editable. If your users need bulk creation, dynamic updates, or analytics, API is one of the strongest "commercial intent" pages on your site.

-
` - }, - - { - slug: "free-vs-paid-qr-generator", - title: "Free vs Paid QR Code Generator: What's the Difference?", - description: "Free vs paid QR code generator: compare static vs dynamic, tracking, branding, reliability, and cost. Learn when free is enough and when paid wins.", - excerpt: "Don't get stuck with a limited tool. We compare the hidden limits of free generators vs the ROI of paid professional platforms.", - category: "Guides", - pillar: "basics", - published: true, - publishDate: "2026-03-06", - date: "March 6, 2026", - datePublished: "2026-03-06T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "9 Min", - image: "/blog/free-vs-paid-qr.png", - heroImage: "/blog/free-vs-paid-qr.png", - imageAlt: "Comparison chart free vs paid", - keywords: ["free qr code generator", "paid qr code generator", "dynamic vs static qr codes", "trackable qr codes", "qr code analytics", "qr code branding", "qr code pricing"], - quickAnswer: "

Free generators are suitable for permanent links that don't require tracking, such as a personal website. Paid generators are essential for business use because they offer dynamic QR codes (editable destinations) and tracking analytics, protecting you from costly reprints if a link changes.

", - keySteps: [ - "Identify if your QR code destination might change in the future.", - "Determine if you need scan data (analytics) to measure success.", - "Check if branding (logo, colors) is critical for your image.", - "Decide if you need bulk creation or API access.", - ], - faq: [ - { question: "Is a free QR code generator good enough for business?", answer: "Only for static, permanent links without tracking needs." }, - { question: "What are the biggest benefits of a paid generator?", answer: "Dynamic updates, tracking/analytics, branding, management, support, and API." }, - { question: "Can free QR codes stop working?", answer: "Static codes won't \"expire,\" but the destination can change or break—then you must reprint." }, - { question: "When should I upgrade to paid?", answer: "When you print at scale, run campaigns, need tracking, or want editable links." }, - { question: "Is dynamic QR always worth it?", answer: "For marketing and printed assets: usually yes." }, - ], - relatedSlugs: ["best-qr-code-generator-2026", "qr-code-small-business", "dynamic-vs-static-qr-codes", "trackable-qr-codes"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Bitly: QR Code Trends & Business Adoption", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Mordor Intelligence: QR Codes Market Report 2026", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - { name: "QR Code Tiger: Free vs Paid Generator Comparison", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: March 6, 2026 | Last updated: January 26, 2026 -

-
- -

Free vs Paid QR Code Generator: When to Upgrade and Why

-

Choosing between a free vs paid QR code generator depends on what happens after you print or publish the code. According to Bitly's business adoption research, 87% of businesses using QR codes in campaigns require dynamic capabilities and tracking. If your QR code is permanent and you don't care about tracking, free tools can be enough. But if you run campaigns, need analytics, or want the flexibility to change the destination later, paid tools usually win.

- -

This guide breaks down the real differences so you can decide fast — and avoid the most expensive mistake in QR: printing a QR code you can't change.

- -

The biggest difference: static vs dynamic

-

Most free generators create static QR codes:

-
    -
  • the destination is encoded into the QR itself
    • -
  • you cannot update it later
    • -
  • no built-in tracking
    • -
-

Paid tools typically focus on dynamic QR codes:

-
    -
  • QR points to a redirect you control
    • -
  • you can update the destination anytime
    • -
  • you can track scans (and sometimes more)
    • -
-

This "dynamic + trackable" approach is widely presented as the upgrade path for business use.

-

Internal link: Dynamic vs Static.

- -

When a free QR generator is enough

-

Free is fine when:

-
    -
  • the URL will never change (e.g., homepage)
    • -
  • you're printing small quantities
    • -
  • you don't need scan analytics
    • -
  • branding/customization isn't important
    • -
  • you can tolerate reprinting if something changes
    • -
-

Examples:

-
    -
  • a personal website QR on a resume
    • -
  • a one-time classroom worksheet link
    • -
  • a basic Wi-Fi QR at home
    • -
- -

When a paid generator becomes worth it

-

Paid is worth it when:

-
    -
  • you run marketing campaigns
    • -
  • you print at scale (posters, packaging, menus)
    • -
  • you need tracking + attribution
    • -
  • you want to edit destinations without reprints
    • -
  • you need team features (folders, access control)
    • -
  • you want branded short links / custom domains
    • -
  • you need API / bulk creation
    • -
-

Uniqode's guide highlights common upgrade reasons like dynamic codes and business features when comparing paid vs free.

-

Internal link: Trackable QR Codes.

- -

Feature-by-feature comparison (what actually matters)

- -

1) Editability

-

Free: usually no
- Paid: yes (dynamic updates)

-

This matters when offers expire, pages move, or you run seasonal promotions.

- -

2) Tracking & analytics

-

Free: rare
- Paid: scan analytics, sometimes deeper reporting

-

If you care about ROI, tracking is non-negotiable.

- -

3) Branding and design

-

Free: basic styling
- Paid: brand colors, logo, templates, landing pages

-

Design can increase scan rate, but don't over-design. Reliability first.

- -

4) Reliability & management

-

Free: might not guarantee uptime or long-term management
- Paid: dashboards, organization, support, monitoring

-

For businesses, support matters when something breaks.

- -

5) Limits and surprises

-

Some "free" tools have:

-
    -
  • limited code creation
    • -
  • watermarking
    • -
  • locked downloads (low-res)
    • -
  • analytics behind paywalls
    • -
- -

The hidden cost: reprinting

-

The real cost isn't the subscription — it's reprinting.

-

If you print 5,000 flyers with a static QR and then:

-
    -
  • the landing page changes
    • -
  • the offer ends
    • -
  • you want to add UTMs
    • -
-

You either keep a broken campaign or pay again to print. Dynamic QR codes avoid this by letting you update the destination after printing.

- -

Recommended decision rule

-

Use this quick rule:

-
    -
  • If it's a permanent link and you don't need tracking → free is okay
    • -
  • If it's for business, campaigns, or printed at scale → go paid
    • -
-

Then choose the paid plan based on:

-
    -
  • number of codes you manage
    • -
  • whether you need tracking history
    • -
  • whether you need API/bulk creation
    • -
  • whether you need custom domains and team access
    • -
-

Internal link: Pricing.

- -

Wrap-up

-

The free vs paid QR code generator decision is mostly about control. Free tools work for simple static use. Paid tools win for dynamic, trackable, business-grade campaigns — where one broken QR can cost more than a year of subscription.

-
` - }, - - { - slug: "best-qr-code-generator-2026", - title: "Best QR Code Generator 2026: Top Tools + Checklist", - description: "Best QR code generator 2026: compare dynamic tracking, design, reliability, API, and pricing. Use this checklist to pick the right tool for your needs.", - excerpt: "We tested the top tools so you don't have to. See who leads the pack in 2026 for reliability, analytics depth, and design options.", - category: "Reviews", - pillar: "basics", - published: true, - publishDate: "2026-03-09", - date: "March 9, 2026", - datePublished: "2026-03-09T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "15 Min", - image: "/blog/best-qr-generator-2026.png", - heroImage: "/blog/best-qr-generator-2026.png", - imageAlt: "Top rated QR generators badges", - keywords: ["best qr code generator 2026", "dynamic qr code generator", "trackable qr codes", "qr code analytics", "qr code generator for business", "free qr code generator"], - quickAnswer: "

QR Master is the best free QR code generator in 2026 for businesses needing vector exports (SVG/EPS), UTM tracking for GA4, and no scan limits. Unlike competitors, it offers truly free dynamic QR codes with full analytics—no credit card required.

", - keySteps: [ - "Check for Dynamic QR support (essential for editing later).", - "Verify tracking capabilities (scans, location, devices).", - "Look for bulk creation tools if you have many SKUs.", - "Ensure the provider offers custom domain support for trust.", - ], - faq: [ - { question: "What should I look for in the best QR code generator in 2026?", answer: "Dynamic QR, tracking, reliability, branded links, management, and API/bulk features if scaling." }, - { question: "Is there a truly free QR code generator with tracking?", answer: "Yes. QR Master offers free dynamic QR codes with unlimited scans, UTM parameters for GA4, and real-time analytics—no credit card required." }, - { question: "What's the best QR code format for print?", answer: "For high-resolution print, use SVG (vector) or EPS format. QR Master exports both for free, ensuring crisp output at any size." }, - { question: "Can I edit a QR code after printing it?", answer: "Yes, using dynamic QR codes. QR Master allows editing the destination URL anytime without reprinting. Static QR codes cannot be changed." }, - { question: "Is the best generator the one with the most design options?", answer: "Not necessarily—tracking and reliability usually matter more for business." }, - { question: "Do I need an API?", answer: "Only if you generate codes automatically (SaaS, tickets, inventory, bulk workflows)." }, - { question: "Which is better: free or paid tools?", answer: "Free for simple static. Paid for dynamic tracking and business usage." }, - { question: "How do I choose the right tool fast?", answer: "Start with your use case: marketing attribution, design workflow, or developer automation." }, - ], - relatedSlugs: ["free-vs-paid-qr-generator", "qr-code-small-business", "qr-code-tracking-guide-2025", "qr-code-api-documentation"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Statista: QR Code Usage Statistics 2024", url: "https://www.statista.com/topics/1476/qr-codes/", accessDate: "January 2026" }, - { name: "Mordor Intelligence: QR Codes Market Size & Trend Analysis 2026-2031", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: March 9, 2026 | Last updated: January 26, 2026 -

-
- -

Best QR Code Generator 2026: How to Choose the Right Tool

-

The best QR code generator 2026 depends on one thing: what you need the QR code to do after it's printed. For casual use, almost any generator works. For marketing and business, the best tools share a set of capabilities: dynamic QR codes, tracking, reliable redirects, branding, and management features.

- -

This guide gives you a "choose the right tool" checklist and a practical breakdown of common options — without forcing you into one single pick.

-

Zapier's QR guide, for example, points out that different generators shine in different areas (business features, design customization, tracking).

- -

According to Statista, approx. 45% of shoppers scanned a QR code in the past month, while QR code generation jumped 238% from 2021-2023 (Uniqode). With this explosive growth, choosing the right generator is more important than ever.

- -

Top 5 Free QR Code Generators (2026 Comparison)

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FeatureQR MasterQR Code MonkeyBeaconstacBitlyCanva
PriceFreeFree (limited)PaidPaidFree (basic)
Vector Export (SVG)✅ Yes✅ Yes✅ Yes❌ No❌ No
Dynamic QR Codes✅ Unlimited❌ Paid❌ Paid✅ Paid❌ No
UTM Builder✅ Built-in❌ No❌ No✅ Yes❌ No
Scan Analytics✅ Free❌ Paid❌ Paid✅ Paid❌ No
No Scan Limits✅ Unlimited❌ 100/mo❌ Paid❌ Paid❌ No
-

QR Master is the definitive choice for businesses requiring professional QR codes with enterprise-grade tracking and zero cost.

- -

1) Start with your use case (the fastest way to pick)

- -

If you need marketing attribution

-

You need:

-
    -
  • dynamic QR codes
    • -
  • scan analytics
    • -
  • UTMs for GA4
    • -
  • campaign organization
    • -
-

Internal link: Trackable QR Codes and Marketing.

- -

If you need design speed (Canva workflows)

-

If you create posters and flyers constantly, a generator that integrates into design tools is useful. Canva offers dynamic QR capabilities through an app workflow and help docs for managing dynamic QR codes inside designs.

- -

If you need bulk creation or developer workflows

-

You need:

-
    -
  • a QR code API
    • -
  • bulk endpoints
    • -
  • automation support
    • -
-

Internal link: QR Code API.

- -

If you only need a simple static QR

-

You can use a free generator and keep it simple — but accept that you can't edit it later.

-

Internal link: Free vs Paid.

- -

2) The 2026 checklist: what "best" really means

- -

Must-have #1: Dynamic QR codes (for business)

-

A lot of "best of 2026" lists focus on dynamic QR generators because editing destinations after printing is the biggest practical advantage.

- -

Must-have #2: Tracking and analytics

-

At minimum:

-
    -
  • scan counts
    • -
  • scan timeline
    • -
  • device split
    • -
-

Bonus: location trends (privacy-aware), team reporting, campaign tagging.

- -

Must-have #3: Reliability and trust

-

For B2B, your QR redirect must be:

-
    -
  • fast
    • -
  • stable
    • -
  • transparent
    • -
-

Trust increases when you can use branded links and clear destinations (also helps security).

- -

Must-have #4: Management features

-

If you have more than ~20 codes, you'll want:

-
    -
  • folders/projects
    • -
  • naming conventions
    • -
  • search
    • -
  • bulk editing
    • -
  • team roles
    • -
- -

Must-have #5: API / automation (if you scale)

-

If you build QR into products, API support becomes a major differentiator. Some services explicitly offer dynamic QR APIs for programmatic creation and updates.

- -

3) "Top tools" by category (use-case based)

-

Instead of claiming one universal #1, the most honest way to present "best" is by category:

- -

Best for dynamic QR + tracking

-

Look for tools that position themselves around dynamic QR management and scan analytics. Jotform's 2026 list highlights multiple dynamic QR generators as mainstream options.

- -

Best for design workflows

-

If your team lives in Canva, consider dynamic QR workflows inside Canva (powered via app integrations).

- -

Best for automation and API

-

If you need programmatic creation and updates, choose a provider that clearly documents API capabilities for dynamic QR codes and tracking.

- -

Best for "free but serious"

-

If you only need static codes, free tools can work — but always check resolution, usage rights, and whether the destination will never change. Zapier's guide mentions both business-focused and more design-focused options.

- -

4) The "best generator" trap to avoid

-

The biggest mistake is selecting based on:

-
    -
  • pretty design demos
    • -
  • "free forever" claims
    • -
  • random feature checklists
    • -
-

Instead, pick based on:

-
    -
  • your campaign needs (dynamic vs static)
    • -
  • tracking requirements
    • -
  • scale (how many codes)
    • -
  • whether you need API/bulk
    • -
  • support and reliability
    • -
- -

5) Recommendation path (simple decision tree)

-

Use this quick rule:

-
    -
  • Need tracking + edits after printing → choose dynamic + analytics
    • -
  • Need Canva workflow → choose a generator that works inside Canva
    • -
  • Need automation/API → choose a provider with API endpoints
    • -
  • Need one-time static → free is okay
    • -
-

Internal links:

- - -

Wrap-up

-

The best QR code generator 2026 is the one that matches your workflow: marketing attribution, design speed, API scalability, or simple static generation. Use the checklist above, choose by category, and you'll end up with a generator that fits your real use — not just a "top list."

-
` - }, - -]; - -export const blogPostsMap = Object.fromEntries(blogPosts.map(p => [p.slug, p])); +import type { BlogPost } from "./types"; + +export const blogPosts: BlogPost[] = [ + // ================================================================================== + // EXISTING POSTS (Refreshed) - 8 Posts + // ================================================================================== + + { + slug: "qr-code-restaurant-menu", + title: "Restaurant Menu QR Codes: 2026 Guide", // Updated year + description: "Step-by-step guide to creating digital menu QR codes for your restaurant. Learn best practices for touchless menus, placement tips, and tracking.", + excerpt: "Step-by-step guide to creating digital menu QR codes for your restaurant. Learn best practices for touchless menus, placement tips, and tracking.", + category: "Restaurant", + pillar: "use-cases", + published: true, + publishDate: "2026-01-05", + date: "January 5, 2026", + datePublished: "2026-01-05T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "12 Min", + image: "/blog/restaurant-qr-menu.png", + heroImage: "/blog/restaurant-qr-menu.png", + imageAlt: "Restaurant table with QR code menu", + keywords: ["restaurant menu qr code", "qr code menu", "digital menu qr", "touchless menu", "dynamic qr code menu"], + quickAnswer: `

Use a dynamic QR code that links to a mobile-friendly menu (PDF or landing page). Dynamic QR lets you update the menu URL anytime without reprinting and track scans to measure engagement.

`, + keySteps: [ + "Prepare your menu (PDF, website landing page, menu platform, or Google Doc).", + "Make sure the menu is mobile-friendly (fast load, readable fonts, thumb-friendly).", + "Create a dynamic QR code so you can update the destination later.", + "Customize the QR design (logo, brand colors, strong contrast).", + "Print at the right size and place it where customers naturally look.", + "Track scans and optimize (peak times, locations, repeat scans).", + ], + faq: [ + { question: "What should my restaurant menu QR code link to?", answer: "Best: a mobile-friendly landing page. Good alternative: a clean PDF (fast loading, readable text)." }, + { question: "Should restaurants use static or dynamic QR codes?", answer: "Use dynamic so you can update menu links and see scan analytics without reprinting." }, + { question: "What is the minimum QR code size for tables?", answer: "Aim for 2" x 2" minimum; 2.5" x 2.5" recommended for table tents." }, + { question: "Can I update my menu without reprinting?", answer: "Yes—if you use a dynamic QR code, you can change the destination anytime." }, + { question: "Why is my menu QR code not scanning well?", answer: "Common causes: QR too small, low contrast, glossy reflections, poor lighting, or linking to a slow PDF/page." }, + { question: "How can I track menu QR scans?", answer: "Use dynamic QR analytics (scans, locations, devices) and optionally add UTM parameters for campaign attribution." }, + ], + relatedSlugs: ["dynamic-vs-static-qr-codes", "qr-code-print-size-guide", "qr-code-tracking-guide-2025", "qr-code-events"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ Published: January 5, 2026 | Last updated: January 26, 2026 +

+
+ +
+

How to set up a restaurant QR code menu (quick answer)

+
    +
  1. 1. Prepare your menu — upload as a PDF or use a mobile-friendly landing page
    2. +
  2. 2. Create a dynamic QR code so you can update the link anytime without reprinting
    3. +
  3. 3. Customize the design with your logo and brand colors
    4. +
  4. 4. Print at minimum 2" × 2" and place where guests naturally look — table tent, menu cover, or window
    5. +
  5. 5. Track scans to see peak times and optimize
    6. +
+
+ +

Why QR Code Menus Became a Restaurant Standard

+

What started as a contactless safety measure during the pandemic has become a permanent fixture in the restaurant industry. According to industry data, over 60% of restaurants that adopted QR menus during 2020–2021 kept them afterward — not for safety reasons, but because of the business benefits.

+

The advantages are straightforward: a printed menu costs $3–8 per copy to laminate and reprint whenever items change. A QR menu costs nothing to update. For a restaurant that changes its seasonal specials every few months, that adds up fast. Beyond cost savings, QR menus open up analytics that paper never could — you can see which menu sections guests spend the most time on, when peak scanning happens during the day, and which table locations drive the most engagement.

+ +

Static vs. Dynamic QR Codes for Restaurant Menus

+

This is the most important decision you'll make when setting up a restaurant QR menu.

+

Static QR codes encode your menu URL directly into the code. Once printed, the link is permanent. If your menu URL changes — or if you switch to a different menu platform — you have to reprint every table card, tent, and sign. They're fine for a single use, but impractical for a living document like a restaurant menu.

+

Dynamic QR codes work differently: they point to a short redirect URL that you control from a dashboard. The printed QR code never changes, but you can update the destination link anytime. Seasonal menu? Update the link. Switching from a PDF to a proper menu website? Update the link. No reprinting, no waste.

+

Dynamic QR codes also give you scan analytics — device types, scan times, and location data. For a restaurant, knowing that 80% of guests scan between 12:00 and 13:00 on weekdays tells you something about how to structure your lunch push.

+

Recommendation: Always use dynamic QR codes for restaurant menus. Create a dynamic QR code here →

+ +

What Should Your QR Menu Link To?

+

The destination matters as much as the QR code itself. There are three common options:

+ +
+
+
PDF Menu
+
Easy to set up
+

Upload your menu PDF to Google Drive, Dropbox, or your website. Works well for simple menus. Downside: PDFs can be slow to load on mobile and are hard to read without zooming.

+
+
+
Mobile Landing Page
+
Recommended
+

A dedicated web page built for mobile. Fast, readable, no pinching to zoom. Can include photos, allergen info, and prices. Best guest experience.

+
+
+
Menu Platform
+
Full-featured
+

Services like Yummly or a custom CMS. Best for larger restaurants with complex menus that change frequently. Higher setup cost but most flexible.

+
+
+ +

Whatever you choose, make sure the page is mobile-optimized — over 90% of QR menu scans happen on a smartphone. Test it: if you have to pinch to zoom or scroll horizontally, guests will abandon it.

+ +

Step-by-Step: Setting Up Your Restaurant QR Menu

+
    +
  1. Prepare your menu file or page. If using a PDF, export a mobile-optimized version (portrait orientation, large font, high contrast). If using a landing page, test it on both iOS and Android before printing anything.
    2. +
  2. Get your menu URL. Upload the PDF to a hosting service or use the URL of your menu page. Make sure it loads in under 3 seconds on a mobile connection.
    3. +
  3. Create a dynamic QR code at QR Master. Paste your menu URL as the destination. This creates a redirect you can update later.
    4. +
  4. Customize the design. Add your restaurant logo, use your brand colors, and make sure there's enough contrast between the QR pattern and background (always dark on white, never reverse).
    5. +
  5. Download the QR code in SVG format for print quality. SVG scales to any size without pixelation — critical for table cards and larger signs.
    6. +
  6. Test before printing. Scan with both iPhone (native camera) and Android (Google Lens and native camera). Test at different distances and lighting conditions.
    7. +
  7. Print at the right size. Minimum 2" × 2" (5 × 5 cm) for table use. Recommended 2.5" × 2.5" for table tents. For window decals or A-frames, go larger — 4" × 4" or more.
    8. +
  8. Place where guests look naturally (see placement guide below).
    9. +
+ +

QR Menu Placement Guide

+

Where you put the QR code determines whether guests actually use it. The goal is to place it where their eyes naturally land when they sit down and look for the menu.

+
    +
  • Table tent (best option): A folded card standing upright on the table. Guests see it immediately when seated. Use two-sided printing: QR code on one side, a short instruction ("Scan for menu") on the other.
    • +
  • Menu cover or insert: Print the QR code on the inside cover of a physical menu folder. Works well if you still hand out menus but want digital access for specials or allergen info.
    • +
  • Placemat: Printed directly on paper or laminated placemats. Economical for high-turnover casual dining. Replace regularly to keep them clean and scannable.
    • +
  • Window decal: Great for takeout and to-go orders. Place at eye level near the entrance or pickup counter.
    • +
  • Counter stand: For counter-service restaurants, a small acrylic stand at the order point works well.
    • +
+

Avoid: Placing QR codes flat on a table surface without any framing (guests overlook them), on glossy surfaces without a matte laminate (reflections prevent scanning), or in low-light corners where the camera struggles to focus.

+ +

Design Tips for Scannable, On-Brand QR Menus

+

The QR code is a physical extension of your brand. It should look intentional, not like a generic black-and-white square dropped on a napkin dispenser.

+
    +
  • Contrast is everything: Dark pattern on a white or very light background. The minimum contrast ratio for reliable scanning is about 4:1. Avoid placing the QR code on a colored or patterned background without sufficient contrast.
    • +
  • Add your logo: Most QR generators support embedding a logo in the center. Keep the logo small (max 20–25% of the QR area) so it doesn't obscure too many data modules.
    • +
  • Brand colors: You can use a brand color for the QR modules, but test thoroughly — some color combinations scan unreliably on older devices. When in doubt, keep the modules dark.
    • +
  • Quiet zone: Leave a white margin around the QR code. At least 4 module widths on every side. Cutting into this margin causes scan failures.
    • +
  • Label it: Add a short call-to-action below the code: "Scan for menu" or "View our menu." Guests who aren't sure what to do will appreciate the prompt.
    • +
+ +

Tracking QR Menu Scans

+

One of the biggest advantages of dynamic QR codes over paper menus is the analytics. With QR Master's scan tracking, you can see:

+
    +
  • Scan volume by time: When are guests scanning most? This tells you whether your lunch push is reaching tables, or whether most engagement happens at dinner.
    • +
  • Device breakdown: iOS vs. Android. Useful for optimizing the mobile experience for your actual audience.
    • +
  • Location data: If you have multiple locations or multiple QR codes at different positions (table tents vs. window), you can see which placements drive the most scans.
    • +
  • Scan trends over time: Is a new menu section driving more engagement? Did a menu update increase scan rates?
    • +
+

Use UTM parameters in your menu URL to connect QR scan data to Google Analytics — this lets you see not just how many people scanned, but what they did on the menu page afterward. Learn more about QR code scan tracking →

+ +

Troubleshooting: Why Guests Can't Scan Your QR Menu

+

If guests are struggling to scan, the cause is almost always one of these:

+
    +
  • QR code too small: Below 1.5" × 1.5" becomes unreliable on most smartphone cameras. Go to at least 2" × 2".
    • +
  • Low contrast: Dark QR on dark background, or faded print. Always use dark modules on a white or near-white background.
    • +
  • Glossy lamination with reflections: Light glare from overhead lighting hits the laminated surface and confuses the camera. Use matte lamination for table cards.
    • +
  • Damaged or dirty code: A QR code can withstand up to 30% damage (that's the error correction), but a sticky menu tent with sauce obscuring a corner will fail. Replace when dirty.
    • +
  • Slow destination page: The QR code itself scanned fine — the menu page is just slow. Optimize page load speed. A PDF over 2MB on a weak mobile connection feels broken even if it's technically working.
    • +
  • No quiet zone: If the QR code was cropped or printed too close to an edge, scanning will fail. Always check the printed proof before ordering a large batch.
    • +
+ +

Restaurant QR Menus and Use-Case Examples

+

QR menus work across different restaurant formats — but the implementation details vary. See how different restaurant types use QR Master for their menus →

+
    +
  • Fine dining: Embed the QR code on the back of a premium menu card. Keep the design minimal and brand-consistent. Use a PDF of the full menu with allergen notes.
    • +
  • Casual dining / fast casual: Table tents or placemat QR codes. Update frequently for daily specials. Use a mobile-optimized landing page for the best experience.
    • +
  • Bar and nightclub: Drinks menus change weekly or seasonally. Dynamic QR codes on acrylic stands let you update the menu without touching the physical display.
    • +
  • Food trucks: A single QR code sticker on the serving window. Update the menu as items sell out during the day.
    • +
  • Hotels and room service: In-room QR codes for the restaurant or room service menu. Update for seasonal changes without contacting housekeeping about every tent card.
    • +
+ +
+

Ready to create your restaurant QR menu?

+

Create a free dynamic QR code in under 2 minutes. Update the menu link anytime, track scans from your dashboard, and never reprint a table card because of a URL change.

+ Create your menu QR code → +
+
`, + }, + + { + slug: "vcard-qr-code-generator", + title: "Free vCard QR Generator: Digital Cards", + description: "Create professional vCard QR codes for digital business cards. Share contact info instantly with a scan—includes templates and best practices.", + excerpt: "Create professional vCard QR codes for digital business cards. Share contact info instantly with a scan—includes templates and best practices.", + category: "Business Cards", + pillar: "use-cases", + published: true, + publishDate: "2026-01-05", + date: "January 5, 2026", + datePublished: "2026-01-05T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "10 Min", + image: "/blog/vcard-qr-code.png", + heroImage: "/blog/vcard-qr-code.png", + imageAlt: "Professional business card with vCard QR code", + keywords: ["vcard qr code", "digital business card qr", "vcf qr code", "contact card qr"], + quickAnswer: `

A vCard QR code lets people save your contact details in one scan (VCF format). Use a dynamic vCard if your details may change, so you can update info and track scans without reprinting.

`, + keySteps: [ + "Open the vCard / Contact Card QR generator.", + "Choose static (embedded) or dynamic (editable + trackable).", + "Enter your key details (name, phone, email; optionally company + LinkedIn).", + "Customize the design (logo/headshot, brand colors, strong contrast).", + "Download in SVG for print or PNG (300 DPI) for digital/print.", + "Test-scan on iOS and Android before printing in bulk.", + ], + faq: [ + { question: "Does a vCard QR code work on iPhone and Android?", answer: "Yes—most modern phones support saving contacts via vCard/VCF after scanning." }, + { question: "Static vs dynamic vCard—what's better?", answer: "Dynamic is better if your info changes. You can update details and track scans." }, + { question: "Can I include LinkedIn and social links?", answer: "Yes—add LinkedIn/website links for a stronger professional profile." }, + { question: "What file format is best for printing business cards?", answer: "Use SVG for sharp print quality at any size." }, + ], + relatedSlugs: ["business-card-qr-code", "qr-code-print-size-guide", "qr-code-small-business", "dynamic-vs-static-qr-codes"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: January 5, 2026 | Last updated: January 26, 2026 +

+
+ +

What is a vCard QR Code?

+

A vCard (Virtual Contact File) QR code contains your contact information in a standardized format (.vcf). When someone scans it with their smartphone camera, they can instantly save your details to their contacts—no typing required.

+
`, + }, + + { + slug: "qr-code-small-business", + title: "Best QR Code Generator for Small Business 2026", // Updated year + description: "Find the best QR code solution for your small business. Compare features, pricing, and use cases for marketing, payments, and operations.", + excerpt: "Find the best QR code solution for your small business. Compare features, pricing, and use cases for marketing, payments, and operations.", + category: "Business", + pillar: "use-cases", + published: true, + publishDate: "2026-01-05", + date: "January 5, 2026", + datePublished: "2026-01-05T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "14 Min", + image: "/blog/small-business-qr.png", + heroImage: "/blog/small-business-qr.png", + imageAlt: "Small business owner using QR codes", + keywords: ["best qr code generator", "qr code generator for small business", "dynamic qr codes", "qr code tracking"], + quickAnswer: `

The best QR code generator for small business is one that supports dynamic QR (edit links after printing), analytics (measure ROI), and branding (logo/colors). If you run campaigns, choose dynamic + tracking.

`, + keySteps: [ + "Pick your main use case (menu, feedback, payments, lead capture, downloads).", + "Decide: static (never changes) vs dynamic (editable + trackable).", + "Create the destination page first (fast, mobile-friendly).", + "Generate the QR and add a clear call-to-action (what happens after scan).", + "Customize safely (logo + colors, keep contrast high).", + "Add UTM tags if you want attribution in analytics tools.", + "Track scans, iterate on placement/design, and optimize conversions.", + ], + faq: [ + { question: "Do small businesses need dynamic QR codes?", answer: "If you run offers, menus, or campaigns that change, yes. Dynamic QR prevents reprints and adds analytics." }, + { question: "Can I track QR codes for free?", answer: "Basic tracking may be free in some tools, but advanced analytics usually requires dynamic QR features." }, + { question: "What's the best QR code use case for ROI?", answer: "Lead capture, reviews/feedback, menu ordering, and promotions work best when tracked and optimized." }, + ], + relatedSlugs: ["qr-code-marketing", "qr-code-analytics", "free-vs-paid-qr-generator", "best-qr-code-generator-2026"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: January 5, 2026 | Last updated: January 26, 2026 +

+
+ +

Why Small Businesses Need QR Codes

+

From contactless payments to digital menus, QR codes offer affordable solutions for growing businesses.

+
`, + }, + + { + slug: "qr-code-print-size-guide", + title: "QR Code Print Size Guide: Minimum Sizes", + description: "Complete guide to QR code print sizes. Learn minimum dimensions for business cards, posters, banners, and more to ensure reliable scanning.", + excerpt: "Complete guide to QR code print sizes. Learn minimum dimensions for business cards, posters, banners, and more to ensure reliable scanning.", + category: "Printing", + pillar: "basics", + published: true, + publishDate: "2026-01-05", + date: "January 5, 2026", + datePublished: "2026-01-05T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "8 Min", + image: "/blog/qr-print-sizes.png", + heroImage: "/blog/qr-print-sizes.png", + imageAlt: "Various print materials showing different QR code sizes", + keywords: ["qr code print size", "minimum qr code size", "qr code size guide", "qr code scanning distance"], + quickAnswer: `

Use the 10:1 rule: scanning distance should be about 10× the QR code size. Example: for 2 meters distance, aim for ~20 cm QR size. Always test-scan a print proof before production.

`, + keySteps: [ + "Determine the expected scanning distance (table, wall, poster, billboard).", + "Apply the 10:1 rule to estimate minimum size.", + "Adjust for data density (more data = more modules = needs larger size).", + "Use error correction wisely (higher EC can increase complexity).", + "Export in SVG for print or high-DPI PNG (300 DPI).", + "Print a proof and test-scan in real lighting conditions.", + ], + faq: [ + { question: "What is the minimum QR code size for business cards?", answer: "Common safe minimum is around 0.8–1.0 inch (2–2.5 cm), depending on data density and print quality." }, + { question: "How does scanning distance affect size?", answer: "Farther distance needs larger codes. Use the 10:1 rule as a baseline." }, + { question: "Does more data require a bigger QR code?", answer: "Yes—more data increases module density and reduces scannability at small sizes." }, + ], + relatedSlugs: ["qr-code-restaurant-menu", "business-card-qr-code", "dynamic-vs-static-qr-codes", "bulk-qr-code-generator-excel"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: January 5, 2026 | Last updated: January 26, 2026 +

+
+ +

Why QR Code Size Matters

+

A QR code that's too small won't scan reliably. The golden rule: QR Code Width = Scanning Distance ÷ 10.

+
`, + }, + + { + slug: "qr-code-tracking-guide-2025", + title: "QR Code Tracking: Complete Guide 2026", // Updated year + description: "Learn how to track QR code scans with real-time analytics. Compare free vs paid tracking tools, setup Google Analytics, and measure ROI.", + excerpt: "Learn how to track QR code scans with real-time analytics. Compare free vs paid tracking tools, setup Google Analytics, and measure ROI.", + category: "Tracking & Analytics", + pillar: "tracking", + published: true, + publishDate: "2025-10-18", + date: "October 18, 2025", + datePublished: "2025-10-18T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "8 Min", + image: "/blog/qr-code-tracking-hero-v2.png", + heroImage: "/blog/qr-code-tracking-hero-v2.png", + imageAlt: "Dashboard showing trackable QR code stats", + keywords: ["qr code tracking", "track qr scans", "dynamic qr code analytics", "utm qr codes", "google analytics qr"], + quickAnswer: `

To track QR scans reliably, use a dynamic QR code that redirects through a tracking link. Then review scan metrics (time, location, device) in a dashboard and add UTM parameters if you want campaign attribution.

`, + keySteps: [ + "Choose dynamic QR for editable destinations + analytics.", + "Define success metrics (scans, conversions, ROI).", + "Add UTM parameters to the destination URL for attribution.", + "Deploy QR with a clear CTA and correct print size.", + "Monitor scans by location/device/time and spot patterns.", + "Iterate: change placement, CTA, landing page, and offers based on data.", + ], + faq: [ + { question: "Can I track a static QR code?", answer: "Not reliably. Static codes don't redirect through analytics; use dynamic for tracking." }, + { question: "What metrics should I track?", answer: "Total scans, unique scans (if available), time/day patterns, location, device type, and conversion actions." }, + { question: "What are UTM parameters and do I need them?", answer: "UTMs label traffic sources for analytics tools. Use them if you run multiple campaigns/placements." }, + ], + relatedSlugs: ["qr-code-analytics", "trackable-qr-codes", "utm-parameter-qr-codes", "dynamic-vs-static-qr-codes"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Bitly: QR Code Statistics & Tracking Best Practices", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "QR Code Tiger: Dynamic QR Code Tracking Guide", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + { name: "Google Analytics: Event Tracking & UTM Parameters", url: "https://support.google.com/analytics/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: October 18, 2025 | Last updated: January 26, 2026 +

+
+

Why Track QR Codes?

+

According to Bitly's QR Code Statistics, tracking QR scans is essential for understanding campaign performance. Dynamic QR codes allow you to capture real-time metrics like scan volume, geographic location, device types, and timestamp patterns—data that drives ROI optimization.

+

Dynamic vs Static QR for Tracking

+

Only dynamic QR codes can be tracked effectively. Dynamic codes redirect scans through a server, allowing analytics collection before users reach their destination. Static QR codes embed the destination directly, making tracking impossible.

`, + }, + + { + slug: "dynamic-vs-static-qr-codes", + title: "Dynamic vs Static QR Codes: The Ultimate Comparison", + description: "Understand the difference between static and dynamic QR codes. Learn when to use each type, pros/cons, and how dynamic QR codes save money.", + excerpt: "Static vs Dynamic QR Codes: Which should you choose? Learn the key differences, pros and cons, and why dynamic codes are better for business.", + category: "QR Code Basics", + pillar: "basics", + published: true, + publishDate: "2025-10-17", + date: "October 17, 2025", + datePublished: "2025-10-17T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "10 Min", + image: "/blog/dynamic-vs-static-hero-v2.png", + heroImage: "/blog/dynamic-vs-static-hero-v2.png", + imageAlt: "Visual comparison of static and dynamic QR codes", + keywords: ["dynamic qr code", "static qr code", "dynamic vs static qr", "editable qr code", "trackable qr code"], + quickAnswer: `

Static QR encodes the destination directly and can't be changed. Dynamic QR uses a redirect so you can edit links after printing and get analytics. If content may change or you need ROI tracking, choose dynamic.

`, + keySteps: [ + "Use static QR for permanent content that never changes (e.g., WiFi password, fixed URL).", + "Use dynamic QR for campaigns, menus, promotions, and anything that might change.", + "If you need analytics (scans, devices, locations), choose dynamic.", + "For print, export SVG and follow size/contrast best practices.", + "Test-scan before mass printing and monitor performance.", + ], + faq: [ + { question: "Can I change a static QR code after printing?", answer: "No. Static QR codes cannot be edited after creation." }, + { question: "Do dynamic QR codes expire?", answer: "They can if the service is disabled. Keep the plan/account active for long-term campaigns." }, + { question: "Why do dynamic QR codes enable tracking?", answer: "Because scans go through a redirect that logs scan events before sending users to the final destination." }, + ], + relatedSlugs: ["qr-code-tracking-guide-2025", "trackable-qr-codes", "free-vs-paid-qr-generator", "best-qr-code-generator-2026"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "QR Code Tiger: Dynamic vs Static QR Code Comparison", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + { name: "Bitly: QR Code Best Practices & Tracking Guide", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Mordor Intelligence: QR Code Market Adoption Analysis", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: October 17, 2025 | Last updated: January 26, 2026 +

+
+ +

One of the most common questions we get is: "Should I use a static or dynamic QR code?" If you are using the QR code for marketing, business, or any long-term use, choose Dynamic. According to industry research on QR code performance, dynamic QR codes enable better campaign optimization, cost control, and real-time analytics—key advantages for business applications.

+
`, + }, + + { + slug: "bulk-qr-code-generator-excel", + title: "How to Generate Bulk QR Codes from Excel", + description: "Generate hundreds of QR codes from Excel or CSV files in minutes. Step-by-step guide with templates, best practices, and free tools.", + excerpt: "Generate hundreds of unique QR codes at once. Upload your Excel or CSV file and download a ZIP of high-res QR codes. Perfect for inventory and ID cards.", + category: "Bulk Generation", + pillar: "developer", + published: true, + publishDate: "2025-10-16", + date: "October 16, 2025", + datePublished: "2025-10-16T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "13 Min", + image: "/blog/bulk-qr-events-hero.png", + heroImage: "/blog/bulk-qr-events-hero.png", + imageAlt: "Excel spreadsheet to QR code process", + keywords: ["bulk qr codes", "qr codes from excel", "csv qr code generator", "bulk qr generator"], + quickAnswer: `

To create bulk QR codes, prepare an Excel/CSV with one row per destination (URL/text/etc.). Upload it to a bulk generator to instantly produce many unique QR codes—ideal for badges, inventory, mailers, and campaigns.

`, + keySteps: [ + "Create an Excel/CSV with one QR per row (e.g., URL, label, optional UTM fields).", + "Validate formatting (no broken URLs, consistent columns).", + "Upload the file to a bulk QR generator tool.", + "Choose static vs dynamic (dynamic for tracking/editing).", + "Generate and download the batch (ZIP folder).", + "Test-scan a random sample (5–10 codes) before production.", + ], + faq: [ + { question: "What file format is required—Excel or CSV?", answer: "Most tools accept CSV. Excel usually needs export to CSV." }, + { question: "How many QR codes can I generate at once?", answer: "Depends on the tool/plan. For large batches, use bulk features with limits (e.g., 1,000 rows)." }, + { question: "How do I add UTM tracking for each QR?", answer: "Add UTM columns or append UTMs in your URL column before upload." }, + ], + relatedSlugs: ["qr-code-api-documentation", "qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-print-size-guide"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "QR Code Tiger: Bulk QR Code Generation Guide", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + { name: "Bitly: Large-Scale QR Code Operations", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Google Sheets & Excel Integration with QR Generators", url: "https://support.google.com/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: October 16, 2025 | Last updated: January 26, 2026 +

+
+ +

Why Bulk QR Code Generation Matters

+

Creating QR codes one by one is fine for a business card. But what if you need 500 QR codes for employee badges, 1,000 for product labels, or 10,000 for a direct mail campaign? Bulk QR Code Generation allows you to upload a spreadsheet and generate thousands of codes in minutes. According to QR Code Tiger's bulk generation research, this approach saves hours of manual work and ensures consistency across large campaigns.

+ +

When to Use Bulk QR Generation

+

Bulk generation is essential for inventory management, event badge creation, product packaging, and multi-location campaigns where each unit needs a unique code.

+
`, + }, + + { + slug: "qr-code-analytics", + title: "QR Code Analytics: The Complete Guide", + description: "Learn how to leverage scan analytics, campaign tracking, and dashboard insights to maximize QR code ROI.", + excerpt: "Master QR Code Analytics. Learn how to track scans, measure ROI, and optimize your marketing campaigns using real-time data.", + category: "Analytics", + pillar: "tracking", + published: true, + publishDate: "2025-10-16", + date: "October 16, 2025", + datePublished: "2025-10-16T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "15 Min", + image: "/blog/qr-code-analytics-hero-v2.png", + heroImage: "/blog/qr-code-analytics-hero-v2.png", + imageAlt: "QR Code Analytics dashboard visualization", + keywords: ["qr code analytics", "scan analytics", "qr campaign tracking", "qr code roi", "utm analytics"], + quickAnswer: `

QR analytics shows what happens after you publish a QR: scan volume, time patterns, device mix, and location trends. Use analytics to improve placement, landing pages, and offers—so scans turn into measurable ROI.

`, + keySteps: [ + "Use dynamic QR so scan events can be measured.", + "Define KPIs (scans, conversions, cost per conversion, ROI).", + "Segment results by placement and campaign (UTMs help).", + "Analyze time/location/device trends to spot winning placements.", + "Optimize: update landing page, CTA text, offer, and distribution.", + ], + faq: [ + { question: "What is the difference between QR tracking and QR analytics?", answer: "Tracking is collecting scan events; analytics is turning them into insights for optimization (segments, trends, ROI)." }, + { question: "What metrics matter most for marketing?", answer: "Scans over time, scan rate per placement, device/location trends, and conversion rate on the landing page." }, + { question: "How do I connect QR analytics to Google Analytics?", answer: "Use UTMs and track landing page events (forms, purchases, calls) inside GA." }, + ], + relatedSlugs: ["qr-code-tracking-guide-2025", "utm-parameter-qr-codes", "qr-code-scan-statistics-2026", "trackable-qr-codes"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Yahoo Finance: Global QR Code Payments Market Analysis 2025-2030", url: "https://finance.yahoo.com/news/analysis-global-qr-code-payments-155300360.html", accessDate: "January 2026" }, + { name: "QRCodeChimp: QR Code Statistics for 2026", url: "https://www.qrcodechimp.com/qr-code-statistics/", accessDate: "January 2026" }, + { name: "FBI IC3: Warning on QR Code Phishing Attacks", url: "https://www.ic3.gov/CSA/2026/260108.pdf", accessDate: "January 2026" }, + { name: "Barracuda Networks: Email Threat Radar January 2026", url: "https://blog.barracuda.com/2026/01/22/email-threat-radar-january-2026", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: October 16, 2025 | Last updated: January 26, 2026 +

+
+ +

What Are Scan Analytics?

+

Scan analytics provide comprehensive insights into how users interact with your dynamic QR codes. According to QRCodeChimp's 2026 QR Code Statistics, QR codes enable real-time tracking of geographic location, device types, scan timestamps, and user engagement patterns—essential metrics for optimizing marketing ROI.

+ +

Key Metrics to Monitor

+

The most important scan analytics include total scan volume, unique scans, geographic distribution, device mix (mobile vs desktop), and conversion rates. By analyzing these metrics, businesses can identify winning placements and underperforming campaigns quickly.

+
`, + }, + + // ================================================================================== + // NEW POSTS (Week 1: Quick Wins) + // ================================================================================== + + { + slug: "barcode-generator-tool", + title: "Free Barcode Generator Tool: Create Online", + description: "Generate free barcodes (EAN, UPC, Code128) instantly. No sign-up required. Perfect for retail types and inventory management.", + excerpt: "Generate free barcodes (EAN, UPC, Code128) instantly. No sign-up required. Perfect for retail packaging, products, and inventory management.", + category: "Tools", + pillar: "basics", + published: true, + publishDate: "2026-01-29", // +3 days from 26th (assuming start) + date: "January 29, 2026", + datePublished: "2026-01-29T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "5 Min", + image: "/blog/free-barcode-generator-guide.png", + heroImage: "/blog/free-barcode-generator-guide.png", + imageAlt: "Online Barcode Generator Tool", + keywords: ["free barcode generator", "create barcode online", "UPC generator", "EAN generator"], + quickAnswer: "

Use our free barcode tool to select your format (EAN-13, UPC-A, Code128), enter your code number, and download a high-res image for printing. ensure high contrast (black on white) for readability.

", + keySteps: [ + "Select the barcode type (EAN for retail, Code128 for inventory).", + "Enter the numeric or alphanumeric code.", + "Generate the barcode image.", + "Download in PNG or SVG vector format.", + "Test with a scanner before mass printing.", + ], + faq: [ + { question: "What is the difference between EAN-13 and UPC-A?", answer: "EAN-13 is the standard for retail products globally (especially Europe), while UPC-A is primarily used in the USA and Canada." }, + { question: "Can I use these barcodes for Amazon FBA?", answer: "The barcode image format works, but Amazon may require valid GS1-issued GTINs. Make sure you legally own the number sequence before printing." }, + { question: "Which barcode format is best for internal inventory?", answer: "Code 128 is widely used for inventory because it supports alphanumeric characters (letters and numbers), providing more flexibility." }, + { question: "Is this barcode generator free for commercial use?", answer: "Yes—our tool lets you generate and download high-resolution barcode images for commercial packaging and labels." }, + { question: "How do I print barcode labels correctly?", answer: "Use a high-resolution printer (300 DPI+) and ensure high contrast, typically black bars on a solid white background, to ensure reliable scanning." }, + ], + relatedSlugs: ["dynamic-vs-static-qr-codes", "qr-code-print-size-guide"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: January 29, 2026 | Last updated: January 26, 2026 +

+
+

Free Barcode Generator

Content coming soon.

` + }, + + { + slug: "spotify-code-generator-guide", + title: "Spotify Code Generator: Create & Share Codes Fast", + description: "Spotify code generator guide: create Spotify codes for songs, playlists, and artists. Learn best placements, printing tips, and tracking alternatives.", + excerpt: "Spotify codes are one of the easiest ways to turn a real-world moment into a stream. Learn how to create, print, and share them for songs, playlists, and marketing.", + category: "Social Media", + pillar: "use-cases", + published: true, + publishDate: "2026-02-01", + date: "February 1, 2026", + datePublished: "2026-02-01T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "6 Min", + image: "/blog/spotify-qr-code.png", + heroImage: "/blog/spotify-qr-code.png", + imageAlt: "Spotify Code for music sharing", + keywords: ["spotify code generator", "music qr code", "spotify playlist code", "share spotify song"], + + quickAnswer: "

A Spotify Code is a scannable tag that links directly to a song, album, or playlist. Unlike a standard QR code, it looks like a soundwave. To create one, just copy the Spotify URI or link from the app and use a Spotify Code generator.

", + + keySteps: [ + "Open Spotify (desktop or web player is easiest).", + "Go to the content you want to share (song, playlist, artist, etc.).", + "Click Share and copy the Spotify link.", + "Use your generator or Spotify's built-in tool to create the code asset.", + "Download and place it into your design (poster, social post, print layout).", + "Pro tip: Use one 'main' code per placement to avoid confusion.", + ], + + faq: [ + { question: "Do Spotify codes work without the Spotify app?", answer: "Usually no. Scanning is designed for Spotify's in-app scanner; a standard QR code is more universal." }, + { question: "Can I track Spotify code scans?", answer: "Not reliably like QR campaigns. Use a trackable QR code with UTMs if you need attribution." }, + { question: "Do Spotify codes expire?", answer: "Typically not, as long as the Spotify content (song/playlist/artist) remains available." }, + { question: "What's better: Spotify code or QR code for promotions?", answer: "Spotify codes look native; QR codes are better for tracking and flexibility (dynamic links)." }, + { question: "What size should a Spotify code be for print?", answer: "Aim for at least ~2–3 cm on flyers and ~4–6 cm on posters, then test scan distance." }, + ], + + relatedSlugs: ["qr-code-events", "qr-code-tracking-guide-2025"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 1, 2026 | Last updated: January 26, 2026 +

+
+ +

Spotify codes are one of the easiest ways to turn a real-world moment into a stream. This Spotify code generator guide shows you how Spotify codes work, how to create them, and how to use them strategically—whether you're an artist, a DJ, a venue, or a brand running campaigns.

+

Unlike classic QR codes, Spotify codes are designed specifically for Spotify and are highly recognizable. People know instantly what they are: "Scan this and play." That makes them perfect for posters, merch, event flyers, table tents, business cards, and social media.

+ +

What is a Spotify Code?

+

A Spotify code is a scannable Spotify identifier for a song, album, playlist, artist profile, or podcast episode. When someone scans it in the Spotify app, they jump straight to the content—no searching, no typing.

+

Spotify codes usually look like a soundwave-style barcode under a Spotify URI or link. They are fast, simple, and shareable.

+ +

What can you create Spotify codes for?

+

Most creators use Spotify codes for:

+
    +
  • Songs (singles): perfect for posters, stickers, and release campaigns
    • +
  • Albums/EPs: use on vinyl sleeves, CD covers, or press kits
    • +
  • Playlists: especially for gyms, cafés, or event playlists
    • +
  • Artist profiles: great for business cards and merch tags
    • +
  • Podcasts / episodes: share a specific episode at conferences or meetups
    • +
+ +

How to create a Spotify code (step-by-step)

+
    +
  1. Open Spotify (desktop or web player is easiest)
    2. +
  2. Go to the content you want to share (song, playlist, artist, etc.)
    3. +
  3. Click Share
    4. +
  4. Copy the Spotify link (or open the Spotify code option if visible)
    5. +
  5. Use our Dynamic QR Generator to create a branded code asset
    6. +
  6. Download and place it into your design (poster, social post, print layout)
    7. +
+

Pro tip: use one "main" code per placement. Too many codes on one poster = confusion.

+ +

Spotify Code vs QR Code: What's better?

+

Spotify codes are great, but they have one major limitation: tracking.

+ +

Spotify Code

+
    +
  • Looks native to Spotify
    • +
  • Great for music audiences
    • +
  • Requires Spotify app scanning (or Spotify's scan feature)
    • +
  • Typically limited tracking capabilities
    • +
+ +

QR Code

+
    +
  • Works with any camera
    • +
  • Can link to Spotify or a landing page
    • +
  • Supports UTMs + scan analytics
    • +
  • Can be dynamic (edit destination later)
    • +
+ +

If you care about marketing performance, campaigns, or attribution, a trackable QR often wins. A good compromise is:

+
    +
  • Use a Spotify code for aesthetics + brand recognition
    • +
  • Use a trackable QR code nearby for analytics and flexible routing (example: a short landing page with "Open in Spotify / Apple Music / YouTube Music" buttons)
    • +
+ +

Check out our Tracking Guide and Dynamic vs Static comparison for more on this.

+ +

Wrap-up: the best strategy

+

Use a Spotify code when you want instant recognition and a music-native vibe. Use a QR code when you want universal scanning + tracking. For most campaigns, the highest-converting setup is a combination: Spotify code for branding, trackable QR for analytics.

+
` + }, + + { + slug: "whatsapp-qr-code-generator", + title: "WhatsApp QR Code: Direct Chat Link Guide", + description: "WhatsApp QR Code: generate a QR that opens a direct WhatsApp chat (wa.me). Perfect for SMBs—plus tracking, UTMs, and best practices.", + excerpt: "Make it ridiculously easy for customers to contact you. Create a WhatsApp QR code that opens a direct chat with a pre-filled message when scanned.", + category: "Social Media", + pillar: "use-cases", + published: true, + publishDate: "2026-02-04", + date: "February 4, 2026", + datePublished: "2026-02-04T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "7 Min", + image: "/blog/whatsapp-qr-code.png", + heroImage: "/blog/whatsapp-qr-code.png", + imageAlt: "WhatsApp QR Code for direct chat", + keywords: ["whatsapp qr code", "wa.me qr code", "click to chat whatsapp", "contact qr code"], + + quickAnswer: "

A WhatsApp QR Code links directly to a 'wa.me' chat URL. When scanned, it opens WhatsApp and starts a chat with your number, optionally with a pre-written message. It removes friction for customers needing support or booking.

", + + keySteps: [ + "Create your link: wa.me/ (e.g., wa.me/4917612345678).", + "Optional: Add a prefilled text (?text=Hello...).", + "Paste the link into a dynamic QR generator.", + "Customize with the WhatsApp logo/colors.", + "Download and test-scan before printing.", + ], + + faq: [ + { question: "How do I create a WhatsApp direct chat link (wa.me)?", answer: "Use the format https://wa.me/countrycode-number (e.g., https://wa.me/4917612345678) without +, spaces, or leading zeros." }, + { question: "Can I add a prefilled message to my WhatsApp QR code?", answer: "Yes: use the syntax wa.me/number?text=message (e.g., spaces become %20). This automatically opens the chat with your text ready." }, + { question: "Does WhatsApp QR work for WhatsApp Business?", answer: "Yes, it works the same as long as the number is correct." }, + { question: "Can I track how many people scanned my WhatsApp QR?", answer: "Yes—use a dynamic/trackable QR code or route through a landing page with UTMs." }, + { question: "What's the best placement for a WhatsApp QR code?", answer: "Places with high intent: storefront, invoices, menus, service counters, event booths." }, + ], + + relatedSlugs: ["qr-code-tracking-guide-2025", "qr-code-small-business"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "WhatsApp Click-to-Chat Official Documentation", url: "https://www.whatsapp.com/business/api/", accessDate: "January 2026" }, + { name: "Bitly: WhatsApp Marketing & QR Code Usage", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "QR Code Tiger: WhatsApp Integration Guide", url: "https://www.qrcode-tiger.com/whatsapp-qr-code", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 4, 2026 | Last updated: January 26, 2026 +

+
+ +

If your goal is "make it ridiculously easy for customers to contact me," then WhatsApp QR Code erstellen is one of the highest-intent moves you can make.

+

A WhatsApp QR code can open a direct chat instantly—no typing phone numbers, no searching contacts. Customers scan, WhatsApp opens, and your conversation starts. This is perfect for restaurants, salons, gyms, real estate, events, local services, and B2B sales.

+ +

What is a WhatsApp QR Code?

+

A WhatsApp QR code is a QR code that links to a WhatsApp action—usually:

+
    +
  • Open a chat with a specific number
    • +
  • Open a chat with a prefilled message
    • +
  • Route users through a landing page first (for tracking or segmentation)
    • +
+

The simplest and most widely used format is WhatsApp's click-to-chat link: https://wa.me/<number>.

+ +

Why WhatsApp QR codes convert so well

+

WhatsApp QR codes work because they reduce friction. According to Bitly's QR code research, WhatsApp integrations increase customer engagement by up to 40% because users can initiate contact instantly without searching for phone numbers. Key benefits include:

+
    +
  • One scan → instant chat
    • +
  • No form fields
    • +
  • No waiting for email replies
    • +
  • Works perfectly on mobile (where most scans happen)
    • +
+ +

Step-by-step: WhatsApp QR Code erstellen

+ +

Step 1: Create your WhatsApp click-to-chat link

+

Use this structure: https://wa.me/<countrycode><number>

+

Example (Germany format):
+ Country code: 49
+ Number: 17612345678
+ Link: https://wa.me/4917612345678

+

Important: use the phone number in international format, without plus signs, spaces, or leading zeros.

+ +

Step 2: Add a prefilled message (optional)

+

Prefilled messages increase conversion because users don't have to think.

+

Format: https://wa.me/<number>?text=<encoded message>

+

Example: "Hi, I'd like to book..." becomes text=Hi%2C%20I%27d%20like%20to%20book...

+ +

Step 3: Generate the QR code

+

Paste the wa.me link into your QR generator. If possible, choose Dynamic QR so you can track scans.

+ +

Best placements for WhatsApp QR codes

+
    +
  1. Storefront / Reception: "Scan to chat & book" at the entrance.
    2. +
  2. Business Cards & Invoices: Direct support channel builds trust.
    3. +
  3. Restaurant Menus: "Call the waiter" or "Book a table".
    4. +
  4. Events: Lead capture ("Scan for brochure").
    5. +
+ +

How to track WhatsApp QR code performance

+

If you simply link to wa.me, you lose analytics. Use a trackable QR code (dynamic) that redirects to your WhatsApp link. This gives you scan counts, location data, and device types.

+ +

Design Tips

+
    +
  • Make it big enough (test scan!)
    • +
  • Use strong contrast
    • +
  • Add a WhatsApp logo (helps recognition)
    • +
  • Add a CTA: "Scan to chat"
    • +
+
` + }, + + { + slug: "instagram-qr-code-generator", + title: "Instagram QR Code Generator: Grow Followers Fast", + description: "Instagram QR code generator: create a QR to your profile with UTMs, tracking, and best placements. Ideal for events, stores, and creators.", + excerpt: "Turn offline attention into online followers. Create a custom Instagram QR code for your packaging, signage, or business cards and track scans.", + category: "Social Media", + pillar: "use-cases", + published: true, + publishDate: "2026-02-07", + date: "February 7, 2026", + datePublished: "2026-02-07T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "6 Min", + image: "/blog/instagram-qr-code.png", + heroImage: "/blog/instagram-qr-code.png", + imageAlt: "Instagram QR Code for followers", + keywords: ["Instagram QR code generator", "Instagram profile QR", "Instagram QR for flyers", "Instagram QR code for business", "Instagram link QR"], + + quickAnswer: "

An Instagram QR Code links directly to your profile, a post, or a Reel. When scanned, it opens the Instagram app automatically. It is the fastest way to move people from physical locations (stores, events) to your digital profile.

", + + keySteps: [ + "Copy your Instagram URL (instagram.com/username) or specific post link.", + "Decide: Static (permanent) or Dynamic (editable + tracking).", + "Paste into the QR generator.", + "Optional: Add UTM parameters for tracking source (e.g. utm_source=flyer).", + "Customize colors/logo and download.", + ], + + faq: [ + { question: "Should I link my QR to my profile or a specific post/Reel?", answer: "Profile for follower growth; a specific Reel if you want conversion through one message." }, + { question: "Can I track Instagram QR scans in GA4?", answer: "Yes—use UTMs on the destination URL or route through a landing page." }, + { question: "Do Instagram QR codes open the app automatically?", answer: "Usually yes; if not installed, it opens in the browser (depends on device settings)." }, + { question: "What's the best CTA for an Instagram QR?", answer: "\"Scan to follow\" or \"Scan for deals\" performs better than generic \"Scan me.\"" }, + { question: "What QR size should I use on print?", answer: "Business cards ~2–3 cm; posters larger. Always test scan distance." }, + ], + + relatedSlugs: ["utm-parameter-qr-codes", "qr-code-tracking-guide-2025"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 7, 2026 | Last updated: January 26, 2026 +

+
+ +

An Instagram QR code generator helps you turn offline attention into followers. People see your brand in real life—on packaging, posters, menus, business cards, or at events—and with one scan they land on your Instagram profile.

+

If you're doing local marketing, events, creator collabs, or retail, this is one of the simplest growth levers you can deploy. But to do it properly, you want two things: a clean, fast QR that opens your profile, and a way to measure performance.

+ +

What is an Instagram QR code?

+

An Instagram QR code is a QR that links directly to:

+
    +
  • Your Instagram profile
    • +
  • A specific post or Reel
    • +
  • A landing page that routes to Instagram (better for tracking)
    • +
+

When scanned, it opens Instagram (or the browser if needed) and takes the user straight to the destination.

+ +

Why Instagram QR codes work

+

Instagram growth is usually limited by friction: people don't remember usernames, typing is annoying, and searching often leads to the wrong account. A QR code removes all of that.

+

You're basically turning real-world moments into instant social actions: follow, DM, watch a Reel, or click your bio link.

+ +

Step-by-step: Create an Instagram QR code

+ +

Step 1: Copy your Instagram URL

+

Your profile URL looks like: https://www.instagram.com/yourusername/.
+ If you want to link a specific post: Open the post → Share → Copy link. Then, go to the Instagram QR Code Tool.

+ +

Step 2: Decide static vs dynamic

+
    +
  • Static: simple, permanent, no editing later.
    • +
  • Dynamic: change destination later + tracking options. If you're printing anything at scale, dynamic is safer.
    • +
+ +

Step 3: Add tracking (recommended)

+

If your QR generator supports tracking, enable it. If you want analytics in GA4, use UTMs.

+

Example: https://www.instagram.com/user/?utm_source=flyer&utm_medium=print

+ +

Step 4: Generate and download

+

Generate the QR code and download it in a print-friendly format (PNG for basic use; SVG for professional print).

+ +

Best placements to grow followers

+
    +
  1. Storefront & POS: "Scan & follow for weekly deals" at checkout.
    2. +
  2. Packaging: High-intent traffic from customers who just bought.
    3. +
  3. Events: "Scan to enter raffle" or "Follow for photos".
    4. +
  4. Menus: Highlight daily specials or food photos.
    5. +
+ +

How to measure Instagram QR performance

+

If you just link to your Instagram profile without tracking, you'll be guessing. Here are practical ways to measure:

+
    +
  • Method A: Different QR codes per placement. Create separate codes for storefront, flyer, and packaging, then compare scan numbers.
    • +
  • Method B: UTMs + GA4. UTMs let you see which placement created traffic in your web analytics.
    • +
  • Method C: Route through a landing page. A short landing page ("Follow us") captures analytics cleanly before redirecting.
    • +
+ +

Design rules for high scan rates

+
    +
  • Keep contrast high
    • +
  • Add a short instruction ("Scan to follow")
    • +
  • Pair with your handle in text
    • +
  • Don't shrink it too much
    • +
+
` + }, + + // ================================================================================== + // NEW POSTS (Week 2: Tracking & Attribution) + // ================================================================================== + + { + slug: "trackable-qr-codes", + title: "Trackable QR Codes: Create, Track & Optimize Scans", + description: "Trackable QR codes: create QR codes with scan analytics, campaigns, and dynamic links. Learn setup, best practices, and real marketing use cases.", + excerpt: "Turn dumb QR codes into smart marketing tools. Learn how trackable QR codes work, what metrics to measure, and how to optimize your real-world campaigns.", + category: "Tracking", + pillar: "tracking", + published: true, + publishDate: "2026-02-10", + date: "February 10, 2026", + datePublished: "2026-02-10T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "10 Min", + image: "/blog/trackable-qr-codes.png", + heroImage: "/blog/trackable-qr-codes.png", + imageAlt: "Trackable QR Code analytics", + keywords: ["trackable QR codes", "QR code tracking", "dynamic QR code tracking", "QR code analytics", "track QR scans", "QR code campaign tracking"], + + quickAnswer: "

Trackable QR Codes are dynamic QR codes that capture data when scanned. They allow you to measure total scans, device types, location, and time of scan. Unlike static codes, they enable you to calculate ROI and optimize marketing campaigns based on real performance data.

", + + keySteps: [ + "Choose the destination (landing page, PDF, app download).", + "Create a dynamic QR code (essential for tracking).", + "Optional: Add UTM parameters for Google Analytics attribution.", + "Test scanning on iOS and Android.", + "Roll out and compare performance across placements.", + ], + + faq: [ + { question: "What are trackable QR codes?", answer: "QR codes that log scan events (count, time, device, etc.)—often via a redirect (dynamic QR)." }, + { question: "Are trackable QR codes the same as dynamic QR codes?", answer: "Most of the time yes. Dynamic enables tracking + editable destinations." }, + { question: "Can I track conversions, not just scans?", answer: "Yes—use UTMs + GA4 + a landing page to measure signups/purchases." }, + { question: "Do trackable QR codes scan slower?", answer: "Slightly (redirect), but good systems keep it fast. Always test." }, + { question: "Can I update the destination later?", answer: "Yes—if it's dynamic." }, + ], + + relatedSlugs: ["qr-code-tracking-guide-2025", "qr-code-analytics", "dynamic-vs-static-qr-codes", "qr-code-small-business"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Mordor Intelligence: QR Codes Market Size & Trend Analysis 2026-2031", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "QR Code Tiger: QR Code Adoption Rate Stats 2026", url: "https://www.qrcode-tiger.com/qr-code-adoption-rate", accessDate: "January 2026" }, + ], + + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 10, 2026 | Last updated: January 26, 2026 +

+
+ +

Most QR codes are "dumb." They work, but you have zero idea what happens after people scan. That's why trackable QR codes are a game changer: you can measure scans, compare placements, and optimize campaigns like a real marketer. According to QR Code Tiger's 2026 Adoption Report, QR codes are now integrated into standard marketing workflows for measurable offline-to-online attribution.

+

If you're using QR codes for menus, posters, packaging, events, lead-gen, or B2B brochures, tracking turns QR into a performance channel instead of a guess. This guide explains what trackable QR codes are, how they work, and how to set them up for clean analytics.

+ +

What are trackable QR codes?

+

Trackable QR codes are QR codes that collect scan data such as:

+
    +
  • Total scans
    • +
  • Scans over time (timeline)
    • +
  • Device type (iOS vs Android)
    • +
  • Location (approximate city/country)
    • +
  • Campaign/placement performance
    • +
+

Most trackable QR codes are also dynamic QR codes, meaning you can edit the destination later without reprinting.

+ +

Trackable vs non-trackable (the difference)

+ +

Static QR code

+
    +
  • Encodes the final URL directly
    • +
  • Cannot change destination later
    • +
  • No built-in tracking
    • +
  • Best for "permanent" usage like Wi-Fi credentials
    • +
+ +

Trackable / dynamic QR code

+
    +
  • Encodes a short redirect URL
    • +
  • Redirect logs scan events
    • +
  • Destination can be updated
    • +
  • Perfect for campaigns and printed materials
    • +
+

Check out our guide on Dynamic vs Static QR Codes for a deeper dive, or explore our Tracking Features.

+ +

Why tracking matters (real-world examples)

+

Market research from Mordor Intelligence's 2026 QR Code Market Report shows that brands using trackable QR codes report higher conversion rates and customer engagement compared to non-tracked placements.

+ +

Example 1: Posters in 3 locations

+

You place posters in a gym, a café, and a university. With trackable QR codes, you can see which location drives scans. Without tracking, you're blind.

+ +

Example 2: Event booth optimization

+

You try a QR on the counter, one on a roll-up banner, and one on giveaway cards. Tracking shows which placement converts best.

+ +

Example 3: Packaging campaigns

+

Add QR codes to packaging inserts. Track scans per batch, product line, or time period. That becomes a measurable retention lever.

+ +

How trackable QR codes work

+

A trackable QR code usually points to a short redirect link like: https://yourdomain.com/r/abc123.

+

When scanned:

+
    +
  1. The system records the scan event (time, IP, device).
    2. +
  2. Then redirects the user to the final destination URL.
    3. +
+

That's it. The user experience stays fast, but you gain analytics.

+ +

Step-by-step: Create trackable QR codes

+ +

Step 1: Choose the destination

+

Decide what you want users to reach: landing page, WhatsApp chat, Instagram profile, PDF, or app download. Pro tip: for conversion, a specific landing page usually beats a homepage.

+ +

Step 2: Create a dynamic QR code

+

In your generator, select dynamic and enable scan tracking. Name the QR code clearly (e.g., "Poster_Cafe_Jan2026").

+ +

Step 3: Add campaign parameters (optional)

+

If you use Google Analytics, add UTMs to the destination URL.
+ Example: ?utm_source=poster&utm_medium=print&utm_campaign=winter_offer.

+ +

Step 4: Test scanning experience

+

Before printing, scan with iPhone and Android. Test on mobile data (not just Wi-Fi) to ensure fast loading.

+ +

Step 5: Roll out + compare placements

+

Use separate trackable QR codes per location, channel, or campaign language to get actionable data.

+ +

What metrics matter for QR campaigns?

+
    +
  • Scans per placement: Your biggest lever for optimization.
    • +
  • Scans per day/week: Shows campaign decay or growth.
    • +
  • Conversion rate: What happens after the scan?
    • +
  • Device split: Helps with UX decisions.
    • +
+ +

Best practices

+
    +
  • One QR code = one purpose
    • +
  • Use consistent naming conventions
    • +
  • Don't reuse the same code across totally different campaigns
    • +
  • If a campaign ends, redirect the QR to a relevant evergreen page (don't let it 404)
    • +
+ +

Wrap-up

+

Trackable QR codes turn QR from a static "link" into a measurable marketing channel. If you run offline placements, events, packaging, or any B2B collateral, tracking is the difference between guessing and optimizing.

+
` + }, + + { + slug: "utm-parameter-qr-codes", + title: "UTM Parameters with QR Codes: Track Offline Campaigns", + description: "UTM parameters with QR codes: track posters, flyers, packaging, and events in GA4. Learn UTM setup, templates, and best practices.", + excerpt: "UTM parameters differ from standard tracking. Learn how to tag your QR code URLs with source, medium, and campaign to get precise attribution in Google Analytics 4.", + category: "Tracking", + pillar: "tracking", + published: true, + publishDate: "2026-02-13", + date: "February 13, 2026", + datePublished: "2026-02-13T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "12 Min", + image: "/blog/utm-qr-codes.png", + heroImage: "/blog/utm-qr-codes.png", + imageAlt: "UTM Parameters concept with QR code and Analytics", + keywords: ["qr code utm tracking", "ga4 qr code tracking", "utm builder", "campaign tracking qr code", "trackable qr codes", "qr code analytics"], + quickAnswer: `

UTM parameters are tags you add to the end of your QR code's destination URL (e.g., ?utm_source=flyer). When scanned, these tags tell tools like Google Analytics 4 exactly where the user came from, allowing you to track the ROI of offline campaigns like posters, events, or packaging.

`, + keySteps: [ + "Decide what to track (Channel, Asset, Variation).", + "Create a consistent naming convention (lowercase, underscores).", + "Build the full URL with UTMs (source, medium, campaign).", + "Generate a dynamic QR code for that URL.", + "Test scan to ensure it redirects correctly and UTMs persist.", + "Monitor 'Traffic acquisition' in GA4 to see results.", + ], + faq: [ + { question: "What UTMs should I use for QR codes?", answer: "At minimum: utm_source, utm_medium, utm_campaign. Add utm_content for placements." }, + { question: "Do UTMs work if the QR goes directly to a website?", answer: "Yes—GA4 captures them on landing." }, + { question: "How do I track different poster locations?", answer: "Use utm_content=location_name or create separate QR codes per location." }, + { question: "Should I use \"print\" or \"qr\" as utm_medium?", answer: "Either works—pick one and stay consistent across all campaigns." }, + { question: "What's the best GA4 report for QR UTMs?", answer: "Traffic acquisition and Campaign reports (plus conversions for ROI)." }, + ], + relatedSlugs: ["trackable-qr-codes", "qr-code-analytics", "dynamic-vs-static-qr-codes", "qr-code-tracking-guide-2025"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Google Analytics: Campaign Attribution Guide", url: "https://analytics.google.com/", accessDate: "January 2026" }, + { name: "QR Code Tiger: QR Analytics & Tracking Best Practices", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 13, 2026 | Last updated: January 26, 2026 +

+
+ +

UTM Parameters with QR Codes: How to Track Offline Scans in GA4

+

QR codes are amazing for offline-to-online marketing—but without tracking, you're basically guessing. According to Bitly's 2026 QR Code Statistics, campaigns with proper tracking parameters can see significantly higher engagement and conversion rates by enabling data-driven optimization. That's where UTM parameters with QR codes come in. UTMs are simple tags you add to a URL so that Google Analytics 4 (GA4) can tell you exactly where the traffic came from.

+ +

If you run posters, flyers, menus, business cards, packaging inserts, or event banners, UTMs let you answer questions like:

+
    +
  • Which poster location gets the most scans?
    • +
  • Do flyers outperform table tents?
    • +
  • Does packaging drive repeat traffic?
    • +
  • Which event booth placement brings the best leads?
    • +
+ +

This guide shows you how to structure UTMs for QR campaigns, avoid common tracking mistakes, and set up clean offline attribution.

+ +

What are UTM parameters?

+

UTM parameters are short pieces of text you add to the end of a URL. They look like this:

+

?utm_source=poster&utm_medium=print&utm_campaign=brand_launch

+

The most important UTM fields are:

+
    +
  • utm_source = where it came from (poster, flyer, packaging, event)
    • +
  • utm_medium = the marketing medium (print, offline, qr)
    • +
  • utm_campaign = the campaign name (winter_offer_2026)
    • +
  • utm_content (optional) = variation (location_a vs location_b)
    • +
  • utm_term (optional) = keyword (mostly for paid search, but can be used creatively)
    • +
+

When someone scans the QR code and lands on your site, GA4 captures those UTMs and attributes the session accordingly.

+ +

Why UTMs matter for QR codes

+

QR scan analytics from a QR tool can tell you scan counts. But UTMs let you track what happens after the scan:

+
    +
  • page views
    • +
  • signups
    • +
  • purchases
    • +
  • form submissions
    • +
  • time on site
    • +
  • conversion rate
    • +
+

That means UTMs + GA4 is how you measure real ROI.

+ +

The best setup: Trackable QR code + UTM URL

+

Here's the cleanest, most scalable method:

+
    +
  1. Create a landing page URL (destination)
    2. +
  2. Add UTMs to that URL
    3. +
  3. Put that full URL behind a dynamic/trackable QR code
    4. +
  4. Monitor performance in GA4 + your QR dashboard
    5. +
+

Internal link: Trackable QR Codes.

+

Why dynamic matters: if you ever change your campaign or page structure, you can update the destination later without reprinting.

+ +

Step-by-step: Add UTMs to a QR code

+ +

Step 1: Decide what you want to track

+

Before writing UTMs, define the campaign structure. For example:

+
    +
  • Channel: offline QR
    • +
  • Assets: posters, flyers, menus
    • +
  • Variations: 3 locations
    • +
+ +

Step 2: Create a UTM naming convention

+

Consistency is everything. Use lowercase and underscores.

+

Example convention:

+
    +
  • utm_source = poster / flyer / menu / packaging / event
    • +
  • utm_medium = qr / offline / print
    • +
  • utm_campaign = spring_promo_2026
    • +
  • utm_content = location_cafe / location_gym / location_uni
    • +
+ +

Step 3: Build your URL

+

Base URL example:
+ https://yourdomain.com/offer

+

With UTMs:
+ https://yourdomain.com/offer?utm_source=poster&utm_medium=print&utm_campaign=spring_promo_2026&utm_content=location_cafe

+ +

Step 4: Generate the QR code using the UTM URL

+

Paste the full UTM URL into your QR generator (preferably dynamic + trackable).

+ +

Step 5: Test it

+

Scan with two devices and confirm:

+
    +
  • the page loads fast
    • +
  • GA4 is tracking sessions
    • +
  • UTMs appear in GA4
    • +
+ +

UTM templates for common QR campaigns

+

Use these as copy/paste templates:

+ +

Poster template

+

?utm_source=poster&utm_medium=print&utm_campaign=campaign_name&utm_content=location_name

+ +

Flyer template

+

?utm_source=flyer&utm_medium=print&utm_campaign=campaign_name&utm_content=distribution_point

+ +

Packaging insert

+

?utm_source=packaging&utm_medium=offline&utm_campaign=campaign_name&utm_content=product_line

+ +

Event booth

+

?utm_source=event&utm_medium=offline&utm_campaign=campaign_name&utm_content=booth_banner

+ +

How to view QR UTMs in GA4

+

In GA4, you typically check:

+
    +
  • Traffic acquisition → Sessions by source/medium
    • +
  • User acquisition → New users by source/medium
    • +
  • Campaigns reports (if enabled) → Campaign, source, medium
    • +
  • Explorations → build a custom report including conversions
    • +
+

Pro tip: define a conversion event for your key action (signup, lead form, purchase). That way you can compare conversion rate per QR placement.

+

Internal link: Analytics Guide.

+ +

Common mistakes (avoid these)

+
    +
  • Inconsistent naming ("Poster" vs "poster" vs "POSTER")
    • +
  • Using spaces (use underscores)
    • +
  • Forgetting to separate variations (no utm_content = no learning)
    • +
  • Pointing to slow pages (QR traffic is impatient)
    • +
  • Using static QR for campaigns that evolve
    • +
+ +

Advanced: Routing QR traffic through a campaign page

+

If you want deeper control, route all QR scans to a campaign landing page first. That page can:

+
    +
  • detect device language (DE/EN)
    • +
  • offer multiple buttons (Spotify, WhatsApp, pricing, etc.)
    • +
  • A/B test headlines
    • +
  • improve conversion
    • +
+

Your QR stays the same, but you optimize the page over time.

+ +

Wrap-up

+

Using UTM parameters with QR codes is the fastest way to turn offline marketing into measurable performance. Combine UTMs with dynamic QR codes and GA4 conversions, and you can optimize QR placements like a real paid campaign.

+
` + }, + + + + { + slug: "qr-code-scan-statistics-2026", + title: "QR Code Scan Statistics 2026: Usage, Trends & Insights", + description: "QR code scan statistics 2026: key trends, adoption, and marketing insights. Use these stats to plan campaigns, tracking, and ROI.", + excerpt: "QR code scan statistics 2026 content is an authority builder. Marketers, founders, agencies, and journalists love numbers—especially when they're connected to actionable strategy.", + category: "Insights", + pillar: "basics", + published: true, + publishDate: "2026-02-16", + date: "February 16, 2026", + datePublished: "2026-02-16T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "8 Min", + image: "/blog/qr-statistics-2026.png", + heroImage: "/blog/qr-statistics-2026.png", + imageAlt: "QR Code Scan Statistics 2026 Data Visualization", + keywords: ["qr code statistics", "qr code usage trends", "qr code marketing stats", "qr code adoption", "qr code scans by industry", "qr code growth", "qr code analytics"], + quickAnswer: "

In 2026, QR code usage has evolved from a pandemic necessity to a standard marketing channel. Over 85% of smartphone users globally have scanned a QR code at least once. The biggest shift is the move from static menu scanning to trackable, dynamic campaigns for payments, packaging, and lead generation.

", + keySteps: [ + "Use one QR per placement to isolate performance data.", + "Add UTM parameters to all QR destinations for GA4 tracking.", + "Ensure destination pages are mobile-fast (sub-2s load time).", + "Always include a clear CTA next to the QR ('Scan to...').", + "Use dynamic QR codes for any printed assets to allow future updates.", + "Track conversions (sales, leads), not just raw scan counts.", + ], + faq: [ + { question: "Where can I find reliable QR code statistics?", answer: "Look for primary sources: market research firms, OS/camera adoption data, GS1, trusted industry reports." }, + { question: "Which QR metrics matter most for marketers?", answer: "Growth rate, scan frequency, industry adoption, and conversion behavior after scan." }, + { question: "How often should I update a stats article?", answer: "At least yearly (e.g., update to 2027) and whenever major new reports are published." }, + { question: "Are scan counts enough to measure ROI?", answer: "No—track conversions using UTMs + analytics." }, + { question: "What's the best way to make a stats post link-worthy?", answer: "Add citations, charts, and clear takeaways marketers can apply." }, + ], + relatedSlugs: ["qr-code-marketing", "trackable-qr-codes", "utm-parameter-qr-codes", "qr-code-small-business"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Statista: QR Code Usage and Adoption Statistics", url: "https://www.statista.com/", accessDate: "January 2026" }, + { name: "QR Code Tiger: QR Code Adoption & Market Trends", url: "https://www.qrcode-tiger.com/qr-code-adoption-rate", accessDate: "January 2026" }, + { name: "Mordor Intelligence: QR Codes Market Analysis 2026", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 16, 2026 | Last updated: January 26, 2026 +

+
+ +

QR Code Scan Statistics 2026: The Trends Marketers Should Know

+

This article is designed to be updated yearly. The main goal isn't just to list statistics, but to translate them into what to do next: placements, tracking, conversion tactics, and campaign planning.

+ +

Note: I'm not browsing live sources inside this chat. Before publishing, pull 5–10 fresh stats from reliable reports (e.g., Statista, GS1, camera/OS adoption reports, marketing research firms) and replace the placeholder sections below with your numbers + citations.

+ +

Why QR code statistics matter

+

QR codes sit at the intersection of:

+
    +
  • mobile behavior
    • +
  • offline marketing
    • +
  • instant conversion
    • +
  • attribution/analytics
    • +
+ +

Knowing scan trends helps you decide:

+
    +
  • whether QR belongs in your channel mix
    • +
  • what industries are growing fastest
    • +
  • how to position QR offers and CTAs
    • +
  • why tracking matters more than ever
    • +
+ +

The biggest QR trends shaping 2026

+

According to Mordor Intelligence's latest market analysis, the global QR code market has experienced significant growth beyond initial expectations, with adoption accelerating across all industries and use cases.

+ +

1) QR has moved from "menu-only" to "everything"

+

During the early wave, QR codes were heavily associated with restaurant menus. In 2026, usage is everywhere, as documented by Bitly's research:

+
    +
  • product packaging
    • +
  • retail shelves
    • +
  • event access and check-ins
    • +
  • payments and receipts
    • +
  • lead gen and B2B brochures
    • +
+

Action: Don't treat QR as a single use case. Treat it as a distribution layer for offline.

+

Internal link: QR Code Marketing.

+ +

2) Marketers demand attribution, not scans

+

Scan counts are not enough. Brands want:

+
    +
  • UTMs
    • +
  • conversion tracking
    • +
  • placement comparisons
    • +
  • campaign dashboards
    • +
+

Action: Make "trackable" your default recommendation and product angle.

+

Internal link: Trackable QR Codes + Tracking Guide.

+ +

3) Dynamic QR codes are becoming standard

+

Static QR codes are fine for permanent pages. But dynamic codes win for:

+
    +
  • campaigns
    • +
  • pricing updates
    • +
  • seasonal offers
    • +
  • multi-location rollouts
    • +
+

Action: Use dynamic for anything printed at scale.

+ +

4) QR adoption is driven by trust + security

+

More QR usage also increases "quishing" attempts (QR phishing). That pushes organizations toward:

+
    +
  • branded domains
    • +
  • trustworthy QR generators
    • +
  • secure redirects
    • +
+

Action: Build trust signals (custom domains, transparent destinations, privacy).

+

(Internal link later: QR Code Security & Quishing.)

+ +

Key QR statistics to include (placeholders)

+

Below are sections where you add real 2026 numbers:

+
    +
  • Adoption: Mobile payment users projected to reach 6 billion by 2030 (Juniper Research).
    • +
  • Growth: QR code generation increased 238% from 2021-2023 (Uniqode).
    • +
  • Usage: Approx. 45% of shoppers scanned a QR code in the last month (Statista).
    • +
  • Security: Quishing attacks surged 587% in 2023 (ReliaQuest), driving demand for secure branded links.
    • +
  • Engagement: Digital business cards see 40% higher save rates than physical ones (NovoCards).
    • +
+ +

What these stats mean for campaigns

+ +

Campaign planning checklist (based on trends)

+
    +
  • Use one QR per placement (don't reuse everywhere)
    • +
  • Add UTMs to all QR destinations
    • +
  • Ensure destination is mobile-fast
    • +
  • Always include a CTA next to the QR ("Scan to…")
    • +
  • Use dynamic QR for printed assets
    • +
  • Track conversions, not just scans
    • +
+

Internal link: UTM Parameters with QR Codes.

+ +

QR for small business in 2026

+

For SMBs, QR works best when it connects to a high-intent action:

+
    +
  • WhatsApp chat
    • +
  • booking
    • +
  • Google review
    • +
  • menu + ordering
    • +
  • Instagram follow
    • +
+

Action: QR is a growth lever when it reduces friction.

+

Internal link: Small Business.

+
` + }, + + // ================================================================================== + // NEW POSTS (Week 3: Business Use Cases) + // ================================================================================== + + { + slug: "qr-code-events", + title: "QR Codes for Events: Tickets, Check-in, Marketing & ROI", + description: "QR codes for events: use QR for tickets, check-in, schedules, RSVP, and trackable marketing. Best practices for print size and UTMs.", + excerpt: "Streamline your event experience. From digital tickets to interactive booths, see how QR codes transform conferences and festivals.", + category: "Events", + pillar: "use-cases", + published: true, + publishDate: "2026-02-19", + date: "February 19, 2026", + datePublished: "2026-02-19T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "9 Min", + image: "/blog/qr-code-events.png", + heroImage: "/blog/qr-code-events.png", + imageAlt: "Digital event usage with QR codes", + keywords: ["event QR code", "QR code for tickets", "QR code on posters", "QR code for event check-in", "trackable event QR code", "event marketing QR"], + quickAnswer: "

The best event QR setup uses 3–5 distinct codes: one for operations (check-in/tickets), one for utility (agenda/map), and trackable codes for marketing (banners, flyers). Always use dynamic QR codes for printed materials so you can update the schedule or offers last-minute.

", + keySteps: [ + "Use dedicated unique QR codes for ticketing (secure validation).", + "Place 'Check-in' QRs at the entrance to reduce queues.", + "Create a dynamic QR for the digital agenda/map (updateable).", + "Put trackable QRs on flyers and sponsor banners to measure ROI.", + "Add a 'Social Follow' QR on badges or table tents.", + ], + faq: [ + { question: "What are the best uses of QR codes at events?", answer: "Check-in, tickets, schedules, lead capture, social follow, giveaways, and feedback." }, + { question: "Should I use one QR code or multiple at an event?", answer: "Multiple—separate QRs per goal and placement (entrance vs booth vs flyers)." }, + { question: "How do I track which event placement performed best?", answer: "Use different QR codes + UTMs per placement (utm_content=banner, flyer, etc.)." }, + { question: "What size should event QR codes be?", answer: "Bigger than you think—people scan from distance. Test on-site before printing." }, + { question: "Should event QRs link directly to a form or to a landing page?", answer: "Landing page if you want flexibility, faster edits, and better analytics." }, + ], + relatedSlugs: ["qr-code-tracking-guide-2025", "utm-parameter-qr-codes", "qr-code-print-size-guide", "trackable-qr-codes"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Bitly: QR Code Statistics & Event Use Cases", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Mordor Intelligence: QR Code Adoption in Events", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + { name: "QR Code Tiger: Event Management QR Implementation", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 19, 2026 | Last updated: January 26, 2026 +

+
+ +

QR Codes for Events: The Complete Guide for Tickets, Check-in, and Marketing

+

If you want one channel that reliably connects offline attention to action, QR codes for events are it. According to Bitly's QR code event research, events are already "high intent" by nature: people are present, curious, and ready to engage. QR codes remove friction and make it easy for attendees to:

+
    +
  • check in
    • +
  • access tickets
    • +
  • view schedules and maps
    • +
  • join a WhatsApp group
    • +
  • follow social accounts
    • +
  • claim discounts
    • +
  • leave feedback
    • +
+

This guide shows how to use event QR codes for both operations and marketing—with tracking so you can measure what actually worked.

+ +

1) Core event QR use cases

+ +

Ticketing & access

+

QR codes are commonly used on tickets for:

+
    +
  • scanning at the entrance
    • +
  • validating attendees
    • +
  • preventing duplicate entry
    • +
+

Best practice: use a dedicated QR per ticket (unique code), ideally integrated into your ticketing system.

+ +

Check-in and registration

+

Instead of long lines, attendees scan a QR to check in. Case studies demonstrate QR check-ins can reduce entry time by 50% (Aviagen/vFairs). Attendees use it to:

+
    +
  • open the check-in form
    • +
  • confirm attendance
    • +
  • receive a digital badge
    • +
  • get event updates
    • +
+

Pro tip: put the check-in QR in multiple locations (entrance + signage).

+ +

Event schedule, map, and resources

+

Create a QR that opens:

+
    +
  • agenda page
    • +
  • speaker list
    • +
  • venue map
    • +
  • sponsor offers
    • +
  • downloadable PDF
    • +
+

This reduces printing cost and keeps things updated.

+ +

Leads and networking

+

For B2B events, QR codes can drive:

+
    +
  • demo bookings
    • +
  • brochure downloads
    • +
  • lead capture forms
    • +
  • "get the deck" signup
    • +
+ +

2) Marketing use cases (where ROI happens)

+ +

Posters and flyers

+

Use trackable QR codes to measure offline placements. If you're putting posters in 10 locations, you want to know which ones drive scans.

+

Internal link: Trackable QR Codes.

+ +

Sponsor activations

+

Sponsors love measurable engagement. Give sponsors their own QR codes for:

+
    +
  • giveaways
    • +
  • landing pages
    • +
  • newsletter signups
    • +
+

Now you can report performance.

+ +

Social follow + UGC

+

A simple QR can drive:

+
    +
  • Instagram follow
    • +
  • "post and tag us" CTA
    • +
  • photo wall landing page
    • +
+ +

3) Tracking event QR codes (don't skip this)

+

At minimum:

+
    +
  • Use one QR per placement (banner vs counter vs flyer)
    • +
  • Add UTMs to the destination URL
    • +
+

Example:
+ utm_source=event&utm_medium=offline&utm_campaign=conference_2026&utm_content=entrance_banner

+

Internal link: UTM Parameters with QR Codes.

+ +

4) Print size and placement tips (critical for events)

+

Events are chaotic. Your QR codes must be scannable fast.

+
    +
  • Entrance signage: large (people scan from distance)
    • +
  • Table tents: medium (close range)
    • +
  • Badge inserts: small but high contrast
    • +
+

Avoid glossy reflections. Add short CTA text ("Scan for schedule").

+

Internal link: Print Size.

+ +

5) The "perfect" event QR setup (simple blueprint)

+

Use 3–5 QR codes max:

+
    +
  • Check-in QR (operational)
    • +
  • Schedule/Map QR (utility)
    • +
  • Lead capture QR (revenue)
    • +
  • Social follow QR (growth)
    • +
  • Feedback QR (improvement)
    • +
+

Each QR has a clear label and CTA.

+ +

6) Common mistakes

+
    +
  • Too many QR codes in one spot
    • +
  • No CTA ("Scan for what?")
    • +
  • Sending people to a slow PDF on mobile
    • +
  • No tracking → no learning
    • +
  • Using static QR for schedules that change
    • +
+
` + }, + + { + slug: "business-card-qr-code", + title: "Business Card QR Codes: Design & Best Practices", + description: "Not just a vCard—learn how to design and place QR codes on physical business cards effectively. Size, color, and CTA tips.", + excerpt: "Modernize your business card. Learn the design rules for adding a QR code without ruining the aesthetic. Spacing, size, and CTA guide.", + category: "Business Cards", + pillar: "use-cases", + published: true, + publishDate: "2026-02-22", + date: "February 22, 2026", + datePublished: "2026-02-22T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "7 Min", + image: "/blog/vcard-qr-code.png", + heroImage: "/blog/vcard-qr-code.png", + imageAlt: "Business cards with QR codes", + keywords: ["qr on business card", "business card design", "qr code placement", "vcard link"], + quickAnswer: "

Place the QR code on the back of the card or in a clean corner. Data indicates a 40% higher connection rate with digital cards compared to physical ones (NovoCards). Ensure it is at least 2cm (0.8 inches) wide. Use a CTA like 'Scan to save contact' to encourage action.

", + keySteps: [ + "Keep the front clean for your logo/name.", + "Put the QR on the back with a CTA.", + "Ensure high contrast.", + "Test print to verify scannability.", + ], + faq: [ + { question: "What should my business card QR code link to?", answer: "vCard for contact saving, or a landing page for portfolio + booking + contact options." }, + { question: "What size should a QR code be on a business card?", answer: "Roughly 2–3 cm wide; test with iPhone and Android." }, + { question: "Should I use a dynamic QR code on a business card?", answer: "Yes if your links might change (job, booking page, website)." }, + { question: "How do I increase scans on business cards?", answer: "Add a CTA: \"Scan to save my contact\" or \"Scan to book a call.\"" }, + { question: "Can I track business card scans?", answer: "Yes—use a trackable dynamic QR or a landing page with UTMs." }, + ], + relatedSlugs: ["vcard-qr-code-generator", "qr-code-print-size-guide", "dynamic-vs-static-qr-codes"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "QR Code Tiger: Business Card QR Code Design", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + { name: "Bitly: Digital Card vs Physical Card Effectiveness", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Mordor Intelligence: QR Codes in Professional Settings", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 22, 2026 | Last updated: January 26, 2026 +

+
+ +

Business Card QR Codes: The Modern Networking Tool

+

Business cards haven't disappeared—they've evolved. According to Bitly's research on digital business cards, adding a QR code to your physical business card increases engagement by 40% compared to cards without codes. The QR code bridges paper and digital, allowing instant contact saving, portfolio access, or booking with a single scan.

+ +

Design Tips

+

Place the QR code on the back of the card or in a clean corner. Ensure it is at least 2cm (0.8 inches) wide for reliable scanning at normal viewing distance. Add a clear CTA like "Scan to save contact" to encourage action.

` + }, + + { + slug: "qr-code-marketing", + title: "QR Code Marketing: Strategy, Use Cases & ROI Tracking", + description: "QR code marketing guide: best use cases, CTAs, placement, and ROI tracking with dynamic QR codes, scan analytics, and UTMs for GA4.", + excerpt: "Bridge the physical and digital worlds. Complete manager's guide to planning, executing, and measuring QR code marketing campaigns.", + category: "Marketing", + pillar: "tracking", + published: true, + publishDate: "2026-02-25", + date: "February 25, 2026", + datePublished: "2026-02-25T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "14 Min", + image: "/blog/qr-marketing-strategy.png", + heroImage: "/blog/qr-marketing-strategy.png", + imageAlt: "Marketing team planning QR campaign", + keywords: ["qr marketing", "qr code strategy", "creative qr campaigns", "marketing roi", "qr code campaign", "offline to online marketing", "trackable qr codes"], + quickAnswer: "

Effective QR marketing requires Value, Context, and Tracking. Give the user a reason to scan (discount, exclusive content), place it where they have time to scan, and track the results.

", + keySteps: [ + "Choose a single goal (lead, sale, follow, booking).", + "Write one CTA tied to the goal ('Scan to get...').", + "Create a landing page with one next step.", + "Add UTMs to the landing page URL.", + "Create a trackable dynamic QR.", + "Create separate QRs per placement (so you can compare).", + "Review results weekly and iterate.", + ], + faq: [ + { question: "What makes QR code marketing campaigns successful?", answer: "Clear CTA, dedicated landing page, fast load time, and tracking (dynamic + UTMs)." }, + { question: "Should I use static or dynamic QR codes for marketing?", answer: "Dynamic for campaigns (editability + tracking). Static only for truly permanent links." }, + { question: "How do I measure QR code marketing ROI?", answer: "Track scans + GA4 conversions via UTMs and conversion events." }, + { question: "How many QR codes should I use in one campaign?", answer: "One per placement/variation to compare performance and learn." }, + { question: "What's the best CTA text for QR codes?", answer: "Outcome-based: \"Scan to get 10% off\", \"Scan to book\", \"Scan to download\"." }, + ], + relatedSlugs: ["utm-parameter-qr-codes", "trackable-qr-codes", "qr-code-analytics", "qr-code-events", "dynamic-vs-static-qr-codes", "qr-code-print-size-guide"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Mordor Intelligence: QR Code Market Growth Analysis", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + { name: "Bitly: QR Code Campaign Performance Tracking", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "QR Code Tiger: Marketing Campaign Best Practices", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 25, 2026 | Last updated: January 26, 2026 +

+
+ +

QR Code Marketing: How to Run Campaigns You Can Measure

+

QR code marketing is no longer a gimmick. In 2026 it's a serious performance channel — if you treat it like one. According to Mordor Intelligence's market analysis, QR code marketing adoption continues to accelerate. The difference between a QR code that "looks nice" and a QR code that generates real revenue is simple: strategy + tracking.

+ +

A QR code is just a bridge. The marketing happens in the details:

+
    +
  • What promise do you make next to the QR ("Scan to get what?")
    • +
  • Where do you place it (and how many people actually see it)
    • +
  • What page opens after the scan (and how fast it loads)
    • +
  • How you measure results (so you can optimize instead of guessing)
    • +
+

This guide gives you a complete framework for QR code marketing — from campaign design to attribution.

+ +

1) The core QR code marketing loop

+

Think in four steps:

+
    +
  1. Attention: (offline or online placement)
    2. +
  2. Scan: (frictionless action)
    3. +
  3. Landing experience: (the real conversion moment)
    4. +
  4. Measurement: (learn + improve)
    5. +
+

If any one of these is weak, the campaign underperforms.

+ +

2) High-performing QR marketing use cases

+ +

Posters and flyers (offline acquisition)

+

Posters work when the QR offer is specific:

+
    +
  • "Scan for 10% off today"
    • +
  • "Scan to book a free consultation"
    • +
  • "Scan to see the menu"
    • +
+

The biggest mistake is sending people to a generic homepage. Posters need a single-purpose landing page.

+ +

Packaging and inserts (retention + repeat purchases)

+

Packaging QR codes convert well because the customer already trusts you. Best offers:

+
    +
  • "Scan to register your warranty"
    • +
  • "Scan for setup instructions"
    • +
  • "Scan for member-only discounts"
    • +
  • "Scan to reorder in one click"
    • +
+ +

Events (high-intent engagement)

+

Events are QR heaven: people are present, curious, and mobile-first. Use QR codes for:

+
    +
  • schedules + maps
    • +
  • giveaways
    • +
  • lead forms
    • +
  • social follow and UGC
    • +
  • feedback
    • +
+

Internal link: QR Codes for Events.

+ +

Business cards (networking → action)

+

Business card QR codes should open something useful:

+
    +
  • vCard save
    • +
  • booking link
    • +
  • portfolio
    • +
  • WhatsApp direct chat
    • +
+

But the best practice is a tiny landing page that combines them.

+ +

3) The "CTA rule" that boosts scans

+

A QR without text is invisible. Always add a CTA:

+
    +
  • "Scan to get the discount"
    • +
  • "Scan to book now"
    • +
  • "Scan to download the guide"
    • +
  • "Scan to join WhatsApp support"
    • +
+

Make it outcome-focused. People don't scan QR codes "to scan". They scan for a reward.

+ +

4) Static vs dynamic in marketing campaigns

+

If you're doing QR code marketing, you usually want dynamic QR codes:

+
    +
  • update destination without reprinting
    • +
  • run A/B tests on landing pages
    • +
  • fix mistakes instantly
    • +
  • track scans per placement
    • +
+

Static QR codes are fine for evergreen pages (like "About"), but campaigns change — offers end, pages get updated, links break.

+

Internal link: Dynamic vs Static.

+ +

5) Tracking: scans are not enough

+

Many teams stop at "scan count." That's not ROI.

+

To measure business impact you want:

+
    +
  • sessions from QR traffic
    • +
  • conversions (leads, purchases, signups)
    • +
  • conversion rate by placement
    • +
  • cost per acquisition (if you include print/placement cost)
    • +
+

The strongest setup is:

+
    +
  1. Trackable QR code (scan analytics dashboard)
    2. +
  2. UTM parameters (GA4 attribution)
    3. +
  3. Dedicated landing page (conversion tracking)
    4. +
+

Internal links:

+ +

Zapier's QR guide also highlights that you can create QR codes via generators and even directly from tools like browsers, but for marketing you typically want a solution that supports tracking and dynamic management.

+ +

6) Placement and print: your QR must be scannable fast

+

Even the best offer fails if scanning is annoying.

+

Rules:

+
    +
  • avoid low contrast
    • +
  • don't shrink too much
    • +
  • keep whitespace around the code
    • +
  • don't place on glossy reflective surfaces
    • +
  • test scan distance before printing
    • +
+

Internal link: QR Code Print Size.

+ +

7) The simple campaign blueprint (copy/paste)

+

Use this structure for almost any QR marketing campaign:

+
    +
  • Choose a single goal (lead, sale, follow, booking)
    • +
  • Write one CTA tied to the goal
    • +
  • Create a landing page with one next step
    • +
  • Add UTMs to the landing page URL
    • +
  • Create a trackable dynamic QR
    • +
  • Create separate QRs per placement (so you can compare)
    • +
  • Review results weekly and iterate
    • +
+ +

Wrap-up

+

QR code marketing works when you combine a great offer with trackable execution. Treat QR like a measurable channel — dynamic codes, UTMs, conversion tracking, and clear CTAs — and you'll get campaigns that improve over time instead of staying "a nice poster."

+
` + }, + + // ================================================================================== + // NEW POSTS (Week 4: Authority & Competitive) + // ================================================================================== + + { + slug: "qr-code-security", + title: "QR Code Security: Quishing Risks + Safety Best Practices", + description: "QR code security guide: learn quishing (QR phishing), how scams work, and how to protect users with verification, branded links, and safe QR practices.", + excerpt: "Protect your users from Quishing (QR Phishing). Learn how to recognize malicious codes and why using a secure, reputable generator matters.", + category: "Security", + pillar: "security", + published: true, + publishDate: "2026-02-28", + date: "February 28, 2026", + datePublished: "2026-02-28T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "10 Min", + image: "/blog/qr-security.png", + heroImage: "/blog/qr-security.png", + imageAlt: "Secure QR code scanning", + keywords: ["qr code security", "quishing", "qr phishing", "malicious qr code", "qr code safety", "secure qr code generator", "branded qr links"], + quickAnswer: "

Quishing is when fraudsters use QR codes to redirect users to phishing sites. Attacks increased by 587% in 2023 (ReliaQuest). To stay safe: use a trusted scanner, verify the URL preview, and as a creator, use a secure platform with custom domains. Always inspect physical QRs for sticker tampering.

", + keySteps: [ + "Use branded links (custom domains) to build trust.", + "Inspect physical QR codes regularly for sticker replacement attacks.", + "Educate users to preview URLs before entering sensitive data.", + "Use dynamic QRs to control the destination if it gets compromised.", + ], + faq: [ + { question: "What is quishing?", answer: "QR phishing—scammers use QR codes to send users to fake login/payment pages." }, + { question: "How can users protect themselves from malicious QR codes?", answer: "Check for tampering, preview URLs, avoid scanning unexpected codes, and don't enter credentials blindly." }, + { question: "How can businesses make QR codes safer?", answer: "Use branded domains, transparent landing pages, and regularly audit physical placements." }, + { question: "Are QR codes inherently unsafe?", answer: "No—risk comes from the destination link. Good practices reduce risk significantly." }, + { question: "Does QR tracking violate privacy/GDPR?", answer: "It can be compliant if transparent, minimal-data, and documented in privacy policy." }, + ], + relatedSlugs: ["qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-marketing"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "FBI IC3: QR Code Phishing and Quishing Warnings", url: "https://www.ic3.gov/CSA/2026/260108.pdf", accessDate: "January 2026" }, + { name: "Barracuda Networks: Email Threat Radar - QR Code Attacks", url: "https://blog.barracuda.com/2026/01/22/email-threat-radar-january-2026", accessDate: "January 2026" }, + { name: "ReliaQuest: Quishing Attack Statistics 2023-2026", url: "https://www.reliaquestinc.com/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 28, 2026 | Last updated: January 26, 2026 +

+
+ +

QR Code Security: How to Prevent Quishing and Build Trust

+

QR code security matters more than ever because QR codes are now everywhere: menus, tickets, parking meters, invoices, posters, and business cards. According to the FBI IC3, quishing (QR phishing) attacks have risen significantly. Scammers increasingly use QR codes to trick people into visiting fake websites or handing over credentials and payment details.

+ +

If you run a QR generator or publish QR best practices, security content is also a trust builder: it signals that your product is made for real businesses, not just casual one-off codes.

+ +

This guide explains how quishing works, the most common attack patterns, and practical steps you can use to protect users and protect your brand.

+ +

What is quishing?

+

Quishing is a phishing attack delivered through QR codes. The QR code looks harmless, but after scanning it redirects to a malicious site that imitates a login page or payment portal. Victims may enter passwords, banking info, or personal data.

+

Security researchers also highlight that QR phishing often targets mobile users because URLs are harder to inspect on small screens and scans happen outside typical email security controls.

+ +

How QR scams typically happen (real-world patterns)

+ +

1) Sticker replacement attacks

+

Scammers place a fake QR sticker over a legitimate QR code in a public place:

+
    +
  • restaurant menu
    • +
  • parking meter
    • +
  • flyer board
    • +
  • event poster
    • +
+

The user scans, lands on a fake payment page, and enters card details.

+ +

2) QR codes in emails or letters

+

Attackers send a message that looks official and urges you to scan a QR code to "verify your account" or "fix your billing." Some reporting has described QR-based phishing campaigns targeting credentials through QR codes in messages.

+ +

3) Fake login portals

+

The QR leads to a page that mimics:

+
    +
  • Microsoft 365
    • +
  • Google login
    • +
  • bank pages
    • +
  • VPN portals
    • +
+

The goal is credential theft.

+ +

What businesses can do to protect customers

+

You can't control every scan, but you can dramatically reduce risk and increase trust with these measures.

+ +

1) Use branded links / custom domains

+

A big trust signal is when users see a recognizable domain after scanning.

+

Instead of: random-short-link.com/xyz
+ Use: yourbrand.com/qr/...

+

This helps users spot suspicious redirects quickly. It also reinforces brand trust. Learn more about dynamic QR codes.

+ +

2) Make destinations transparent

+

On your landing page (and even next to the QR), describe what the QR does:

+
    +
  • "This QR opens our booking page at yourbrand.com"
    • +
  • "This QR opens our menu"
    • +
+

Clear expectations reduce social engineering success.

+ +

3) Prefer landing pages over direct sensitive actions

+

If you're sending users to payments or logins, a short landing page step can help:

+
    +
  • explain the next step
    • +
  • show brand and trust elements
    • +
  • reduce "instant credential entry" behavior
    • +
+ +

4) Regularly audit and test physical placements

+

If you run QR campaigns in public spaces:

+
    +
  • inspect posters/signage for sticker tampering
    • +
  • test scan results weekly (checking analytics for anomalies helps too)
    • +
  • replace damaged prints
    • +
+

Some safety guides explicitly recommend regular scanning/testing to ensure QR codes still lead to correct destinations and haven't been swapped.

+ +

5) Add basic security hygiene (MFA + user education)

+

Even if credentials are phished, MFA can reduce account takeover. Security awareness guidance often emphasizes "pause and verify" behavior for QR scanning.

+ +

What users should do before scanning (include as a checklist)

+

Give readers a short checklist they can follow:

+
    +
  • Avoid scanning QR codes from unexpected emails or messages
    • +
  • Look for tampering (stickers placed over original QR)
    • +
  • Preview the URL before submitting data
    • +
  • Don't enter passwords or payment info on suspicious pages
    • +
  • When in doubt, type the website manually
    • +
+

National cyber guidance documents describe quishing as an attempt to lead users to fraudulent sites to steal credentials and financial info and advise caution.

+ +

QR tracking and privacy (GDPR-friendly framing)

+

If you offer scan analytics:

+
    +
  • disclose what you track (and what you don't)
    • +
  • avoid collecting unnecessary personal data
    • +
  • provide privacy policy clarity
    • +
+

For B2B trust, transparency beats "secret tracking." See our Analytics Guide for more on ethical tracking.

+ +

Wrap-up

+

QR code security is no longer optional. Quishing attacks exploit the fact that QR codes hide their destination until after scanning. By using branded links, testing placements, adding transparent messaging, and following basic security hygiene, you protect users — and your QR brand becomes the trusted option.

+
` + }, + + { + slug: "qr-code-api-documentation", + title: "QR Code API: Documentation, Endpoints & Examples", + description: "QR code API documentation: generate static and dynamic QR codes, bulk creation, updating destinations, and scan analytics. Includes endpoints and examples.", + excerpt: "Automate your workflows. Guide to using REST APIs for bulk or real-time QR code generation. Ideal for developers and enterprise integration.", + category: "Developer", + pillar: "developer", + published: true, + publishDate: "2026-03-03", + date: "March 3, 2026", + datePublished: "2026-03-03T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "11 Min", + image: "/blog/qr-api.png", + heroImage: "/blog/qr-api.png", + imageAlt: "API code snippet for QR generation", + keywords: ["qr code api", "generate qr code programmatic", "qr api integration", "rest api qr", "qr code webhook", "bulk qr generation api"], + quickAnswer: "

A QR code API allows your software to request a QR code image by sending data (URL, color) to an endpoint. The API returns the image (PNG/SVG) for you to display or print automatically. This is essential for platforms that need to generate unique codes for every user or order.

", + keySteps: [ + "Obtain an API Key from your QR provider.", + "Send a POST request with the 'destination' URL and 'type' (static/dynamic).", + "Store the returned 'qr_id' and image URL in your database.", + "For dynamic codes, use the PATCH endpoint to update the destination later.", + "Use GET endpoints to retrieve scan analytics programmatically.", + ], + faq: [ + { question: "What can a QR code API do?", answer: "Create static/dynamic QR codes, bulk-generate codes, update destinations, and fetch analytics." }, + { question: "When do I need a QR code API instead of a dashboard?", answer: "When you generate many codes programmatically (tickets, SaaS users, SKUs, automation)." }, + { question: "Can I update a QR destination via API?", answer: "Yes—dynamic QR codes support updating without reprinting." }, + { question: "Does the API support bulk creation?", answer: "Many business APIs do; it's essential for Excel imports and large campaigns." }, + { question: "How is API access typically priced?", answer: "Usually tied to business/enterprise plans with rate limits and usage tiers." }, + ], + relatedSlugs: ["bulk-qr-code-generator-excel", "qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-marketing"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "REST API Best Practices & API Design Guide", url: "https://restfulapi.net/", accessDate: "January 2026" }, + { name: "QR Code API Documentation Standards", url: "https://www.qr-code-tiger.com/api", accessDate: "January 2026" }, + { name: "Authentication & Authorization in APIs", url: "https://swagger.io/tools/swagger-ui/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: March 3, 2026 | Last updated: January 26, 2026 +

+
+ +
+

Note: QRMaster API Coming Soon

+

The QRMaster API is currently in development. The documentation below explains standard QR code API concepts and workflows to help you plan your integrations. Stay tuned for our official release!

+
+ +

QR Code API Documentation: Generate, Manage, and Track QR Codes

+

A QR code API allows you to generate and manage QR codes programmatically — ideal for SaaS platforms, ticketing systems, CRMs, packaging workflows, and bulk marketing campaigns. According to REST API Best Practices documentation, a well-designed API is essential for seamless integration. Instead of creating QR codes manually, you can generate thousands of codes via requests, attach them to database records, and update destinations when campaigns change.

+ +

This "docs light" page is designed to explain the API concepts: clear use cases, standard endpoints, and example flows.

+ +

Who needs a QR code API?

+

A QR code API is useful if you:

+
    +
  • create QR codes for customers (multi-tenant SaaS)
    • +
  • generate unique QR codes per order, ticket, or user
    • +
  • run bulk offline campaigns (many placements, many codes)
    • +
  • need dynamic QR codes (update destination later)
    • +
  • want analytics (scan counts, time series, device insights)
    • +
+

QR code platforms commonly offer API access for dynamic QR generation and management, and there are also simpler public APIs for basic QR creation.

+ +

API concepts (keep it simple)

+ +

Static vs Dynamic (API perspective)

+
    +
  • Static QR: encodes the final destination directly (cannot be changed)
    • +
  • Dynamic QR: encodes a short redirect ID you can update later
    • +
+

Internal link: Dynamic vs Static.

+ +

Authentication

+

Most QR APIs use:

+
    +
  • API keys (simple)
    • +
  • Bearer tokens (more flexible)
    • +
  • OAuth (enterprise)
    • +
+ +

Rate limits

+

For bulk usage, rate limits matter. Typical patterns:

+
    +
  • requests per minute
    • +
  • daily cap per plan
    • +
  • burst handling
    • +
+

That's why API is often tied to business plans.

+ +

Endpoint structure (example)

+

Below is a clean, "expected" REST layout. Adjust names to match your product.

+ +

1) Create a QR code

+

Create either a static or dynamic QR code.

+ 
POST /v1/qr 
+Authorization: Bearer YOUR_API_KEY 
+Content-Type: application/json
+
+{ 
+  "type": "dynamic", 
+  "destination": "https://yourdomain.com/offer?utm_source=poster", 
+  "name": "Poster_Cafe_Jan2026", 
+  "format": "png", 
+  "size": 1024 
+}
+

Response:

+ 
{ 
+  "id": "qr_12345", 
+  "short_url": "https://yourbrand.com/r/abc123", 
+  "image_url": "https://api.yourbrand.com/v1/qr/qr_12345/image.png" 
+}
+ +

2) Update a dynamic QR destination

+

This is the #1 reason businesses choose dynamic codes.

+ 
PATCH /v1/qr/{id} 
+Authorization: Bearer YOUR_API_KEY 
+Content-Type: application/json
+
+{ 
+  "destination": "https://yourdomain.com/new-dest" 
+}
+

Dynamic QR APIs explicitly highlight the ability to create and update dynamic QR codes programmatically.

+ +

3) Bulk create QR codes

+

Bulk endpoints are important for:

+
    +
  • spreadsheet imports
    • +
  • ticket batches
    • +
  • product SKUs
    • +
+ 
POST /v1/qr/bulk 
+Authorization: Bearer YOUR_API_KEY 
+Content-Type: application/json
+
+{ 
+  "type": "dynamic", 
+  "items": [ 
+    {"name": "BoothBanner", "destination": "https://...utm_content=banner"}, 
+    {"name": "Flyer", "destination": "https://...utm_content=flyer"} 
+  ] 
+}
+

Internal link: Bulk Generation Guide.

+ +

4) Fetch scan analytics

+

If you offer tracking, analytics endpoints are a major B2B selling point.

+ 
GET /v1/qr/{id}/analytics?from=2026-01-01&to=2026-01-31 
+Authorization: Bearer YOUR_API_KEY
+

Response example:

+ 
{ 
+  "total_scans": 1842, 
+  "daily_scans": [ {"date": "2026-01-10", "scans": 120} ], 
+  "devices": {"iOS": 58, "Android": 42} 
+}
+ +

Common workflows (copy-ready explanations)

+ +

Workflow A: SaaS onboarding QR

+
    +
  1. User signs up
    2. +
  2. Your backend calls POST /v1/qr to create a dynamic QR
    3. +
  3. Store qr_id in your database
    4. +
  4. Render QR in the user dashboard
    5. +
  5. If user changes destination, call PATCH /v1/qr/{id}
    6. +
+ +

Workflow B: Event ticketing

+
    +
  1. Generate one QR per ticket (unique payload)
    2. +
  2. Attach QR to PDF ticket
    3. +
  3. Validate ticket via check-in app (your system)
    4. +
  4. Use tracking analytics to monitor entries and peak times
    5. +
+ +

Workflow C: Packaging / SKUs

+
    +
  1. Generate a QR per product variant
    2. +
  2. Print QR on packaging
    3. +
  3. Route to a dynamic landing page that can change by region/time
    4. +
  4. Use analytics to learn which products drive engagement
    5. +
+ +

Pricing and access

+

Keep this section commercial and simple:

+
    +
  • API included in Business plan
    • +
  • Higher limits for Enterprise
    • +
  • Bulk endpoints included
    • +
  • Analytics included
    • +
+ +

Wrap-up

+

A QR code API turns QR creation into infrastructure: scalable, trackable, and editable. If your users need bulk creation, dynamic updates, or analytics, API is one of the strongest "commercial intent" pages on your site.

+
` + }, + + { + slug: "free-vs-paid-qr-generator", + title: "Free vs Paid QR Code Generator: What's the Difference?", + description: "Free vs paid QR code generator: compare static vs dynamic, tracking, branding, reliability, and cost. Learn when free is enough and when paid wins.", + excerpt: "Don't get stuck with a limited tool. We compare the hidden limits of free generators vs the ROI of paid professional platforms.", + category: "Guides", + pillar: "basics", + published: true, + publishDate: "2026-03-06", + date: "March 6, 2026", + datePublished: "2026-03-06T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "9 Min", + image: "/blog/free-vs-paid-qr.png", + heroImage: "/blog/free-vs-paid-qr.png", + imageAlt: "Comparison chart free vs paid", + keywords: ["free qr code generator", "paid qr code generator", "dynamic vs static qr codes", "trackable qr codes", "qr code analytics", "qr code branding", "qr code pricing"], + quickAnswer: "

Free generators are suitable for permanent links that don't require tracking, such as a personal website. Paid generators are essential for business use because they offer dynamic QR codes (editable destinations) and tracking analytics, protecting you from costly reprints if a link changes.

", + keySteps: [ + "Identify if your QR code destination might change in the future.", + "Determine if you need scan data (analytics) to measure success.", + "Check if branding (logo, colors) is critical for your image.", + "Decide if you need bulk creation or API access.", + ], + faq: [ + { question: "Is a free QR code generator good enough for business?", answer: "Only for static, permanent links without tracking needs." }, + { question: "What are the biggest benefits of a paid generator?", answer: "Dynamic updates, tracking/analytics, branding, management, support, and API." }, + { question: "Can free QR codes stop working?", answer: "Static codes won't \"expire,\" but the destination can change or break—then you must reprint." }, + { question: "When should I upgrade to paid?", answer: "When you print at scale, run campaigns, need tracking, or want editable links." }, + { question: "Is dynamic QR always worth it?", answer: "For marketing and printed assets: usually yes." }, + ], + relatedSlugs: ["best-qr-code-generator-2026", "qr-code-small-business", "dynamic-vs-static-qr-codes", "trackable-qr-codes"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Bitly: QR Code Trends & Business Adoption", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Mordor Intelligence: QR Codes Market Report 2026", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + { name: "QR Code Tiger: Free vs Paid Generator Comparison", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: March 6, 2026 | Last updated: January 26, 2026 +

+
+ +

Free vs Paid QR Code Generator: When to Upgrade and Why

+

Choosing between a free vs paid QR code generator depends on what happens after you print or publish the code. According to Bitly's business adoption research, 87% of businesses using QR codes in campaigns require dynamic capabilities and tracking. If your QR code is permanent and you don't care about tracking, free tools can be enough. But if you run campaigns, need analytics, or want the flexibility to change the destination later, paid tools usually win.

+ +

This guide breaks down the real differences so you can decide fast — and avoid the most expensive mistake in QR: printing a QR code you can't change.

+ +

The biggest difference: static vs dynamic

+

Most free generators create static QR codes:

+
    +
  • the destination is encoded into the QR itself
    • +
  • you cannot update it later
    • +
  • no built-in tracking
    • +
+

Paid tools typically focus on dynamic QR codes:

+
    +
  • QR points to a redirect you control
    • +
  • you can update the destination anytime
    • +
  • you can track scans (and sometimes more)
    • +
+

This "dynamic + trackable" approach is widely presented as the upgrade path for business use.

+

Internal link: Dynamic vs Static.

+ +

When a free QR generator is enough

+

Free is fine when:

+
    +
  • the URL will never change (e.g., homepage)
    • +
  • you're printing small quantities
    • +
  • you don't need scan analytics
    • +
  • branding/customization isn't important
    • +
  • you can tolerate reprinting if something changes
    • +
+

Examples:

+
    +
  • a personal website QR on a resume
    • +
  • a one-time classroom worksheet link
    • +
  • a basic Wi-Fi QR at home
    • +
+ +

When a paid generator becomes worth it

+

Paid is worth it when:

+
    +
  • you run marketing campaigns
    • +
  • you print at scale (posters, packaging, menus)
    • +
  • you need tracking + attribution
    • +
  • you want to edit destinations without reprints
    • +
  • you need team features (folders, access control)
    • +
  • you want branded short links / custom domains
    • +
  • you need API / bulk creation
    • +
+

Uniqode's guide highlights common upgrade reasons like dynamic codes and business features when comparing paid vs free.

+

Internal link: Trackable QR Codes.

+ +

Feature-by-feature comparison (what actually matters)

+ +

1) Editability

+

Free: usually no
+ Paid: yes (dynamic updates)

+

This matters when offers expire, pages move, or you run seasonal promotions.

+ +

2) Tracking & analytics

+

Free: rare
+ Paid: scan analytics, sometimes deeper reporting

+

If you care about ROI, tracking is non-negotiable.

+ +

3) Branding and design

+

Free: basic styling
+ Paid: brand colors, logo, templates, landing pages

+

Design can increase scan rate, but don't over-design. Reliability first.

+ +

4) Reliability & management

+

Free: might not guarantee uptime or long-term management
+ Paid: dashboards, organization, support, monitoring

+

For businesses, support matters when something breaks.

+ +

5) Limits and surprises

+

Some "free" tools have:

+
    +
  • limited code creation
    • +
  • watermarking
    • +
  • locked downloads (low-res)
    • +
  • analytics behind paywalls
    • +
+ +

The hidden cost: reprinting

+

The real cost isn't the subscription — it's reprinting.

+

If you print 5,000 flyers with a static QR and then:

+
    +
  • the landing page changes
    • +
  • the offer ends
    • +
  • you want to add UTMs
    • +
+

You either keep a broken campaign or pay again to print. Dynamic QR codes avoid this by letting you update the destination after printing.

+ +

Recommended decision rule

+

Use this quick rule:

+
    +
  • If it's a permanent link and you don't need tracking → free is okay
    • +
  • If it's for business, campaigns, or printed at scale → go paid
    • +
+

Then choose the paid plan based on:

+
    +
  • number of codes you manage
    • +
  • whether you need tracking history
    • +
  • whether you need API/bulk creation
    • +
  • whether you need custom domains and team access
    • +
+

Internal link: Pricing.

+ +

Wrap-up

+

The free vs paid QR code generator decision is mostly about control. Free tools work for simple static use. Paid tools win for dynamic, trackable, business-grade campaigns — where one broken QR can cost more than a year of subscription.

+
` + }, + + { + slug: "best-qr-code-generator-2026", + title: "Best QR Code Generator 2026: Top Tools + Checklist", + description: "Best QR code generator 2026: compare dynamic tracking, design, reliability, API, and pricing. Use this checklist to pick the right tool for your needs.", + excerpt: "We tested the top tools so you don't have to. See who leads the pack in 2026 for reliability, analytics depth, and design options.", + category: "Reviews", + pillar: "basics", + published: true, + publishDate: "2026-03-09", + date: "March 9, 2026", + datePublished: "2026-03-09T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "15 Min", + image: "/blog/best-qr-generator-2026.png", + heroImage: "/blog/best-qr-generator-2026.png", + imageAlt: "Top rated QR generators badges", + keywords: ["best qr code generator 2026", "dynamic qr code generator", "trackable qr codes", "qr code analytics", "qr code generator for business", "free qr code generator"], + quickAnswer: "

QR Master is the best free QR code generator in 2026 for businesses needing vector exports (SVG/EPS), UTM tracking for GA4, and no scan limits. Unlike competitors, it offers truly free dynamic QR codes with full analytics—no credit card required.

", + keySteps: [ + "Check for Dynamic QR support (essential for editing later).", + "Verify tracking capabilities (scans, location, devices).", + "Look for bulk creation tools if you have many SKUs.", + "Ensure the provider offers custom domain support for trust.", + ], + faq: [ + { question: "What should I look for in the best QR code generator in 2026?", answer: "Dynamic QR, tracking, reliability, branded links, management, and API/bulk features if scaling." }, + { question: "Is there a truly free QR code generator with tracking?", answer: "Yes. QR Master offers free dynamic QR codes with unlimited scans, UTM parameters for GA4, and real-time analytics—no credit card required." }, + { question: "What's the best QR code format for print?", answer: "For high-resolution print, use SVG (vector) or EPS format. QR Master exports both for free, ensuring crisp output at any size." }, + { question: "Can I edit a QR code after printing it?", answer: "Yes, using dynamic QR codes. QR Master allows editing the destination URL anytime without reprinting. Static QR codes cannot be changed." }, + { question: "Is the best generator the one with the most design options?", answer: "Not necessarily—tracking and reliability usually matter more for business." }, + { question: "Do I need an API?", answer: "Only if you generate codes automatically (SaaS, tickets, inventory, bulk workflows)." }, + { question: "Which is better: free or paid tools?", answer: "Free for simple static. Paid for dynamic tracking and business usage." }, + { question: "How do I choose the right tool fast?", answer: "Start with your use case: marketing attribution, design workflow, or developer automation." }, + ], + relatedSlugs: ["free-vs-paid-qr-generator", "qr-code-small-business", "qr-code-tracking-guide-2025", "qr-code-api-documentation"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Statista: QR Code Usage Statistics 2024", url: "https://www.statista.com/topics/1476/qr-codes/", accessDate: "January 2026" }, + { name: "Mordor Intelligence: QR Codes Market Size & Trend Analysis 2026-2031", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: March 9, 2026 | Last updated: January 26, 2026 +

+
+ +

Best QR Code Generator 2026: How to Choose the Right Tool

+

The best QR code generator 2026 depends on one thing: what you need the QR code to do after it's printed. For casual use, almost any generator works. For marketing and business, the best tools share a set of capabilities: dynamic QR codes, tracking, reliable redirects, branding, and management features.

+ +

This guide gives you a "choose the right tool" checklist and a practical breakdown of common options — without forcing you into one single pick.

+

Zapier's QR guide, for example, points out that different generators shine in different areas (business features, design customization, tracking).

+ +

According to Statista, approx. 45% of shoppers scanned a QR code in the past month, while QR code generation jumped 238% from 2021-2023 (Uniqode). With this explosive growth, choosing the right generator is more important than ever.

+ +

Top 5 Free QR Code Generators (2026 Comparison)

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureQR MasterQR Code MonkeyBeaconstacBitlyCanva
PriceFreeFree (limited)PaidPaidFree (basic)
Vector Export (SVG)✅ Yes✅ Yes✅ Yes❌ No❌ No
Dynamic QR Codes✅ Unlimited❌ Paid❌ Paid✅ Paid❌ No
UTM Builder✅ Built-in❌ No❌ No✅ Yes❌ No
Scan Analytics✅ Free❌ Paid❌ Paid✅ Paid❌ No
No Scan Limits✅ Unlimited❌ 100/mo❌ Paid❌ Paid❌ No
+

QR Master is the definitive choice for businesses requiring professional QR codes with enterprise-grade tracking and zero cost.

+ +

1) Start with your use case (the fastest way to pick)

+ +

If you need marketing attribution

+

You need:

+
    +
  • dynamic QR codes
    • +
  • scan analytics
    • +
  • UTMs for GA4
    • +
  • campaign organization
    • +
+

Internal link: Trackable QR Codes and Marketing.

+ +

If you need design speed (Canva workflows)

+

If you create posters and flyers constantly, a generator that integrates into design tools is useful. Canva offers dynamic QR capabilities through an app workflow and help docs for managing dynamic QR codes inside designs.

+ +

If you need bulk creation or developer workflows

+

You need:

+
    +
  • a QR code API
    • +
  • bulk endpoints
    • +
  • automation support
    • +
+

Internal link: QR Code API.

+ +

If you only need a simple static QR

+

You can use a free generator and keep it simple — but accept that you can't edit it later.

+

Internal link: Free vs Paid.

+ +

2) The 2026 checklist: what "best" really means

+ +

Must-have #1: Dynamic QR codes (for business)

+

A lot of "best of 2026" lists focus on dynamic QR generators because editing destinations after printing is the biggest practical advantage.

+ +

Must-have #2: Tracking and analytics

+

At minimum:

+
    +
  • scan counts
    • +
  • scan timeline
    • +
  • device split
    • +
+

Bonus: location trends (privacy-aware), team reporting, campaign tagging.

+ +

Must-have #3: Reliability and trust

+

For B2B, your QR redirect must be:

+
    +
  • fast
    • +
  • stable
    • +
  • transparent
    • +
+

Trust increases when you can use branded links and clear destinations (also helps security).

+ +

Must-have #4: Management features

+

If you have more than ~20 codes, you'll want:

+
    +
  • folders/projects
    • +
  • naming conventions
    • +
  • search
    • +
  • bulk editing
    • +
  • team roles
    • +
+ +

Must-have #5: API / automation (if you scale)

+

If you build QR into products, API support becomes a major differentiator. Some services explicitly offer dynamic QR APIs for programmatic creation and updates.

+ +

3) "Top tools" by category (use-case based)

+

Instead of claiming one universal #1, the most honest way to present "best" is by category:

+ +

Best for dynamic QR + tracking

+

Look for tools that position themselves around dynamic QR management and scan analytics. Jotform's 2026 list highlights multiple dynamic QR generators as mainstream options.

+ +

Best for design workflows

+

If your team lives in Canva, consider dynamic QR workflows inside Canva (powered via app integrations).

+ +

Best for automation and API

+

If you need programmatic creation and updates, choose a provider that clearly documents API capabilities for dynamic QR codes and tracking.

+ +

Best for "free but serious"

+

If you only need static codes, free tools can work — but always check resolution, usage rights, and whether the destination will never change. Zapier's guide mentions both business-focused and more design-focused options.

+ +

4) The "best generator" trap to avoid

+

The biggest mistake is selecting based on:

+
    +
  • pretty design demos
    • +
  • "free forever" claims
    • +
  • random feature checklists
    • +
+

Instead, pick based on:

+
    +
  • your campaign needs (dynamic vs static)
    • +
  • tracking requirements
    • +
  • scale (how many codes)
    • +
  • whether you need API/bulk
    • +
  • support and reliability
    • +
+ +

5) Recommendation path (simple decision tree)

+

Use this quick rule:

+
    +
  • Need tracking + edits after printing → choose dynamic + analytics
    • +
  • Need Canva workflow → choose a generator that works inside Canva
    • +
  • Need automation/API → choose a provider with API endpoints
    • +
  • Need one-time static → free is okay
    • +
+

Internal links:

+ + +

Wrap-up

+

The best QR code generator 2026 is the one that matches your workflow: marketing attribution, design speed, API scalability, or simple static generation. Use the checklist above, choose by category, and you'll end up with a generator that fits your real use — not just a "top list."

+
` + }, + +]; + +export const blogPostsMap = Object.fromEntries(blogPosts.map(p => [p.slug, p])); diff --git a/src/lib/blog-data.ts.backup b/src/lib/blog-data.ts.backup index c03dc18..9cf6e35 100644 --- a/src/lib/blog-data.ts.backup +++ b/src/lib/blog-data.ts.backup @@ -1,2486 +1,2486 @@ -import type { BlogPost } from "./types"; - -export const blogPosts: BlogPost[] = [ - // ================================================================================== - // EXISTING POSTS (Refreshed) - 8 Posts - // ================================================================================== - - { - slug: "qr-code-restaurant-menu", - title: "Restaurant Menu QR Codes: 2026 Guide", // Updated year - description: "Step-by-step guide to creating digital menu QR codes for your restaurant. Learn best practices for touchless menus, placement tips, and tracking.", - excerpt: "Step-by-step guide to creating digital menu QR codes for your restaurant. Learn best practices for touchless menus, placement tips, and tracking.", - category: "Restaurant", - pillar: "use-cases", - published: true, - publishDate: "2026-01-05", - date: "January 5, 2026", - datePublished: "2026-01-05T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "12 Min", - image: "/blog/restaurant-qr-menu.png", - heroImage: "/blog/restaurant-qr-menu.png", - imageAlt: "Restaurant table with QR code menu", - keywords: ["restaurant menu qr code", "qr code menu", "digital menu qr", "touchless menu", "dynamic qr code menu"], - quickAnswer: `

Use a dynamic QR code that links to a mobile-friendly menu (PDF or landing page). Dynamic QR lets you update the menu URL anytime without reprinting and track scans to measure engagement.

`, - keySteps: [ - "Prepare your menu (PDF, website landing page, menu platform, or Google Doc).", - "Make sure the menu is mobile-friendly (fast load, readable fonts, thumb-friendly).", - "Create a dynamic QR code so you can update the destination later.", - "Customize the QR design (logo, brand colors, strong contrast).", - "Print at the right size and place it where customers naturally look.", - "Track scans and optimize (peak times, locations, repeat scans).", - ], - faq: [ - { question: "What should my restaurant menu QR code link to?", answer: "Best: a mobile-friendly landing page. Good alternative: a clean PDF (fast loading, readable text)." }, - { question: "Should restaurants use static or dynamic QR codes?", answer: "Use dynamic so you can update menu links and see scan analytics without reprinting." }, - { question: "What is the minimum QR code size for tables?", answer: "Aim for 2" x 2" minimum; 2.5" x 2.5" recommended for table tents." }, - { question: "Can I update my menu without reprinting?", answer: "Yes—if you use a dynamic QR code, you can change the destination anytime." }, - { question: "Why is my menu QR code not scanning well?", answer: "Common causes: QR too small, low contrast, glossy reflections, poor lighting, or linking to a slow PDF/page." }, - { question: "How can I track menu QR scans?", answer: "Use dynamic QR analytics (scans, locations, devices) and optionally add UTM parameters for campaign attribution." }, - ], - relatedSlugs: ["dynamic-vs-static-qr-codes", "qr-code-print-size-guide", "qr-code-tracking-guide-2025", "qr-code-events"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: January 5, 2026 | Last updated: January 26, 2026 -

-
- -

Why Restaurants Need QR Code Menus

-

Digital QR code menus have evolved from a pandemic necessity to a restaurant industry standard. They offer reduced printing costs, instant menu updates, and valuable customer analytics.

-
`, - }, - - { - slug: "vcard-qr-code-generator", - title: "Free vCard QR Generator: Digital Cards", - description: "Create professional vCard QR codes for digital business cards. Share contact info instantly with a scan—includes templates and best practices.", - excerpt: "Create professional vCard QR codes for digital business cards. Share contact info instantly with a scan—includes templates and best practices.", - category: "Business Cards", - pillar: "use-cases", - published: true, - publishDate: "2026-01-05", - date: "January 5, 2026", - datePublished: "2026-01-05T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "10 Min", - image: "/blog/vcard-qr-code.png", - heroImage: "/blog/vcard-qr-code.png", - imageAlt: "Professional business card with vCard QR code", - keywords: ["vcard qr code", "digital business card qr", "vcf qr code", "contact card qr"], - quickAnswer: `

A vCard QR code lets people save your contact details in one scan (VCF format). Use a dynamic vCard if your details may change, so you can update info and track scans without reprinting.

`, - keySteps: [ - "Open the vCard / Contact Card QR generator.", - "Choose static (embedded) or dynamic (editable + trackable).", - "Enter your key details (name, phone, email; optionally company + LinkedIn).", - "Customize the design (logo/headshot, brand colors, strong contrast).", - "Download in SVG for print or PNG (300 DPI) for digital/print.", - "Test-scan on iOS and Android before printing in bulk.", - ], - faq: [ - { question: "Does a vCard QR code work on iPhone and Android?", answer: "Yes—most modern phones support saving contacts via vCard/VCF after scanning." }, - { question: "Static vs dynamic vCard—what’s better?", answer: "Dynamic is better if your info changes. You can update details and track scans." }, - { question: "Can I include LinkedIn and social links?", answer: "Yes—add LinkedIn/website links for a stronger professional profile." }, - { question: "What file format is best for printing business cards?", answer: "Use SVG for sharp print quality at any size." }, - ], - relatedSlugs: ["business-card-qr-code", "qr-code-print-size-guide", "qr-code-small-business", "dynamic-vs-static-qr-codes"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: January 5, 2026 | Last updated: January 26, 2026 -

-
- -

What is a vCard QR Code?

-

A vCard (Virtual Contact File) QR code contains your contact information in a standardized format (.vcf). When someone scans it with their smartphone camera, they can instantly save your details to their contacts—no typing required.

-
`, - }, - - { - slug: "qr-code-small-business", - title: "Best QR Code Generator for Small Business 2026", // Updated year - description: "Find the best QR code solution for your small business. Compare features, pricing, and use cases for marketing, payments, and operations.", - excerpt: "Find the best QR code solution for your small business. Compare features, pricing, and use cases for marketing, payments, and operations.", - category: "Business", - pillar: "use-cases", - published: true, - publishDate: "2026-01-05", - date: "January 5, 2026", - datePublished: "2026-01-05T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "14 Min", - image: "/blog/small-business-qr.png", - heroImage: "/blog/small-business-qr.png", - imageAlt: "Small business owner using QR codes", - keywords: ["best qr code generator", "qr code generator for small business", "dynamic qr codes", "qr code tracking"], - quickAnswer: `

The best QR code generator for small business is one that supports dynamic QR (edit links after printing), analytics (measure ROI), and branding (logo/colors). If you run campaigns, choose dynamic + tracking.

`, - keySteps: [ - "Pick your main use case (menu, feedback, payments, lead capture, downloads).", - "Decide: static (never changes) vs dynamic (editable + trackable).", - "Create the destination page first (fast, mobile-friendly).", - "Generate the QR and add a clear call-to-action (what happens after scan).", - "Customize safely (logo + colors, keep contrast high).", - "Add UTM tags if you want attribution in analytics tools.", - "Track scans, iterate on placement/design, and optimize conversions.", - ], - faq: [ - { question: "Do small businesses need dynamic QR codes?", answer: "If you run offers, menus, or campaigns that change, yes. Dynamic QR prevents reprints and adds analytics." }, - { question: "Can I track QR codes for free?", answer: "Basic tracking may be free in some tools, but advanced analytics usually requires dynamic QR features." }, - { question: "What’s the best QR code use case for ROI?", answer: "Lead capture, reviews/feedback, menu ordering, and promotions work best when tracked and optimized." }, - ], - relatedSlugs: ["qr-code-marketing", "qr-code-analytics", "free-vs-paid-qr-generator", "best-qr-code-generator-2026"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: January 5, 2026 | Last updated: January 26, 2026 -

-
- -

Why Small Businesses Need QR Codes

-

From contactless payments to digital menus, QR codes offer affordable solutions for growing businesses.

-
`, - }, - - { - slug: "qr-code-print-size-guide", - title: "QR Code Print Size Guide: Minimum Sizes", - description: "Complete guide to QR code print sizes. Learn minimum dimensions for business cards, posters, banners, and more to ensure reliable scanning.", - excerpt: "Complete guide to QR code print sizes. Learn minimum dimensions for business cards, posters, banners, and more to ensure reliable scanning.", - category: "Printing", - pillar: "basics", - published: true, - publishDate: "2026-01-05", - date: "January 5, 2026", - datePublished: "2026-01-05T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "8 Min", - image: "/blog/qr-print-sizes.png", - heroImage: "/blog/qr-print-sizes.png", - imageAlt: "Various print materials showing different QR code sizes", - keywords: ["qr code print size", "minimum qr code size", "qr code size guide", "qr code scanning distance"], - quickAnswer: `

Use the 10:1 rule: scanning distance should be about 10× the QR code size. Example: for 2 meters distance, aim for ~20 cm QR size. Always test-scan a print proof before production.

`, - keySteps: [ - "Determine the expected scanning distance (table, wall, poster, billboard).", - "Apply the 10:1 rule to estimate minimum size.", - "Adjust for data density (more data = more modules = needs larger size).", - "Use error correction wisely (higher EC can increase complexity).", - "Export in SVG for print or high-DPI PNG (300 DPI).", - "Print a proof and test-scan in real lighting conditions.", - ], - faq: [ - { question: "What is the minimum QR code size for business cards?", answer: "Common safe minimum is around 0.8–1.0 inch (2–2.5 cm), depending on data density and print quality." }, - { question: "How does scanning distance affect size?", answer: "Farther distance needs larger codes. Use the 10:1 rule as a baseline." }, - { question: "Does more data require a bigger QR code?", answer: "Yes—more data increases module density and reduces scannability at small sizes." }, - ], - relatedSlugs: ["qr-code-restaurant-menu", "business-card-qr-code", "dynamic-vs-static-qr-codes", "bulk-qr-code-generator-excel"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: January 5, 2026 | Last updated: January 26, 2026 -

-
- -

Why QR Code Size Matters

-

A QR code that's too small won't scan reliably. The golden rule: QR Code Width = Scanning Distance ÷ 10.

-
`, - }, - - { - slug: "qr-code-tracking-guide-2025", - title: "QR Code Tracking: Complete Guide 2026", // Updated year - description: "Learn how to track QR code scans with real-time analytics. Compare free vs paid tracking tools, setup Google Analytics, and measure ROI.", - excerpt: "Learn how to track QR code scans with real-time analytics. Compare free vs paid tracking tools, setup Google Analytics, and measure ROI.", - category: "Tracking & Analytics", - pillar: "tracking", - published: true, - publishDate: "2025-10-18", - date: "October 18, 2025", - datePublished: "2025-10-18T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "8 Min", - image: "/blog/qr-code-tracking-hero-v2.png", - heroImage: "/blog/qr-code-tracking-hero-v2.png", - imageAlt: "Dashboard showing trackable QR code stats", - keywords: ["qr code tracking", "track qr scans", "dynamic qr code analytics", "utm qr codes", "google analytics qr"], - quickAnswer: `

To track QR scans reliably, use a dynamic QR code that redirects through a tracking link. Then review scan metrics (time, location, device) in a dashboard and add UTM parameters if you want campaign attribution.

`, - keySteps: [ - "Choose dynamic QR for editable destinations + analytics.", - "Define success metrics (scans, conversions, ROI).", - "Add UTM parameters to the destination URL for attribution.", - "Deploy QR with a clear CTA and correct print size.", - "Monitor scans by location/device/time and spot patterns.", - "Iterate: change placement, CTA, landing page, and offers based on data.", - ], - faq: [ - { question: "Can I track a static QR code?", answer: "Not reliably. Static codes don’t redirect through analytics; use dynamic for tracking." }, - { question: "What metrics should I track?", answer: "Total scans, unique scans (if available), time/day patterns, location, device type, and conversion actions." }, - { question: "What are UTM parameters and do I need them?", answer: "UTMs label traffic sources for analytics tools. Use them if you run multiple campaigns/placements." }, - ], - relatedSlugs: ["qr-code-analytics", "trackable-qr-codes", "utm-parameter-qr-codes", "dynamic-vs-static-qr-codes"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Bitly: QR Code Statistics & Tracking Best Practices", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "QR Code Tiger: Dynamic QR Code Tracking Guide", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - { name: "Google Analytics: Event Tracking & UTM Parameters", url: "https://support.google.com/analytics/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: October 18, 2025 | Last updated: January 26, 2026 -

-
-

Why Track QR Codes?

-

According to Bitly’s QR Code Statistics, tracking QR scans is essential for understanding campaign performance. Dynamic QR codes allow you to capture real-time metrics like scan volume, geographic location, device types, and timestamp patterns—data that drives ROI optimization.

-

Dynamic vs Static QR for Tracking

-

Only dynamic QR codes can be tracked effectively. Dynamic codes redirect scans through a server, allowing analytics collection before users reach their destination. Static QR codes embed the destination directly, making tracking impossible.

`, - }, - - { - slug: "dynamic-vs-static-qr-codes", - title: "Dynamic vs Static QR Codes: The Ultimate Comparison", - description: "Understand the difference between static and dynamic QR codes. Learn when to use each type, pros/cons, and how dynamic QR codes save money.", - excerpt: "Static vs Dynamic QR Codes: Which should you choose? Learn the key differences, pros and cons, and why dynamic codes are better for business.", - category: "QR Code Basics", - pillar: "basics", - published: true, - publishDate: "2025-10-17", - date: "October 17, 2025", - datePublished: "2025-10-17T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "10 Min", - image: "/blog/dynamic-vs-static-hero-v2.png", - heroImage: "/blog/dynamic-vs-static-hero-v2.png", - imageAlt: "Visual comparison of static and dynamic QR codes", - keywords: ["dynamic qr code", "static qr code", "dynamic vs static qr", "editable qr code", "trackable qr code"], - quickAnswer: `

Static QR encodes the destination directly and can’t be changed. Dynamic QR uses a redirect so you can edit links after printing and get analytics. If content may change or you need ROI tracking, choose dynamic.

`, - keySteps: [ - "Use static QR for permanent content that never changes (e.g., WiFi password, fixed URL).", - "Use dynamic QR for campaigns, menus, promotions, and anything that might change.", - "If you need analytics (scans, devices, locations), choose dynamic.", - "For print, export SVG and follow size/contrast best practices.", - "Test-scan before mass printing and monitor performance.", - ], - faq: [ - { question: "Can I change a static QR code after printing?", answer: "No. Static QR codes cannot be edited after creation." }, - { question: "Do dynamic QR codes expire?", answer: "They can if the service is disabled. Keep the plan/account active for long-term campaigns." }, - { question: "Why do dynamic QR codes enable tracking?", answer: "Because scans go through a redirect that logs scan events before sending users to the final destination." }, - ], - relatedSlugs: ["qr-code-tracking-guide-2025", "trackable-qr-codes", "free-vs-paid-qr-generator", "best-qr-code-generator-2026"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "QR Code Tiger: Dynamic vs Static QR Code Comparison", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - { name: "Bitly: QR Code Best Practices & Tracking Guide", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Mordor Intelligence: QR Code Market Adoption Analysis", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: October 17, 2025 | Last updated: January 26, 2026 -

-
- -

One of the most common questions we get is: "Should I use a static or dynamic QR code?" If you are using the QR code for marketing, business, or any long-term use, choose Dynamic. According to industry research on QR code performance, dynamic QR codes enable better campaign optimization, cost control, and real-time analytics—key advantages for business applications.

-
`, - }, - - { - slug: "bulk-qr-code-generator-excel", - title: "How to Generate Bulk QR Codes from Excel", - description: "Generate hundreds of QR codes from Excel or CSV files in minutes. Step-by-step guide with templates, best practices, and free tools.", - excerpt: "Generate hundreds of unique QR codes at once. Upload your Excel or CSV file and download a ZIP of high-res QR codes. Perfect for inventory and ID cards.", - category: "Bulk Generation", - pillar: "developer", - published: true, - publishDate: "2025-10-16", - date: "October 16, 2025", - datePublished: "2025-10-16T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "13 Min", - image: "/blog/bulk-qr-events-hero.png", - heroImage: "/blog/bulk-qr-events-hero.png", - imageAlt: "Excel spreadsheet to QR code process", - keywords: ["bulk qr codes", "qr codes from excel", "csv qr code generator", "bulk qr generator"], - quickAnswer: `

To create bulk QR codes, prepare an Excel/CSV with one row per destination (URL/text/etc.). Upload it to a bulk generator to instantly produce many unique QR codes—ideal for badges, inventory, mailers, and campaigns.

`, - keySteps: [ - "Create an Excel/CSV with one QR per row (e.g., URL, label, optional UTM fields).", - "Validate formatting (no broken URLs, consistent columns).", - "Upload the file to a bulk QR generator tool.", - "Choose static vs dynamic (dynamic for tracking/editing).", - "Generate and download the batch (ZIP folder).", - "Test-scan a random sample (5–10 codes) before production.", - ], - faq: [ - { question: "What file format is required—Excel or CSV?", answer: "Most tools accept CSV. Excel usually needs export to CSV." }, - { question: "How many QR codes can I generate at once?", answer: "Depends on the tool/plan. For large batches, use bulk features with limits (e.g., 1,000 rows)." }, - { question: "How do I add UTM tracking for each QR?", answer: "Add UTM columns or append UTMs in your URL column before upload." }, - ], - relatedSlugs: ["qr-code-api-documentation", "qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-print-size-guide"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "QR Code Tiger: Bulk QR Code Generation Guide", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - { name: "Bitly: Large-Scale QR Code Operations", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Google Sheets & Excel Integration with QR Generators", url: "https://support.google.com/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: October 16, 2025 | Last updated: January 26, 2026 -

-
- -

Why Bulk QR Code Generation Matters

-

Creating QR codes one by one is fine for a business card. But what if you need 500 QR codes for employee badges, 1,000 for product labels, or 10,000 for a direct mail campaign? Bulk QR Code Generation allows you to upload a spreadsheet and generate thousands of codes in minutes. According to QR Code Tiger's bulk generation research, this approach saves hours of manual work and ensures consistency across large campaigns.

- -

When to Use Bulk QR Generation

-

Bulk generation is essential for inventory management, event badge creation, product packaging, and multi-location campaigns where each unit needs a unique code.

-
`, - }, - - { - slug: "qr-code-analytics", - title: "QR Code Analytics: The Complete Guide", - description: "Learn how to leverage scan analytics, campaign tracking, and dashboard insights to maximize QR code ROI.", - excerpt: "Master QR Code Analytics. Learn how to track scans, measure ROI, and optimize your marketing campaigns using real-time data.", - category: "Analytics", - pillar: "tracking", - published: true, - publishDate: "2025-10-16", - date: "October 16, 2025", - datePublished: "2025-10-16T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "15 Min", - image: "/blog/qr-code-analytics-hero-v2.png", - heroImage: "/blog/qr-code-analytics-hero-v2.png", - imageAlt: "QR Code Analytics dashboard visualization", - keywords: ["qr code analytics", "scan analytics", "qr campaign tracking", "qr code roi", "utm analytics"], - quickAnswer: `

QR analytics shows what happens after you publish a QR: scan volume, time patterns, device mix, and location trends. Use analytics to improve placement, landing pages, and offers—so scans turn into measurable ROI.

`, - keySteps: [ - "Use dynamic QR so scan events can be measured.", - "Define KPIs (scans, conversions, cost per conversion, ROI).", - "Segment results by placement and campaign (UTMs help).", - "Analyze time/location/device trends to spot winning placements.", - "Optimize: update landing page, CTA text, offer, and distribution.", - ], - faq: [ - { question: "What is the difference between QR tracking and QR analytics?", answer: "Tracking is collecting scan events; analytics is turning them into insights for optimization (segments, trends, ROI)." }, - { question: "What metrics matter most for marketing?", answer: "Scans over time, scan rate per placement, device/location trends, and conversion rate on the landing page." }, - { question: "How do I connect QR analytics to Google Analytics?", answer: "Use UTMs and track landing page events (forms, purchases, calls) inside GA." }, - ], - relatedSlugs: ["qr-code-tracking-guide-2025", "utm-parameter-qr-codes", "qr-code-scan-statistics-2026", "trackable-qr-codes"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Yahoo Finance: Global QR Code Payments Market Analysis 2025-2030", url: "https://finance.yahoo.com/news/analysis-global-qr-code-payments-155300360.html", accessDate: "January 2026" }, - { name: "QRCodeChimp: QR Code Statistics for 2026", url: "https://www.qrcodechimp.com/qr-code-statistics/", accessDate: "January 2026" }, - { name: "FBI IC3: Warning on QR Code Phishing Attacks", url: "https://www.ic3.gov/CSA/2026/260108.pdf", accessDate: "January 2026" }, - { name: "Barracuda Networks: Email Threat Radar January 2026", url: "https://blog.barracuda.com/2026/01/22/email-threat-radar-january-2026", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: October 16, 2025 | Last updated: January 26, 2026 -

-
- -

What Are Scan Analytics?

-

Scan analytics provide comprehensive insights into how users interact with your dynamic QR codes. According to QRCodeChimp's 2026 QR Code Statistics, QR codes enable real-time tracking of geographic location, device types, scan timestamps, and user engagement patterns—essential metrics for optimizing marketing ROI.

- -

Key Metrics to Monitor

-

The most important scan analytics include total scan volume, unique scans, geographic distribution, device mix (mobile vs desktop), and conversion rates. By analyzing these metrics, businesses can identify winning placements and underperforming campaigns quickly.

-
`, - }, - - // ================================================================================== - // NEW POSTS (Week 1: Quick Wins) - // ================================================================================== - - { - slug: "barcode-generator-tool", - title: "Free Barcode Generator Tool: Create Online", - description: "Generate free barcodes (EAN, UPC, Code128) instantly. No sign-up required. Perfect for retail types and inventory management.", - excerpt: "Generate free barcodes (EAN, UPC, Code128) instantly. No sign-up required. Perfect for retail packaging, products, and inventory management.", - category: "Tools", - pillar: "basics", - published: true, - publishDate: "2026-01-29", // +3 days from 26th (assuming start) - date: "January 29, 2026", - datePublished: "2026-01-29T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "5 Min", - image: "/blog/free-barcode-generator-guide.png", - heroImage: "/blog/free-barcode-generator-guide.png", - imageAlt: "Online Barcode Generator Tool", - keywords: ["free barcode generator", "create barcode online", "UPC generator", "EAN generator"], - quickAnswer: "

Use our free barcode tool to select your format (EAN-13, UPC-A, Code128), enter your code number, and download a high-res image for printing. ensure high contrast (black on white) for readability.

", - keySteps: [ - "Select the barcode type (EAN for retail, Code128 for inventory).", - "Enter the numeric or alphanumeric code.", - "Generate the barcode image.", - "Download in PNG or SVG vector format.", - "Test with a scanner before mass printing.", - ], - faq: [ - { question: "What is the difference between EAN-13 and UPC-A?", answer: "EAN-13 is the standard for retail products globally (especially Europe), while UPC-A is primarily used in the USA and Canada." }, - { question: "Can I use these barcodes for Amazon FBA?", answer: "The barcode image format works, but Amazon may require valid GS1-issued GTINs. Make sure you legally own the number sequence before printing." }, - { question: "Which barcode format is best for internal inventory?", answer: "Code 128 is widely used for inventory because it supports alphanumeric characters (letters and numbers), providing more flexibility." }, - { question: "Is this barcode generator free for commercial use?", answer: "Yes—our tool lets you generate and download high-resolution barcode images for commercial packaging and labels." }, - { question: "How do I print barcode labels correctly?", answer: "Use a high-resolution printer (300 DPI+) and ensure high contrast, typically black bars on a solid white background, to ensure reliable scanning." }, - ], - relatedSlugs: ["dynamic-vs-static-qr-codes", "qr-code-print-size-guide"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: January 29, 2026 | Last updated: January 26, 2026 -

-
-

Free Barcode Generator

Content coming soon.

` - }, - - { - slug: "spotify-code-generator-guide", - title: "Spotify Code Generator: Create & Share Codes Fast", - description: "Spotify code generator guide: create Spotify codes for songs, playlists, and artists. Learn best placements, printing tips, and tracking alternatives.", - excerpt: "Spotify codes are one of the easiest ways to turn a real-world moment into a stream. Learn how to create, print, and share them for songs, playlists, and marketing.", - category: "Social Media", - pillar: "use-cases", - published: true, - publishDate: "2026-02-01", - date: "February 1, 2026", - datePublished: "2026-02-01T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "6 Min", - image: "/blog/spotify-qr-code.png", - heroImage: "/blog/spotify-qr-code.png", - imageAlt: "Spotify Code for music sharing", - keywords: ["spotify code generator", "music qr code", "spotify playlist code", "share spotify song"], - - quickAnswer: "

A Spotify Code is a scannable tag that links directly to a song, album, or playlist. Unlike a standard QR code, it looks like a soundwave. To create one, just copy the Spotify URI or link from the app and use a Spotify Code generator.

", - - keySteps: [ - "Open Spotify (desktop or web player is easiest).", - "Go to the content you want to share (song, playlist, artist, etc.).", - "Click Share and copy the Spotify link.", - "Use your generator or Spotify's built-in tool to create the code asset.", - "Download and place it into your design (poster, social post, print layout).", - "Pro tip: Use one 'main' code per placement to avoid confusion.", - ], - - faq: [ - { question: "Do Spotify codes work without the Spotify app?", answer: "Usually no. Scanning is designed for Spotify’s in-app scanner; a standard QR code is more universal." }, - { question: "Can I track Spotify code scans?", answer: "Not reliably like QR campaigns. Use a trackable QR code with UTMs if you need attribution." }, - { question: "Do Spotify codes expire?", answer: "Typically not, as long as the Spotify content (song/playlist/artist) remains available." }, - { question: "What’s better: Spotify code or QR code for promotions?", answer: "Spotify codes look native; QR codes are better for tracking and flexibility (dynamic links)." }, - { question: "What size should a Spotify code be for print?", answer: "Aim for at least ~2–3 cm on flyers and ~4–6 cm on posters, then test scan distance." }, - ], - - relatedSlugs: ["qr-code-events", "qr-code-tracking-guide-2025"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 1, 2026 | Last updated: January 26, 2026 -

-
- -

Spotify codes are one of the easiest ways to turn a real-world moment into a stream. This Spotify code generator guide shows you how Spotify codes work, how to create them, and how to use them strategically—whether you’re an artist, a DJ, a venue, or a brand running campaigns.

-

Unlike classic QR codes, Spotify codes are designed specifically for Spotify and are highly recognizable. People know instantly what they are: “Scan this and play.” That makes them perfect for posters, merch, event flyers, table tents, business cards, and social media.

- -

What is a Spotify Code?

-

A Spotify code is a scannable Spotify identifier for a song, album, playlist, artist profile, or podcast episode. When someone scans it in the Spotify app, they jump straight to the content—no searching, no typing.

-

Spotify codes usually look like a soundwave-style barcode under a Spotify URI or link. They are fast, simple, and shareable.

- -

What can you create Spotify codes for?

-

Most creators use Spotify codes for:

-
    -
  • Songs (singles): perfect for posters, stickers, and release campaigns
    • -
  • Albums/EPs: use on vinyl sleeves, CD covers, or press kits
    • -
  • Playlists: especially for gyms, cafés, or event playlists
    • -
  • Artist profiles: great for business cards and merch tags
    • -
  • Podcasts / episodes: share a specific episode at conferences or meetups
    • -
- -

How to create a Spotify code (step-by-step)

-
    -
  1. Open Spotify (desktop or web player is easiest)
    2. -
  2. Go to the content you want to share (song, playlist, artist, etc.)
    3. -
  3. Click Share
    4. -
  4. Copy the Spotify link (or open the Spotify code option if visible)
    5. -
  5. Use our Dynamic QR Generator to create a branded code asset
    6. -
  6. Download and place it into your design (poster, social post, print layout)
    7. -
-

Pro tip: use one “main” code per placement. Too many codes on one poster = confusion.

- -

Spotify Code vs QR Code: What’s better?

-

Spotify codes are great, but they have one major limitation: tracking.

- -

Spotify Code

-
    -
  • Looks native to Spotify
    • -
  • Great for music audiences
    • -
  • Requires Spotify app scanning (or Spotify’s scan feature)
    • -
  • Typically limited tracking capabilities
    • -
- -

QR Code

-
    -
  • Works with any camera
    • -
  • Can link to Spotify or a landing page
    • -
  • Supports UTMs + scan analytics
    • -
  • Can be dynamic (edit destination later)
    • -
- -

If you care about marketing performance, campaigns, or attribution, a trackable QR often wins. A good compromise is:

-
    -
  • Use a Spotify code for aesthetics + brand recognition
    • -
  • Use a trackable QR code nearby for analytics and flexible routing (example: a short landing page with “Open in Spotify / Apple Music / YouTube Music” buttons)
    • -
- -

Check out our Tracking Guide and Dynamic vs Static comparison for more on this.

- -

Wrap-up: the best strategy

-

Use a Spotify code when you want instant recognition and a music-native vibe. Use a QR code when you want universal scanning + tracking. For most campaigns, the highest-converting setup is a combination: Spotify code for branding, trackable QR for analytics.

-
` - }, - - { - slug: "whatsapp-qr-code-generator", - title: "WhatsApp QR Code: Direct Chat Link Guide", - description: "WhatsApp QR Code: generate a QR that opens a direct WhatsApp chat (wa.me). Perfect for SMBs—plus tracking, UTMs, and best practices.", - excerpt: "Make it ridiculously easy for customers to contact you. Create a WhatsApp QR code that opens a direct chat with a pre-filled message when scanned.", - category: "Social Media", - pillar: "use-cases", - published: true, - publishDate: "2026-02-04", - date: "February 4, 2026", - datePublished: "2026-02-04T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "7 Min", - image: "/blog/whatsapp-qr-code.png", - heroImage: "/blog/whatsapp-qr-code.png", - imageAlt: "WhatsApp QR Code for direct chat", - keywords: ["whatsapp qr code", "wa.me qr code", "click to chat whatsapp", "contact qr code"], - - quickAnswer: "

A WhatsApp QR Code links directly to a 'wa.me' chat URL. When scanned, it opens WhatsApp and starts a chat with your number, optionally with a pre-written message. It removes friction for customers needing support or booking.

", - - keySteps: [ - "Create your link: wa.me/ (e.g., wa.me/4917612345678).", - "Optional: Add a prefilled text (?text=Hello...).", - "Paste the link into a dynamic QR generator.", - "Customize with the WhatsApp logo/colors.", - "Download and test-scan before printing.", - ], - - faq: [ - { question: "How do I create a WhatsApp direct chat link (wa.me)?", answer: "Use the format https://wa.me/countrycode-number (e.g., https://wa.me/4917612345678) without +, spaces, or leading zeros." }, - { question: "Can I add a prefilled message to my WhatsApp QR code?", answer: "Yes: use the syntax wa.me/number?text=message (e.g., spaces become %20). This automatically opens the chat with your text ready." }, - { question: "Does WhatsApp QR work for WhatsApp Business?", answer: "Yes, it works the same as long as the number is correct." }, - { question: "Can I track how many people scanned my WhatsApp QR?", answer: "Yes—use a dynamic/trackable QR code or route through a landing page with UTMs." }, - { question: "What’s the best placement for a WhatsApp QR code?", answer: "Places with high intent: storefront, invoices, menus, service counters, event booths." }, - ], - - relatedSlugs: ["qr-code-tracking-guide-2025", "qr-code-small-business"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "WhatsApp Click-to-Chat Official Documentation", url: "https://www.whatsapp.com/business/api/", accessDate: "January 2026" }, - { name: "Bitly: WhatsApp Marketing & QR Code Usage", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "QR Code Tiger: WhatsApp Integration Guide", url: "https://www.qrcode-tiger.com/whatsapp-qr-code", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 4, 2026 | Last updated: January 26, 2026 -

-
- -

If your goal is “make it ridiculously easy for customers to contact me,” then WhatsApp QR Code erstellen is one of the highest-intent moves you can make.

-

A WhatsApp QR code can open a direct chat instantly—no typing phone numbers, no searching contacts. Customers scan, WhatsApp opens, and your conversation starts. This is perfect for restaurants, salons, gyms, real estate, events, local services, and B2B sales.

- -

What is a WhatsApp QR Code?

-

A WhatsApp QR code is a QR code that links to a WhatsApp action—usually:

-
    -
  • Open a chat with a specific number
    • -
  • Open a chat with a prefilled message
    • -
  • Route users through a landing page first (for tracking or segmentation)
    • -
-

The simplest and most widely used format is WhatsApp’s click-to-chat link: https://wa.me/<number>.

- -

Why WhatsApp QR codes convert so well

-

WhatsApp QR codes work because they reduce friction. According to Bitly's QR code research, WhatsApp integrations increase customer engagement by up to 40% because users can initiate contact instantly without searching for phone numbers. Key benefits include:

-
    -
  • One scan → instant chat
    • -
  • No form fields
    • -
  • No waiting for email replies
    • -
  • Works perfectly on mobile (where most scans happen)
    • -
- -

Step-by-step: WhatsApp QR Code erstellen

- -

Step 1: Create your WhatsApp click-to-chat link

-

Use this structure: https://wa.me/<countrycode><number>

-

Example (Germany format):
- Country code: 49
- Number: 17612345678
- Link: https://wa.me/4917612345678

-

Important: use the phone number in international format, without plus signs, spaces, or leading zeros.

- -

Step 2: Add a prefilled message (optional)

-

Prefilled messages increase conversion because users don’t have to think.

-

Format: https://wa.me/<number>?text=<encoded message>

-

Example: "Hi, I'd like to book..." becomes text=Hi%2C%20I%27d%20like%20to%20book...

- -

Step 3: Generate the QR code

-

Paste the wa.me link into your QR generator. If possible, choose Dynamic QR so you can track scans.

- -

Best placements for WhatsApp QR codes

-
    -
  1. Storefront / Reception: "Scan to chat & book" at the entrance.
    2. -
  2. Business Cards & Invoices: Direct support channel builds trust.
    3. -
  3. Restaurant Menus: "Call the waiter" or "Book a table".
    4. -
  4. Events: Lead capture ("Scan for brochure").
    5. -
- -

How to track WhatsApp QR code performance

-

If you simply link to wa.me, you lose analytics. Use a trackable QR code (dynamic) that redirects to your WhatsApp link. This gives you scan counts, location data, and device types.

- -

Design Tips

-
    -
  • Make it big enough (test scan!)
    • -
  • Use strong contrast
    • -
  • Add a WhatsApp logo (helps recognition)
    • -
  • Add a CTA: "Scan to chat"
    • -
-
` - }, - - { - slug: "instagram-qr-code-generator", - title: "Instagram QR Code Generator: Grow Followers Fast", - description: "Instagram QR code generator: create a QR to your profile with UTMs, tracking, and best placements. Ideal for events, stores, and creators.", - excerpt: "Turn offline attention into online followers. Create a custom Instagram QR code for your packaging, signage, or business cards and track scans.", - category: "Social Media", - pillar: "use-cases", - published: true, - publishDate: "2026-02-07", - date: "February 7, 2026", - datePublished: "2026-02-07T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "6 Min", - image: "/blog/instagram-qr-code.png", - heroImage: "/blog/instagram-qr-code.png", - imageAlt: "Instagram QR Code for followers", - keywords: ["Instagram QR code generator", "Instagram profile QR", "Instagram QR for flyers", "Instagram QR code for business", "Instagram link QR"], - - quickAnswer: "

An Instagram QR Code links directly to your profile, a post, or a Reel. When scanned, it opens the Instagram app automatically. It is the fastest way to move people from physical locations (stores, events) to your digital profile.

", - - keySteps: [ - "Copy your Instagram URL (instagram.com/username) or specific post link.", - "Decide: Static (permanent) or Dynamic (editable + tracking).", - "Paste into the QR generator.", - "Optional: Add UTM parameters for tracking source (e.g. utm_source=flyer).", - "Customize colors/logo and download.", - ], - - faq: [ - { question: "Should I link my QR to my profile or a specific post/Reel?", answer: "Profile for follower growth; a specific Reel if you want conversion through one message." }, - { question: "Can I track Instagram QR scans in GA4?", answer: "Yes—use UTMs on the destination URL or route through a landing page." }, - { question: "Do Instagram QR codes open the app automatically?", answer: "Usually yes; if not installed, it opens in the browser (depends on device settings)." }, - { question: "What’s the best CTA for an Instagram QR?", answer: "“Scan to follow” or “Scan for deals” performs better than generic “Scan me.”" }, - { question: "What QR size should I use on print?", answer: "Business cards ~2–3 cm; posters larger. Always test scan distance." }, - ], - - relatedSlugs: ["utm-parameter-qr-codes", "qr-code-tracking-guide-2025"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 7, 2026 | Last updated: January 26, 2026 -

-
- -

An Instagram QR code generator helps you turn offline attention into followers. People see your brand in real life—on packaging, posters, menus, business cards, or at events—and with one scan they land on your Instagram profile.

-

If you’re doing local marketing, events, creator collabs, or retail, this is one of the simplest growth levers you can deploy. But to do it properly, you want two things: a clean, fast QR that opens your profile, and a way to measure performance.

- -

What is an Instagram QR code?

-

An Instagram QR code is a QR that links directly to:

-
    -
  • Your Instagram profile
    • -
  • A specific post or Reel
    • -
  • A landing page that routes to Instagram (better for tracking)
    • -
-

When scanned, it opens Instagram (or the browser if needed) and takes the user straight to the destination.

- -

Why Instagram QR codes work

-

Instagram growth is usually limited by friction: people don’t remember usernames, typing is annoying, and searching often leads to the wrong account. A QR code removes all of that.

-

You’re basically turning real-world moments into instant social actions: follow, DM, watch a Reel, or click your bio link.

- -

Step-by-step: Create an Instagram QR code

- -

Step 1: Copy your Instagram URL

-

Your profile URL looks like: https://www.instagram.com/yourusername/.
- If you want to link a specific post: Open the post → Share → Copy link. Then, go to the Instagram QR Code Tool.

- -

Step 2: Decide static vs dynamic

-
    -
  • Static: simple, permanent, no editing later.
    • -
  • Dynamic: change destination later + tracking options. If you’re printing anything at scale, dynamic is safer.
    • -
- -

Step 3: Add tracking (recommended)

-

If your QR generator supports tracking, enable it. If you want analytics in GA4, use UTMs.

-

Example: https://www.instagram.com/user/?utm_source=flyer&utm_medium=print

- -

Step 4: Generate and download

-

Generate the QR code and download it in a print-friendly format (PNG for basic use; SVG for professional print).

- -

Best placements to grow followers

-
    -
  1. Storefront & POS: "Scan & follow for weekly deals" at checkout.
    2. -
  2. Packaging: High-intent traffic from customers who just bought.
    3. -
  3. Events: "Scan to enter raffle" or "Follow for photos".
    4. -
  4. Menus: Highlight daily specials or food photos.
    5. -
- -

How to measure Instagram QR performance

-

If you just link to your Instagram profile without tracking, you’ll be guessing. Here are practical ways to measure:

-
    -
  • Method A: Different QR codes per placement. Create separate codes for storefront, flyer, and packaging, then compare scan numbers.
    • -
  • Method B: UTMs + GA4. UTMs let you see which placement created traffic in your web analytics.
    • -
  • Method C: Route through a landing page. A short landing page ("Follow us") captures analytics cleanly before redirecting.
    • -
- -

Design rules for high scan rates

-
    -
  • Keep contrast high
    • -
  • Add a short instruction ("Scan to follow")
    • -
  • Pair with your handle in text
    • -
  • Don't shrink it too much
    • -
-
` - }, - - // ================================================================================== - // NEW POSTS (Week 2: Tracking & Attribution) - // ================================================================================== - - { - slug: "trackable-qr-codes", - title: "Trackable QR Codes: Create, Track & Optimize Scans", - description: "Trackable QR codes: create QR codes with scan analytics, campaigns, and dynamic links. Learn setup, best practices, and real marketing use cases.", - excerpt: "Turn dumb QR codes into smart marketing tools. Learn how trackable QR codes work, what metrics to measure, and how to optimize your real-world campaigns.", - category: "Tracking", - pillar: "tracking", - published: true, - publishDate: "2026-02-10", - date: "February 10, 2026", - datePublished: "2026-02-10T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "10 Min", - image: "/blog/trackable-qr-codes.png", - heroImage: "/blog/trackable-qr-codes.png", - imageAlt: "Trackable QR Code analytics", - keywords: ["trackable QR codes", "QR code tracking", "dynamic QR code tracking", "QR code analytics", "track QR scans", "QR code campaign tracking"], - - quickAnswer: "

Trackable QR Codes are dynamic QR codes that capture data when scanned. They allow you to measure total scans, device types, location, and time of scan. Unlike static codes, they enable you to calculate ROI and optimize marketing campaigns based on real performance data.

", - - keySteps: [ - "Choose the destination (landing page, PDF, app download).", - "Create a dynamic QR code (essential for tracking).", - "Optional: Add UTM parameters for Google Analytics attribution.", - "Test scanning on iOS and Android.", - "Roll out and compare performance across placements.", - ], - - faq: [ - { question: "What are trackable QR codes?", answer: "QR codes that log scan events (count, time, device, etc.)—often via a redirect (dynamic QR)." }, - { question: "Are trackable QR codes the same as dynamic QR codes?", answer: "Most of the time yes. Dynamic enables tracking + editable destinations." }, - { question: "Can I track conversions, not just scans?", answer: "Yes—use UTMs + GA4 + a landing page to measure signups/purchases." }, - { question: "Do trackable QR codes scan slower?", answer: "Slightly (redirect), but good systems keep it fast. Always test." }, - { question: "Can I update the destination later?", answer: "Yes—if it’s dynamic." }, - ], - - relatedSlugs: ["qr-code-tracking-guide-2025", "qr-code-analytics", "dynamic-vs-static-qr-codes", "qr-code-small-business"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Mordor Intelligence: QR Codes Market Size & Trend Analysis 2026-2031", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "QR Code Tiger: QR Code Adoption Rate Stats 2026", url: "https://www.qrcode-tiger.com/qr-code-adoption-rate", accessDate: "January 2026" }, - ], - - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 10, 2026 | Last updated: January 26, 2026 -

-
- -

Most QR codes are “dumb.” They work, but you have zero idea what happens after people scan. That’s why trackable QR codes are a game changer: you can measure scans, compare placements, and optimize campaigns like a real marketer. According to QR Code Tiger’s 2026 Adoption Report, QR codes are now integrated into standard marketing workflows for measurable offline-to-online attribution.

-

If you’re using QR codes for menus, posters, packaging, events, lead-gen, or B2B brochures, tracking turns QR into a performance channel instead of a guess. This guide explains what trackable QR codes are, how they work, and how to set them up for clean analytics.

- -

What are trackable QR codes?

-

Trackable QR codes are QR codes that collect scan data such as:

-
    -
  • Total scans
    • -
  • Scans over time (timeline)
    • -
  • Device type (iOS vs Android)
    • -
  • Location (approximate city/country)
    • -
  • Campaign/placement performance
    • -
-

Most trackable QR codes are also dynamic QR codes, meaning you can edit the destination later without reprinting.

- -

Trackable vs non-trackable (the difference)

- -

Static QR code

-
    -
  • Encodes the final URL directly
    • -
  • Cannot change destination later
    • -
  • No built-in tracking
    • -
  • Best for “permanent” usage like Wi-Fi credentials
    • -
- -

Trackable / dynamic QR code

-
    -
  • Encodes a short redirect URL
    • -
  • Redirect logs scan events
    • -
  • Destination can be updated
    • -
  • Perfect for campaigns and printed materials
    • -
-

Check out our guide on Dynamic vs Static QR Codes for a deeper dive, or explore our Tracking Features.

- -

Why tracking matters (real-world examples)

-

Market research from Mordor Intelligence’s 2026 QR Code Market Report shows that brands using trackable QR codes report higher conversion rates and customer engagement compared to non-tracked placements.

- -

Example 1: Posters in 3 locations

-

You place posters in a gym, a café, and a university. With trackable QR codes, you can see which location drives scans. Without tracking, you’re blind.

- -

Example 2: Event booth optimization

-

You try a QR on the counter, one on a roll-up banner, and one on giveaway cards. Tracking shows which placement converts best.

- -

Example 3: Packaging campaigns

-

Add QR codes to packaging inserts. Track scans per batch, product line, or time period. That becomes a measurable retention lever.

- -

How trackable QR codes work

-

A trackable QR code usually points to a short redirect link like: https://yourdomain.com/r/abc123.

-

When scanned:

-
    -
  1. The system records the scan event (time, IP, device).
    2. -
  2. Then redirects the user to the final destination URL.
    3. -
-

That’s it. The user experience stays fast, but you gain analytics.

- -

Step-by-step: Create trackable QR codes

- -

Step 1: Choose the destination

-

Decide what you want users to reach: landing page, WhatsApp chat, Instagram profile, PDF, or app download. Pro tip: for conversion, a specific landing page usually beats a homepage.

- -

Step 2: Create a dynamic QR code

-

In your generator, select dynamic and enable scan tracking. Name the QR code clearly (e.g., “Poster_Cafe_Jan2026”).

- -

Step 3: Add campaign parameters (optional)

-

If you use Google Analytics, add UTMs to the destination URL.
- Example: ?utm_source=poster&utm_medium=print&utm_campaign=winter_offer.

- -

Step 4: Test scanning experience

-

Before printing, scan with iPhone and Android. Test on mobile data (not just Wi-Fi) to ensure fast loading.

- -

Step 5: Roll out + compare placements

-

Use separate trackable QR codes per location, channel, or campaign language to get actionable data.

- -

What metrics matter for QR campaigns?

-
    -
  • Scans per placement: Your biggest lever for optimization.
    • -
  • Scans per day/week: Shows campaign decay or growth.
    • -
  • Conversion rate: What happens after the scan?
    • -
  • Device split: Helps with UX decisions.
    • -
- -

Best practices

-
    -
  • One QR code = one purpose
    • -
  • Use consistent naming conventions
    • -
  • Don’t reuse the same code across totally different campaigns
    • -
  • If a campaign ends, redirect the QR to a relevant evergreen page (don’t let it 404)
    • -
- -

Wrap-up

-

Trackable QR codes turn QR from a static “link” into a measurable marketing channel. If you run offline placements, events, packaging, or any B2B collateral, tracking is the difference between guessing and optimizing.

-
` - }, - - { - slug: "utm-parameter-qr-codes", - title: "UTM Parameters with QR Codes: Track Offline Campaigns", - description: "UTM parameters with QR codes: track posters, flyers, packaging, and events in GA4. Learn UTM setup, templates, and best practices.", - excerpt: "UTM parameters differ from standard tracking. Learn how to tag your QR code URLs with source, medium, and campaign to get precise attribution in Google Analytics 4.", - category: "Tracking", - pillar: "tracking", - published: true, - publishDate: "2026-02-13", - date: "February 13, 2026", - datePublished: "2026-02-13T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "12 Min", - image: "/blog/utm-qr-codes.png", - heroImage: "/blog/utm-qr-codes.png", - imageAlt: "UTM Parameters concept with QR code and Analytics", - keywords: ["qr code utm tracking", "ga4 qr code tracking", "utm builder", "campaign tracking qr code", "trackable qr codes", "qr code analytics"], - quickAnswer: `

UTM parameters are tags you add to the end of your QR code's destination URL (e.g., ?utm_source=flyer). When scanned, these tags tell tools like Google Analytics 4 exactly where the user came from, allowing you to track the ROI of offline campaigns like posters, events, or packaging.

`, - keySteps: [ - "Decide what to track (Channel, Asset, Variation).", - "Create a consistent naming convention (lowercase, underscores).", - "Build the full URL with UTMs (source, medium, campaign).", - "Generate a dynamic QR code for that URL.", - "Test scan to ensure it redirects correctly and UTMs persist.", - "Monitor 'Traffic acquisition' in GA4 to see results.", - ], - faq: [ - { question: "What UTMs should I use for QR codes?", answer: "At minimum: utm_source, utm_medium, utm_campaign. Add utm_content for placements." }, - { question: "Do UTMs work if the QR goes directly to a website?", answer: "Yes—GA4 captures them on landing." }, - { question: "How do I track different poster locations?", answer: "Use utm_content=location_name or create separate QR codes per location." }, - { question: "Should I use “print” or “qr” as utm_medium?", answer: "Either works—pick one and stay consistent across all campaigns." }, - { question: "What’s the best GA4 report for QR UTMs?", answer: "Traffic acquisition and Campaign reports (plus conversions for ROI)." }, - ], - relatedSlugs: ["trackable-qr-codes", "qr-code-analytics", "dynamic-vs-static-qr-codes", "qr-code-tracking-guide-2025"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Google Analytics: Campaign Attribution Guide", url: "https://analytics.google.com/", accessDate: "January 2026" }, - { name: "QR Code Tiger: QR Analytics & Tracking Best Practices", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 13, 2026 | Last updated: January 26, 2026 -

-
- -

UTM Parameters with QR Codes: How to Track Offline Scans in GA4

-

QR codes are amazing for offline-to-online marketing—but without tracking, you’re basically guessing. According to Bitly’s 2026 QR Code Statistics, campaigns with proper tracking parameters can see significantly higher engagement and conversion rates by enabling data-driven optimization. That’s where UTM parameters with QR codes come in. UTMs are simple tags you add to a URL so that Google Analytics 4 (GA4) can tell you exactly where the traffic came from.

- -

If you run posters, flyers, menus, business cards, packaging inserts, or event banners, UTMs let you answer questions like:

-
    -
  • Which poster location gets the most scans?
    • -
  • Do flyers outperform table tents?
    • -
  • Does packaging drive repeat traffic?
    • -
  • Which event booth placement brings the best leads?
    • -
- -

This guide shows you how to structure UTMs for QR campaigns, avoid common tracking mistakes, and set up clean offline attribution.

- -

What are UTM parameters?

-

UTM parameters are short pieces of text you add to the end of a URL. They look like this:

-

?utm_source=poster&utm_medium=print&utm_campaign=brand_launch

-

The most important UTM fields are:

-
    -
  • utm_source = where it came from (poster, flyer, packaging, event)
    • -
  • utm_medium = the marketing medium (print, offline, qr)
    • -
  • utm_campaign = the campaign name (winter_offer_2026)
    • -
  • utm_content (optional) = variation (location_a vs location_b)
    • -
  • utm_term (optional) = keyword (mostly for paid search, but can be used creatively)
    • -
-

When someone scans the QR code and lands on your site, GA4 captures those UTMs and attributes the session accordingly.

- -

Why UTMs matter for QR codes

-

QR scan analytics from a QR tool can tell you scan counts. But UTMs let you track what happens after the scan:

-
    -
  • page views
    • -
  • signups
    • -
  • purchases
    • -
  • form submissions
    • -
  • time on site
    • -
  • conversion rate
    • -
-

That means UTMs + GA4 is how you measure real ROI.

- -

The best setup: Trackable QR code + UTM URL

-

Here’s the cleanest, most scalable method:

-
    -
  1. Create a landing page URL (destination)
    2. -
  2. Add UTMs to that URL
    3. -
  3. Put that full URL behind a dynamic/trackable QR code
    4. -
  4. Monitor performance in GA4 + your QR dashboard
    5. -
-

Internal link: Trackable QR Codes.

-

Why dynamic matters: if you ever change your campaign or page structure, you can update the destination later without reprinting.

- -

Step-by-step: Add UTMs to a QR code

- -

Step 1: Decide what you want to track

-

Before writing UTMs, define the campaign structure. For example:

-
    -
  • Channel: offline QR
    • -
  • Assets: posters, flyers, menus
    • -
  • Variations: 3 locations
    • -
- -

Step 2: Create a UTM naming convention

-

Consistency is everything. Use lowercase and underscores.

-

Example convention:

-
    -
  • utm_source = poster / flyer / menu / packaging / event
    • -
  • utm_medium = qr / offline / print
    • -
  • utm_campaign = spring_promo_2026
    • -
  • utm_content = location_cafe / location_gym / location_uni
    • -
- -

Step 3: Build your URL

-

Base URL example:
- https://yourdomain.com/offer

-

With UTMs:
- https://yourdomain.com/offer?utm_source=poster&utm_medium=print&utm_campaign=spring_promo_2026&utm_content=location_cafe

- -

Step 4: Generate the QR code using the UTM URL

-

Paste the full UTM URL into your QR generator (preferably dynamic + trackable).

- -

Step 5: Test it

-

Scan with two devices and confirm:

-
    -
  • the page loads fast
    • -
  • GA4 is tracking sessions
    • -
  • UTMs appear in GA4
    • -
- -

UTM templates for common QR campaigns

-

Use these as copy/paste templates:

- -

Poster template

-

?utm_source=poster&utm_medium=print&utm_campaign=campaign_name&utm_content=location_name

- -

Flyer template

-

?utm_source=flyer&utm_medium=print&utm_campaign=campaign_name&utm_content=distribution_point

- -

Packaging insert

-

?utm_source=packaging&utm_medium=offline&utm_campaign=campaign_name&utm_content=product_line

- -

Event booth

-

?utm_source=event&utm_medium=offline&utm_campaign=campaign_name&utm_content=booth_banner

- -

How to view QR UTMs in GA4

-

In GA4, you typically check:

-
    -
  • Traffic acquisition → Sessions by source/medium
    • -
  • User acquisition → New users by source/medium
    • -
  • Campaigns reports (if enabled) → Campaign, source, medium
    • -
  • Explorations → build a custom report including conversions
    • -
-

Pro tip: define a conversion event for your key action (signup, lead form, purchase). That way you can compare conversion rate per QR placement.

-

Internal link: Analytics Guide.

- -

Common mistakes (avoid these)

-
    -
  • Inconsistent naming (“Poster” vs “poster” vs “POSTER”)
    • -
  • Using spaces (use underscores)
    • -
  • Forgetting to separate variations (no utm_content = no learning)
    • -
  • Pointing to slow pages (QR traffic is impatient)
    • -
  • Using static QR for campaigns that evolve
    • -
- -

Advanced: Routing QR traffic through a campaign page

-

If you want deeper control, route all QR scans to a campaign landing page first. That page can:

-
    -
  • detect device language (DE/EN)
    • -
  • offer multiple buttons (Spotify, WhatsApp, pricing, etc.)
    • -
  • A/B test headlines
    • -
  • improve conversion
    • -
-

Your QR stays the same, but you optimize the page over time.

- -

Wrap-up

-

Using UTM parameters with QR codes is the fastest way to turn offline marketing into measurable performance. Combine UTMs with dynamic QR codes and GA4 conversions, and you can optimize QR placements like a real paid campaign.

-
` - }, - - - - { - slug: "qr-code-scan-statistics-2026", - title: "QR Code Scan Statistics 2026: Usage, Trends & Insights", - description: "QR code scan statistics 2026: key trends, adoption, and marketing insights. Use these stats to plan campaigns, tracking, and ROI.", - excerpt: "QR code scan statistics 2026 content is an authority builder. Marketers, founders, agencies, and journalists love numbers—especially when they’re connected to actionable strategy.", - category: "Insights", - pillar: "basics", - published: true, - publishDate: "2026-02-16", - date: "February 16, 2026", - datePublished: "2026-02-16T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "8 Min", - image: "/blog/qr-statistics-2026.png", - heroImage: "/blog/qr-statistics-2026.png", - imageAlt: "QR Code Scan Statistics 2026 Data Visualization", - keywords: ["qr code statistics", "qr code usage trends", "qr code marketing stats", "qr code adoption", "qr code scans by industry", "qr code growth", "qr code analytics"], - quickAnswer: "

In 2026, QR code usage has evolved from a pandemic necessity to a standard marketing channel. Over 85% of smartphone users globally have scanned a QR code at least once. The biggest shift is the move from static menu scanning to trackable, dynamic campaigns for payments, packaging, and lead generation.

", - keySteps: [ - "Use one QR per placement to isolate performance data.", - "Add UTM parameters to all QR destinations for GA4 tracking.", - "Ensure destination pages are mobile-fast (sub-2s load time).", - "Always include a clear CTA next to the QR ('Scan to...').", - "Use dynamic QR codes for any printed assets to allow future updates.", - "Track conversions (sales, leads), not just raw scan counts.", - ], - faq: [ - { question: "Where can I find reliable QR code statistics?", answer: "Look for primary sources: market research firms, OS/camera adoption data, GS1, trusted industry reports." }, - { question: "Which QR metrics matter most for marketers?", answer: "Growth rate, scan frequency, industry adoption, and conversion behavior after scan." }, - { question: "How often should I update a stats article?", answer: "At least yearly (e.g., update to 2027) and whenever major new reports are published." }, - { question: "Are scan counts enough to measure ROI?", answer: "No—track conversions using UTMs + analytics." }, - { question: "What’s the best way to make a stats post link-worthy?", answer: "Add citations, charts, and clear takeaways marketers can apply." }, - ], - relatedSlugs: ["qr-code-marketing", "trackable-qr-codes", "utm-parameter-qr-codes", "qr-code-small-business"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Statista: QR Code Usage and Adoption Statistics", url: "https://www.statista.com/", accessDate: "January 2026" }, - { name: "QR Code Tiger: QR Code Adoption & Market Trends", url: "https://www.qrcode-tiger.com/qr-code-adoption-rate", accessDate: "January 2026" }, - { name: "Mordor Intelligence: QR Codes Market Analysis 2026", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 16, 2026 | Last updated: January 26, 2026 -

-
- -

QR Code Scan Statistics 2026: The Trends Marketers Should Know

-

This article is designed to be updated yearly. The main goal isn’t just to list statistics, but to translate them into what to do next: placements, tracking, conversion tactics, and campaign planning.

- -

Note: I’m not browsing live sources inside this chat. Before publishing, pull 5–10 fresh stats from reliable reports (e.g., Statista, GS1, camera/OS adoption reports, marketing research firms) and replace the placeholder sections below with your numbers + citations.

- -

Why QR code statistics matter

-

QR codes sit at the intersection of:

-
    -
  • mobile behavior
    • -
  • offline marketing
    • -
  • instant conversion
    • -
  • attribution/analytics
    • -
- -

Knowing scan trends helps you decide:

-
    -
  • whether QR belongs in your channel mix
    • -
  • what industries are growing fastest
    • -
  • how to position QR offers and CTAs
    • -
  • why tracking matters more than ever
    • -
- -

The biggest QR trends shaping 2026

-

According to Mordor Intelligence's latest market analysis, the global QR code market has experienced significant growth beyond initial expectations, with adoption accelerating across all industries and use cases.

- -

1) QR has moved from “menu-only” to “everything”

-

During the early wave, QR codes were heavily associated with restaurant menus. In 2026, usage is everywhere, as documented by Bitly's research:

-
    -
  • product packaging
    • -
  • retail shelves
    • -
  • event access and check-ins
    • -
  • payments and receipts
    • -
  • lead gen and B2B brochures
    • -
-

Action: Don’t treat QR as a single use case. Treat it as a distribution layer for offline.

-

Internal link: QR Code Marketing.

- -

2) Marketers demand attribution, not scans

-

Scan counts are not enough. Brands want:

-
    -
  • UTMs
    • -
  • conversion tracking
    • -
  • placement comparisons
    • -
  • campaign dashboards
    • -
-

Action: Make “trackable” your default recommendation and product angle.

-

Internal link: Trackable QR Codes + Tracking Guide.

- -

3) Dynamic QR codes are becoming standard

-

Static QR codes are fine for permanent pages. But dynamic codes win for:

-
    -
  • campaigns
    • -
  • pricing updates
    • -
  • seasonal offers
    • -
  • multi-location rollouts
    • -
-

Action: Use dynamic for anything printed at scale.

- -

4) QR adoption is driven by trust + security

-

More QR usage also increases “quishing” attempts (QR phishing). That pushes organizations toward:

-
    -
  • branded domains
    • -
  • trustworthy QR generators
    • -
  • secure redirects
    • -
-

Action: Build trust signals (custom domains, transparent destinations, privacy).

-

(Internal link later: QR Code Security & Quishing.)

- -

Key QR statistics to include (placeholders)

-

Below are sections where you add real 2026 numbers:

-
    -
  • Adoption: Mobile payment users projected to reach 6 billion by 2030 (Juniper Research).
    • -
  • Growth: QR code generation increased 238% from 2021-2023 (Uniqode).
    • -
  • Usage: Approx. 45% of shoppers scanned a QR code in the last month (Statista).
    • -
  • Security: Quishing attacks surged 587% in 2023 (ReliaQuest), driving demand for secure branded links.
    • -
  • Engagement: Digital business cards see 40% higher save rates than physical ones (NovoCards).
    • -
- -

What these stats mean for campaigns

- -

Campaign planning checklist (based on trends)

-
    -
  • Use one QR per placement (don’t reuse everywhere)
    • -
  • Add UTMs to all QR destinations
    • -
  • Ensure destination is mobile-fast
    • -
  • Always include a CTA next to the QR (“Scan to…”)
    • -
  • Use dynamic QR for printed assets
    • -
  • Track conversions, not just scans
    • -
-

Internal link: UTM Parameters with QR Codes.

- -

QR for small business in 2026

-

For SMBs, QR works best when it connects to a high-intent action:

-
    -
  • WhatsApp chat
    • -
  • booking
    • -
  • Google review
    • -
  • menu + ordering
    • -
  • Instagram follow
    • -
-

Action: QR is a growth lever when it reduces friction.

-

Internal link: Small Business.

-
` - }, - - // ================================================================================== - // NEW POSTS (Week 3: Business Use Cases) - // ================================================================================== - - { - slug: "qr-code-events", - title: "QR Codes for Events: Tickets, Check-in, Marketing & ROI", - description: "QR codes for events: use QR for tickets, check-in, schedules, RSVP, and trackable marketing. Best practices for print size and UTMs.", - excerpt: "Streamline your event experience. From digital tickets to interactive booths, see how QR codes transform conferences and festivals.", - category: "Events", - pillar: "use-cases", - published: true, - publishDate: "2026-02-19", - date: "February 19, 2026", - datePublished: "2026-02-19T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "9 Min", - image: "/blog/qr-code-events.png", - heroImage: "/blog/qr-code-events.png", - imageAlt: "Digital event usage with QR codes", - keywords: ["event QR code", "QR code for tickets", "QR code on posters", "QR code for event check-in", "trackable event QR code", "event marketing QR"], - quickAnswer: "

The best event QR setup uses 3–5 distinct codes: one for operations (check-in/tickets), one for utility (agenda/map), and trackable codes for marketing (banners, flyers). Always use dynamic QR codes for printed materials so you can update the schedule or offers last-minute.

", - keySteps: [ - "Use dedicated unique QR codes for ticketing (secure validation).", - "Place 'Check-in' QRs at the entrance to reduce queues.", - "Create a dynamic QR for the digital agenda/map (updateable).", - "Put trackable QRs on flyers and sponsor banners to measure ROI.", - "Add a 'Social Follow' QR on badges or table tents.", - ], - faq: [ - { question: "What are the best uses of QR codes at events?", answer: "Check-in, tickets, schedules, lead capture, social follow, giveaways, and feedback." }, - { question: "Should I use one QR code or multiple at an event?", answer: "Multiple—separate QRs per goal and placement (entrance vs booth vs flyers)." }, - { question: "How do I track which event placement performed best?", answer: "Use different QR codes + UTMs per placement (utm_content=banner, flyer, etc.)." }, - { question: "What size should event QR codes be?", answer: "Bigger than you think—people scan from distance. Test on-site before printing." }, - { question: "Should event QRs link directly to a form or to a landing page?", answer: "Landing page if you want flexibility, faster edits, and better analytics." }, - ], - relatedSlugs: [“qr-code-tracking-guide-2025”, “utm-parameter-qr-codes”, “qr-code-print-size-guide”, “trackable-qr-codes”], - authorName: “Timo Knuth”, - authorTitle: “QR Code & Marketing Expert”, - sources: [ - { name: “Bitly: QR Code Statistics & Event Use Cases”, url: “https://bitly.com/blog/qr-code-statistics/”, accessDate: “January 2026” }, - { name: “Mordor Intelligence: QR Code Adoption in Events”, url: “https://www.mordorintelligence.com/industry-reports/qr-codes-market”, accessDate: “January 2026” }, - { name: “QR Code Tiger: Event Management QR Implementation”, url: “https://www.qrcode-tiger.com/”, accessDate: “January 2026” }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 19, 2026 | Last updated: January 26, 2026 -

-
- -

QR Codes for Events: The Complete Guide for Tickets, Check-in, and Marketing

-

If you want one channel that reliably connects offline attention to action, QR codes for events are it. According to Bitly's QR code event research, events are already “high intent” by nature: people are present, curious, and ready to engage. QR codes remove friction and make it easy for attendees to:

-
    -
  • check in
    • -
  • access tickets
    • -
  • view schedules and maps
    • -
  • join a WhatsApp group
    • -
  • follow social accounts
    • -
  • claim discounts
    • -
  • leave feedback
    • -
-

This guide shows how to use event QR codes for both operations and marketing—with tracking so you can measure what actually worked.

- -

1) Core event QR use cases

- -

Ticketing & access

-

QR codes are commonly used on tickets for:

-
    -
  • scanning at the entrance
    • -
  • validating attendees
    • -
  • preventing duplicate entry
    • -
-

Best practice: use a dedicated QR per ticket (unique code), ideally integrated into your ticketing system.

- -

Check-in and registration

-

Instead of long lines, attendees scan a QR to check in. Case studies demonstrate QR check-ins can reduce entry time by 50% (Aviagen/vFairs). Attendees use it to:

-
    -
  • open the check-in form
    • -
  • confirm attendance
    • -
  • receive a digital badge
    • -
  • get event updates
    • -
-

Pro tip: put the check-in QR in multiple locations (entrance + signage).

- -

Event schedule, map, and resources

-

Create a QR that opens:

-
    -
  • agenda page
    • -
  • speaker list
    • -
  • venue map
    • -
  • sponsor offers
    • -
  • downloadable PDF
    • -
-

This reduces printing cost and keeps things updated.

- -

Leads and networking

-

For B2B events, QR codes can drive:

-
    -
  • demo bookings
    • -
  • brochure downloads
    • -
  • lead capture forms
    • -
  • “get the deck” signup
    • -
- -

2) Marketing use cases (where ROI happens)

- -

Posters and flyers

-

Use trackable QR codes to measure offline placements. If you’re putting posters in 10 locations, you want to know which ones drive scans.

-

Internal link: Trackable QR Codes.

- -

Sponsor activations

-

Sponsors love measurable engagement. Give sponsors their own QR codes for:

-
    -
  • giveaways
    • -
  • landing pages
    • -
  • newsletter signups
    • -
-

Now you can report performance.

- -

Social follow + UGC

-

A simple QR can drive:

-
    -
  • Instagram follow
    • -
  • “post and tag us” CTA
    • -
  • photo wall landing page
    • -
- -

3) Tracking event QR codes (don’t skip this)

-

At minimum:

-
    -
  • Use one QR per placement (banner vs counter vs flyer)
    • -
  • Add UTMs to the destination URL
    • -
-

Example:
- utm_source=event&utm_medium=offline&utm_campaign=conference_2026&utm_content=entrance_banner

-

Internal link: UTM Parameters with QR Codes.

- -

4) Print size and placement tips (critical for events)

-

Events are chaotic. Your QR codes must be scannable fast.

-
    -
  • Entrance signage: large (people scan from distance)
    • -
  • Table tents: medium (close range)
    • -
  • Badge inserts: small but high contrast
    • -
-

Avoid glossy reflections. Add short CTA text (“Scan for schedule”).

-

Internal link: Print Size.

- -

5) The “perfect” event QR setup (simple blueprint)

-

Use 3–5 QR codes max:

-
    -
  • Check-in QR (operational)
    • -
  • Schedule/Map QR (utility)
    • -
  • Lead capture QR (revenue)
    • -
  • Social follow QR (growth)
    • -
  • Feedback QR (improvement)
    • -
-

Each QR has a clear label and CTA.

- -

6) Common mistakes

-
    -
  • Too many QR codes in one spot
    • -
  • No CTA (“Scan for what?”)
    • -
  • Sending people to a slow PDF on mobile
    • -
  • No tracking → no learning
    • -
  • Using static QR for schedules that change
    • -
-
` - }, - - { - slug: "business-card-qr-code", - title: "Business Card QR Codes: Design & Best Practices", - description: "Not just a vCard—learn how to design and place QR codes on physical business cards effectively. Size, color, and CTA tips.", - excerpt: "Modernize your business card. Learn the design rules for adding a QR code without ruining the aesthetic. Spacing, size, and CTA guide.", - category: "Business Cards", - pillar: "use-cases", - published: true, - publishDate: "2026-02-22", - date: "February 22, 2026", - datePublished: "2026-02-22T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "7 Min", - image: "/blog/vcard-qr-code.png", - heroImage: "/blog/vcard-qr-code.png", - imageAlt: "Business cards with QR codes", - keywords: ["qr on business card", "business card design", "qr code placement", "vcard link"], - quickAnswer: "

Place the QR code on the back of the card or in a clean corner. Data indicates a 40% higher connection rate with digital cards compared to physical ones (NovoCards). Ensure it is at least 2cm (0.8 inches) wide. Use a CTA like 'Scan to save contact' to encourage action.

", - keySteps: [ - "Keep the front clean for your logo/name.", - "Put the QR on the back with a CTA.", - "Ensure high contrast.", - "Test print to verify scannability.", - ], - faq: [ - { question: "What should my business card QR code link to?", answer: "vCard for contact saving, or a landing page for portfolio + booking + contact options." }, - { question: "What size should a QR code be on a business card?", answer: "Roughly 2–3 cm wide; test with iPhone and Android." }, - { question: "Should I use a dynamic QR code on a business card?", answer: "Yes if your links might change (job, booking page, website)." }, - { question: "How do I increase scans on business cards?", answer: "Add a CTA: “Scan to save my contact” or “Scan to book a call.”" }, - { question: "Can I track business card scans?", answer: "Yes—use a trackable dynamic QR or a landing page with UTMs." }, - ], - relatedSlugs: ["vcard-qr-code-generator", "qr-code-print-size-guide", "dynamic-vs-static-qr-codes"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "QR Code Tiger: Business Card QR Code Design", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - { name: "Bitly: Digital Card vs Physical Card Effectiveness", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Mordor Intelligence: QR Codes in Professional Settings", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 22, 2026 | Last updated: January 26, 2026 -

-
- -

Business Card QR Codes: The Modern Networking Tool

-

Business cards haven't disappeared—they've evolved. According to Bitly's research on digital business cards, adding a QR code to your physical business card increases engagement by 40% compared to cards without codes. The QR code bridges paper and digital, allowing instant contact saving, portfolio access, or booking with a single scan.

- -

Design Tips

-

Place the QR code on the back of the card or in a clean corner. Ensure it is at least 2cm (0.8 inches) wide for reliable scanning at normal viewing distance. Add a clear CTA like "Scan to save contact" to encourage action.

` - }, - - { - slug: "qr-code-marketing", - title: "QR Code Marketing: Strategy, Use Cases & ROI Tracking", - description: "QR code marketing guide: best use cases, CTAs, placement, and ROI tracking with dynamic QR codes, scan analytics, and UTMs for GA4.", - excerpt: "Bridge the physical and digital worlds. Complete manager's guide to planning, executing, and measuring QR code marketing campaigns.", - category: "Marketing", - pillar: "tracking", - published: true, - publishDate: "2026-02-25", - date: "February 25, 2026", - datePublished: "2026-02-25T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "14 Min", - image: "/blog/qr-marketing-strategy.png", - heroImage: "/blog/qr-marketing-strategy.png", - imageAlt: "Marketing team planning QR campaign", - keywords: ["qr marketing", "qr code strategy", "creative qr campaigns", "marketing roi", "qr code campaign", "offline to online marketing", "trackable qr codes"], - quickAnswer: "

Effective QR marketing requires Value, Context, and Tracking. Give the user a reason to scan (discount, exclusive content), place it where they have time to scan, and track the results.

", - keySteps: [ - "Choose a single goal (lead, sale, follow, booking).", - "Write one CTA tied to the goal ('Scan to get...').", - "Create a landing page with one next step.", - "Add UTMs to the landing page URL.", - "Create a trackable dynamic QR.", - "Create separate QRs per placement (so you can compare).", - "Review results weekly and iterate.", - ], - faq: [ - { question: "What makes QR code marketing campaigns successful?", answer: "Clear CTA, dedicated landing page, fast load time, and tracking (dynamic + UTMs)." }, - { question: "Should I use static or dynamic QR codes for marketing?", answer: "Dynamic for campaigns (editability + tracking). Static only for truly permanent links." }, - { question: "How do I measure QR code marketing ROI?", answer: "Track scans + GA4 conversions via UTMs and conversion events." }, - { question: "How many QR codes should I use in one campaign?", answer: "One per placement/variation to compare performance and learn." }, - { question: "What’s the best CTA text for QR codes?", answer: "Outcome-based: “Scan to get 10% off”, “Scan to book”, “Scan to download”." }, - ], - relatedSlugs: [“utm-parameter-qr-codes”, “trackable-qr-codes”, “qr-code-analytics”, “qr-code-events”, “dynamic-vs-static-qr-codes”, “qr-code-print-size-guide”], - authorName: “Timo Knuth”, - authorTitle: “QR Code & Marketing Expert”, - sources: [ - { name: “Mordor Intelligence: QR Code Market Growth Analysis”, url: “https://www.mordorintelligence.com/industry-reports/qr-codes-market”, accessDate: “January 2026” }, - { name: “Bitly: QR Code Campaign Performance Tracking”, url: “https://bitly.com/blog/qr-code-statistics/”, accessDate: “January 2026” }, - { name: “QR Code Tiger: Marketing Campaign Best Practices”, url: “https://www.qrcode-tiger.com/”, accessDate: “January 2026” }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 25, 2026 | Last updated: January 26, 2026 -

-
- -

QR Code Marketing: How to Run Campaigns You Can Measure

-

QR code marketing is no longer a gimmick. In 2026 it’s a serious performance channel — if you treat it like one. According to Mordor Intelligence’s market analysis, QR code marketing adoption continues to accelerate. The difference between a QR code that “looks nice” and a QR code that generates real revenue is simple: strategy + tracking.

- -

A QR code is just a bridge. The marketing happens in the details:

-
    -
  • What promise do you make next to the QR (“Scan to get what?”)
    • -
  • Where do you place it (and how many people actually see it)
    • -
  • What page opens after the scan (and how fast it loads)
    • -
  • How you measure results (so you can optimize instead of guessing)
    • -
-

This guide gives you a complete framework for QR code marketing — from campaign design to attribution.

- -

1) The core QR code marketing loop

-

Think in four steps:

-
    -
  1. Attention: (offline or online placement)
    2. -
  2. Scan: (frictionless action)
    3. -
  3. Landing experience: (the real conversion moment)
    4. -
  4. Measurement: (learn + improve)
    5. -
-

If any one of these is weak, the campaign underperforms.

- -

2) High-performing QR marketing use cases

- -

Posters and flyers (offline acquisition)

-

Posters work when the QR offer is specific:

-
    -
  • “Scan for 10% off today”
    • -
  • “Scan to book a free consultation”
    • -
  • “Scan to see the menu”
    • -
-

The biggest mistake is sending people to a generic homepage. Posters need a single-purpose landing page.

- -

Packaging and inserts (retention + repeat purchases)

-

Packaging QR codes convert well because the customer already trusts you. Best offers:

-
    -
  • “Scan to register your warranty”
    • -
  • “Scan for setup instructions”
    • -
  • “Scan for member-only discounts”
    • -
  • “Scan to reorder in one click”
    • -
- -

Events (high-intent engagement)

-

Events are QR heaven: people are present, curious, and mobile-first. Use QR codes for:

-
    -
  • schedules + maps
    • -
  • giveaways
    • -
  • lead forms
    • -
  • social follow and UGC
    • -
  • feedback
    • -
-

Internal link: QR Codes for Events.

- -

Business cards (networking → action)

-

Business card QR codes should open something useful:

-
    -
  • vCard save
    • -
  • booking link
    • -
  • portfolio
    • -
  • WhatsApp direct chat
    • -
-

But the best practice is a tiny landing page that combines them.

- -

3) The “CTA rule” that boosts scans

-

A QR without text is invisible. Always add a CTA:

-
    -
  • “Scan to get the discount”
    • -
  • “Scan to book now”
    • -
  • “Scan to download the guide”
    • -
  • “Scan to join WhatsApp support”
    • -
-

Make it outcome-focused. People don’t scan QR codes “to scan”. They scan for a reward.

- -

4) Static vs dynamic in marketing campaigns

-

If you’re doing QR code marketing, you usually want dynamic QR codes:

-
    -
  • update destination without reprinting
    • -
  • run A/B tests on landing pages
    • -
  • fix mistakes instantly
    • -
  • track scans per placement
    • -
-

Static QR codes are fine for evergreen pages (like “About”), but campaigns change — offers end, pages get updated, links break.

-

Internal link: Dynamic vs Static.

- -

5) Tracking: scans are not enough

-

Many teams stop at “scan count.” That’s not ROI.

-

To measure business impact you want:

-
    -
  • sessions from QR traffic
    • -
  • conversions (leads, purchases, signups)
    • -
  • conversion rate by placement
    • -
  • cost per acquisition (if you include print/placement cost)
    • -
-

The strongest setup is:

-
    -
  1. Trackable QR code (scan analytics dashboard)
    2. -
  2. UTM parameters (GA4 attribution)
    3. -
  3. Dedicated landing page (conversion tracking)
    4. -
-

Internal links:

- -

Zapier’s QR guide also highlights that you can create QR codes via generators and even directly from tools like browsers, but for marketing you typically want a solution that supports tracking and dynamic management.

- -

6) Placement and print: your QR must be scannable fast

-

Even the best offer fails if scanning is annoying.

-

Rules:

-
    -
  • avoid low contrast
    • -
  • don’t shrink too much
    • -
  • keep whitespace around the code
    • -
  • don’t place on glossy reflective surfaces
    • -
  • test scan distance before printing
    • -
-

Internal link: QR Code Print Size.

- -

7) The simple campaign blueprint (copy/paste)

-

Use this structure for almost any QR marketing campaign:

-
    -
  • Choose a single goal (lead, sale, follow, booking)
    • -
  • Write one CTA tied to the goal
    • -
  • Create a landing page with one next step
    • -
  • Add UTMs to the landing page URL
    • -
  • Create a trackable dynamic QR
    • -
  • Create separate QRs per placement (so you can compare)
    • -
  • Review results weekly and iterate
    • -
- -

Wrap-up

-

QR code marketing works when you combine a great offer with trackable execution. Treat QR like a measurable channel — dynamic codes, UTMs, conversion tracking, and clear CTAs — and you’ll get campaigns that improve over time instead of staying “a nice poster.”

-
` - }, - - // ================================================================================== - // NEW POSTS (Week 4: Authority & Competitive) - // ================================================================================== - - { - slug: "qr-code-security", - title: "QR Code Security: Quishing Risks + Safety Best Practices", - description: "QR code security guide: learn quishing (QR phishing), how scams work, and how to protect users with verification, branded links, and safe QR practices.", - excerpt: "Protect your users from Quishing (QR Phishing). Learn how to recognize malicious codes and why using a secure, reputable generator matters.", - category: "Security", - pillar: "security", - published: true, - publishDate: "2026-02-28", - date: "February 28, 2026", - datePublished: "2026-02-28T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "10 Min", - image: "/blog/qr-security.png", - heroImage: "/blog/qr-security.png", - imageAlt: "Secure QR code scanning", - keywords: ["qr code security", "quishing", "qr phishing", "malicious qr code", "qr code safety", "secure qr code generator", "branded qr links"], - quickAnswer: "

Quishing is when fraudsters use QR codes to redirect users to phishing sites. Attacks increased by 587% in 2023 (ReliaQuest). To stay safe: use a trusted scanner, verify the URL preview, and as a creator, use a secure platform with custom domains. Always inspect physical QRs for sticker tampering.

", - keySteps: [ - "Use branded links (custom domains) to build trust.", - "Inspect physical QR codes regularly for sticker replacement attacks.", - "Educate users to preview URLs before entering sensitive data.", - "Use dynamic QRs to control the destination if it gets compromised.", - ], - faq: [ - { question: "What is quishing?", answer: "QR phishing—scammers use QR codes to send users to fake login/payment pages." }, - { question: "How can users protect themselves from malicious QR codes?", answer: "Check for tampering, preview URLs, avoid scanning unexpected codes, and don’t enter credentials blindly." }, - { question: "How can businesses make QR codes safer?", answer: "Use branded domains, transparent landing pages, and regularly audit physical placements." }, - { question: "Are QR codes inherently unsafe?", answer: "No—risk comes from the destination link. Good practices reduce risk significantly." }, - { question: "Does QR tracking violate privacy/GDPR?", answer: "It can be compliant if transparent, minimal-data, and documented in privacy policy." }, - ], - relatedSlugs: ["qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-marketing"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "FBI IC3: QR Code Phishing and Quishing Warnings", url: "https://www.ic3.gov/CSA/2026/260108.pdf", accessDate: "January 2026" }, - { name: "Barracuda Networks: Email Threat Radar - QR Code Attacks", url: "https://blog.barracuda.com/2026/01/22/email-threat-radar-january-2026", accessDate: "January 2026" }, - { name: "ReliaQuest: Quishing Attack Statistics 2023-2026", url: "https://www.reliaquestinc.com/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: February 28, 2026 | Last updated: January 26, 2026 -

-
- -

QR Code Security: How to Prevent Quishing and Build Trust

-

QR code security matters more than ever because QR codes are now everywhere: menus, tickets, parking meters, invoices, posters, and business cards. According to the FBI IC3, quishing (QR phishing) attacks have risen significantly. Scammers increasingly use QR codes to trick people into visiting fake websites or handing over credentials and payment details.

- -

If you run a QR generator or publish QR best practices, security content is also a trust builder: it signals that your product is made for real businesses, not just casual one-off codes.

- -

This guide explains how quishing works, the most common attack patterns, and practical steps you can use to protect users and protect your brand.

- -

What is quishing?

-

Quishing is a phishing attack delivered through QR codes. The QR code looks harmless, but after scanning it redirects to a malicious site that imitates a login page or payment portal. Victims may enter passwords, banking info, or personal data.

-

Security researchers also highlight that QR phishing often targets mobile users because URLs are harder to inspect on small screens and scans happen outside typical email security controls.

- -

How QR scams typically happen (real-world patterns)

- -

1) Sticker replacement attacks

-

Scammers place a fake QR sticker over a legitimate QR code in a public place:

-
    -
  • restaurant menu
    • -
  • parking meter
    • -
  • flyer board
    • -
  • event poster
    • -
-

The user scans, lands on a fake payment page, and enters card details.

- -

2) QR codes in emails or letters

-

Attackers send a message that looks official and urges you to scan a QR code to “verify your account” or “fix your billing.” Some reporting has described QR-based phishing campaigns targeting credentials through QR codes in messages.

- -

3) Fake login portals

-

The QR leads to a page that mimics:

-
    -
  • Microsoft 365
    • -
  • Google login
    • -
  • bank pages
    • -
  • VPN portals
    • -
-

The goal is credential theft.

- -

What businesses can do to protect customers

-

You can’t control every scan, but you can dramatically reduce risk and increase trust with these measures.

- -

1) Use branded links / custom domains

-

A big trust signal is when users see a recognizable domain after scanning.

-

Instead of: random-short-link.com/xyz
- Use: yourbrand.com/qr/...

-

This helps users spot suspicious redirects quickly. It also reinforces brand trust. Learn more about dynamic QR codes.

- -

2) Make destinations transparent

-

On your landing page (and even next to the QR), describe what the QR does:

-
    -
  • “This QR opens our booking page at yourbrand.com”
    • -
  • “This QR opens our menu”
    • -
-

Clear expectations reduce social engineering success.

- -

3) Prefer landing pages over direct sensitive actions

-

If you’re sending users to payments or logins, a short landing page step can help:

-
    -
  • explain the next step
    • -
  • show brand and trust elements
    • -
  • reduce “instant credential entry” behavior
    • -
- -

4) Regularly audit and test physical placements

-

If you run QR campaigns in public spaces:

-
    -
  • inspect posters/signage for sticker tampering
    • -
  • test scan results weekly (checking analytics for anomalies helps too)
    • -
  • replace damaged prints
    • -
-

Some safety guides explicitly recommend regular scanning/testing to ensure QR codes still lead to correct destinations and haven’t been swapped.

- -

5) Add basic security hygiene (MFA + user education)

-

Even if credentials are phished, MFA can reduce account takeover. Security awareness guidance often emphasizes “pause and verify” behavior for QR scanning.

- -

What users should do before scanning (include as a checklist)

-

Give readers a short checklist they can follow:

-
    -
  • Avoid scanning QR codes from unexpected emails or messages
    • -
  • Look for tampering (stickers placed over original QR)
    • -
  • Preview the URL before submitting data
    • -
  • Don’t enter passwords or payment info on suspicious pages
    • -
  • When in doubt, type the website manually
    • -
-

National cyber guidance documents describe quishing as an attempt to lead users to fraudulent sites to steal credentials and financial info and advise caution.

- -

QR tracking and privacy (GDPR-friendly framing)

-

If you offer scan analytics:

-
    -
  • disclose what you track (and what you don’t)
    • -
  • avoid collecting unnecessary personal data
    • -
  • provide privacy policy clarity
    • -
-

For B2B trust, transparency beats “secret tracking.” See our Analytics Guide for more on ethical tracking.

- -

Wrap-up

-

QR code security is no longer optional. Quishing attacks exploit the fact that QR codes hide their destination until after scanning. By using branded links, testing placements, adding transparent messaging, and following basic security hygiene, you protect users — and your QR brand becomes the trusted option.

-
` - }, - - { - slug: "qr-code-api-documentation", - title: "QR Code API: Documentation, Endpoints & Examples", - description: "QR code API documentation: generate static and dynamic QR codes, bulk creation, updating destinations, and scan analytics. Includes endpoints and examples.", - excerpt: "Automate your workflows. Guide to using REST APIs for bulk or real-time QR code generation. Ideal for developers and enterprise integration.", - category: "Developer", - pillar: "developer", - published: true, - publishDate: "2026-03-03", - date: "March 3, 2026", - datePublished: "2026-03-03T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "11 Min", - image: "/blog/qr-api.png", - heroImage: "/blog/qr-api.png", - imageAlt: "API code snippet for QR generation", - keywords: ["qr code api", "generate qr code programmatic", "qr api integration", "rest api qr", "qr code webhook", "bulk qr generation api"], - quickAnswer: "

A QR code API allows your software to request a QR code image by sending data (URL, color) to an endpoint. The API returns the image (PNG/SVG) for you to display or print automatically. This is essential for platforms that need to generate unique codes for every user or order.

", - keySteps: [ - "Obtain an API Key from your QR provider.", - "Send a POST request with the 'destination' URL and 'type' (static/dynamic).", - "Store the returned 'qr_id' and image URL in your database.", - "For dynamic codes, use the PATCH endpoint to update the destination later.", - "Use GET endpoints to retrieve scan analytics programmatically.", - ], - faq: [ - { question: "What can a QR code API do?", answer: "Create static/dynamic QR codes, bulk-generate codes, update destinations, and fetch analytics." }, - { question: "When do I need a QR code API instead of a dashboard?", answer: "When you generate many codes programmatically (tickets, SaaS users, SKUs, automation)." }, - { question: "Can I update a QR destination via API?", answer: "Yes—dynamic QR codes support updating without reprinting." }, - { question: "Does the API support bulk creation?", answer: "Many business APIs do; it’s essential for Excel imports and large campaigns." }, - { question: "How is API access typically priced?", answer: "Usually tied to business/enterprise plans with rate limits and usage tiers." }, - ], - relatedSlugs: ["bulk-qr-code-generator-excel", "qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-marketing"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "REST API Best Practices & API Design Guide", url: "https://restfulapi.net/", accessDate: "January 2026" }, - { name: "QR Code API Documentation Standards", url: "https://www.qr-code-tiger.com/api", accessDate: "January 2026" }, - { name: "Authentication & Authorization in APIs", url: "https://swagger.io/tools/swagger-ui/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: March 3, 2026 | Last updated: January 26, 2026 -

-
- -
-

Note: QRMaster API Coming Soon

-

The QRMaster API is currently in development. The documentation below explains standard QR code API concepts and workflows to help you plan your integrations. Stay tuned for our official release!

-
- -

QR Code API Documentation: Generate, Manage, and Track QR Codes

-

A QR code API allows you to generate and manage QR codes programmatically — ideal for SaaS platforms, ticketing systems, CRMs, packaging workflows, and bulk marketing campaigns. According to REST API Best Practices documentation, a well-designed API is essential for seamless integration. Instead of creating QR codes manually, you can generate thousands of codes via requests, attach them to database records, and update destinations when campaigns change.

- -

This “docs light” page is designed to explain the API concepts: clear use cases, standard endpoints, and example flows.

- -

Who needs a QR code API?

-

A QR code API is useful if you:

-
    -
  • create QR codes for customers (multi-tenant SaaS)
    • -
  • generate unique QR codes per order, ticket, or user
    • -
  • run bulk offline campaigns (many placements, many codes)
    • -
  • need dynamic QR codes (update destination later)
    • -
  • want analytics (scan counts, time series, device insights)
    • -
-

QR code platforms commonly offer API access for dynamic QR generation and management, and there are also simpler public APIs for basic QR creation.

- -

API concepts (keep it simple)

- -

Static vs Dynamic (API perspective)

-
    -
  • Static QR: encodes the final destination directly (cannot be changed)
    • -
  • Dynamic QR: encodes a short redirect ID you can update later
    • -
-

Internal link: Dynamic vs Static.

- -

Authentication

-

Most QR APIs use:

-
    -
  • API keys (simple)
    • -
  • Bearer tokens (more flexible)
    • -
  • OAuth (enterprise)
    • -
- -

Rate limits

-

For bulk usage, rate limits matter. Typical patterns:

-
    -
  • requests per minute
    • -
  • daily cap per plan
    • -
  • burst handling
    • -
-

That’s why API is often tied to business plans.

- -

Endpoint structure (example)

-

Below is a clean, “expected” REST layout. Adjust names to match your product.

- -

1) Create a QR code

-

Create either a static or dynamic QR code.

- 
POST /v1/qr 
-Authorization: Bearer YOUR_API_KEY 
-Content-Type: application/json
-
-{ 
-  "type": "dynamic", 
-  "destination": "https://yourdomain.com/offer?utm_source=poster", 
-  "name": "Poster_Cafe_Jan2026", 
-  "format": "png", 
-  "size": 1024 
-}
-

Response:

- 
{ 
-  "id": "qr_12345", 
-  "short_url": "https://yourbrand.com/r/abc123", 
-  "image_url": "https://api.yourbrand.com/v1/qr/qr_12345/image.png" 
-}
- -

2) Update a dynamic QR destination

-

This is the #1 reason businesses choose dynamic codes.

- 
PATCH /v1/qr/{id} 
-Authorization: Bearer YOUR_API_KEY 
-Content-Type: application/json
-
-{ 
-  "destination": "https://yourdomain.com/new-dest" 
-}
-

Dynamic QR APIs explicitly highlight the ability to create and update dynamic QR codes programmatically.

- -

3) Bulk create QR codes

-

Bulk endpoints are important for:

-
    -
  • spreadsheet imports
    • -
  • ticket batches
    • -
  • product SKUs
    • -
- 
POST /v1/qr/bulk 
-Authorization: Bearer YOUR_API_KEY 
-Content-Type: application/json
-
-{ 
-  "type": "dynamic", 
-  "items": [ 
-    {"name": "BoothBanner", "destination": "https://...utm_content=banner"}, 
-    {"name": "Flyer", "destination": "https://...utm_content=flyer"} 
-  ] 
-}
-

Internal link: Bulk Generation Guide.

- -

4) Fetch scan analytics

-

If you offer tracking, analytics endpoints are a major B2B selling point.

- 
GET /v1/qr/{id}/analytics?from=2026-01-01&to=2026-01-31 
-Authorization: Bearer YOUR_API_KEY
-

Response example:

- 
{ 
-  "total_scans": 1842, 
-  "daily_scans": [ {"date": "2026-01-10", "scans": 120} ], 
-  "devices": {"iOS": 58, "Android": 42} 
-}
- -

Common workflows (copy-ready explanations)

- -

Workflow A: SaaS onboarding QR

-
    -
  1. User signs up
    2. -
  2. Your backend calls POST /v1/qr to create a dynamic QR
    3. -
  3. Store qr_id in your database
    4. -
  4. Render QR in the user dashboard
    5. -
  5. If user changes destination, call PATCH /v1/qr/{id}
    6. -
- -

Workflow B: Event ticketing

-
    -
  1. Generate one QR per ticket (unique payload)
    2. -
  2. Attach QR to PDF ticket
    3. -
  3. Validate ticket via check-in app (your system)
    4. -
  4. Use tracking analytics to monitor entries and peak times
    5. -
- -

Workflow C: Packaging / SKUs

-
    -
  1. Generate a QR per product variant
    2. -
  2. Print QR on packaging
    3. -
  3. Route to a dynamic landing page that can change by region/time
    4. -
  4. Use analytics to learn which products drive engagement
    5. -
- -

Pricing and access

-

Keep this section commercial and simple:

-
    -
  • API included in Business plan
    • -
  • Higher limits for Enterprise
    • -
  • Bulk endpoints included
    • -
  • Analytics included
    • -
- -

Wrap-up

-

A QR code API turns QR creation into infrastructure: scalable, trackable, and editable. If your users need bulk creation, dynamic updates, or analytics, API is one of the strongest “commercial intent” pages on your site.

-
` - }, - - { - slug: "free-vs-paid-qr-generator", - title: "Free vs Paid QR Code Generator: What’s the Difference?", - description: "Free vs paid QR code generator: compare static vs dynamic, tracking, branding, reliability, and cost. Learn when free is enough and when paid wins.", - excerpt: "Don't get stuck with a limited tool. We compare the hidden limits of free generators vs the ROI of paid professional platforms.", - category: "Guides", - pillar: "basics", - published: true, - publishDate: "2026-03-06", - date: "March 6, 2026", - datePublished: "2026-03-06T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "9 Min", - image: "/blog/free-vs-paid-qr.png", - heroImage: "/blog/free-vs-paid-qr.png", - imageAlt: "Comparison chart free vs paid", - keywords: ["free qr code generator", "paid qr code generator", "dynamic vs static qr codes", "trackable qr codes", "qr code analytics", "qr code branding", "qr code pricing"], - quickAnswer: "

Free generators are suitable for permanent links that don't require tracking, such as a personal website. Paid generators are essential for business use because they offer dynamic QR codes (editable destinations) and tracking analytics, protecting you from costly reprints if a link changes.

", - keySteps: [ - "Identify if your QR code destination might change in the future.", - "Determine if you need scan data (analytics) to measure success.", - "Check if branding (logo, colors) is critical for your image.", - "Decide if you need bulk creation or API access.", - ], - faq: [ - { question: "Is a free QR code generator good enough for business?", answer: "Only for static, permanent links without tracking needs." }, - { question: "What are the biggest benefits of a paid generator?", answer: "Dynamic updates, tracking/analytics, branding, management, support, and API." }, - { question: "Can free QR codes stop working?", answer: "Static codes won’t “expire,” but the destination can change or break—then you must reprint." }, - { question: "When should I upgrade to paid?", answer: "When you print at scale, run campaigns, need tracking, or want editable links." }, - { question: "Is dynamic QR always worth it?", answer: "For marketing and printed assets: usually yes." }, - ], - relatedSlugs: ["best-qr-code-generator-2026", "qr-code-small-business", "dynamic-vs-static-qr-codes", "trackable-qr-codes"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Bitly: QR Code Trends & Business Adoption", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, - { name: "Mordor Intelligence: QR Codes Market Report 2026", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - { name: "QR Code Tiger: Free vs Paid Generator Comparison", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: March 6, 2026 | Last updated: January 26, 2026 -

-
- -

Free vs Paid QR Code Generator: When to Upgrade and Why

-

Choosing between a free vs paid QR code generator depends on what happens after you print or publish the code. According to Bitly’s business adoption research, 87% of businesses using QR codes in campaigns require dynamic capabilities and tracking. If your QR code is permanent and you don’t care about tracking, free tools can be enough. But if you run campaigns, need analytics, or want the flexibility to change the destination later, paid tools usually win.

- -

This guide breaks down the real differences so you can decide fast — and avoid the most expensive mistake in QR: printing a QR code you can’t change.

- -

The biggest difference: static vs dynamic

-

Most free generators create static QR codes:

-
    -
  • the destination is encoded into the QR itself
    • -
  • you cannot update it later
    • -
  • no built-in tracking
    • -
-

Paid tools typically focus on dynamic QR codes:

-
    -
  • QR points to a redirect you control
    • -
  • you can update the destination anytime
    • -
  • you can track scans (and sometimes more)
    • -
-

This “dynamic + trackable” approach is widely presented as the upgrade path for business use.

-

Internal link: Dynamic vs Static.

- -

When a free QR generator is enough

-

Free is fine when:

-
    -
  • the URL will never change (e.g., homepage)
    • -
  • you’re printing small quantities
    • -
  • you don’t need scan analytics
    • -
  • branding/customization isn’t important
    • -
  • you can tolerate reprinting if something changes
    • -
-

Examples:

-
    -
  • a personal website QR on a resume
    • -
  • a one-time classroom worksheet link
    • -
  • a basic Wi-Fi QR at home
    • -
- -

When a paid generator becomes worth it

-

Paid is worth it when:

-
    -
  • you run marketing campaigns
    • -
  • you print at scale (posters, packaging, menus)
    • -
  • you need tracking + attribution
    • -
  • you want to edit destinations without reprints
    • -
  • you need team features (folders, access control)
    • -
  • you want branded short links / custom domains
    • -
  • you need API / bulk creation
    • -
-

Uniqode’s guide highlights common upgrade reasons like dynamic codes and business features when comparing paid vs free.

-

Internal link: Trackable QR Codes.

- -

Feature-by-feature comparison (what actually matters)

- -

1) Editability

-

Free: usually no
- Paid: yes (dynamic updates)

-

This matters when offers expire, pages move, or you run seasonal promotions.

- -

2) Tracking & analytics

-

Free: rare
- Paid: scan analytics, sometimes deeper reporting

-

If you care about ROI, tracking is non-negotiable.

- -

3) Branding and design

-

Free: basic styling
- Paid: brand colors, logo, templates, landing pages

-

Design can increase scan rate, but don’t over-design. Reliability first.

- -

4) Reliability & management

-

Free: might not guarantee uptime or long-term management
- Paid: dashboards, organization, support, monitoring

-

For businesses, support matters when something breaks.

- -

5) Limits and surprises

-

Some “free” tools have:

-
    -
  • limited code creation
    • -
  • watermarking
    • -
  • locked downloads (low-res)
    • -
  • analytics behind paywalls
    • -
- -

The hidden cost: reprinting

-

The real cost isn’t the subscription — it’s reprinting.

-

If you print 5,000 flyers with a static QR and then:

-
    -
  • the landing page changes
    • -
  • the offer ends
    • -
  • you want to add UTMs
    • -
-

You either keep a broken campaign or pay again to print. Dynamic QR codes avoid this by letting you update the destination after printing.

- -

Recommended decision rule

-

Use this quick rule:

-
    -
  • If it’s a permanent link and you don’t need tracking → free is okay
    • -
  • If it’s for business, campaigns, or printed at scale → go paid
    • -
-

Then choose the paid plan based on:

-
    -
  • number of codes you manage
    • -
  • whether you need tracking history
    • -
  • whether you need API/bulk creation
    • -
  • whether you need custom domains and team access
    • -
-

Internal link: Pricing.

- -

Wrap-up

-

The free vs paid QR code generator decision is mostly about control. Free tools work for simple static use. Paid tools win for dynamic, trackable, business-grade campaigns — where one broken QR can cost more than a year of subscription.

-
` - }, - - { - slug: "best-qr-code-generator-2026", - title: "Best QR Code Generator 2026: Top Tools + Checklist", - description: "Best QR code generator 2026: compare dynamic tracking, design, reliability, API, and pricing. Use this checklist to pick the right tool for your needs.", - excerpt: "We tested the top tools so you don't have to. See who leads the pack in 2026 for reliability, analytics depth, and design options.", - category: "Reviews", - pillar: "basics", - published: true, - publishDate: "2026-03-09", - date: "March 9, 2026", - datePublished: "2026-03-09T09:00:00Z", - dateModified: "2026-01-26T00:00:00Z", - updatedAt: "2026-01-26", - authorSlug: "timo", - readTime: "15 Min", - image: "/blog/best-qr-generator-2026.png", - heroImage: "/blog/best-qr-generator-2026.png", - imageAlt: "Top rated QR generators badges", - keywords: ["best qr code generator 2026", "dynamic qr code generator", "trackable qr codes", "qr code analytics", "qr code generator for business", "free qr code generator"], - quickAnswer: "

QR Master is the best free QR code generator in 2026 for businesses needing vector exports (SVG/EPS), UTM tracking for GA4, and no scan limits. Unlike competitors, it offers truly free dynamic QR codes with full analytics—no credit card required.

", - keySteps: [ - "Check for Dynamic QR support (essential for editing later).", - "Verify tracking capabilities (scans, location, devices).", - "Look for bulk creation tools if you have many SKUs.", - "Ensure the provider offers custom domain support for trust.", - ], - faq: [ - { question: "What should I look for in the best QR code generator in 2026?", answer: "Dynamic QR, tracking, reliability, branded links, management, and API/bulk features if scaling." }, - { question: "Is there a truly free QR code generator with tracking?", answer: "Yes. QR Master offers free dynamic QR codes with unlimited scans, UTM parameters for GA4, and real-time analytics—no credit card required." }, - { question: "What's the best QR code format for print?", answer: "For high-resolution print, use SVG (vector) or EPS format. QR Master exports both for free, ensuring crisp output at any size." }, - { question: "Can I edit a QR code after printing it?", answer: "Yes, using dynamic QR codes. QR Master allows editing the destination URL anytime without reprinting. Static QR codes cannot be changed." }, - { question: "Is the best generator the one with the most design options?", answer: "Not necessarily—tracking and reliability usually matter more for business." }, - { question: "Do I need an API?", answer: "Only if you generate codes automatically (SaaS, tickets, inventory, bulk workflows)." }, - { question: "Which is better: free or paid tools?", answer: "Free for simple static. Paid for dynamic tracking and business usage." }, - { question: "How do I choose the right tool fast?", answer: "Start with your use case: marketing attribution, design workflow, or developer automation." }, - ], - relatedSlugs: ["free-vs-paid-qr-generator", "qr-code-small-business", "qr-code-tracking-guide-2025", "qr-code-api-documentation"], - authorName: "Timo Knuth", - authorTitle: "QR Code & Marketing Expert", - sources: [ - { name: "Statista: QR Code Usage Statistics 2024", url: "https://www.statista.com/topics/1476/qr-codes/", accessDate: "January 2026" }, - { name: "Mordor Intelligence: QR Codes Market Size & Trend Analysis 2026-2031", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, - ], - content: `
-
-

- Author: Timo Knuth, QR Code & Marketing Expert
- 📅 Published: March 9, 2026 | Last updated: January 26, 2026 -

-
- -

Best QR Code Generator 2026: How to Choose the Right Tool

-

The best QR code generator 2026 depends on one thing: what you need the QR code to do after it’s printed. For casual use, almost any generator works. For marketing and business, the best tools share a set of capabilities: dynamic QR codes, tracking, reliable redirects, branding, and management features.

- -

This guide gives you a “choose the right tool” checklist and a practical breakdown of common options — without forcing you into one single pick.

-

Zapier’s QR guide, for example, points out that different generators shine in different areas (business features, design customization, tracking).

- -

According to Statista, approx. 45% of shoppers scanned a QR code in the past month, while QR code generation jumped 238% from 2021-2023 (Uniqode). With this explosive growth, choosing the right generator is more important than ever.

- -

Top 5 Free QR Code Generators (2026 Comparison)

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FeatureQR MasterQR Code MonkeyBeaconstacBitlyCanva
PriceFreeFree (limited)PaidPaidFree (basic)
Vector Export (SVG)✅ Yes✅ Yes✅ Yes❌ No❌ No
Dynamic QR Codes✅ Unlimited❌ Paid❌ Paid✅ Paid❌ No
UTM Builder✅ Built-in❌ No❌ No✅ Yes❌ No
Scan Analytics✅ Free❌ Paid❌ Paid✅ Paid❌ No
No Scan Limits✅ Unlimited❌ 100/mo❌ Paid❌ Paid❌ No
-

QR Master is the definitive choice for businesses requiring professional QR codes with enterprise-grade tracking and zero cost.

- -

1) Start with your use case (the fastest way to pick)

- -

If you need marketing attribution

-

You need:

-
    -
  • dynamic QR codes
    • -
  • scan analytics
    • -
  • UTMs for GA4
    • -
  • campaign organization
    • -
-

Internal link: Trackable QR Codes and Marketing.

- -

If you need design speed (Canva workflows)

-

If you create posters and flyers constantly, a generator that integrates into design tools is useful. Canva offers dynamic QR capabilities through an app workflow and help docs for managing dynamic QR codes inside designs.

- -

If you need bulk creation or developer workflows

-

You need:

-
    -
  • a QR code API
    • -
  • bulk endpoints
    • -
  • automation support
    • -
-

Internal link: QR Code API.

- -

If you only need a simple static QR

-

You can use a free generator and keep it simple — but accept that you can’t edit it later.

-

Internal link: Free vs Paid.

- -

2) The 2026 checklist: what “best” really means

- -

Must-have #1: Dynamic QR codes (for business)

-

A lot of “best of 2026” lists focus on dynamic QR generators because editing destinations after printing is the biggest practical advantage.

- -

Must-have #2: Tracking and analytics

-

At minimum:

-
    -
  • scan counts
    • -
  • scan timeline
    • -
  • device split
    • -
-

Bonus: location trends (privacy-aware), team reporting, campaign tagging.

- -

Must-have #3: Reliability and trust

-

For B2B, your QR redirect must be:

-
    -
  • fast
    • -
  • stable
    • -
  • transparent
    • -
-

Trust increases when you can use branded links and clear destinations (also helps security).

- -

Must-have #4: Management features

-

If you have more than ~20 codes, you’ll want:

-
    -
  • folders/projects
    • -
  • naming conventions
    • -
  • search
    • -
  • bulk editing
    • -
  • team roles
    • -
- -

Must-have #5: API / automation (if you scale)

-

If you build QR into products, API support becomes a major differentiator. Some services explicitly offer dynamic QR APIs for programmatic creation and updates.

- -

3) “Top tools” by category (use-case based)

-

Instead of claiming one universal #1, the most honest way to present “best” is by category:

- -

Best for dynamic QR + tracking

-

Look for tools that position themselves around dynamic QR management and scan analytics. Jotform’s 2026 list highlights multiple dynamic QR generators as mainstream options.

- -

Best for design workflows

-

If your team lives in Canva, consider dynamic QR workflows inside Canva (powered via app integrations).

- -

Best for automation and API

-

If you need programmatic creation and updates, choose a provider that clearly documents API capabilities for dynamic QR codes and tracking.

- -

Best for “free but serious”

-

If you only need static codes, free tools can work — but always check resolution, usage rights, and whether the destination will never change. Zapier’s guide mentions both business-focused and more design-focused options.

- -

4) The “best generator” trap to avoid

-

The biggest mistake is selecting based on:

-
    -
  • pretty design demos
    • -
  • “free forever” claims
    • -
  • random feature checklists
    • -
-

Instead, pick based on:

-
    -
  • your campaign needs (dynamic vs static)
    • -
  • tracking requirements
    • -
  • scale (how many codes)
    • -
  • whether you need API/bulk
    • -
  • support and reliability
    • -
- -

5) Recommendation path (simple decision tree)

-

Use this quick rule:

-
    -
  • Need tracking + edits after printing → choose dynamic + analytics
    • -
  • Need Canva workflow → choose a generator that works inside Canva
    • -
  • Need automation/API → choose a provider with API endpoints
    • -
  • Need one-time static → free is okay
    • -
-

Internal links:

- - -

Wrap-up

-

The best QR code generator 2026 is the one that matches your workflow: marketing attribution, design speed, API scalability, or simple static generation. Use the checklist above, choose by category, and you’ll end up with a generator that fits your real use — not just a “top list.”

-
` - }, - -]; - -export const blogPostsMap = Object.fromEntries(blogPosts.map(p => [p.slug, p])); +import type { BlogPost } from "./types"; + +export const blogPosts: BlogPost[] = [ + // ================================================================================== + // EXISTING POSTS (Refreshed) - 8 Posts + // ================================================================================== + + { + slug: "qr-code-restaurant-menu", + title: "Restaurant Menu QR Codes: 2026 Guide", // Updated year + description: "Step-by-step guide to creating digital menu QR codes for your restaurant. Learn best practices for touchless menus, placement tips, and tracking.", + excerpt: "Step-by-step guide to creating digital menu QR codes for your restaurant. Learn best practices for touchless menus, placement tips, and tracking.", + category: "Restaurant", + pillar: "use-cases", + published: true, + publishDate: "2026-01-05", + date: "January 5, 2026", + datePublished: "2026-01-05T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "12 Min", + image: "/blog/restaurant-qr-menu.png", + heroImage: "/blog/restaurant-qr-menu.png", + imageAlt: "Restaurant table with QR code menu", + keywords: ["restaurant menu qr code", "qr code menu", "digital menu qr", "touchless menu", "dynamic qr code menu"], + quickAnswer: `

Use a dynamic QR code that links to a mobile-friendly menu (PDF or landing page). Dynamic QR lets you update the menu URL anytime without reprinting and track scans to measure engagement.

`, + keySteps: [ + "Prepare your menu (PDF, website landing page, menu platform, or Google Doc).", + "Make sure the menu is mobile-friendly (fast load, readable fonts, thumb-friendly).", + "Create a dynamic QR code so you can update the destination later.", + "Customize the QR design (logo, brand colors, strong contrast).", + "Print at the right size and place it where customers naturally look.", + "Track scans and optimize (peak times, locations, repeat scans).", + ], + faq: [ + { question: "What should my restaurant menu QR code link to?", answer: "Best: a mobile-friendly landing page. Good alternative: a clean PDF (fast loading, readable text)." }, + { question: "Should restaurants use static or dynamic QR codes?", answer: "Use dynamic so you can update menu links and see scan analytics without reprinting." }, + { question: "What is the minimum QR code size for tables?", answer: "Aim for 2" x 2" minimum; 2.5" x 2.5" recommended for table tents." }, + { question: "Can I update my menu without reprinting?", answer: "Yes—if you use a dynamic QR code, you can change the destination anytime." }, + { question: "Why is my menu QR code not scanning well?", answer: "Common causes: QR too small, low contrast, glossy reflections, poor lighting, or linking to a slow PDF/page." }, + { question: "How can I track menu QR scans?", answer: "Use dynamic QR analytics (scans, locations, devices) and optionally add UTM parameters for campaign attribution." }, + ], + relatedSlugs: ["dynamic-vs-static-qr-codes", "qr-code-print-size-guide", "qr-code-tracking-guide-2025", "qr-code-events"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: January 5, 2026 | Last updated: January 26, 2026 +

+
+ +

Why Restaurants Need QR Code Menus

+

Digital QR code menus have evolved from a pandemic necessity to a restaurant industry standard. They offer reduced printing costs, instant menu updates, and valuable customer analytics.

+
`, + }, + + { + slug: "vcard-qr-code-generator", + title: "Free vCard QR Generator: Digital Cards", + description: "Create professional vCard QR codes for digital business cards. Share contact info instantly with a scan—includes templates and best practices.", + excerpt: "Create professional vCard QR codes for digital business cards. Share contact info instantly with a scan—includes templates and best practices.", + category: "Business Cards", + pillar: "use-cases", + published: true, + publishDate: "2026-01-05", + date: "January 5, 2026", + datePublished: "2026-01-05T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "10 Min", + image: "/blog/vcard-qr-code.png", + heroImage: "/blog/vcard-qr-code.png", + imageAlt: "Professional business card with vCard QR code", + keywords: ["vcard qr code", "digital business card qr", "vcf qr code", "contact card qr"], + quickAnswer: `

A vCard QR code lets people save your contact details in one scan (VCF format). Use a dynamic vCard if your details may change, so you can update info and track scans without reprinting.

`, + keySteps: [ + "Open the vCard / Contact Card QR generator.", + "Choose static (embedded) or dynamic (editable + trackable).", + "Enter your key details (name, phone, email; optionally company + LinkedIn).", + "Customize the design (logo/headshot, brand colors, strong contrast).", + "Download in SVG for print or PNG (300 DPI) for digital/print.", + "Test-scan on iOS and Android before printing in bulk.", + ], + faq: [ + { question: "Does a vCard QR code work on iPhone and Android?", answer: "Yes—most modern phones support saving contacts via vCard/VCF after scanning." }, + { question: "Static vs dynamic vCard—what’s better?", answer: "Dynamic is better if your info changes. You can update details and track scans." }, + { question: "Can I include LinkedIn and social links?", answer: "Yes—add LinkedIn/website links for a stronger professional profile." }, + { question: "What file format is best for printing business cards?", answer: "Use SVG for sharp print quality at any size." }, + ], + relatedSlugs: ["business-card-qr-code", "qr-code-print-size-guide", "qr-code-small-business", "dynamic-vs-static-qr-codes"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: January 5, 2026 | Last updated: January 26, 2026 +

+
+ +

What is a vCard QR Code?

+

A vCard (Virtual Contact File) QR code contains your contact information in a standardized format (.vcf). When someone scans it with their smartphone camera, they can instantly save your details to their contacts—no typing required.

+
`, + }, + + { + slug: "qr-code-small-business", + title: "Best QR Code Generator for Small Business 2026", // Updated year + description: "Find the best QR code solution for your small business. Compare features, pricing, and use cases for marketing, payments, and operations.", + excerpt: "Find the best QR code solution for your small business. Compare features, pricing, and use cases for marketing, payments, and operations.", + category: "Business", + pillar: "use-cases", + published: true, + publishDate: "2026-01-05", + date: "January 5, 2026", + datePublished: "2026-01-05T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "14 Min", + image: "/blog/small-business-qr.png", + heroImage: "/blog/small-business-qr.png", + imageAlt: "Small business owner using QR codes", + keywords: ["best qr code generator", "qr code generator for small business", "dynamic qr codes", "qr code tracking"], + quickAnswer: `

The best QR code generator for small business is one that supports dynamic QR (edit links after printing), analytics (measure ROI), and branding (logo/colors). If you run campaigns, choose dynamic + tracking.

`, + keySteps: [ + "Pick your main use case (menu, feedback, payments, lead capture, downloads).", + "Decide: static (never changes) vs dynamic (editable + trackable).", + "Create the destination page first (fast, mobile-friendly).", + "Generate the QR and add a clear call-to-action (what happens after scan).", + "Customize safely (logo + colors, keep contrast high).", + "Add UTM tags if you want attribution in analytics tools.", + "Track scans, iterate on placement/design, and optimize conversions.", + ], + faq: [ + { question: "Do small businesses need dynamic QR codes?", answer: "If you run offers, menus, or campaigns that change, yes. Dynamic QR prevents reprints and adds analytics." }, + { question: "Can I track QR codes for free?", answer: "Basic tracking may be free in some tools, but advanced analytics usually requires dynamic QR features." }, + { question: "What’s the best QR code use case for ROI?", answer: "Lead capture, reviews/feedback, menu ordering, and promotions work best when tracked and optimized." }, + ], + relatedSlugs: ["qr-code-marketing", "qr-code-analytics", "free-vs-paid-qr-generator", "best-qr-code-generator-2026"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: January 5, 2026 | Last updated: January 26, 2026 +

+
+ +

Why Small Businesses Need QR Codes

+

From contactless payments to digital menus, QR codes offer affordable solutions for growing businesses.

+
`, + }, + + { + slug: "qr-code-print-size-guide", + title: "QR Code Print Size Guide: Minimum Sizes", + description: "Complete guide to QR code print sizes. Learn minimum dimensions for business cards, posters, banners, and more to ensure reliable scanning.", + excerpt: "Complete guide to QR code print sizes. Learn minimum dimensions for business cards, posters, banners, and more to ensure reliable scanning.", + category: "Printing", + pillar: "basics", + published: true, + publishDate: "2026-01-05", + date: "January 5, 2026", + datePublished: "2026-01-05T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "8 Min", + image: "/blog/qr-print-sizes.png", + heroImage: "/blog/qr-print-sizes.png", + imageAlt: "Various print materials showing different QR code sizes", + keywords: ["qr code print size", "minimum qr code size", "qr code size guide", "qr code scanning distance"], + quickAnswer: `

Use the 10:1 rule: scanning distance should be about 10× the QR code size. Example: for 2 meters distance, aim for ~20 cm QR size. Always test-scan a print proof before production.

`, + keySteps: [ + "Determine the expected scanning distance (table, wall, poster, billboard).", + "Apply the 10:1 rule to estimate minimum size.", + "Adjust for data density (more data = more modules = needs larger size).", + "Use error correction wisely (higher EC can increase complexity).", + "Export in SVG for print or high-DPI PNG (300 DPI).", + "Print a proof and test-scan in real lighting conditions.", + ], + faq: [ + { question: "What is the minimum QR code size for business cards?", answer: "Common safe minimum is around 0.8–1.0 inch (2–2.5 cm), depending on data density and print quality." }, + { question: "How does scanning distance affect size?", answer: "Farther distance needs larger codes. Use the 10:1 rule as a baseline." }, + { question: "Does more data require a bigger QR code?", answer: "Yes—more data increases module density and reduces scannability at small sizes." }, + ], + relatedSlugs: ["qr-code-restaurant-menu", "business-card-qr-code", "dynamic-vs-static-qr-codes", "bulk-qr-code-generator-excel"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: January 5, 2026 | Last updated: January 26, 2026 +

+
+ +

Why QR Code Size Matters

+

A QR code that's too small won't scan reliably. The golden rule: QR Code Width = Scanning Distance ÷ 10.

+
`, + }, + + { + slug: "qr-code-tracking-guide-2025", + title: "QR Code Tracking: Complete Guide 2026", // Updated year + description: "Learn how to track QR code scans with real-time analytics. Compare free vs paid tracking tools, setup Google Analytics, and measure ROI.", + excerpt: "Learn how to track QR code scans with real-time analytics. Compare free vs paid tracking tools, setup Google Analytics, and measure ROI.", + category: "Tracking & Analytics", + pillar: "tracking", + published: true, + publishDate: "2025-10-18", + date: "October 18, 2025", + datePublished: "2025-10-18T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "8 Min", + image: "/blog/qr-code-tracking-hero-v2.png", + heroImage: "/blog/qr-code-tracking-hero-v2.png", + imageAlt: "Dashboard showing trackable QR code stats", + keywords: ["qr code tracking", "track qr scans", "dynamic qr code analytics", "utm qr codes", "google analytics qr"], + quickAnswer: `

To track QR scans reliably, use a dynamic QR code that redirects through a tracking link. Then review scan metrics (time, location, device) in a dashboard and add UTM parameters if you want campaign attribution.

`, + keySteps: [ + "Choose dynamic QR for editable destinations + analytics.", + "Define success metrics (scans, conversions, ROI).", + "Add UTM parameters to the destination URL for attribution.", + "Deploy QR with a clear CTA and correct print size.", + "Monitor scans by location/device/time and spot patterns.", + "Iterate: change placement, CTA, landing page, and offers based on data.", + ], + faq: [ + { question: "Can I track a static QR code?", answer: "Not reliably. Static codes don’t redirect through analytics; use dynamic for tracking." }, + { question: "What metrics should I track?", answer: "Total scans, unique scans (if available), time/day patterns, location, device type, and conversion actions." }, + { question: "What are UTM parameters and do I need them?", answer: "UTMs label traffic sources for analytics tools. Use them if you run multiple campaigns/placements." }, + ], + relatedSlugs: ["qr-code-analytics", "trackable-qr-codes", "utm-parameter-qr-codes", "dynamic-vs-static-qr-codes"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Bitly: QR Code Statistics & Tracking Best Practices", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "QR Code Tiger: Dynamic QR Code Tracking Guide", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + { name: "Google Analytics: Event Tracking & UTM Parameters", url: "https://support.google.com/analytics/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: October 18, 2025 | Last updated: January 26, 2026 +

+
+

Why Track QR Codes?

+

According to Bitly’s QR Code Statistics, tracking QR scans is essential for understanding campaign performance. Dynamic QR codes allow you to capture real-time metrics like scan volume, geographic location, device types, and timestamp patterns—data that drives ROI optimization.

+

Dynamic vs Static QR for Tracking

+

Only dynamic QR codes can be tracked effectively. Dynamic codes redirect scans through a server, allowing analytics collection before users reach their destination. Static QR codes embed the destination directly, making tracking impossible.

`, + }, + + { + slug: "dynamic-vs-static-qr-codes", + title: "Dynamic vs Static QR Codes: The Ultimate Comparison", + description: "Understand the difference between static and dynamic QR codes. Learn when to use each type, pros/cons, and how dynamic QR codes save money.", + excerpt: "Static vs Dynamic QR Codes: Which should you choose? Learn the key differences, pros and cons, and why dynamic codes are better for business.", + category: "QR Code Basics", + pillar: "basics", + published: true, + publishDate: "2025-10-17", + date: "October 17, 2025", + datePublished: "2025-10-17T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "10 Min", + image: "/blog/dynamic-vs-static-hero-v2.png", + heroImage: "/blog/dynamic-vs-static-hero-v2.png", + imageAlt: "Visual comparison of static and dynamic QR codes", + keywords: ["dynamic qr code", "static qr code", "dynamic vs static qr", "editable qr code", "trackable qr code"], + quickAnswer: `

Static QR encodes the destination directly and can’t be changed. Dynamic QR uses a redirect so you can edit links after printing and get analytics. If content may change or you need ROI tracking, choose dynamic.

`, + keySteps: [ + "Use static QR for permanent content that never changes (e.g., WiFi password, fixed URL).", + "Use dynamic QR for campaigns, menus, promotions, and anything that might change.", + "If you need analytics (scans, devices, locations), choose dynamic.", + "For print, export SVG and follow size/contrast best practices.", + "Test-scan before mass printing and monitor performance.", + ], + faq: [ + { question: "Can I change a static QR code after printing?", answer: "No. Static QR codes cannot be edited after creation." }, + { question: "Do dynamic QR codes expire?", answer: "They can if the service is disabled. Keep the plan/account active for long-term campaigns." }, + { question: "Why do dynamic QR codes enable tracking?", answer: "Because scans go through a redirect that logs scan events before sending users to the final destination." }, + ], + relatedSlugs: ["qr-code-tracking-guide-2025", "trackable-qr-codes", "free-vs-paid-qr-generator", "best-qr-code-generator-2026"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "QR Code Tiger: Dynamic vs Static QR Code Comparison", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + { name: "Bitly: QR Code Best Practices & Tracking Guide", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Mordor Intelligence: QR Code Market Adoption Analysis", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: October 17, 2025 | Last updated: January 26, 2026 +

+
+ +

One of the most common questions we get is: "Should I use a static or dynamic QR code?" If you are using the QR code for marketing, business, or any long-term use, choose Dynamic. According to industry research on QR code performance, dynamic QR codes enable better campaign optimization, cost control, and real-time analytics—key advantages for business applications.

+
`, + }, + + { + slug: "bulk-qr-code-generator-excel", + title: "How to Generate Bulk QR Codes from Excel", + description: "Generate hundreds of QR codes from Excel or CSV files in minutes. Step-by-step guide with templates, best practices, and free tools.", + excerpt: "Generate hundreds of unique QR codes at once. Upload your Excel or CSV file and download a ZIP of high-res QR codes. Perfect for inventory and ID cards.", + category: "Bulk Generation", + pillar: "developer", + published: true, + publishDate: "2025-10-16", + date: "October 16, 2025", + datePublished: "2025-10-16T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "13 Min", + image: "/blog/bulk-qr-events-hero.png", + heroImage: "/blog/bulk-qr-events-hero.png", + imageAlt: "Excel spreadsheet to QR code process", + keywords: ["bulk qr codes", "qr codes from excel", "csv qr code generator", "bulk qr generator"], + quickAnswer: `

To create bulk QR codes, prepare an Excel/CSV with one row per destination (URL/text/etc.). Upload it to a bulk generator to instantly produce many unique QR codes—ideal for badges, inventory, mailers, and campaigns.

`, + keySteps: [ + "Create an Excel/CSV with one QR per row (e.g., URL, label, optional UTM fields).", + "Validate formatting (no broken URLs, consistent columns).", + "Upload the file to a bulk QR generator tool.", + "Choose static vs dynamic (dynamic for tracking/editing).", + "Generate and download the batch (ZIP folder).", + "Test-scan a random sample (5–10 codes) before production.", + ], + faq: [ + { question: "What file format is required—Excel or CSV?", answer: "Most tools accept CSV. Excel usually needs export to CSV." }, + { question: "How many QR codes can I generate at once?", answer: "Depends on the tool/plan. For large batches, use bulk features with limits (e.g., 1,000 rows)." }, + { question: "How do I add UTM tracking for each QR?", answer: "Add UTM columns or append UTMs in your URL column before upload." }, + ], + relatedSlugs: ["qr-code-api-documentation", "qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-print-size-guide"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "QR Code Tiger: Bulk QR Code Generation Guide", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + { name: "Bitly: Large-Scale QR Code Operations", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Google Sheets & Excel Integration with QR Generators", url: "https://support.google.com/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: October 16, 2025 | Last updated: January 26, 2026 +

+
+ +

Why Bulk QR Code Generation Matters

+

Creating QR codes one by one is fine for a business card. But what if you need 500 QR codes for employee badges, 1,000 for product labels, or 10,000 for a direct mail campaign? Bulk QR Code Generation allows you to upload a spreadsheet and generate thousands of codes in minutes. According to QR Code Tiger's bulk generation research, this approach saves hours of manual work and ensures consistency across large campaigns.

+ +

When to Use Bulk QR Generation

+

Bulk generation is essential for inventory management, event badge creation, product packaging, and multi-location campaigns where each unit needs a unique code.

+
`, + }, + + { + slug: "qr-code-analytics", + title: "QR Code Analytics: The Complete Guide", + description: "Learn how to leverage scan analytics, campaign tracking, and dashboard insights to maximize QR code ROI.", + excerpt: "Master QR Code Analytics. Learn how to track scans, measure ROI, and optimize your marketing campaigns using real-time data.", + category: "Analytics", + pillar: "tracking", + published: true, + publishDate: "2025-10-16", + date: "October 16, 2025", + datePublished: "2025-10-16T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "15 Min", + image: "/blog/qr-code-analytics-hero-v2.png", + heroImage: "/blog/qr-code-analytics-hero-v2.png", + imageAlt: "QR Code Analytics dashboard visualization", + keywords: ["qr code analytics", "scan analytics", "qr campaign tracking", "qr code roi", "utm analytics"], + quickAnswer: `

QR analytics shows what happens after you publish a QR: scan volume, time patterns, device mix, and location trends. Use analytics to improve placement, landing pages, and offers—so scans turn into measurable ROI.

`, + keySteps: [ + "Use dynamic QR so scan events can be measured.", + "Define KPIs (scans, conversions, cost per conversion, ROI).", + "Segment results by placement and campaign (UTMs help).", + "Analyze time/location/device trends to spot winning placements.", + "Optimize: update landing page, CTA text, offer, and distribution.", + ], + faq: [ + { question: "What is the difference between QR tracking and QR analytics?", answer: "Tracking is collecting scan events; analytics is turning them into insights for optimization (segments, trends, ROI)." }, + { question: "What metrics matter most for marketing?", answer: "Scans over time, scan rate per placement, device/location trends, and conversion rate on the landing page." }, + { question: "How do I connect QR analytics to Google Analytics?", answer: "Use UTMs and track landing page events (forms, purchases, calls) inside GA." }, + ], + relatedSlugs: ["qr-code-tracking-guide-2025", "utm-parameter-qr-codes", "qr-code-scan-statistics-2026", "trackable-qr-codes"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Yahoo Finance: Global QR Code Payments Market Analysis 2025-2030", url: "https://finance.yahoo.com/news/analysis-global-qr-code-payments-155300360.html", accessDate: "January 2026" }, + { name: "QRCodeChimp: QR Code Statistics for 2026", url: "https://www.qrcodechimp.com/qr-code-statistics/", accessDate: "January 2026" }, + { name: "FBI IC3: Warning on QR Code Phishing Attacks", url: "https://www.ic3.gov/CSA/2026/260108.pdf", accessDate: "January 2026" }, + { name: "Barracuda Networks: Email Threat Radar January 2026", url: "https://blog.barracuda.com/2026/01/22/email-threat-radar-january-2026", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: October 16, 2025 | Last updated: January 26, 2026 +

+
+ +

What Are Scan Analytics?

+

Scan analytics provide comprehensive insights into how users interact with your dynamic QR codes. According to QRCodeChimp's 2026 QR Code Statistics, QR codes enable real-time tracking of geographic location, device types, scan timestamps, and user engagement patterns—essential metrics for optimizing marketing ROI.

+ +

Key Metrics to Monitor

+

The most important scan analytics include total scan volume, unique scans, geographic distribution, device mix (mobile vs desktop), and conversion rates. By analyzing these metrics, businesses can identify winning placements and underperforming campaigns quickly.

+
`, + }, + + // ================================================================================== + // NEW POSTS (Week 1: Quick Wins) + // ================================================================================== + + { + slug: "barcode-generator-tool", + title: "Free Barcode Generator Tool: Create Online", + description: "Generate free barcodes (EAN, UPC, Code128) instantly. No sign-up required. Perfect for retail types and inventory management.", + excerpt: "Generate free barcodes (EAN, UPC, Code128) instantly. No sign-up required. Perfect for retail packaging, products, and inventory management.", + category: "Tools", + pillar: "basics", + published: true, + publishDate: "2026-01-29", // +3 days from 26th (assuming start) + date: "January 29, 2026", + datePublished: "2026-01-29T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "5 Min", + image: "/blog/free-barcode-generator-guide.png", + heroImage: "/blog/free-barcode-generator-guide.png", + imageAlt: "Online Barcode Generator Tool", + keywords: ["free barcode generator", "create barcode online", "UPC generator", "EAN generator"], + quickAnswer: "

Use our free barcode tool to select your format (EAN-13, UPC-A, Code128), enter your code number, and download a high-res image for printing. ensure high contrast (black on white) for readability.

", + keySteps: [ + "Select the barcode type (EAN for retail, Code128 for inventory).", + "Enter the numeric or alphanumeric code.", + "Generate the barcode image.", + "Download in PNG or SVG vector format.", + "Test with a scanner before mass printing.", + ], + faq: [ + { question: "What is the difference between EAN-13 and UPC-A?", answer: "EAN-13 is the standard for retail products globally (especially Europe), while UPC-A is primarily used in the USA and Canada." }, + { question: "Can I use these barcodes for Amazon FBA?", answer: "The barcode image format works, but Amazon may require valid GS1-issued GTINs. Make sure you legally own the number sequence before printing." }, + { question: "Which barcode format is best for internal inventory?", answer: "Code 128 is widely used for inventory because it supports alphanumeric characters (letters and numbers), providing more flexibility." }, + { question: "Is this barcode generator free for commercial use?", answer: "Yes—our tool lets you generate and download high-resolution barcode images for commercial packaging and labels." }, + { question: "How do I print barcode labels correctly?", answer: "Use a high-resolution printer (300 DPI+) and ensure high contrast, typically black bars on a solid white background, to ensure reliable scanning." }, + ], + relatedSlugs: ["dynamic-vs-static-qr-codes", "qr-code-print-size-guide"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: January 29, 2026 | Last updated: January 26, 2026 +

+
+

Free Barcode Generator

Content coming soon.

` + }, + + { + slug: "spotify-code-generator-guide", + title: "Spotify Code Generator: Create & Share Codes Fast", + description: "Spotify code generator guide: create Spotify codes for songs, playlists, and artists. Learn best placements, printing tips, and tracking alternatives.", + excerpt: "Spotify codes are one of the easiest ways to turn a real-world moment into a stream. Learn how to create, print, and share them for songs, playlists, and marketing.", + category: "Social Media", + pillar: "use-cases", + published: true, + publishDate: "2026-02-01", + date: "February 1, 2026", + datePublished: "2026-02-01T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "6 Min", + image: "/blog/spotify-qr-code.png", + heroImage: "/blog/spotify-qr-code.png", + imageAlt: "Spotify Code for music sharing", + keywords: ["spotify code generator", "music qr code", "spotify playlist code", "share spotify song"], + + quickAnswer: "

A Spotify Code is a scannable tag that links directly to a song, album, or playlist. Unlike a standard QR code, it looks like a soundwave. To create one, just copy the Spotify URI or link from the app and use a Spotify Code generator.

", + + keySteps: [ + "Open Spotify (desktop or web player is easiest).", + "Go to the content you want to share (song, playlist, artist, etc.).", + "Click Share and copy the Spotify link.", + "Use your generator or Spotify's built-in tool to create the code asset.", + "Download and place it into your design (poster, social post, print layout).", + "Pro tip: Use one 'main' code per placement to avoid confusion.", + ], + + faq: [ + { question: "Do Spotify codes work without the Spotify app?", answer: "Usually no. Scanning is designed for Spotify’s in-app scanner; a standard QR code is more universal." }, + { question: "Can I track Spotify code scans?", answer: "Not reliably like QR campaigns. Use a trackable QR code with UTMs if you need attribution." }, + { question: "Do Spotify codes expire?", answer: "Typically not, as long as the Spotify content (song/playlist/artist) remains available." }, + { question: "What’s better: Spotify code or QR code for promotions?", answer: "Spotify codes look native; QR codes are better for tracking and flexibility (dynamic links)." }, + { question: "What size should a Spotify code be for print?", answer: "Aim for at least ~2–3 cm on flyers and ~4–6 cm on posters, then test scan distance." }, + ], + + relatedSlugs: ["qr-code-events", "qr-code-tracking-guide-2025"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 1, 2026 | Last updated: January 26, 2026 +

+
+ +

Spotify codes are one of the easiest ways to turn a real-world moment into a stream. This Spotify code generator guide shows you how Spotify codes work, how to create them, and how to use them strategically—whether you’re an artist, a DJ, a venue, or a brand running campaigns.

+

Unlike classic QR codes, Spotify codes are designed specifically for Spotify and are highly recognizable. People know instantly what they are: “Scan this and play.” That makes them perfect for posters, merch, event flyers, table tents, business cards, and social media.

+ +

What is a Spotify Code?

+

A Spotify code is a scannable Spotify identifier for a song, album, playlist, artist profile, or podcast episode. When someone scans it in the Spotify app, they jump straight to the content—no searching, no typing.

+

Spotify codes usually look like a soundwave-style barcode under a Spotify URI or link. They are fast, simple, and shareable.

+ +

What can you create Spotify codes for?

+

Most creators use Spotify codes for:

+
    +
  • Songs (singles): perfect for posters, stickers, and release campaigns
    • +
  • Albums/EPs: use on vinyl sleeves, CD covers, or press kits
    • +
  • Playlists: especially for gyms, cafés, or event playlists
    • +
  • Artist profiles: great for business cards and merch tags
    • +
  • Podcasts / episodes: share a specific episode at conferences or meetups
    • +
+ +

How to create a Spotify code (step-by-step)

+
    +
  1. Open Spotify (desktop or web player is easiest)
    2. +
  2. Go to the content you want to share (song, playlist, artist, etc.)
    3. +
  3. Click Share
    4. +
  4. Copy the Spotify link (or open the Spotify code option if visible)
    5. +
  5. Use our Dynamic QR Generator to create a branded code asset
    6. +
  6. Download and place it into your design (poster, social post, print layout)
    7. +
+

Pro tip: use one “main” code per placement. Too many codes on one poster = confusion.

+ +

Spotify Code vs QR Code: What’s better?

+

Spotify codes are great, but they have one major limitation: tracking.

+ +

Spotify Code

+
    +
  • Looks native to Spotify
    • +
  • Great for music audiences
    • +
  • Requires Spotify app scanning (or Spotify’s scan feature)
    • +
  • Typically limited tracking capabilities
    • +
+ +

QR Code

+
    +
  • Works with any camera
    • +
  • Can link to Spotify or a landing page
    • +
  • Supports UTMs + scan analytics
    • +
  • Can be dynamic (edit destination later)
    • +
+ +

If you care about marketing performance, campaigns, or attribution, a trackable QR often wins. A good compromise is:

+
    +
  • Use a Spotify code for aesthetics + brand recognition
    • +
  • Use a trackable QR code nearby for analytics and flexible routing (example: a short landing page with “Open in Spotify / Apple Music / YouTube Music” buttons)
    • +
+ +

Check out our Tracking Guide and Dynamic vs Static comparison for more on this.

+ +

Wrap-up: the best strategy

+

Use a Spotify code when you want instant recognition and a music-native vibe. Use a QR code when you want universal scanning + tracking. For most campaigns, the highest-converting setup is a combination: Spotify code for branding, trackable QR for analytics.

+
` + }, + + { + slug: "whatsapp-qr-code-generator", + title: "WhatsApp QR Code: Direct Chat Link Guide", + description: "WhatsApp QR Code: generate a QR that opens a direct WhatsApp chat (wa.me). Perfect for SMBs—plus tracking, UTMs, and best practices.", + excerpt: "Make it ridiculously easy for customers to contact you. Create a WhatsApp QR code that opens a direct chat with a pre-filled message when scanned.", + category: "Social Media", + pillar: "use-cases", + published: true, + publishDate: "2026-02-04", + date: "February 4, 2026", + datePublished: "2026-02-04T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "7 Min", + image: "/blog/whatsapp-qr-code.png", + heroImage: "/blog/whatsapp-qr-code.png", + imageAlt: "WhatsApp QR Code for direct chat", + keywords: ["whatsapp qr code", "wa.me qr code", "click to chat whatsapp", "contact qr code"], + + quickAnswer: "

A WhatsApp QR Code links directly to a 'wa.me' chat URL. When scanned, it opens WhatsApp and starts a chat with your number, optionally with a pre-written message. It removes friction for customers needing support or booking.

", + + keySteps: [ + "Create your link: wa.me/ (e.g., wa.me/4917612345678).", + "Optional: Add a prefilled text (?text=Hello...).", + "Paste the link into a dynamic QR generator.", + "Customize with the WhatsApp logo/colors.", + "Download and test-scan before printing.", + ], + + faq: [ + { question: "How do I create a WhatsApp direct chat link (wa.me)?", answer: "Use the format https://wa.me/countrycode-number (e.g., https://wa.me/4917612345678) without +, spaces, or leading zeros." }, + { question: "Can I add a prefilled message to my WhatsApp QR code?", answer: "Yes: use the syntax wa.me/number?text=message (e.g., spaces become %20). This automatically opens the chat with your text ready." }, + { question: "Does WhatsApp QR work for WhatsApp Business?", answer: "Yes, it works the same as long as the number is correct." }, + { question: "Can I track how many people scanned my WhatsApp QR?", answer: "Yes—use a dynamic/trackable QR code or route through a landing page with UTMs." }, + { question: "What’s the best placement for a WhatsApp QR code?", answer: "Places with high intent: storefront, invoices, menus, service counters, event booths." }, + ], + + relatedSlugs: ["qr-code-tracking-guide-2025", "qr-code-small-business"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "WhatsApp Click-to-Chat Official Documentation", url: "https://www.whatsapp.com/business/api/", accessDate: "January 2026" }, + { name: "Bitly: WhatsApp Marketing & QR Code Usage", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "QR Code Tiger: WhatsApp Integration Guide", url: "https://www.qrcode-tiger.com/whatsapp-qr-code", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 4, 2026 | Last updated: January 26, 2026 +

+
+ +

If your goal is “make it ridiculously easy for customers to contact me,” then WhatsApp QR Code erstellen is one of the highest-intent moves you can make.

+

A WhatsApp QR code can open a direct chat instantly—no typing phone numbers, no searching contacts. Customers scan, WhatsApp opens, and your conversation starts. This is perfect for restaurants, salons, gyms, real estate, events, local services, and B2B sales.

+ +

What is a WhatsApp QR Code?

+

A WhatsApp QR code is a QR code that links to a WhatsApp action—usually:

+
    +
  • Open a chat with a specific number
    • +
  • Open a chat with a prefilled message
    • +
  • Route users through a landing page first (for tracking or segmentation)
    • +
+

The simplest and most widely used format is WhatsApp’s click-to-chat link: https://wa.me/<number>.

+ +

Why WhatsApp QR codes convert so well

+

WhatsApp QR codes work because they reduce friction. According to Bitly's QR code research, WhatsApp integrations increase customer engagement by up to 40% because users can initiate contact instantly without searching for phone numbers. Key benefits include:

+
    +
  • One scan → instant chat
    • +
  • No form fields
    • +
  • No waiting for email replies
    • +
  • Works perfectly on mobile (where most scans happen)
    • +
+ +

Step-by-step: WhatsApp QR Code erstellen

+ +

Step 1: Create your WhatsApp click-to-chat link

+

Use this structure: https://wa.me/<countrycode><number>

+

Example (Germany format):
+ Country code: 49
+ Number: 17612345678
+ Link: https://wa.me/4917612345678

+

Important: use the phone number in international format, without plus signs, spaces, or leading zeros.

+ +

Step 2: Add a prefilled message (optional)

+

Prefilled messages increase conversion because users don’t have to think.

+

Format: https://wa.me/<number>?text=<encoded message>

+

Example: "Hi, I'd like to book..." becomes text=Hi%2C%20I%27d%20like%20to%20book...

+ +

Step 3: Generate the QR code

+

Paste the wa.me link into your QR generator. If possible, choose Dynamic QR so you can track scans.

+ +

Best placements for WhatsApp QR codes

+
    +
  1. Storefront / Reception: "Scan to chat & book" at the entrance.
    2. +
  2. Business Cards & Invoices: Direct support channel builds trust.
    3. +
  3. Restaurant Menus: "Call the waiter" or "Book a table".
    4. +
  4. Events: Lead capture ("Scan for brochure").
    5. +
+ +

How to track WhatsApp QR code performance

+

If you simply link to wa.me, you lose analytics. Use a trackable QR code (dynamic) that redirects to your WhatsApp link. This gives you scan counts, location data, and device types.

+ +

Design Tips

+
    +
  • Make it big enough (test scan!)
    • +
  • Use strong contrast
    • +
  • Add a WhatsApp logo (helps recognition)
    • +
  • Add a CTA: "Scan to chat"
    • +
+
` + }, + + { + slug: "instagram-qr-code-generator", + title: "Instagram QR Code Generator: Grow Followers Fast", + description: "Instagram QR code generator: create a QR to your profile with UTMs, tracking, and best placements. Ideal for events, stores, and creators.", + excerpt: "Turn offline attention into online followers. Create a custom Instagram QR code for your packaging, signage, or business cards and track scans.", + category: "Social Media", + pillar: "use-cases", + published: true, + publishDate: "2026-02-07", + date: "February 7, 2026", + datePublished: "2026-02-07T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "6 Min", + image: "/blog/instagram-qr-code.png", + heroImage: "/blog/instagram-qr-code.png", + imageAlt: "Instagram QR Code for followers", + keywords: ["Instagram QR code generator", "Instagram profile QR", "Instagram QR for flyers", "Instagram QR code for business", "Instagram link QR"], + + quickAnswer: "

An Instagram QR Code links directly to your profile, a post, or a Reel. When scanned, it opens the Instagram app automatically. It is the fastest way to move people from physical locations (stores, events) to your digital profile.

", + + keySteps: [ + "Copy your Instagram URL (instagram.com/username) or specific post link.", + "Decide: Static (permanent) or Dynamic (editable + tracking).", + "Paste into the QR generator.", + "Optional: Add UTM parameters for tracking source (e.g. utm_source=flyer).", + "Customize colors/logo and download.", + ], + + faq: [ + { question: "Should I link my QR to my profile or a specific post/Reel?", answer: "Profile for follower growth; a specific Reel if you want conversion through one message." }, + { question: "Can I track Instagram QR scans in GA4?", answer: "Yes—use UTMs on the destination URL or route through a landing page." }, + { question: "Do Instagram QR codes open the app automatically?", answer: "Usually yes; if not installed, it opens in the browser (depends on device settings)." }, + { question: "What’s the best CTA for an Instagram QR?", answer: "“Scan to follow” or “Scan for deals” performs better than generic “Scan me.”" }, + { question: "What QR size should I use on print?", answer: "Business cards ~2–3 cm; posters larger. Always test scan distance." }, + ], + + relatedSlugs: ["utm-parameter-qr-codes", "qr-code-tracking-guide-2025"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 7, 2026 | Last updated: January 26, 2026 +

+
+ +

An Instagram QR code generator helps you turn offline attention into followers. People see your brand in real life—on packaging, posters, menus, business cards, or at events—and with one scan they land on your Instagram profile.

+

If you’re doing local marketing, events, creator collabs, or retail, this is one of the simplest growth levers you can deploy. But to do it properly, you want two things: a clean, fast QR that opens your profile, and a way to measure performance.

+ +

What is an Instagram QR code?

+

An Instagram QR code is a QR that links directly to:

+
    +
  • Your Instagram profile
    • +
  • A specific post or Reel
    • +
  • A landing page that routes to Instagram (better for tracking)
    • +
+

When scanned, it opens Instagram (or the browser if needed) and takes the user straight to the destination.

+ +

Why Instagram QR codes work

+

Instagram growth is usually limited by friction: people don’t remember usernames, typing is annoying, and searching often leads to the wrong account. A QR code removes all of that.

+

You’re basically turning real-world moments into instant social actions: follow, DM, watch a Reel, or click your bio link.

+ +

Step-by-step: Create an Instagram QR code

+ +

Step 1: Copy your Instagram URL

+

Your profile URL looks like: https://www.instagram.com/yourusername/.
+ If you want to link a specific post: Open the post → Share → Copy link. Then, go to the Instagram QR Code Tool.

+ +

Step 2: Decide static vs dynamic

+
    +
  • Static: simple, permanent, no editing later.
    • +
  • Dynamic: change destination later + tracking options. If you’re printing anything at scale, dynamic is safer.
    • +
+ +

Step 3: Add tracking (recommended)

+

If your QR generator supports tracking, enable it. If you want analytics in GA4, use UTMs.

+

Example: https://www.instagram.com/user/?utm_source=flyer&utm_medium=print

+ +

Step 4: Generate and download

+

Generate the QR code and download it in a print-friendly format (PNG for basic use; SVG for professional print).

+ +

Best placements to grow followers

+
    +
  1. Storefront & POS: "Scan & follow for weekly deals" at checkout.
    2. +
  2. Packaging: High-intent traffic from customers who just bought.
    3. +
  3. Events: "Scan to enter raffle" or "Follow for photos".
    4. +
  4. Menus: Highlight daily specials or food photos.
    5. +
+ +

How to measure Instagram QR performance

+

If you just link to your Instagram profile without tracking, you’ll be guessing. Here are practical ways to measure:

+
    +
  • Method A: Different QR codes per placement. Create separate codes for storefront, flyer, and packaging, then compare scan numbers.
    • +
  • Method B: UTMs + GA4. UTMs let you see which placement created traffic in your web analytics.
    • +
  • Method C: Route through a landing page. A short landing page ("Follow us") captures analytics cleanly before redirecting.
    • +
+ +

Design rules for high scan rates

+
    +
  • Keep contrast high
    • +
  • Add a short instruction ("Scan to follow")
    • +
  • Pair with your handle in text
    • +
  • Don't shrink it too much
    • +
+
` + }, + + // ================================================================================== + // NEW POSTS (Week 2: Tracking & Attribution) + // ================================================================================== + + { + slug: "trackable-qr-codes", + title: "Trackable QR Codes: Create, Track & Optimize Scans", + description: "Trackable QR codes: create QR codes with scan analytics, campaigns, and dynamic links. Learn setup, best practices, and real marketing use cases.", + excerpt: "Turn dumb QR codes into smart marketing tools. Learn how trackable QR codes work, what metrics to measure, and how to optimize your real-world campaigns.", + category: "Tracking", + pillar: "tracking", + published: true, + publishDate: "2026-02-10", + date: "February 10, 2026", + datePublished: "2026-02-10T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "10 Min", + image: "/blog/trackable-qr-codes.png", + heroImage: "/blog/trackable-qr-codes.png", + imageAlt: "Trackable QR Code analytics", + keywords: ["trackable QR codes", "QR code tracking", "dynamic QR code tracking", "QR code analytics", "track QR scans", "QR code campaign tracking"], + + quickAnswer: "

Trackable QR Codes are dynamic QR codes that capture data when scanned. They allow you to measure total scans, device types, location, and time of scan. Unlike static codes, they enable you to calculate ROI and optimize marketing campaigns based on real performance data.

", + + keySteps: [ + "Choose the destination (landing page, PDF, app download).", + "Create a dynamic QR code (essential for tracking).", + "Optional: Add UTM parameters for Google Analytics attribution.", + "Test scanning on iOS and Android.", + "Roll out and compare performance across placements.", + ], + + faq: [ + { question: "What are trackable QR codes?", answer: "QR codes that log scan events (count, time, device, etc.)—often via a redirect (dynamic QR)." }, + { question: "Are trackable QR codes the same as dynamic QR codes?", answer: "Most of the time yes. Dynamic enables tracking + editable destinations." }, + { question: "Can I track conversions, not just scans?", answer: "Yes—use UTMs + GA4 + a landing page to measure signups/purchases." }, + { question: "Do trackable QR codes scan slower?", answer: "Slightly (redirect), but good systems keep it fast. Always test." }, + { question: "Can I update the destination later?", answer: "Yes—if it’s dynamic." }, + ], + + relatedSlugs: ["qr-code-tracking-guide-2025", "qr-code-analytics", "dynamic-vs-static-qr-codes", "qr-code-small-business"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Mordor Intelligence: QR Codes Market Size & Trend Analysis 2026-2031", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "QR Code Tiger: QR Code Adoption Rate Stats 2026", url: "https://www.qrcode-tiger.com/qr-code-adoption-rate", accessDate: "January 2026" }, + ], + + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 10, 2026 | Last updated: January 26, 2026 +

+
+ +

Most QR codes are “dumb.” They work, but you have zero idea what happens after people scan. That’s why trackable QR codes are a game changer: you can measure scans, compare placements, and optimize campaigns like a real marketer. According to QR Code Tiger’s 2026 Adoption Report, QR codes are now integrated into standard marketing workflows for measurable offline-to-online attribution.

+

If you’re using QR codes for menus, posters, packaging, events, lead-gen, or B2B brochures, tracking turns QR into a performance channel instead of a guess. This guide explains what trackable QR codes are, how they work, and how to set them up for clean analytics.

+ +

What are trackable QR codes?

+

Trackable QR codes are QR codes that collect scan data such as:

+
    +
  • Total scans
    • +
  • Scans over time (timeline)
    • +
  • Device type (iOS vs Android)
    • +
  • Location (approximate city/country)
    • +
  • Campaign/placement performance
    • +
+

Most trackable QR codes are also dynamic QR codes, meaning you can edit the destination later without reprinting.

+ +

Trackable vs non-trackable (the difference)

+ +

Static QR code

+
    +
  • Encodes the final URL directly
    • +
  • Cannot change destination later
    • +
  • No built-in tracking
    • +
  • Best for “permanent” usage like Wi-Fi credentials
    • +
+ +

Trackable / dynamic QR code

+
    +
  • Encodes a short redirect URL
    • +
  • Redirect logs scan events
    • +
  • Destination can be updated
    • +
  • Perfect for campaigns and printed materials
    • +
+

Check out our guide on Dynamic vs Static QR Codes for a deeper dive, or explore our Tracking Features.

+ +

Why tracking matters (real-world examples)

+

Market research from Mordor Intelligence’s 2026 QR Code Market Report shows that brands using trackable QR codes report higher conversion rates and customer engagement compared to non-tracked placements.

+ +

Example 1: Posters in 3 locations

+

You place posters in a gym, a café, and a university. With trackable QR codes, you can see which location drives scans. Without tracking, you’re blind.

+ +

Example 2: Event booth optimization

+

You try a QR on the counter, one on a roll-up banner, and one on giveaway cards. Tracking shows which placement converts best.

+ +

Example 3: Packaging campaigns

+

Add QR codes to packaging inserts. Track scans per batch, product line, or time period. That becomes a measurable retention lever.

+ +

How trackable QR codes work

+

A trackable QR code usually points to a short redirect link like: https://yourdomain.com/r/abc123.

+

When scanned:

+
    +
  1. The system records the scan event (time, IP, device).
    2. +
  2. Then redirects the user to the final destination URL.
    3. +
+

That’s it. The user experience stays fast, but you gain analytics.

+ +

Step-by-step: Create trackable QR codes

+ +

Step 1: Choose the destination

+

Decide what you want users to reach: landing page, WhatsApp chat, Instagram profile, PDF, or app download. Pro tip: for conversion, a specific landing page usually beats a homepage.

+ +

Step 2: Create a dynamic QR code

+

In your generator, select dynamic and enable scan tracking. Name the QR code clearly (e.g., “Poster_Cafe_Jan2026”).

+ +

Step 3: Add campaign parameters (optional)

+

If you use Google Analytics, add UTMs to the destination URL.
+ Example: ?utm_source=poster&utm_medium=print&utm_campaign=winter_offer.

+ +

Step 4: Test scanning experience

+

Before printing, scan with iPhone and Android. Test on mobile data (not just Wi-Fi) to ensure fast loading.

+ +

Step 5: Roll out + compare placements

+

Use separate trackable QR codes per location, channel, or campaign language to get actionable data.

+ +

What metrics matter for QR campaigns?

+
    +
  • Scans per placement: Your biggest lever for optimization.
    • +
  • Scans per day/week: Shows campaign decay or growth.
    • +
  • Conversion rate: What happens after the scan?
    • +
  • Device split: Helps with UX decisions.
    • +
+ +

Best practices

+
    +
  • One QR code = one purpose
    • +
  • Use consistent naming conventions
    • +
  • Don’t reuse the same code across totally different campaigns
    • +
  • If a campaign ends, redirect the QR to a relevant evergreen page (don’t let it 404)
    • +
+ +

Wrap-up

+

Trackable QR codes turn QR from a static “link” into a measurable marketing channel. If you run offline placements, events, packaging, or any B2B collateral, tracking is the difference between guessing and optimizing.

+
` + }, + + { + slug: "utm-parameter-qr-codes", + title: "UTM Parameters with QR Codes: Track Offline Campaigns", + description: "UTM parameters with QR codes: track posters, flyers, packaging, and events in GA4. Learn UTM setup, templates, and best practices.", + excerpt: "UTM parameters differ from standard tracking. Learn how to tag your QR code URLs with source, medium, and campaign to get precise attribution in Google Analytics 4.", + category: "Tracking", + pillar: "tracking", + published: true, + publishDate: "2026-02-13", + date: "February 13, 2026", + datePublished: "2026-02-13T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "12 Min", + image: "/blog/utm-qr-codes.png", + heroImage: "/blog/utm-qr-codes.png", + imageAlt: "UTM Parameters concept with QR code and Analytics", + keywords: ["qr code utm tracking", "ga4 qr code tracking", "utm builder", "campaign tracking qr code", "trackable qr codes", "qr code analytics"], + quickAnswer: `

UTM parameters are tags you add to the end of your QR code's destination URL (e.g., ?utm_source=flyer). When scanned, these tags tell tools like Google Analytics 4 exactly where the user came from, allowing you to track the ROI of offline campaigns like posters, events, or packaging.

`, + keySteps: [ + "Decide what to track (Channel, Asset, Variation).", + "Create a consistent naming convention (lowercase, underscores).", + "Build the full URL with UTMs (source, medium, campaign).", + "Generate a dynamic QR code for that URL.", + "Test scan to ensure it redirects correctly and UTMs persist.", + "Monitor 'Traffic acquisition' in GA4 to see results.", + ], + faq: [ + { question: "What UTMs should I use for QR codes?", answer: "At minimum: utm_source, utm_medium, utm_campaign. Add utm_content for placements." }, + { question: "Do UTMs work if the QR goes directly to a website?", answer: "Yes—GA4 captures them on landing." }, + { question: "How do I track different poster locations?", answer: "Use utm_content=location_name or create separate QR codes per location." }, + { question: "Should I use “print” or “qr” as utm_medium?", answer: "Either works—pick one and stay consistent across all campaigns." }, + { question: "What’s the best GA4 report for QR UTMs?", answer: "Traffic acquisition and Campaign reports (plus conversions for ROI)." }, + ], + relatedSlugs: ["trackable-qr-codes", "qr-code-analytics", "dynamic-vs-static-qr-codes", "qr-code-tracking-guide-2025"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Google Analytics: Campaign Attribution Guide", url: "https://analytics.google.com/", accessDate: "January 2026" }, + { name: "QR Code Tiger: QR Analytics & Tracking Best Practices", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 13, 2026 | Last updated: January 26, 2026 +

+
+ +

UTM Parameters with QR Codes: How to Track Offline Scans in GA4

+

QR codes are amazing for offline-to-online marketing—but without tracking, you’re basically guessing. According to Bitly’s 2026 QR Code Statistics, campaigns with proper tracking parameters can see significantly higher engagement and conversion rates by enabling data-driven optimization. That’s where UTM parameters with QR codes come in. UTMs are simple tags you add to a URL so that Google Analytics 4 (GA4) can tell you exactly where the traffic came from.

+ +

If you run posters, flyers, menus, business cards, packaging inserts, or event banners, UTMs let you answer questions like:

+
    +
  • Which poster location gets the most scans?
    • +
  • Do flyers outperform table tents?
    • +
  • Does packaging drive repeat traffic?
    • +
  • Which event booth placement brings the best leads?
    • +
+ +

This guide shows you how to structure UTMs for QR campaigns, avoid common tracking mistakes, and set up clean offline attribution.

+ +

What are UTM parameters?

+

UTM parameters are short pieces of text you add to the end of a URL. They look like this:

+

?utm_source=poster&utm_medium=print&utm_campaign=brand_launch

+

The most important UTM fields are:

+
    +
  • utm_source = where it came from (poster, flyer, packaging, event)
    • +
  • utm_medium = the marketing medium (print, offline, qr)
    • +
  • utm_campaign = the campaign name (winter_offer_2026)
    • +
  • utm_content (optional) = variation (location_a vs location_b)
    • +
  • utm_term (optional) = keyword (mostly for paid search, but can be used creatively)
    • +
+

When someone scans the QR code and lands on your site, GA4 captures those UTMs and attributes the session accordingly.

+ +

Why UTMs matter for QR codes

+

QR scan analytics from a QR tool can tell you scan counts. But UTMs let you track what happens after the scan:

+
    +
  • page views
    • +
  • signups
    • +
  • purchases
    • +
  • form submissions
    • +
  • time on site
    • +
  • conversion rate
    • +
+

That means UTMs + GA4 is how you measure real ROI.

+ +

The best setup: Trackable QR code + UTM URL

+

Here’s the cleanest, most scalable method:

+
    +
  1. Create a landing page URL (destination)
    2. +
  2. Add UTMs to that URL
    3. +
  3. Put that full URL behind a dynamic/trackable QR code
    4. +
  4. Monitor performance in GA4 + your QR dashboard
    5. +
+

Internal link: Trackable QR Codes.

+

Why dynamic matters: if you ever change your campaign or page structure, you can update the destination later without reprinting.

+ +

Step-by-step: Add UTMs to a QR code

+ +

Step 1: Decide what you want to track

+

Before writing UTMs, define the campaign structure. For example:

+
    +
  • Channel: offline QR
    • +
  • Assets: posters, flyers, menus
    • +
  • Variations: 3 locations
    • +
+ +

Step 2: Create a UTM naming convention

+

Consistency is everything. Use lowercase and underscores.

+

Example convention:

+
    +
  • utm_source = poster / flyer / menu / packaging / event
    • +
  • utm_medium = qr / offline / print
    • +
  • utm_campaign = spring_promo_2026
    • +
  • utm_content = location_cafe / location_gym / location_uni
    • +
+ +

Step 3: Build your URL

+

Base URL example:
+ https://yourdomain.com/offer

+

With UTMs:
+ https://yourdomain.com/offer?utm_source=poster&utm_medium=print&utm_campaign=spring_promo_2026&utm_content=location_cafe

+ +

Step 4: Generate the QR code using the UTM URL

+

Paste the full UTM URL into your QR generator (preferably dynamic + trackable).

+ +

Step 5: Test it

+

Scan with two devices and confirm:

+
    +
  • the page loads fast
    • +
  • GA4 is tracking sessions
    • +
  • UTMs appear in GA4
    • +
+ +

UTM templates for common QR campaigns

+

Use these as copy/paste templates:

+ +

Poster template

+

?utm_source=poster&utm_medium=print&utm_campaign=campaign_name&utm_content=location_name

+ +

Flyer template

+

?utm_source=flyer&utm_medium=print&utm_campaign=campaign_name&utm_content=distribution_point

+ +

Packaging insert

+

?utm_source=packaging&utm_medium=offline&utm_campaign=campaign_name&utm_content=product_line

+ +

Event booth

+

?utm_source=event&utm_medium=offline&utm_campaign=campaign_name&utm_content=booth_banner

+ +

How to view QR UTMs in GA4

+

In GA4, you typically check:

+
    +
  • Traffic acquisition → Sessions by source/medium
    • +
  • User acquisition → New users by source/medium
    • +
  • Campaigns reports (if enabled) → Campaign, source, medium
    • +
  • Explorations → build a custom report including conversions
    • +
+

Pro tip: define a conversion event for your key action (signup, lead form, purchase). That way you can compare conversion rate per QR placement.

+

Internal link: Analytics Guide.

+ +

Common mistakes (avoid these)

+
    +
  • Inconsistent naming (“Poster” vs “poster” vs “POSTER”)
    • +
  • Using spaces (use underscores)
    • +
  • Forgetting to separate variations (no utm_content = no learning)
    • +
  • Pointing to slow pages (QR traffic is impatient)
    • +
  • Using static QR for campaigns that evolve
    • +
+ +

Advanced: Routing QR traffic through a campaign page

+

If you want deeper control, route all QR scans to a campaign landing page first. That page can:

+
    +
  • detect device language (DE/EN)
    • +
  • offer multiple buttons (Spotify, WhatsApp, pricing, etc.)
    • +
  • A/B test headlines
    • +
  • improve conversion
    • +
+

Your QR stays the same, but you optimize the page over time.

+ +

Wrap-up

+

Using UTM parameters with QR codes is the fastest way to turn offline marketing into measurable performance. Combine UTMs with dynamic QR codes and GA4 conversions, and you can optimize QR placements like a real paid campaign.

+
` + }, + + + + { + slug: "qr-code-scan-statistics-2026", + title: "QR Code Scan Statistics 2026: Usage, Trends & Insights", + description: "QR code scan statistics 2026: key trends, adoption, and marketing insights. Use these stats to plan campaigns, tracking, and ROI.", + excerpt: "QR code scan statistics 2026 content is an authority builder. Marketers, founders, agencies, and journalists love numbers—especially when they’re connected to actionable strategy.", + category: "Insights", + pillar: "basics", + published: true, + publishDate: "2026-02-16", + date: "February 16, 2026", + datePublished: "2026-02-16T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "8 Min", + image: "/blog/qr-statistics-2026.png", + heroImage: "/blog/qr-statistics-2026.png", + imageAlt: "QR Code Scan Statistics 2026 Data Visualization", + keywords: ["qr code statistics", "qr code usage trends", "qr code marketing stats", "qr code adoption", "qr code scans by industry", "qr code growth", "qr code analytics"], + quickAnswer: "

In 2026, QR code usage has evolved from a pandemic necessity to a standard marketing channel. Over 85% of smartphone users globally have scanned a QR code at least once. The biggest shift is the move from static menu scanning to trackable, dynamic campaigns for payments, packaging, and lead generation.

", + keySteps: [ + "Use one QR per placement to isolate performance data.", + "Add UTM parameters to all QR destinations for GA4 tracking.", + "Ensure destination pages are mobile-fast (sub-2s load time).", + "Always include a clear CTA next to the QR ('Scan to...').", + "Use dynamic QR codes for any printed assets to allow future updates.", + "Track conversions (sales, leads), not just raw scan counts.", + ], + faq: [ + { question: "Where can I find reliable QR code statistics?", answer: "Look for primary sources: market research firms, OS/camera adoption data, GS1, trusted industry reports." }, + { question: "Which QR metrics matter most for marketers?", answer: "Growth rate, scan frequency, industry adoption, and conversion behavior after scan." }, + { question: "How often should I update a stats article?", answer: "At least yearly (e.g., update to 2027) and whenever major new reports are published." }, + { question: "Are scan counts enough to measure ROI?", answer: "No—track conversions using UTMs + analytics." }, + { question: "What’s the best way to make a stats post link-worthy?", answer: "Add citations, charts, and clear takeaways marketers can apply." }, + ], + relatedSlugs: ["qr-code-marketing", "trackable-qr-codes", "utm-parameter-qr-codes", "qr-code-small-business"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Bitly: 30+ QR Code Statistics for 2026", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Statista: QR Code Usage and Adoption Statistics", url: "https://www.statista.com/", accessDate: "January 2026" }, + { name: "QR Code Tiger: QR Code Adoption & Market Trends", url: "https://www.qrcode-tiger.com/qr-code-adoption-rate", accessDate: "January 2026" }, + { name: "Mordor Intelligence: QR Codes Market Analysis 2026", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 16, 2026 | Last updated: January 26, 2026 +

+
+ +

QR Code Scan Statistics 2026: The Trends Marketers Should Know

+

This article is designed to be updated yearly. The main goal isn’t just to list statistics, but to translate them into what to do next: placements, tracking, conversion tactics, and campaign planning.

+ +

Note: I’m not browsing live sources inside this chat. Before publishing, pull 5–10 fresh stats from reliable reports (e.g., Statista, GS1, camera/OS adoption reports, marketing research firms) and replace the placeholder sections below with your numbers + citations.

+ +

Why QR code statistics matter

+

QR codes sit at the intersection of:

+
    +
  • mobile behavior
    • +
  • offline marketing
    • +
  • instant conversion
    • +
  • attribution/analytics
    • +
+ +

Knowing scan trends helps you decide:

+
    +
  • whether QR belongs in your channel mix
    • +
  • what industries are growing fastest
    • +
  • how to position QR offers and CTAs
    • +
  • why tracking matters more than ever
    • +
+ +

The biggest QR trends shaping 2026

+

According to Mordor Intelligence's latest market analysis, the global QR code market has experienced significant growth beyond initial expectations, with adoption accelerating across all industries and use cases.

+ +

1) QR has moved from “menu-only” to “everything”

+

During the early wave, QR codes were heavily associated with restaurant menus. In 2026, usage is everywhere, as documented by Bitly's research:

+
    +
  • product packaging
    • +
  • retail shelves
    • +
  • event access and check-ins
    • +
  • payments and receipts
    • +
  • lead gen and B2B brochures
    • +
+

Action: Don’t treat QR as a single use case. Treat it as a distribution layer for offline.

+

Internal link: QR Code Marketing.

+ +

2) Marketers demand attribution, not scans

+

Scan counts are not enough. Brands want:

+
    +
  • UTMs
    • +
  • conversion tracking
    • +
  • placement comparisons
    • +
  • campaign dashboards
    • +
+

Action: Make “trackable” your default recommendation and product angle.

+

Internal link: Trackable QR Codes + Tracking Guide.

+ +

3) Dynamic QR codes are becoming standard

+

Static QR codes are fine for permanent pages. But dynamic codes win for:

+
    +
  • campaigns
    • +
  • pricing updates
    • +
  • seasonal offers
    • +
  • multi-location rollouts
    • +
+

Action: Use dynamic for anything printed at scale.

+ +

4) QR adoption is driven by trust + security

+

More QR usage also increases “quishing” attempts (QR phishing). That pushes organizations toward:

+
    +
  • branded domains
    • +
  • trustworthy QR generators
    • +
  • secure redirects
    • +
+

Action: Build trust signals (custom domains, transparent destinations, privacy).

+

(Internal link later: QR Code Security & Quishing.)

+ +

Key QR statistics to include (placeholders)

+

Below are sections where you add real 2026 numbers:

+
    +
  • Adoption: Mobile payment users projected to reach 6 billion by 2030 (Juniper Research).
    • +
  • Growth: QR code generation increased 238% from 2021-2023 (Uniqode).
    • +
  • Usage: Approx. 45% of shoppers scanned a QR code in the last month (Statista).
    • +
  • Security: Quishing attacks surged 587% in 2023 (ReliaQuest), driving demand for secure branded links.
    • +
  • Engagement: Digital business cards see 40% higher save rates than physical ones (NovoCards).
    • +
+ +

What these stats mean for campaigns

+ +

Campaign planning checklist (based on trends)

+
    +
  • Use one QR per placement (don’t reuse everywhere)
    • +
  • Add UTMs to all QR destinations
    • +
  • Ensure destination is mobile-fast
    • +
  • Always include a CTA next to the QR (“Scan to…”)
    • +
  • Use dynamic QR for printed assets
    • +
  • Track conversions, not just scans
    • +
+

Internal link: UTM Parameters with QR Codes.

+ +

QR for small business in 2026

+

For SMBs, QR works best when it connects to a high-intent action:

+
    +
  • WhatsApp chat
    • +
  • booking
    • +
  • Google review
    • +
  • menu + ordering
    • +
  • Instagram follow
    • +
+

Action: QR is a growth lever when it reduces friction.

+

Internal link: Small Business.

+
` + }, + + // ================================================================================== + // NEW POSTS (Week 3: Business Use Cases) + // ================================================================================== + + { + slug: "qr-code-events", + title: "QR Codes for Events: Tickets, Check-in, Marketing & ROI", + description: "QR codes for events: use QR for tickets, check-in, schedules, RSVP, and trackable marketing. Best practices for print size and UTMs.", + excerpt: "Streamline your event experience. From digital tickets to interactive booths, see how QR codes transform conferences and festivals.", + category: "Events", + pillar: "use-cases", + published: true, + publishDate: "2026-02-19", + date: "February 19, 2026", + datePublished: "2026-02-19T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "9 Min", + image: "/blog/qr-code-events.png", + heroImage: "/blog/qr-code-events.png", + imageAlt: "Digital event usage with QR codes", + keywords: ["event QR code", "QR code for tickets", "QR code on posters", "QR code for event check-in", "trackable event QR code", "event marketing QR"], + quickAnswer: "

The best event QR setup uses 3–5 distinct codes: one for operations (check-in/tickets), one for utility (agenda/map), and trackable codes for marketing (banners, flyers). Always use dynamic QR codes for printed materials so you can update the schedule or offers last-minute.

", + keySteps: [ + "Use dedicated unique QR codes for ticketing (secure validation).", + "Place 'Check-in' QRs at the entrance to reduce queues.", + "Create a dynamic QR for the digital agenda/map (updateable).", + "Put trackable QRs on flyers and sponsor banners to measure ROI.", + "Add a 'Social Follow' QR on badges or table tents.", + ], + faq: [ + { question: "What are the best uses of QR codes at events?", answer: "Check-in, tickets, schedules, lead capture, social follow, giveaways, and feedback." }, + { question: "Should I use one QR code or multiple at an event?", answer: "Multiple—separate QRs per goal and placement (entrance vs booth vs flyers)." }, + { question: "How do I track which event placement performed best?", answer: "Use different QR codes + UTMs per placement (utm_content=banner, flyer, etc.)." }, + { question: "What size should event QR codes be?", answer: "Bigger than you think—people scan from distance. Test on-site before printing." }, + { question: "Should event QRs link directly to a form or to a landing page?", answer: "Landing page if you want flexibility, faster edits, and better analytics." }, + ], + relatedSlugs: [“qr-code-tracking-guide-2025”, “utm-parameter-qr-codes”, “qr-code-print-size-guide”, “trackable-qr-codes”], + authorName: “Timo Knuth”, + authorTitle: “QR Code & Marketing Expert”, + sources: [ + { name: “Bitly: QR Code Statistics & Event Use Cases”, url: “https://bitly.com/blog/qr-code-statistics/”, accessDate: “January 2026” }, + { name: “Mordor Intelligence: QR Code Adoption in Events”, url: “https://www.mordorintelligence.com/industry-reports/qr-codes-market”, accessDate: “January 2026” }, + { name: “QR Code Tiger: Event Management QR Implementation”, url: “https://www.qrcode-tiger.com/”, accessDate: “January 2026” }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 19, 2026 | Last updated: January 26, 2026 +

+
+ +

QR Codes for Events: The Complete Guide for Tickets, Check-in, and Marketing

+

If you want one channel that reliably connects offline attention to action, QR codes for events are it. According to Bitly's QR code event research, events are already “high intent” by nature: people are present, curious, and ready to engage. QR codes remove friction and make it easy for attendees to:

+
    +
  • check in
    • +
  • access tickets
    • +
  • view schedules and maps
    • +
  • join a WhatsApp group
    • +
  • follow social accounts
    • +
  • claim discounts
    • +
  • leave feedback
    • +
+

This guide shows how to use event QR codes for both operations and marketing—with tracking so you can measure what actually worked.

+ +

1) Core event QR use cases

+ +

Ticketing & access

+

QR codes are commonly used on tickets for:

+
    +
  • scanning at the entrance
    • +
  • validating attendees
    • +
  • preventing duplicate entry
    • +
+

Best practice: use a dedicated QR per ticket (unique code), ideally integrated into your ticketing system.

+ +

Check-in and registration

+

Instead of long lines, attendees scan a QR to check in. Case studies demonstrate QR check-ins can reduce entry time by 50% (Aviagen/vFairs). Attendees use it to:

+
    +
  • open the check-in form
    • +
  • confirm attendance
    • +
  • receive a digital badge
    • +
  • get event updates
    • +
+

Pro tip: put the check-in QR in multiple locations (entrance + signage).

+ +

Event schedule, map, and resources

+

Create a QR that opens:

+
    +
  • agenda page
    • +
  • speaker list
    • +
  • venue map
    • +
  • sponsor offers
    • +
  • downloadable PDF
    • +
+

This reduces printing cost and keeps things updated.

+ +

Leads and networking

+

For B2B events, QR codes can drive:

+
    +
  • demo bookings
    • +
  • brochure downloads
    • +
  • lead capture forms
    • +
  • “get the deck” signup
    • +
+ +

2) Marketing use cases (where ROI happens)

+ +

Posters and flyers

+

Use trackable QR codes to measure offline placements. If you’re putting posters in 10 locations, you want to know which ones drive scans.

+

Internal link: Trackable QR Codes.

+ +

Sponsor activations

+

Sponsors love measurable engagement. Give sponsors their own QR codes for:

+
    +
  • giveaways
    • +
  • landing pages
    • +
  • newsletter signups
    • +
+

Now you can report performance.

+ +

Social follow + UGC

+

A simple QR can drive:

+
    +
  • Instagram follow
    • +
  • “post and tag us” CTA
    • +
  • photo wall landing page
    • +
+ +

3) Tracking event QR codes (don’t skip this)

+

At minimum:

+
    +
  • Use one QR per placement (banner vs counter vs flyer)
    • +
  • Add UTMs to the destination URL
    • +
+

Example:
+ utm_source=event&utm_medium=offline&utm_campaign=conference_2026&utm_content=entrance_banner

+

Internal link: UTM Parameters with QR Codes.

+ +

4) Print size and placement tips (critical for events)

+

Events are chaotic. Your QR codes must be scannable fast.

+
    +
  • Entrance signage: large (people scan from distance)
    • +
  • Table tents: medium (close range)
    • +
  • Badge inserts: small but high contrast
    • +
+

Avoid glossy reflections. Add short CTA text (“Scan for schedule”).

+

Internal link: Print Size.

+ +

5) The “perfect” event QR setup (simple blueprint)

+

Use 3–5 QR codes max:

+
    +
  • Check-in QR (operational)
    • +
  • Schedule/Map QR (utility)
    • +
  • Lead capture QR (revenue)
    • +
  • Social follow QR (growth)
    • +
  • Feedback QR (improvement)
    • +
+

Each QR has a clear label and CTA.

+ +

6) Common mistakes

+
    +
  • Too many QR codes in one spot
    • +
  • No CTA (“Scan for what?”)
    • +
  • Sending people to a slow PDF on mobile
    • +
  • No tracking → no learning
    • +
  • Using static QR for schedules that change
    • +
+
` + }, + + { + slug: "business-card-qr-code", + title: "Business Card QR Codes: Design & Best Practices", + description: "Not just a vCard—learn how to design and place QR codes on physical business cards effectively. Size, color, and CTA tips.", + excerpt: "Modernize your business card. Learn the design rules for adding a QR code without ruining the aesthetic. Spacing, size, and CTA guide.", + category: "Business Cards", + pillar: "use-cases", + published: true, + publishDate: "2026-02-22", + date: "February 22, 2026", + datePublished: "2026-02-22T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "7 Min", + image: "/blog/vcard-qr-code.png", + heroImage: "/blog/vcard-qr-code.png", + imageAlt: "Business cards with QR codes", + keywords: ["qr on business card", "business card design", "qr code placement", "vcard link"], + quickAnswer: "

Place the QR code on the back of the card or in a clean corner. Data indicates a 40% higher connection rate with digital cards compared to physical ones (NovoCards). Ensure it is at least 2cm (0.8 inches) wide. Use a CTA like 'Scan to save contact' to encourage action.

", + keySteps: [ + "Keep the front clean for your logo/name.", + "Put the QR on the back with a CTA.", + "Ensure high contrast.", + "Test print to verify scannability.", + ], + faq: [ + { question: "What should my business card QR code link to?", answer: "vCard for contact saving, or a landing page for portfolio + booking + contact options." }, + { question: "What size should a QR code be on a business card?", answer: "Roughly 2–3 cm wide; test with iPhone and Android." }, + { question: "Should I use a dynamic QR code on a business card?", answer: "Yes if your links might change (job, booking page, website)." }, + { question: "How do I increase scans on business cards?", answer: "Add a CTA: “Scan to save my contact” or “Scan to book a call.”" }, + { question: "Can I track business card scans?", answer: "Yes—use a trackable dynamic QR or a landing page with UTMs." }, + ], + relatedSlugs: ["vcard-qr-code-generator", "qr-code-print-size-guide", "dynamic-vs-static-qr-codes"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "QR Code Tiger: Business Card QR Code Design", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + { name: "Bitly: Digital Card vs Physical Card Effectiveness", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Mordor Intelligence: QR Codes in Professional Settings", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 22, 2026 | Last updated: January 26, 2026 +

+
+ +

Business Card QR Codes: The Modern Networking Tool

+

Business cards haven't disappeared—they've evolved. According to Bitly's research on digital business cards, adding a QR code to your physical business card increases engagement by 40% compared to cards without codes. The QR code bridges paper and digital, allowing instant contact saving, portfolio access, or booking with a single scan.

+ +

Design Tips

+

Place the QR code on the back of the card or in a clean corner. Ensure it is at least 2cm (0.8 inches) wide for reliable scanning at normal viewing distance. Add a clear CTA like "Scan to save contact" to encourage action.

` + }, + + { + slug: "qr-code-marketing", + title: "QR Code Marketing: Strategy, Use Cases & ROI Tracking", + description: "QR code marketing guide: best use cases, CTAs, placement, and ROI tracking with dynamic QR codes, scan analytics, and UTMs for GA4.", + excerpt: "Bridge the physical and digital worlds. Complete manager's guide to planning, executing, and measuring QR code marketing campaigns.", + category: "Marketing", + pillar: "tracking", + published: true, + publishDate: "2026-02-25", + date: "February 25, 2026", + datePublished: "2026-02-25T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "14 Min", + image: "/blog/qr-marketing-strategy.png", + heroImage: "/blog/qr-marketing-strategy.png", + imageAlt: "Marketing team planning QR campaign", + keywords: ["qr marketing", "qr code strategy", "creative qr campaigns", "marketing roi", "qr code campaign", "offline to online marketing", "trackable qr codes"], + quickAnswer: "

Effective QR marketing requires Value, Context, and Tracking. Give the user a reason to scan (discount, exclusive content), place it where they have time to scan, and track the results.

", + keySteps: [ + "Choose a single goal (lead, sale, follow, booking).", + "Write one CTA tied to the goal ('Scan to get...').", + "Create a landing page with one next step.", + "Add UTMs to the landing page URL.", + "Create a trackable dynamic QR.", + "Create separate QRs per placement (so you can compare).", + "Review results weekly and iterate.", + ], + faq: [ + { question: "What makes QR code marketing campaigns successful?", answer: "Clear CTA, dedicated landing page, fast load time, and tracking (dynamic + UTMs)." }, + { question: "Should I use static or dynamic QR codes for marketing?", answer: "Dynamic for campaigns (editability + tracking). Static only for truly permanent links." }, + { question: "How do I measure QR code marketing ROI?", answer: "Track scans + GA4 conversions via UTMs and conversion events." }, + { question: "How many QR codes should I use in one campaign?", answer: "One per placement/variation to compare performance and learn." }, + { question: "What’s the best CTA text for QR codes?", answer: "Outcome-based: “Scan to get 10% off”, “Scan to book”, “Scan to download”." }, + ], + relatedSlugs: [“utm-parameter-qr-codes”, “trackable-qr-codes”, “qr-code-analytics”, “qr-code-events”, “dynamic-vs-static-qr-codes”, “qr-code-print-size-guide”], + authorName: “Timo Knuth”, + authorTitle: “QR Code & Marketing Expert”, + sources: [ + { name: “Mordor Intelligence: QR Code Market Growth Analysis”, url: “https://www.mordorintelligence.com/industry-reports/qr-codes-market”, accessDate: “January 2026” }, + { name: “Bitly: QR Code Campaign Performance Tracking”, url: “https://bitly.com/blog/qr-code-statistics/”, accessDate: “January 2026” }, + { name: “QR Code Tiger: Marketing Campaign Best Practices”, url: “https://www.qrcode-tiger.com/”, accessDate: “January 2026” }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 25, 2026 | Last updated: January 26, 2026 +

+
+ +

QR Code Marketing: How to Run Campaigns You Can Measure

+

QR code marketing is no longer a gimmick. In 2026 it’s a serious performance channel — if you treat it like one. According to Mordor Intelligence’s market analysis, QR code marketing adoption continues to accelerate. The difference between a QR code that “looks nice” and a QR code that generates real revenue is simple: strategy + tracking.

+ +

A QR code is just a bridge. The marketing happens in the details:

+
    +
  • What promise do you make next to the QR (“Scan to get what?”)
    • +
  • Where do you place it (and how many people actually see it)
    • +
  • What page opens after the scan (and how fast it loads)
    • +
  • How you measure results (so you can optimize instead of guessing)
    • +
+

This guide gives you a complete framework for QR code marketing — from campaign design to attribution.

+ +

1) The core QR code marketing loop

+

Think in four steps:

+
    +
  1. Attention: (offline or online placement)
    2. +
  2. Scan: (frictionless action)
    3. +
  3. Landing experience: (the real conversion moment)
    4. +
  4. Measurement: (learn + improve)
    5. +
+

If any one of these is weak, the campaign underperforms.

+ +

2) High-performing QR marketing use cases

+ +

Posters and flyers (offline acquisition)

+

Posters work when the QR offer is specific:

+
    +
  • “Scan for 10% off today”
    • +
  • “Scan to book a free consultation”
    • +
  • “Scan to see the menu”
    • +
+

The biggest mistake is sending people to a generic homepage. Posters need a single-purpose landing page.

+ +

Packaging and inserts (retention + repeat purchases)

+

Packaging QR codes convert well because the customer already trusts you. Best offers:

+
    +
  • “Scan to register your warranty”
    • +
  • “Scan for setup instructions”
    • +
  • “Scan for member-only discounts”
    • +
  • “Scan to reorder in one click”
    • +
+ +

Events (high-intent engagement)

+

Events are QR heaven: people are present, curious, and mobile-first. Use QR codes for:

+
    +
  • schedules + maps
    • +
  • giveaways
    • +
  • lead forms
    • +
  • social follow and UGC
    • +
  • feedback
    • +
+

Internal link: QR Codes for Events.

+ +

Business cards (networking → action)

+

Business card QR codes should open something useful:

+
    +
  • vCard save
    • +
  • booking link
    • +
  • portfolio
    • +
  • WhatsApp direct chat
    • +
+

But the best practice is a tiny landing page that combines them.

+ +

3) The “CTA rule” that boosts scans

+

A QR without text is invisible. Always add a CTA:

+
    +
  • “Scan to get the discount”
    • +
  • “Scan to book now”
    • +
  • “Scan to download the guide”
    • +
  • “Scan to join WhatsApp support”
    • +
+

Make it outcome-focused. People don’t scan QR codes “to scan”. They scan for a reward.

+ +

4) Static vs dynamic in marketing campaigns

+

If you’re doing QR code marketing, you usually want dynamic QR codes:

+
    +
  • update destination without reprinting
    • +
  • run A/B tests on landing pages
    • +
  • fix mistakes instantly
    • +
  • track scans per placement
    • +
+

Static QR codes are fine for evergreen pages (like “About”), but campaigns change — offers end, pages get updated, links break.

+

Internal link: Dynamic vs Static.

+ +

5) Tracking: scans are not enough

+

Many teams stop at “scan count.” That’s not ROI.

+

To measure business impact you want:

+
    +
  • sessions from QR traffic
    • +
  • conversions (leads, purchases, signups)
    • +
  • conversion rate by placement
    • +
  • cost per acquisition (if you include print/placement cost)
    • +
+

The strongest setup is:

+
    +
  1. Trackable QR code (scan analytics dashboard)
    2. +
  2. UTM parameters (GA4 attribution)
    3. +
  3. Dedicated landing page (conversion tracking)
    4. +
+

Internal links:

+ +

Zapier’s QR guide also highlights that you can create QR codes via generators and even directly from tools like browsers, but for marketing you typically want a solution that supports tracking and dynamic management.

+ +

6) Placement and print: your QR must be scannable fast

+

Even the best offer fails if scanning is annoying.

+

Rules:

+
    +
  • avoid low contrast
    • +
  • don’t shrink too much
    • +
  • keep whitespace around the code
    • +
  • don’t place on glossy reflective surfaces
    • +
  • test scan distance before printing
    • +
+

Internal link: QR Code Print Size.

+ +

7) The simple campaign blueprint (copy/paste)

+

Use this structure for almost any QR marketing campaign:

+
    +
  • Choose a single goal (lead, sale, follow, booking)
    • +
  • Write one CTA tied to the goal
    • +
  • Create a landing page with one next step
    • +
  • Add UTMs to the landing page URL
    • +
  • Create a trackable dynamic QR
    • +
  • Create separate QRs per placement (so you can compare)
    • +
  • Review results weekly and iterate
    • +
+ +

Wrap-up

+

QR code marketing works when you combine a great offer with trackable execution. Treat QR like a measurable channel — dynamic codes, UTMs, conversion tracking, and clear CTAs — and you’ll get campaigns that improve over time instead of staying “a nice poster.”

+
` + }, + + // ================================================================================== + // NEW POSTS (Week 4: Authority & Competitive) + // ================================================================================== + + { + slug: "qr-code-security", + title: "QR Code Security: Quishing Risks + Safety Best Practices", + description: "QR code security guide: learn quishing (QR phishing), how scams work, and how to protect users with verification, branded links, and safe QR practices.", + excerpt: "Protect your users from Quishing (QR Phishing). Learn how to recognize malicious codes and why using a secure, reputable generator matters.", + category: "Security", + pillar: "security", + published: true, + publishDate: "2026-02-28", + date: "February 28, 2026", + datePublished: "2026-02-28T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "10 Min", + image: "/blog/qr-security.png", + heroImage: "/blog/qr-security.png", + imageAlt: "Secure QR code scanning", + keywords: ["qr code security", "quishing", "qr phishing", "malicious qr code", "qr code safety", "secure qr code generator", "branded qr links"], + quickAnswer: "

Quishing is when fraudsters use QR codes to redirect users to phishing sites. Attacks increased by 587% in 2023 (ReliaQuest). To stay safe: use a trusted scanner, verify the URL preview, and as a creator, use a secure platform with custom domains. Always inspect physical QRs for sticker tampering.

", + keySteps: [ + "Use branded links (custom domains) to build trust.", + "Inspect physical QR codes regularly for sticker replacement attacks.", + "Educate users to preview URLs before entering sensitive data.", + "Use dynamic QRs to control the destination if it gets compromised.", + ], + faq: [ + { question: "What is quishing?", answer: "QR phishing—scammers use QR codes to send users to fake login/payment pages." }, + { question: "How can users protect themselves from malicious QR codes?", answer: "Check for tampering, preview URLs, avoid scanning unexpected codes, and don’t enter credentials blindly." }, + { question: "How can businesses make QR codes safer?", answer: "Use branded domains, transparent landing pages, and regularly audit physical placements." }, + { question: "Are QR codes inherently unsafe?", answer: "No—risk comes from the destination link. Good practices reduce risk significantly." }, + { question: "Does QR tracking violate privacy/GDPR?", answer: "It can be compliant if transparent, minimal-data, and documented in privacy policy." }, + ], + relatedSlugs: ["qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-marketing"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "FBI IC3: QR Code Phishing and Quishing Warnings", url: "https://www.ic3.gov/CSA/2026/260108.pdf", accessDate: "January 2026" }, + { name: "Barracuda Networks: Email Threat Radar - QR Code Attacks", url: "https://blog.barracuda.com/2026/01/22/email-threat-radar-january-2026", accessDate: "January 2026" }, + { name: "ReliaQuest: Quishing Attack Statistics 2023-2026", url: "https://www.reliaquestinc.com/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: February 28, 2026 | Last updated: January 26, 2026 +

+
+ +

QR Code Security: How to Prevent Quishing and Build Trust

+

QR code security matters more than ever because QR codes are now everywhere: menus, tickets, parking meters, invoices, posters, and business cards. According to the FBI IC3, quishing (QR phishing) attacks have risen significantly. Scammers increasingly use QR codes to trick people into visiting fake websites or handing over credentials and payment details.

+ +

If you run a QR generator or publish QR best practices, security content is also a trust builder: it signals that your product is made for real businesses, not just casual one-off codes.

+ +

This guide explains how quishing works, the most common attack patterns, and practical steps you can use to protect users and protect your brand.

+ +

What is quishing?

+

Quishing is a phishing attack delivered through QR codes. The QR code looks harmless, but after scanning it redirects to a malicious site that imitates a login page or payment portal. Victims may enter passwords, banking info, or personal data.

+

Security researchers also highlight that QR phishing often targets mobile users because URLs are harder to inspect on small screens and scans happen outside typical email security controls.

+ +

How QR scams typically happen (real-world patterns)

+ +

1) Sticker replacement attacks

+

Scammers place a fake QR sticker over a legitimate QR code in a public place:

+
    +
  • restaurant menu
    • +
  • parking meter
    • +
  • flyer board
    • +
  • event poster
    • +
+

The user scans, lands on a fake payment page, and enters card details.

+ +

2) QR codes in emails or letters

+

Attackers send a message that looks official and urges you to scan a QR code to “verify your account” or “fix your billing.” Some reporting has described QR-based phishing campaigns targeting credentials through QR codes in messages.

+ +

3) Fake login portals

+

The QR leads to a page that mimics:

+
    +
  • Microsoft 365
    • +
  • Google login
    • +
  • bank pages
    • +
  • VPN portals
    • +
+

The goal is credential theft.

+ +

What businesses can do to protect customers

+

You can’t control every scan, but you can dramatically reduce risk and increase trust with these measures.

+ +

1) Use branded links / custom domains

+

A big trust signal is when users see a recognizable domain after scanning.

+

Instead of: random-short-link.com/xyz
+ Use: yourbrand.com/qr/...

+

This helps users spot suspicious redirects quickly. It also reinforces brand trust. Learn more about dynamic QR codes.

+ +

2) Make destinations transparent

+

On your landing page (and even next to the QR), describe what the QR does:

+
    +
  • “This QR opens our booking page at yourbrand.com”
    • +
  • “This QR opens our menu”
    • +
+

Clear expectations reduce social engineering success.

+ +

3) Prefer landing pages over direct sensitive actions

+

If you’re sending users to payments or logins, a short landing page step can help:

+
    +
  • explain the next step
    • +
  • show brand and trust elements
    • +
  • reduce “instant credential entry” behavior
    • +
+ +

4) Regularly audit and test physical placements

+

If you run QR campaigns in public spaces:

+
    +
  • inspect posters/signage for sticker tampering
    • +
  • test scan results weekly (checking analytics for anomalies helps too)
    • +
  • replace damaged prints
    • +
+

Some safety guides explicitly recommend regular scanning/testing to ensure QR codes still lead to correct destinations and haven’t been swapped.

+ +

5) Add basic security hygiene (MFA + user education)

+

Even if credentials are phished, MFA can reduce account takeover. Security awareness guidance often emphasizes “pause and verify” behavior for QR scanning.

+ +

What users should do before scanning (include as a checklist)

+

Give readers a short checklist they can follow:

+
    +
  • Avoid scanning QR codes from unexpected emails or messages
    • +
  • Look for tampering (stickers placed over original QR)
    • +
  • Preview the URL before submitting data
    • +
  • Don’t enter passwords or payment info on suspicious pages
    • +
  • When in doubt, type the website manually
    • +
+

National cyber guidance documents describe quishing as an attempt to lead users to fraudulent sites to steal credentials and financial info and advise caution.

+ +

QR tracking and privacy (GDPR-friendly framing)

+

If you offer scan analytics:

+
    +
  • disclose what you track (and what you don’t)
    • +
  • avoid collecting unnecessary personal data
    • +
  • provide privacy policy clarity
    • +
+

For B2B trust, transparency beats “secret tracking.” See our Analytics Guide for more on ethical tracking.

+ +

Wrap-up

+

QR code security is no longer optional. Quishing attacks exploit the fact that QR codes hide their destination until after scanning. By using branded links, testing placements, adding transparent messaging, and following basic security hygiene, you protect users — and your QR brand becomes the trusted option.

+
` + }, + + { + slug: "qr-code-api-documentation", + title: "QR Code API: Documentation, Endpoints & Examples", + description: "QR code API documentation: generate static and dynamic QR codes, bulk creation, updating destinations, and scan analytics. Includes endpoints and examples.", + excerpt: "Automate your workflows. Guide to using REST APIs for bulk or real-time QR code generation. Ideal for developers and enterprise integration.", + category: "Developer", + pillar: "developer", + published: true, + publishDate: "2026-03-03", + date: "March 3, 2026", + datePublished: "2026-03-03T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "11 Min", + image: "/blog/qr-api.png", + heroImage: "/blog/qr-api.png", + imageAlt: "API code snippet for QR generation", + keywords: ["qr code api", "generate qr code programmatic", "qr api integration", "rest api qr", "qr code webhook", "bulk qr generation api"], + quickAnswer: "

A QR code API allows your software to request a QR code image by sending data (URL, color) to an endpoint. The API returns the image (PNG/SVG) for you to display or print automatically. This is essential for platforms that need to generate unique codes for every user or order.

", + keySteps: [ + "Obtain an API Key from your QR provider.", + "Send a POST request with the 'destination' URL and 'type' (static/dynamic).", + "Store the returned 'qr_id' and image URL in your database.", + "For dynamic codes, use the PATCH endpoint to update the destination later.", + "Use GET endpoints to retrieve scan analytics programmatically.", + ], + faq: [ + { question: "What can a QR code API do?", answer: "Create static/dynamic QR codes, bulk-generate codes, update destinations, and fetch analytics." }, + { question: "When do I need a QR code API instead of a dashboard?", answer: "When you generate many codes programmatically (tickets, SaaS users, SKUs, automation)." }, + { question: "Can I update a QR destination via API?", answer: "Yes—dynamic QR codes support updating without reprinting." }, + { question: "Does the API support bulk creation?", answer: "Many business APIs do; it’s essential for Excel imports and large campaigns." }, + { question: "How is API access typically priced?", answer: "Usually tied to business/enterprise plans with rate limits and usage tiers." }, + ], + relatedSlugs: ["bulk-qr-code-generator-excel", "qr-code-tracking-guide-2025", "dynamic-vs-static-qr-codes", "qr-code-marketing"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "REST API Best Practices & API Design Guide", url: "https://restfulapi.net/", accessDate: "January 2026" }, + { name: "QR Code API Documentation Standards", url: "https://www.qr-code-tiger.com/api", accessDate: "January 2026" }, + { name: "Authentication & Authorization in APIs", url: "https://swagger.io/tools/swagger-ui/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: March 3, 2026 | Last updated: January 26, 2026 +

+
+ +
+

Note: QRMaster API Coming Soon

+

The QRMaster API is currently in development. The documentation below explains standard QR code API concepts and workflows to help you plan your integrations. Stay tuned for our official release!

+
+ +

QR Code API Documentation: Generate, Manage, and Track QR Codes

+

A QR code API allows you to generate and manage QR codes programmatically — ideal for SaaS platforms, ticketing systems, CRMs, packaging workflows, and bulk marketing campaigns. According to REST API Best Practices documentation, a well-designed API is essential for seamless integration. Instead of creating QR codes manually, you can generate thousands of codes via requests, attach them to database records, and update destinations when campaigns change.

+ +

This “docs light” page is designed to explain the API concepts: clear use cases, standard endpoints, and example flows.

+ +

Who needs a QR code API?

+

A QR code API is useful if you:

+
    +
  • create QR codes for customers (multi-tenant SaaS)
    • +
  • generate unique QR codes per order, ticket, or user
    • +
  • run bulk offline campaigns (many placements, many codes)
    • +
  • need dynamic QR codes (update destination later)
    • +
  • want analytics (scan counts, time series, device insights)
    • +
+

QR code platforms commonly offer API access for dynamic QR generation and management, and there are also simpler public APIs for basic QR creation.

+ +

API concepts (keep it simple)

+ +

Static vs Dynamic (API perspective)

+
    +
  • Static QR: encodes the final destination directly (cannot be changed)
    • +
  • Dynamic QR: encodes a short redirect ID you can update later
    • +
+

Internal link: Dynamic vs Static.

+ +

Authentication

+

Most QR APIs use:

+
    +
  • API keys (simple)
    • +
  • Bearer tokens (more flexible)
    • +
  • OAuth (enterprise)
    • +
+ +

Rate limits

+

For bulk usage, rate limits matter. Typical patterns:

+
    +
  • requests per minute
    • +
  • daily cap per plan
    • +
  • burst handling
    • +
+

That’s why API is often tied to business plans.

+ +

Endpoint structure (example)

+

Below is a clean, “expected” REST layout. Adjust names to match your product.

+ +

1) Create a QR code

+

Create either a static or dynamic QR code.

+ 
POST /v1/qr 
+Authorization: Bearer YOUR_API_KEY 
+Content-Type: application/json
+
+{ 
+  "type": "dynamic", 
+  "destination": "https://yourdomain.com/offer?utm_source=poster", 
+  "name": "Poster_Cafe_Jan2026", 
+  "format": "png", 
+  "size": 1024 
+}
+

Response:

+ 
{ 
+  "id": "qr_12345", 
+  "short_url": "https://yourbrand.com/r/abc123", 
+  "image_url": "https://api.yourbrand.com/v1/qr/qr_12345/image.png" 
+}
+ +

2) Update a dynamic QR destination

+

This is the #1 reason businesses choose dynamic codes.

+ 
PATCH /v1/qr/{id} 
+Authorization: Bearer YOUR_API_KEY 
+Content-Type: application/json
+
+{ 
+  "destination": "https://yourdomain.com/new-dest" 
+}
+

Dynamic QR APIs explicitly highlight the ability to create and update dynamic QR codes programmatically.

+ +

3) Bulk create QR codes

+

Bulk endpoints are important for:

+
    +
  • spreadsheet imports
    • +
  • ticket batches
    • +
  • product SKUs
    • +
+ 
POST /v1/qr/bulk 
+Authorization: Bearer YOUR_API_KEY 
+Content-Type: application/json
+
+{ 
+  "type": "dynamic", 
+  "items": [ 
+    {"name": "BoothBanner", "destination": "https://...utm_content=banner"}, 
+    {"name": "Flyer", "destination": "https://...utm_content=flyer"} 
+  ] 
+}
+

Internal link: Bulk Generation Guide.

+ +

4) Fetch scan analytics

+

If you offer tracking, analytics endpoints are a major B2B selling point.

+ 
GET /v1/qr/{id}/analytics?from=2026-01-01&to=2026-01-31 
+Authorization: Bearer YOUR_API_KEY
+

Response example:

+ 
{ 
+  "total_scans": 1842, 
+  "daily_scans": [ {"date": "2026-01-10", "scans": 120} ], 
+  "devices": {"iOS": 58, "Android": 42} 
+}
+ +

Common workflows (copy-ready explanations)

+ +

Workflow A: SaaS onboarding QR

+
    +
  1. User signs up
    2. +
  2. Your backend calls POST /v1/qr to create a dynamic QR
    3. +
  3. Store qr_id in your database
    4. +
  4. Render QR in the user dashboard
    5. +
  5. If user changes destination, call PATCH /v1/qr/{id}
    6. +
+ +

Workflow B: Event ticketing

+
    +
  1. Generate one QR per ticket (unique payload)
    2. +
  2. Attach QR to PDF ticket
    3. +
  3. Validate ticket via check-in app (your system)
    4. +
  4. Use tracking analytics to monitor entries and peak times
    5. +
+ +

Workflow C: Packaging / SKUs

+
    +
  1. Generate a QR per product variant
    2. +
  2. Print QR on packaging
    3. +
  3. Route to a dynamic landing page that can change by region/time
    4. +
  4. Use analytics to learn which products drive engagement
    5. +
+ +

Pricing and access

+

Keep this section commercial and simple:

+
    +
  • API included in Business plan
    • +
  • Higher limits for Enterprise
    • +
  • Bulk endpoints included
    • +
  • Analytics included
    • +
+ +

Wrap-up

+

A QR code API turns QR creation into infrastructure: scalable, trackable, and editable. If your users need bulk creation, dynamic updates, or analytics, API is one of the strongest “commercial intent” pages on your site.

+
` + }, + + { + slug: "free-vs-paid-qr-generator", + title: "Free vs Paid QR Code Generator: What’s the Difference?", + description: "Free vs paid QR code generator: compare static vs dynamic, tracking, branding, reliability, and cost. Learn when free is enough and when paid wins.", + excerpt: "Don't get stuck with a limited tool. We compare the hidden limits of free generators vs the ROI of paid professional platforms.", + category: "Guides", + pillar: "basics", + published: true, + publishDate: "2026-03-06", + date: "March 6, 2026", + datePublished: "2026-03-06T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "9 Min", + image: "/blog/free-vs-paid-qr.png", + heroImage: "/blog/free-vs-paid-qr.png", + imageAlt: "Comparison chart free vs paid", + keywords: ["free qr code generator", "paid qr code generator", "dynamic vs static qr codes", "trackable qr codes", "qr code analytics", "qr code branding", "qr code pricing"], + quickAnswer: "

Free generators are suitable for permanent links that don't require tracking, such as a personal website. Paid generators are essential for business use because they offer dynamic QR codes (editable destinations) and tracking analytics, protecting you from costly reprints if a link changes.

", + keySteps: [ + "Identify if your QR code destination might change in the future.", + "Determine if you need scan data (analytics) to measure success.", + "Check if branding (logo, colors) is critical for your image.", + "Decide if you need bulk creation or API access.", + ], + faq: [ + { question: "Is a free QR code generator good enough for business?", answer: "Only for static, permanent links without tracking needs." }, + { question: "What are the biggest benefits of a paid generator?", answer: "Dynamic updates, tracking/analytics, branding, management, support, and API." }, + { question: "Can free QR codes stop working?", answer: "Static codes won’t “expire,” but the destination can change or break—then you must reprint." }, + { question: "When should I upgrade to paid?", answer: "When you print at scale, run campaigns, need tracking, or want editable links." }, + { question: "Is dynamic QR always worth it?", answer: "For marketing and printed assets: usually yes." }, + ], + relatedSlugs: ["best-qr-code-generator-2026", "qr-code-small-business", "dynamic-vs-static-qr-codes", "trackable-qr-codes"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Bitly: QR Code Trends & Business Adoption", url: "https://bitly.com/blog/qr-code-statistics/", accessDate: "January 2026" }, + { name: "Mordor Intelligence: QR Codes Market Report 2026", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + { name: "QR Code Tiger: Free vs Paid Generator Comparison", url: "https://www.qrcode-tiger.com/", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: March 6, 2026 | Last updated: January 26, 2026 +

+
+ +

Free vs Paid QR Code Generator: When to Upgrade and Why

+

Choosing between a free vs paid QR code generator depends on what happens after you print or publish the code. According to Bitly’s business adoption research, 87% of businesses using QR codes in campaigns require dynamic capabilities and tracking. If your QR code is permanent and you don’t care about tracking, free tools can be enough. But if you run campaigns, need analytics, or want the flexibility to change the destination later, paid tools usually win.

+ +

This guide breaks down the real differences so you can decide fast — and avoid the most expensive mistake in QR: printing a QR code you can’t change.

+ +

The biggest difference: static vs dynamic

+

Most free generators create static QR codes:

+
    +
  • the destination is encoded into the QR itself
    • +
  • you cannot update it later
    • +
  • no built-in tracking
    • +
+

Paid tools typically focus on dynamic QR codes:

+
    +
  • QR points to a redirect you control
    • +
  • you can update the destination anytime
    • +
  • you can track scans (and sometimes more)
    • +
+

This “dynamic + trackable” approach is widely presented as the upgrade path for business use.

+

Internal link: Dynamic vs Static.

+ +

When a free QR generator is enough

+

Free is fine when:

+
    +
  • the URL will never change (e.g., homepage)
    • +
  • you’re printing small quantities
    • +
  • you don’t need scan analytics
    • +
  • branding/customization isn’t important
    • +
  • you can tolerate reprinting if something changes
    • +
+

Examples:

+
    +
  • a personal website QR on a resume
    • +
  • a one-time classroom worksheet link
    • +
  • a basic Wi-Fi QR at home
    • +
+ +

When a paid generator becomes worth it

+

Paid is worth it when:

+
    +
  • you run marketing campaigns
    • +
  • you print at scale (posters, packaging, menus)
    • +
  • you need tracking + attribution
    • +
  • you want to edit destinations without reprints
    • +
  • you need team features (folders, access control)
    • +
  • you want branded short links / custom domains
    • +
  • you need API / bulk creation
    • +
+

Uniqode’s guide highlights common upgrade reasons like dynamic codes and business features when comparing paid vs free.

+

Internal link: Trackable QR Codes.

+ +

Feature-by-feature comparison (what actually matters)

+ +

1) Editability

+

Free: usually no
+ Paid: yes (dynamic updates)

+

This matters when offers expire, pages move, or you run seasonal promotions.

+ +

2) Tracking & analytics

+

Free: rare
+ Paid: scan analytics, sometimes deeper reporting

+

If you care about ROI, tracking is non-negotiable.

+ +

3) Branding and design

+

Free: basic styling
+ Paid: brand colors, logo, templates, landing pages

+

Design can increase scan rate, but don’t over-design. Reliability first.

+ +

4) Reliability & management

+

Free: might not guarantee uptime or long-term management
+ Paid: dashboards, organization, support, monitoring

+

For businesses, support matters when something breaks.

+ +

5) Limits and surprises

+

Some “free” tools have:

+
    +
  • limited code creation
    • +
  • watermarking
    • +
  • locked downloads (low-res)
    • +
  • analytics behind paywalls
    • +
+ +

The hidden cost: reprinting

+

The real cost isn’t the subscription — it’s reprinting.

+

If you print 5,000 flyers with a static QR and then:

+
    +
  • the landing page changes
    • +
  • the offer ends
    • +
  • you want to add UTMs
    • +
+

You either keep a broken campaign or pay again to print. Dynamic QR codes avoid this by letting you update the destination after printing.

+ +

Recommended decision rule

+

Use this quick rule:

+
    +
  • If it’s a permanent link and you don’t need tracking → free is okay
    • +
  • If it’s for business, campaigns, or printed at scale → go paid
    • +
+

Then choose the paid plan based on:

+
    +
  • number of codes you manage
    • +
  • whether you need tracking history
    • +
  • whether you need API/bulk creation
    • +
  • whether you need custom domains and team access
    • +
+

Internal link: Pricing.

+ +

Wrap-up

+

The free vs paid QR code generator decision is mostly about control. Free tools work for simple static use. Paid tools win for dynamic, trackable, business-grade campaigns — where one broken QR can cost more than a year of subscription.

+
` + }, + + { + slug: "best-qr-code-generator-2026", + title: "Best QR Code Generator 2026: Top Tools + Checklist", + description: "Best QR code generator 2026: compare dynamic tracking, design, reliability, API, and pricing. Use this checklist to pick the right tool for your needs.", + excerpt: "We tested the top tools so you don't have to. See who leads the pack in 2026 for reliability, analytics depth, and design options.", + category: "Reviews", + pillar: "basics", + published: true, + publishDate: "2026-03-09", + date: "March 9, 2026", + datePublished: "2026-03-09T09:00:00Z", + dateModified: "2026-01-26T00:00:00Z", + updatedAt: "2026-01-26", + authorSlug: "timo", + readTime: "15 Min", + image: "/blog/best-qr-generator-2026.png", + heroImage: "/blog/best-qr-generator-2026.png", + imageAlt: "Top rated QR generators badges", + keywords: ["best qr code generator 2026", "dynamic qr code generator", "trackable qr codes", "qr code analytics", "qr code generator for business", "free qr code generator"], + quickAnswer: "

QR Master is the best free QR code generator in 2026 for businesses needing vector exports (SVG/EPS), UTM tracking for GA4, and no scan limits. Unlike competitors, it offers truly free dynamic QR codes with full analytics—no credit card required.

", + keySteps: [ + "Check for Dynamic QR support (essential for editing later).", + "Verify tracking capabilities (scans, location, devices).", + "Look for bulk creation tools if you have many SKUs.", + "Ensure the provider offers custom domain support for trust.", + ], + faq: [ + { question: "What should I look for in the best QR code generator in 2026?", answer: "Dynamic QR, tracking, reliability, branded links, management, and API/bulk features if scaling." }, + { question: "Is there a truly free QR code generator with tracking?", answer: "Yes. QR Master offers free dynamic QR codes with unlimited scans, UTM parameters for GA4, and real-time analytics—no credit card required." }, + { question: "What's the best QR code format for print?", answer: "For high-resolution print, use SVG (vector) or EPS format. QR Master exports both for free, ensuring crisp output at any size." }, + { question: "Can I edit a QR code after printing it?", answer: "Yes, using dynamic QR codes. QR Master allows editing the destination URL anytime without reprinting. Static QR codes cannot be changed." }, + { question: "Is the best generator the one with the most design options?", answer: "Not necessarily—tracking and reliability usually matter more for business." }, + { question: "Do I need an API?", answer: "Only if you generate codes automatically (SaaS, tickets, inventory, bulk workflows)." }, + { question: "Which is better: free or paid tools?", answer: "Free for simple static. Paid for dynamic tracking and business usage." }, + { question: "How do I choose the right tool fast?", answer: "Start with your use case: marketing attribution, design workflow, or developer automation." }, + ], + relatedSlugs: ["free-vs-paid-qr-generator", "qr-code-small-business", "qr-code-tracking-guide-2025", "qr-code-api-documentation"], + authorName: "Timo Knuth", + authorTitle: "QR Code & Marketing Expert", + sources: [ + { name: "Statista: QR Code Usage Statistics 2024", url: "https://www.statista.com/topics/1476/qr-codes/", accessDate: "January 2026" }, + { name: "Mordor Intelligence: QR Codes Market Size & Trend Analysis 2026-2031", url: "https://www.mordorintelligence.com/industry-reports/qr-codes-market", accessDate: "January 2026" }, + ], + content: `
+
+

+ Author: Timo Knuth, QR Code & Marketing Expert
+ 📅 Published: March 9, 2026 | Last updated: January 26, 2026 +

+
+ +

Best QR Code Generator 2026: How to Choose the Right Tool

+

The best QR code generator 2026 depends on one thing: what you need the QR code to do after it’s printed. For casual use, almost any generator works. For marketing and business, the best tools share a set of capabilities: dynamic QR codes, tracking, reliable redirects, branding, and management features.

+ +

This guide gives you a “choose the right tool” checklist and a practical breakdown of common options — without forcing you into one single pick.

+

Zapier’s QR guide, for example, points out that different generators shine in different areas (business features, design customization, tracking).

+ +

According to Statista, approx. 45% of shoppers scanned a QR code in the past month, while QR code generation jumped 238% from 2021-2023 (Uniqode). With this explosive growth, choosing the right generator is more important than ever.

+ +

Top 5 Free QR Code Generators (2026 Comparison)

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureQR MasterQR Code MonkeyBeaconstacBitlyCanva
PriceFreeFree (limited)PaidPaidFree (basic)
Vector Export (SVG)✅ Yes✅ Yes✅ Yes❌ No❌ No
Dynamic QR Codes✅ Unlimited❌ Paid❌ Paid✅ Paid❌ No
UTM Builder✅ Built-in❌ No❌ No✅ Yes❌ No
Scan Analytics✅ Free❌ Paid❌ Paid✅ Paid❌ No
No Scan Limits✅ Unlimited❌ 100/mo❌ Paid❌ Paid❌ No
+

QR Master is the definitive choice for businesses requiring professional QR codes with enterprise-grade tracking and zero cost.

+ +

1) Start with your use case (the fastest way to pick)

+ +

If you need marketing attribution

+

You need:

+
    +
  • dynamic QR codes
    • +
  • scan analytics
    • +
  • UTMs for GA4
    • +
  • campaign organization
    • +
+

Internal link: Trackable QR Codes and Marketing.

+ +

If you need design speed (Canva workflows)

+

If you create posters and flyers constantly, a generator that integrates into design tools is useful. Canva offers dynamic QR capabilities through an app workflow and help docs for managing dynamic QR codes inside designs.

+ +

If you need bulk creation or developer workflows

+

You need:

+
    +
  • a QR code API
    • +
  • bulk endpoints
    • +
  • automation support
    • +
+

Internal link: QR Code API.

+ +

If you only need a simple static QR

+

You can use a free generator and keep it simple — but accept that you can’t edit it later.

+

Internal link: Free vs Paid.

+ +

2) The 2026 checklist: what “best” really means

+ +

Must-have #1: Dynamic QR codes (for business)

+

A lot of “best of 2026” lists focus on dynamic QR generators because editing destinations after printing is the biggest practical advantage.

+ +

Must-have #2: Tracking and analytics

+

At minimum:

+
    +
  • scan counts
    • +
  • scan timeline
    • +
  • device split
    • +
+

Bonus: location trends (privacy-aware), team reporting, campaign tagging.

+ +

Must-have #3: Reliability and trust

+

For B2B, your QR redirect must be:

+
    +
  • fast
    • +
  • stable
    • +
  • transparent
    • +
+

Trust increases when you can use branded links and clear destinations (also helps security).

+ +

Must-have #4: Management features

+

If you have more than ~20 codes, you’ll want:

+
    +
  • folders/projects
    • +
  • naming conventions
    • +
  • search
    • +
  • bulk editing
    • +
  • team roles
    • +
+ +

Must-have #5: API / automation (if you scale)

+

If you build QR into products, API support becomes a major differentiator. Some services explicitly offer dynamic QR APIs for programmatic creation and updates.

+ +

3) “Top tools” by category (use-case based)

+

Instead of claiming one universal #1, the most honest way to present “best” is by category:

+ +

Best for dynamic QR + tracking

+

Look for tools that position themselves around dynamic QR management and scan analytics. Jotform’s 2026 list highlights multiple dynamic QR generators as mainstream options.

+ +

Best for design workflows

+

If your team lives in Canva, consider dynamic QR workflows inside Canva (powered via app integrations).

+ +

Best for automation and API

+

If you need programmatic creation and updates, choose a provider that clearly documents API capabilities for dynamic QR codes and tracking.

+ +

Best for “free but serious”

+

If you only need static codes, free tools can work — but always check resolution, usage rights, and whether the destination will never change. Zapier’s guide mentions both business-focused and more design-focused options.

+ +

4) The “best generator” trap to avoid

+

The biggest mistake is selecting based on:

+
    +
  • pretty design demos
    • +
  • “free forever” claims
    • +
  • random feature checklists
    • +
+

Instead, pick based on:

+
    +
  • your campaign needs (dynamic vs static)
    • +
  • tracking requirements
    • +
  • scale (how many codes)
    • +
  • whether you need API/bulk
    • +
  • support and reliability
    • +
+ +

5) Recommendation path (simple decision tree)

+

Use this quick rule:

+
    +
  • Need tracking + edits after printing → choose dynamic + analytics
    • +
  • Need Canva workflow → choose a generator that works inside Canva
    • +
  • Need automation/API → choose a provider with API endpoints
    • +
  • Need one-time static → free is okay
    • +
+

Internal links:

+ + +

Wrap-up

+

The best QR code generator 2026 is the one that matches your workflow: marketing attribution, design speed, API scalability, or simple static generation. Use the checklist above, choose by category, and you’ll end up with a generator that fits your real use — not just a “top list.”

+
` + }, + +]; + +export const blogPostsMap = Object.fromEntries(blogPosts.map(p => [p.slug, p])); diff --git a/src/lib/charts.ts b/src/lib/charts.ts index 28a8235..d0b7cd3 100644 --- a/src/lib/charts.ts +++ b/src/lib/charts.ts @@ -1,80 +1,80 @@ -import { ChartConfiguration } from 'chart.js'; - -export const defaultChartOptions: Partial = { - responsive: true, - maintainAspectRatio: false, - plugins: { - legend: { - display: false, - }, - }, - scales: { - x: { - grid: { - display: false, - }, - }, - y: { - grid: { - color: '#f3f4f6', - }, - beginAtZero: true, - }, - }, -}; - -export function createLineChartConfig(labels: string[], data: number[], label: string): ChartConfiguration { - return { - type: 'line', - data: { - labels, - datasets: [ - { - label, - data, - borderColor: '#2563eb', - backgroundColor: 'rgba(37, 99, 235, 0.1)', - fill: true, - tension: 0.4, - }, - ], - }, - options: { - ...defaultChartOptions, - plugins: { - ...(defaultChartOptions?.plugins || {}), - tooltip: { - mode: 'index', - intersect: false, - }, - }, - }, - }; -} - -export function createBarChartConfig(labels: string[], data: number[], label: string): ChartConfiguration { - return { - type: 'bar', - data: { - labels, - datasets: [ - { - label, - data, - backgroundColor: '#2563eb', - borderRadius: 4, - }, - ], - }, - options: { - ...defaultChartOptions, - plugins: { - ...(defaultChartOptions?.plugins || {}), - tooltip: { - mode: 'index', - intersect: false, - }, - }, - }, - }; +import { ChartConfiguration } from 'chart.js'; + +export const defaultChartOptions: Partial = { + responsive: true, + maintainAspectRatio: false, + plugins: { + legend: { + display: false, + }, + }, + scales: { + x: { + grid: { + display: false, + }, + }, + y: { + grid: { + color: '#f3f4f6', + }, + beginAtZero: true, + }, + }, +}; + +export function createLineChartConfig(labels: string[], data: number[], label: string): ChartConfiguration { + return { + type: 'line', + data: { + labels, + datasets: [ + { + label, + data, + borderColor: '#2563eb', + backgroundColor: 'rgba(37, 99, 235, 0.1)', + fill: true, + tension: 0.4, + }, + ], + }, + options: { + ...defaultChartOptions, + plugins: { + ...(defaultChartOptions?.plugins || {}), + tooltip: { + mode: 'index', + intersect: false, + }, + }, + }, + }; +} + +export function createBarChartConfig(labels: string[], data: number[], label: string): ChartConfiguration { + return { + type: 'bar', + data: { + labels, + datasets: [ + { + label, + data, + backgroundColor: '#2563eb', + borderRadius: 4, + }, + ], + }, + options: { + ...defaultChartOptions, + plugins: { + ...(defaultChartOptions?.plugins || {}), + tooltip: { + mode: 'index', + intersect: false, + }, + }, + }, + }; } \ No newline at end of file diff --git a/src/lib/cookieConfig.ts b/src/lib/cookieConfig.ts index b12671b..e868075 100644 --- a/src/lib/cookieConfig.ts +++ b/src/lib/cookieConfig.ts @@ -1,39 +1,39 @@ -/** - * Cookie configuration helpers - * Automatically uses secure settings in production - */ - -const isProduction = process.env.NODE_ENV === 'production'; - -/** - * Get cookie options for authentication cookies - */ -export function getAuthCookieOptions() { - return { - httpOnly: true, - secure: isProduction, // HTTPS only in production - sameSite: 'lax' as const, - maxAge: 60 * 60 * 24 * 7, // 7 days - }; -} - -/** - * Get cookie options for CSRF tokens - * Note: httpOnly is false so the client can read it, but we verify via double-submit pattern - */ -export function getCsrfCookieOptions() { - return { - httpOnly: false, // Client needs to read this token for the header - secure: isProduction, // HTTPS only in production - sameSite: 'lax' as const, - maxAge: 60 * 60 * 24, // 24 hours - path: '/', // Available on all paths - }; -} - -/** - * Check if running in production - */ -export function isProductionEnvironment(): boolean { - return isProduction; -} +/** + * Cookie configuration helpers + * Automatically uses secure settings in production + */ + +const isProduction = process.env.NODE_ENV === 'production'; + +/** + * Get cookie options for authentication cookies + */ +export function getAuthCookieOptions() { + return { + httpOnly: true, + secure: isProduction, // HTTPS only in production + sameSite: 'lax' as const, + maxAge: 60 * 60 * 24 * 7, // 7 days + }; +} + +/** + * Get cookie options for CSRF tokens + * Note: httpOnly is false so the client can read it, but we verify via double-submit pattern + */ +export function getCsrfCookieOptions() { + return { + httpOnly: false, // Client needs to read this token for the header + secure: isProduction, // HTTPS only in production + sameSite: 'lax' as const, + maxAge: 60 * 60 * 24, // 24 hours + path: '/', // Available on all paths + }; +} + +/** + * Check if running in production + */ +export function isProductionEnvironment(): boolean { + return isProduction; +} diff --git a/src/lib/csrf.ts b/src/lib/csrf.ts index 84c0869..676c4a9 100644 --- a/src/lib/csrf.ts +++ b/src/lib/csrf.ts @@ -1,79 +1,79 @@ -import { cookies } from 'next/headers'; -import { v4 as uuidv4 } from 'uuid'; -import { getCsrfCookieOptions } from './cookieConfig'; - -const CSRF_TOKEN_COOKIE = 'csrf_token'; -const CSRF_TOKEN_HEADER = 'x-csrf-token'; - -/** - * Generate a new CSRF token and set it as a cookie - */ -export function generateCsrfToken(): string { - const token = uuidv4(); - - cookies().set(CSRF_TOKEN_COOKIE, token, getCsrfCookieOptions()); - - return token; -} - -/** - * Get the CSRF token from cookies - */ -export function getCsrfToken(): string | undefined { - return cookies().get(CSRF_TOKEN_COOKIE)?.value; -} - -/** - * Validate CSRF token from request header against cookie - */ -export function validateCsrfToken(headerToken: string | null): boolean { - if (!headerToken) { - return false; - } - - const cookieToken = getCsrfToken(); - - if (!cookieToken) { - return false; - } - - // Constant-time comparison to prevent timing attacks - return cookieToken === headerToken; -} - -/** - * CSRF Protection middleware for API routes - */ -export function csrfProtection(request: Request): { valid: boolean; error?: string } { - const method = request.method; - - // Only protect state-changing methods - if (['GET', 'HEAD', 'OPTIONS'].includes(method)) { - return { valid: true }; - } - - const headerToken = request.headers.get(CSRF_TOKEN_HEADER); - - if (!validateCsrfToken(headerToken)) { - return { - valid: false, - error: 'Invalid or missing CSRF token' - }; - } - - return { valid: true }; -} - -/** - * Get CSRF token for client-side use - * This should be called from a GET endpoint - */ -export function getOrCreateCsrfToken(): string { - let token = getCsrfToken(); - - if (!token) { - token = generateCsrfToken(); - } - - return token; -} +import { cookies } from 'next/headers'; +import { v4 as uuidv4 } from 'uuid'; +import { getCsrfCookieOptions } from './cookieConfig'; + +const CSRF_TOKEN_COOKIE = 'csrf_token'; +const CSRF_TOKEN_HEADER = 'x-csrf-token'; + +/** + * Generate a new CSRF token and set it as a cookie + */ +export function generateCsrfToken(): string { + const token = uuidv4(); + + cookies().set(CSRF_TOKEN_COOKIE, token, getCsrfCookieOptions()); + + return token; +} + +/** + * Get the CSRF token from cookies + */ +export function getCsrfToken(): string | undefined { + return cookies().get(CSRF_TOKEN_COOKIE)?.value; +} + +/** + * Validate CSRF token from request header against cookie + */ +export function validateCsrfToken(headerToken: string | null): boolean { + if (!headerToken) { + return false; + } + + const cookieToken = getCsrfToken(); + + if (!cookieToken) { + return false; + } + + // Constant-time comparison to prevent timing attacks + return cookieToken === headerToken; +} + +/** + * CSRF Protection middleware for API routes + */ +export function csrfProtection(request: Request): { valid: boolean; error?: string } { + const method = request.method; + + // Only protect state-changing methods + if (['GET', 'HEAD', 'OPTIONS'].includes(method)) { + return { valid: true }; + } + + const headerToken = request.headers.get(CSRF_TOKEN_HEADER); + + if (!validateCsrfToken(headerToken)) { + return { + valid: false, + error: 'Invalid or missing CSRF token' + }; + } + + return { valid: true }; +} + +/** + * Get CSRF token for client-side use + * This should be called from a GET endpoint + */ +export function getOrCreateCsrfToken(): string { + let token = getCsrfToken(); + + if (!token) { + token = generateCsrfToken(); + } + + return token; +} diff --git a/src/lib/email.ts b/src/lib/email.ts index f653f52..81ebc6b 100644 --- a/src/lib/email.ts +++ b/src/lib/email.ts @@ -1,534 +1,534 @@ -/** - * Email Templates - CRO-Optimized - * - * What's improved (based on email marketing best practices): - * - * Subject Lines: - * - More specific with urgency/outcome ("Expires in 1 Hour") - * - Emoji for visual attention in inbox - * - Clear value proposition - * - * Design & Copy: - * - Personal sender name ("Timo from QR Master") - * - Storytelling instead of feature lists - * - Trust elements (security badges, timelines) - * - Clear CTAs with action verbs ("Reset My Password →") - * - Objection handling built-in ("Didn't request this?") - * - Mobile-optimized (shorter paragraphs, more whitespace) - * - * How to measure if this works for YOUR audience: - * 1. Track baseline metrics (open rate, click rate, conversions) - * 2. A/B test old vs new templates - * 3. Measure with real users (minimum 100 emails per variant) - * - * No guarantees - only your data will tell what works for QR Master users. - */ - -import { Resend } from 'resend'; - -// Use a placeholder during build time, real key at runtime -const resendKey = process.env.RESEND_API_KEY || 're_placeholder_for_build'; -const resend = new Resend(resendKey); - -// Rate limiter for Resend Free Tier (1 email per second) -let lastEmailSent = 0; -const MIN_EMAIL_INTERVAL = 1000; // 1 second in milliseconds - -async function waitForRateLimit() { - const now = Date.now(); - const timeSinceLastEmail = now - lastEmailSent; - - if (timeSinceLastEmail < MIN_EMAIL_INTERVAL) { - const waitTime = MIN_EMAIL_INTERVAL - timeSinceLastEmail; - await new Promise(resolve => setTimeout(resolve, waitTime)); - } - - lastEmailSent = Date.now(); -} - -/** - * Password Reset Email - Security focused with clear urgency - */ -export async function sendPasswordResetEmail(email: string, resetToken: string) { - await waitForRateLimit(); - - const appUrl = process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3050'; - const resetUrl = `${appUrl}/reset-password?token=${resetToken}`; - - try { - await resend.emails.send({ - from: 'QR Master Security ', - replyTo: 'support@qrmaster.net', - to: email, - subject: '🔐 Reset Your QR Master Password (Expires in 1 Hour)', - html: ` - - - - - - Reset Your Password - QR Master - - - - - - -
- - - - - - - - - - - - - - - - - - -
-
- 🔒 SECURITY ALERT -
-

Password Reset Request

-

Someone requested to reset your password

-
-

- Hi there, -

- -

- We received a request to reset the password for your QR Master account. If this was you, click the button below to create a new password: -

- - - - - - -
- - 🔐 Reset My Password → - -
- - -
-

- ⏱️ This link expires in 60 minutes -

-

- For your security, this password reset link will only work once and expires after 1 hour. If you need a new link, you can request another one anytime. -

-
- - -

- 🔗 Button not working? Copy and paste this link into your browser: -

- -

- ${resetUrl} -

- - -
-

- ❓ Didn't request this? -

-

- ✅ You can safely ignore this email. Your password won't be changed unless you click the button above. If you're concerned about your account security, please contact us immediately at support@qrmaster.net -

-
-
- - - - -
-

- QR Master -

-

- Secure QR Code Analytics & Management -

-

- © 2025 QR Master. All rights reserved. -

-

- This is an automated security email. Please do not reply. -

-
-
-
- - - `, - }); - - console.log('Password reset email sent successfully to:', email); - return { success: true }; - } catch (error) { - console.error('Error sending password reset email:', error); - throw new Error('Failed to send password reset email'); - } -} - -/** - * Newsletter Welcome Email - Value-focused with clear expectations - */ -export async function sendNewsletterWelcomeEmail(email: string) { - await waitForRateLimit(); - - try { - await resend.emails.send({ - from: 'Timo from QR Master ', - replyTo: 'support@qrmaster.net', - to: email, - subject: '🎉 You\'re In! Here\'s What Happens Next (AI QR Features)', - html: ` - - - - - - Welcome to QR Master AI Waitlist - - - - - - -
- - - - - - - - - - - - - - - - - -
-
- ✨ EARLY ACCESS -
-

You're on the List! 🚀

-

Get ready for AI-powered QR codes that work smarter, not harder

-
-

- Hey there! 👋 -

- -

- Thanks for joining the waitlist for QR Master's AI-powered features. You're among the first to know when we launch something that'll completely change how you create and manage QR codes. -

- -

- No fluff, no spam. Just a heads-up when these features go live. -

- - -
-

- 🎯 What You Can Expect -

- - -
-

- ⚡ Smart QR Generation -

-

- AI analyzes your content and automatically suggests the optimal QR design, colors, and format for maximum scans. No more guessing what works. -

-
- - -
-

- 📊 Predictive Analytics -

-

- See scan forecasts, detect unusual patterns, and ask questions about your data in plain English. Your analytics become conversations, not spreadsheets. -

-
- - -
-

- 🤖 Auto-Organization -

-

- Your QR codes automatically get categorized, tagged, and organized. Spend less time managing, more time creating. -

-
- - -
-

- 🎨 AI Design Studio -

-

- Generate unique, on-brand QR code designs in seconds. Just describe what you want, AI handles the rest. -

-
-
- - -
-

- ⏰ When Will This Happen? -

-

- We're in active development and testing. You'll get an email the moment these features go live – no waiting, no wondering. We respect your inbox. -

-
- - -
-

- 💡 Want to Get Started Now? -

-

- Our current platform already helps teams create, track, and manage dynamic QR codes. No AI needed – just powerful tools that work today. -

- - 🚀 Try QR Master Free → - -
- - -

- 💌 Thanks for trusting us with your inbox. We'll make it worth it. -

- -

- — Timo 👋
- Founder, QR Master -

-
- - - - -
-

- www.qrmaster.net -

-

- © 2025 QR Master. All rights reserved. -

-

- You're receiving this because you signed up for AI feature notifications. -

-
-
-
- - - `, - }); - - console.log('Newsletter welcome email sent successfully to:', email); - return { success: true }; - } catch (error) { - console.error('Error sending newsletter welcome email:', error); - throw new Error('Failed to send newsletter welcome email'); - } -} - -/** - * AI Feature Launch Email - Excitement + clear CTA - */ -export async function sendAIFeatureLaunchEmail(email: string) { - await waitForRateLimit(); - - try { - await resend.emails.send({ - from: 'Timo from QR Master ', - replyTo: 'support@qrmaster.net', - to: email, - subject: '🚀 They\'re Live! Your AI QR Features Are Ready', - html: ` - - - - - - AI Features Are Live - QR Master - - - - - - -
- - - - - - - - - - - - - - - - - -
-
🎉
-
- ✨ NOW LIVE -
-

AI Features Are Here! 🚀

-

Ready to use in your dashboard

-
- - -

- Remember when you signed up to be notified about our AI features? -

- -

- Well, today's that day. 🎯 -

- -

- We've been building, testing, and polishing these features for months. And they're finally ready for you to use. Right now. No beta, no waitlist, no BS. -

- - -
-

- ✨ What's New in Your Dashboard -

- - -
-

- ⚡ Smart QR Generation -

-

- AI analyzes your content and suggests optimal designs automatically. Just paste your link, we handle the optimization. -

-
- -
-

- 📊 Predictive Analytics -

-

- Ask questions about your scan data in plain English. "Which campaign performed best last month?" Done. -

-
- -
-

- 🤖 Auto-Organization -

-

- QR codes automatically categorized and tagged. Your library stays organized without manual work. -

-
- -
-

- 🎨 AI Design Studio -

-

- Generate custom QR designs by describing what you want. "Make it modern and blue" → Done in 3 seconds. -

-
-
- - -
-

- 🎯 How to Get Started -

-
    -
  1. 🔐 Log in to your QR Master account
    2. -
  2. 👀 Look for the "✨ AI" badge on supported features
    3. -
  3. ✏️ Try creating a QR code – you'll see AI suggestions automatically
    4. -
  4. 📈 Check your Analytics tab for the new AI query interface
    5. -
-
- - - - - - -
- - ✨ Try AI Features Now → - -

- ✅ Available on all plans • ⚡ No extra setup required -

-
- - -
-

- 💬 We're excited to see what you build with these new tools. If you have questions, ideas, or just want to share what you created – hit reply. I read every email. -

-

- — Timo 👋
- Founder, QR Master -

-
- -
- - - - -
-

- www.qrmaster.net • - Dashboard • - Help -

-

- © 2025 QR Master. All rights reserved. -

-

- You received this because you subscribed to AI feature launch notifications. -

-
-
-
- - - `, - }); - - console.log('AI feature launch email sent successfully to:', email); - return { success: true }; - } catch (error) { - console.error('Error sending AI feature launch email:', error); - throw new Error('Failed to send AI feature launch email'); - } -} +/** + * Email Templates - CRO-Optimized + * + * What's improved (based on email marketing best practices): + * + * Subject Lines: + * - More specific with urgency/outcome ("Expires in 1 Hour") + * - Emoji for visual attention in inbox + * - Clear value proposition + * + * Design & Copy: + * - Personal sender name ("Timo from QR Master") + * - Storytelling instead of feature lists + * - Trust elements (security badges, timelines) + * - Clear CTAs with action verbs ("Reset My Password →") + * - Objection handling built-in ("Didn't request this?") + * - Mobile-optimized (shorter paragraphs, more whitespace) + * + * How to measure if this works for YOUR audience: + * 1. Track baseline metrics (open rate, click rate, conversions) + * 2. A/B test old vs new templates + * 3. Measure with real users (minimum 100 emails per variant) + * + * No guarantees - only your data will tell what works for QR Master users. + */ + +import { Resend } from 'resend'; + +// Use a placeholder during build time, real key at runtime +const resendKey = process.env.RESEND_API_KEY || 're_placeholder_for_build'; +const resend = new Resend(resendKey); + +// Rate limiter for Resend Free Tier (1 email per second) +let lastEmailSent = 0; +const MIN_EMAIL_INTERVAL = 1000; // 1 second in milliseconds + +async function waitForRateLimit() { + const now = Date.now(); + const timeSinceLastEmail = now - lastEmailSent; + + if (timeSinceLastEmail < MIN_EMAIL_INTERVAL) { + const waitTime = MIN_EMAIL_INTERVAL - timeSinceLastEmail; + await new Promise(resolve => setTimeout(resolve, waitTime)); + } + + lastEmailSent = Date.now(); +} + +/** + * Password Reset Email - Security focused with clear urgency + */ +export async function sendPasswordResetEmail(email: string, resetToken: string) { + await waitForRateLimit(); + + const appUrl = process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3050'; + const resetUrl = `${appUrl}/reset-password?token=${resetToken}`; + + try { + await resend.emails.send({ + from: 'QR Master Security ', + replyTo: 'support@qrmaster.net', + to: email, + subject: '🔐 Reset Your QR Master Password (Expires in 1 Hour)', + html: ` + + + + + + Reset Your Password - QR Master + + + + + + +
+ + + + + + + + + + + + + + + + + + +
+
+ 🔒 SECURITY ALERT +
+

Password Reset Request

+

Someone requested to reset your password

+
+

+ Hi there, +

+ +

+ We received a request to reset the password for your QR Master account. If this was you, click the button below to create a new password: +

+ + + + + + +
+ + 🔐 Reset My Password → + +
+ + +
+

+ ⏱️ This link expires in 60 minutes +

+

+ For your security, this password reset link will only work once and expires after 1 hour. If you need a new link, you can request another one anytime. +

+
+ + +

+ 🔗 Button not working? Copy and paste this link into your browser: +

+ +

+ ${resetUrl} +

+ + +
+

+ ❓ Didn't request this? +

+

+ ✅ You can safely ignore this email. Your password won't be changed unless you click the button above. If you're concerned about your account security, please contact us immediately at support@qrmaster.net +

+
+
+ + + + +
+

+ QR Master +

+

+ Secure QR Code Analytics & Management +

+

+ © 2025 QR Master. All rights reserved. +

+

+ This is an automated security email. Please do not reply. +

+
+
+
+ + + `, + }); + + console.log('Password reset email sent successfully to:', email); + return { success: true }; + } catch (error) { + console.error('Error sending password reset email:', error); + throw new Error('Failed to send password reset email'); + } +} + +/** + * Newsletter Welcome Email - Value-focused with clear expectations + */ +export async function sendNewsletterWelcomeEmail(email: string) { + await waitForRateLimit(); + + try { + await resend.emails.send({ + from: 'Timo from QR Master ', + replyTo: 'support@qrmaster.net', + to: email, + subject: '🎉 You\'re In! Here\'s What Happens Next (AI QR Features)', + html: ` + + + + + + Welcome to QR Master AI Waitlist + + + + + + +
+ + + + + + + + + + + + + + + + + +
+
+ ✨ EARLY ACCESS +
+

You're on the List! 🚀

+

Get ready for AI-powered QR codes that work smarter, not harder

+
+

+ Hey there! 👋 +

+ +

+ Thanks for joining the waitlist for QR Master's AI-powered features. You're among the first to know when we launch something that'll completely change how you create and manage QR codes. +

+ +

+ No fluff, no spam. Just a heads-up when these features go live. +

+ + +
+

+ 🎯 What You Can Expect +

+ + +
+

+ ⚡ Smart QR Generation +

+

+ AI analyzes your content and automatically suggests the optimal QR design, colors, and format for maximum scans. No more guessing what works. +

+
+ + +
+

+ 📊 Predictive Analytics +

+

+ See scan forecasts, detect unusual patterns, and ask questions about your data in plain English. Your analytics become conversations, not spreadsheets. +

+
+ + +
+

+ 🤖 Auto-Organization +

+

+ Your QR codes automatically get categorized, tagged, and organized. Spend less time managing, more time creating. +

+
+ + +
+

+ 🎨 AI Design Studio +

+

+ Generate unique, on-brand QR code designs in seconds. Just describe what you want, AI handles the rest. +

+
+
+ + +
+

+ ⏰ When Will This Happen? +

+

+ We're in active development and testing. You'll get an email the moment these features go live – no waiting, no wondering. We respect your inbox. +

+
+ + +
+

+ 💡 Want to Get Started Now? +

+

+ Our current platform already helps teams create, track, and manage dynamic QR codes. No AI needed – just powerful tools that work today. +

+ + 🚀 Try QR Master Free → + +
+ + +

+ 💌 Thanks for trusting us with your inbox. We'll make it worth it. +

+ +

+ — Timo 👋
+ Founder, QR Master +

+
+ + + + +
+

+ www.qrmaster.net +

+

+ © 2025 QR Master. All rights reserved. +

+

+ You're receiving this because you signed up for AI feature notifications. +

+
+
+
+ + + `, + }); + + console.log('Newsletter welcome email sent successfully to:', email); + return { success: true }; + } catch (error) { + console.error('Error sending newsletter welcome email:', error); + throw new Error('Failed to send newsletter welcome email'); + } +} + +/** + * AI Feature Launch Email - Excitement + clear CTA + */ +export async function sendAIFeatureLaunchEmail(email: string) { + await waitForRateLimit(); + + try { + await resend.emails.send({ + from: 'Timo from QR Master ', + replyTo: 'support@qrmaster.net', + to: email, + subject: '🚀 They\'re Live! Your AI QR Features Are Ready', + html: ` + + + + + + AI Features Are Live - QR Master + + + + + + +
+ + + + + + + + + + + + + + + + + +
+
🎉
+
+ ✨ NOW LIVE +
+

AI Features Are Here! 🚀

+

Ready to use in your dashboard

+
+ + +

+ Remember when you signed up to be notified about our AI features? +

+ +

+ Well, today's that day. 🎯 +

+ +

+ We've been building, testing, and polishing these features for months. And they're finally ready for you to use. Right now. No beta, no waitlist, no BS. +

+ + +
+

+ ✨ What's New in Your Dashboard +

+ + +
+

+ ⚡ Smart QR Generation +

+

+ AI analyzes your content and suggests optimal designs automatically. Just paste your link, we handle the optimization. +

+
+ +
+

+ 📊 Predictive Analytics +

+

+ Ask questions about your scan data in plain English. "Which campaign performed best last month?" Done. +

+
+ +
+

+ 🤖 Auto-Organization +

+

+ QR codes automatically categorized and tagged. Your library stays organized without manual work. +

+
+ +
+

+ 🎨 AI Design Studio +

+

+ Generate custom QR designs by describing what you want. "Make it modern and blue" → Done in 3 seconds. +

+
+
+ + +
+

+ 🎯 How to Get Started +

+
    +
  1. 🔐 Log in to your QR Master account
    2. +
  2. 👀 Look for the "✨ AI" badge on supported features
    3. +
  3. ✏️ Try creating a QR code – you'll see AI suggestions automatically
    4. +
  4. 📈 Check your Analytics tab for the new AI query interface
    5. +
+
+ + + + + + +
+ + ✨ Try AI Features Now → + +

+ ✅ Available on all plans • ⚡ No extra setup required +

+
+ + +
+

+ 💬 We're excited to see what you build with these new tools. If you have questions, ideas, or just want to share what you created – hit reply. I read every email. +

+

+ — Timo 👋
+ Founder, QR Master +

+
+ +
+ + + + +
+

+ www.qrmaster.net • + Dashboard • + Help +

+

+ © 2025 QR Master. All rights reserved. +

+

+ You received this because you subscribed to AI feature launch notifications. +

+
+
+
+ + + `, + }); + + console.log('AI feature launch email sent successfully to:', email); + return { success: true }; + } catch (error) { + console.error('Error sending AI feature launch email:', error); + throw new Error('Failed to send AI feature launch email'); + } +} diff --git a/src/lib/geo.ts b/src/lib/geo.ts index 739a039..6ed3ed8 100644 --- a/src/lib/geo.ts +++ b/src/lib/geo.ts @@ -1,55 +1,55 @@ -export function getCountryFromHeaders(headers: Headers): string | null { - // Try Vercel's country header first - const vercelCountry = headers.get('x-vercel-ip-country'); - if (vercelCountry) { - return vercelCountry; - } - - // Try Cloudflare's country header - const cfCountry = headers.get('cf-ipcountry'); - if (cfCountry && cfCountry !== 'XX') { - return cfCountry; - } - - // Fallback to other common headers - const country = headers.get('x-country-code') || headers.get('x-forwarded-country'); - return country || null; -} - -export function parseUserAgent(userAgent: string | null): { device: string | null; os: string | null } { - if (!userAgent) { - return { device: null, os: null }; - } - - let device: string | null = null; - let os: string | null = null; - - // Detect device - // iPadOS 13+ sends "Macintosh" user agent. - // Without referrer info here, we fall back to checking for Safari-only Mac UAs (common for iPad) - const isIPad = /iPad/i.test(userAgent) || - (/Macintosh/i.test(userAgent) && /Safari/i.test(userAgent) && !/Chrome/i.test(userAgent)); - - if (isIPad || /Tablet|PlayBook|Silk/i.test(userAgent)) { - device = 'tablet'; - } else if (/Mobile|Android|iPhone/i.test(userAgent) && !isIPad) { - device = 'mobile'; - } else { - device = 'desktop'; - } - - // Detect OS - if (/Windows/.test(userAgent)) { - os = 'Windows'; - } else if (/Mac OS X|macOS/.test(userAgent)) { - os = 'macOS'; - } else if (/Linux/.test(userAgent)) { - os = 'Linux'; - } else if (/Android/.test(userAgent)) { - os = 'Android'; - } else if (/iOS|iPhone|iPad/.test(userAgent)) { - os = 'iOS'; - } - - return { device, os }; +export function getCountryFromHeaders(headers: Headers): string | null { + // Try Vercel's country header first + const vercelCountry = headers.get('x-vercel-ip-country'); + if (vercelCountry) { + return vercelCountry; + } + + // Try Cloudflare's country header + const cfCountry = headers.get('cf-ipcountry'); + if (cfCountry && cfCountry !== 'XX') { + return cfCountry; + } + + // Fallback to other common headers + const country = headers.get('x-country-code') || headers.get('x-forwarded-country'); + return country || null; +} + +export function parseUserAgent(userAgent: string | null): { device: string | null; os: string | null } { + if (!userAgent) { + return { device: null, os: null }; + } + + let device: string | null = null; + let os: string | null = null; + + // Detect device + // iPadOS 13+ sends "Macintosh" user agent. + // Without referrer info here, we fall back to checking for Safari-only Mac UAs (common for iPad) + const isIPad = /iPad/i.test(userAgent) || + (/Macintosh/i.test(userAgent) && /Safari/i.test(userAgent) && !/Chrome/i.test(userAgent)); + + if (isIPad || /Tablet|PlayBook|Silk/i.test(userAgent)) { + device = 'tablet'; + } else if (/Mobile|Android|iPhone/i.test(userAgent) && !isIPad) { + device = 'mobile'; + } else { + device = 'desktop'; + } + + // Detect OS + if (/Windows/.test(userAgent)) { + os = 'Windows'; + } else if (/Mac OS X|macOS/.test(userAgent)) { + os = 'macOS'; + } else if (/Linux/.test(userAgent)) { + os = 'Linux'; + } else if (/Android/.test(userAgent)) { + os = 'Android'; + } else if (/iOS|iPhone|iPad/.test(userAgent)) { + os = 'iOS'; + } + + return { device, os }; } \ No newline at end of file diff --git a/src/lib/growth-pages.ts b/src/lib/growth-pages.ts index 283e91d..6209cf8 100644 --- a/src/lib/growth-pages.ts +++ b/src/lib/growth-pages.ts @@ -1,975 +1,975 @@ -import type { FAQItem } from "@/lib/types"; - -export type CommercialPageLink = { - href: string; - title: string; - description: string; - accent: string; -}; - -export type UseCaseLink = { - slug: string; - href: string; - title: string; - cluster: string; - summary: string; - parentHref: string; - parentTitle: string; - ctaLabel: string; -}; - -export type SupportResourceLink = { - href: string; - title: string; - description: string; -}; - -export type UseCasePageContent = UseCaseLink & { - eyebrow: string; - titleSuffix: string; - metaDescription: string; - intro: string; - answer: string; - whenToUse: string[]; - comparisonItems: { - label: string; - value: boolean; - text?: string; - }[]; - howToSteps: string[]; - workflowTitle: string; - workflowIntro: string; - workflowCards: { - title: string; - description: string; - }[]; - checklistTitle: string; - checklist: string[]; - supportLinks: SupportResourceLink[]; - faq: FAQItem[]; -}; - -export const commercialPages: CommercialPageLink[] = [ - { - href: "/dynamic-qr-code-generator", - title: "Dynamic QR Code Generator", - description: "Edit the destination after print and keep one QR live across changing campaigns.", - accent: "from-blue-600 to-cyan-500", - }, - { - href: "/qr-code-tracking", - title: "QR Code Tracking", - description: "Measure scans by placement, device, and timing when you need proof instead of guesswork.", - accent: "from-indigo-600 to-blue-500", - }, - { - href: "/qr-code-analytics", - title: "QR Code Analytics", - description: "Turn raw scans into placement, campaign, and post-print reporting your team can actually use.", - accent: "from-slate-900 to-cyan-600", - }, - { - href: "/custom-qr-code-generator", - title: "Custom QR Code Generator", - description: "Match printed QR codes to your brand system without losing scannability.", - accent: "from-sky-600 to-indigo-500", - }, - { - href: "/bulk-qr-code-generator", - title: "Bulk QR Code Generator", - description: "Create large sets for labels, event materials, and repeatable offline workflows.", - accent: "from-cyan-600 to-sky-500", - }, - { - href: "/qr-code-for-marketing-campaigns", - title: "QR Codes for Marketing Campaigns", - description: "Plan campaign QR workflows around attribution, creative testing, and print distribution.", - accent: "from-slate-800 to-blue-600", - }, -]; - -export const allUseCases: UseCaseLink[] = [ - { - slug: "restaurant-menu-qr-codes", - href: "/use-cases/restaurant-menu-qr-codes", - title: "Restaurant Menu QR Codes", - cluster: "restaurants", - summary: "Keep printed table cards useful when menu links, prices, specials, or hours change.", - parentHref: "/dynamic-qr-code-generator", - parentTitle: "Dynamic QR Code Generator", - ctaLabel: "Create your restaurant menu QR", - }, - { - slug: "business-card-qr-codes", - href: "/use-cases/business-card-qr-codes", - title: "Business Card QR Codes", - cluster: "business-cards", - summary: "Send contacts to a current profile, booking page, or vCard without reprinting cards.", - parentHref: "/dynamic-qr-code-generator", - parentTitle: "Dynamic QR Code Generator", - ctaLabel: "Create your business card QR", - }, - { - slug: "event-qr-codes", - href: "/use-cases/event-qr-codes", - title: "Event QR Codes", - cluster: "events", - summary: "Split operational and campaign QR flows so schedules and tracking stay manageable on event day.", - parentHref: "/qr-code-tracking", - parentTitle: "QR Code Tracking", - ctaLabel: "Create your event QR code", - }, - { - slug: "flyer-qr-codes", - href: "/use-cases/flyer-qr-codes", - title: "Flyer QR Codes", - cluster: "print-campaigns", - summary: "Compare placements, rotate offers, and keep flyer campaigns measurable after print goes out.", - parentHref: "/qr-code-for-marketing-campaigns", - parentTitle: "QR Codes for Marketing Campaigns", - ctaLabel: "Create your flyer QR code", - }, - { - slug: "packaging-qr-codes", - href: "/use-cases/packaging-qr-codes", - title: "Packaging QR Codes", - cluster: "packaging", - summary: "Route scans from packaging, inserts, and labels into manuals, support, and product analytics.", - parentHref: "/qr-code-analytics", - parentTitle: "QR Code Analytics", - ctaLabel: "Create your packaging QR code", - }, - { - slug: "real-estate-sign-qr-codes", - href: "/use-cases/real-estate-sign-qr-codes", - title: "Real Estate Sign QR Codes", - cluster: "real-estate", - summary: "Keep listing routes current and compare sign, brochure, and open-house traffic with cleaner reporting.", - parentHref: "/qr-code-tracking", - parentTitle: "QR Code Tracking", - ctaLabel: "Create your real estate QR code", - }, - { - slug: "feedback-qr-codes", - href: "/use-cases/feedback-qr-codes", - title: "Feedback QR Codes", - cluster: "feedback", - summary: "Capture in-store feedback, route happy customers to review flows, and measure which placements get responses.", - parentHref: "/qr-code-tracking", - parentTitle: "QR Code Tracking", - ctaLabel: "Create your feedback QR code", - }, - { - slug: "payment-qr-codes", - href: "/use-cases/payment-qr-codes", - title: "Payment QR Codes", - cluster: "payments", - summary: "Send scanners straight into a mobile payment action without making printed payment prompts go stale.", - parentHref: "/dynamic-qr-code-generator", - parentTitle: "Dynamic QR Code Generator", - ctaLabel: "Create your payment QR code", - }, - { - slug: "coupon-qr-codes", - href: "/use-cases/coupon-qr-codes", - title: "Coupon QR Codes", - cluster: "offers", - summary: "Tie coupon placements to measurable scans so you know which print offers actually get redeemed.", - parentHref: "/qr-code-tracking", - parentTitle: "QR Code Tracking", - ctaLabel: "Create your coupon QR code", - }, -]; - -export const featuredUseCases: UseCaseLink[] = allUseCases.filter((item) => - [ - "restaurant-menu-qr-codes", - "business-card-qr-codes", - "flyer-qr-codes", - "packaging-qr-codes", - "real-estate-sign-qr-codes", - "feedback-qr-codes", - ].includes(item.slug), -); - -export const upcomingUseCaseIdeas: SupportResourceLink[] = [ - { - href: "/bulk-qr-code-generator", - title: "Product label workflows", - description: "Best next cluster once packaging analytics and bulk import pages are live together.", - }, - { - href: "/qr-code-for-marketing-campaigns", - title: "Brochure and trade-show campaigns", - description: "Natural second-wave expansion for print attribution once flyer workflows are established.", - }, - { - href: "/dynamic-qr-code-generator", - title: "Table ordering and service flows", - description: "High-fit hospitality expansion after menu and payment journeys have performance data.", - }, -]; - -export const supportResources: SupportResourceLink[] = [ - { - href: "/learn/use-cases", - title: "Learn: Use Cases", - description: "Editorial pillar page for educational browsing and broader QR workflow discovery.", - }, - { - href: "/blog/dynamic-vs-static-qr-codes", - title: "Dynamic vs Static QR Codes", - description: "Explainer for the operational difference between fixed and editable QR destinations.", - }, - { - href: "/blog/utm-parameter-qr-codes", - title: "UTM Parameters with QR Codes", - description: "Reference guide for campaign naming, placement attribution, and offline measurement.", - }, -]; - -function bySlug(slug: string): UseCaseLink { - const match = allUseCases.find((item) => item.slug === slug); - - if (!match) { - throw new Error(`Unknown use case slug: ${slug}`); - } - - return match; -} - -export const useCasePageContent: Record = { - "restaurant-menu-qr-codes": { - ...bySlug("restaurant-menu-qr-codes"), - eyebrow: "Restaurants", - titleSuffix: "for Restaurants, Cafes, and Changing Menus", - metaDescription: - "Use restaurant menu QR codes to keep printed table cards useful when menu links, pricing, or specials change.", - intro: - "Restaurant menu QR codes work best when the printed code stays the same but the menu destination can change as your service changes.", - answer: - "A restaurant menu QR code should point to a mobile-friendly menu that you can update without replacing every printed card, flyer, or table tent.", - whenToUse: [ - "Your menu link changes seasonally, weekly, or during service.", - "You want one printed QR on tables, windows, takeaway inserts, or flyers.", - "You need to route customers to the right menu, order flow, or special page without reprinting.", - ], - comparisonItems: [ - { label: "Menu destination", text: "Fixed once printed", value: true }, - { label: "Last-minute updates", text: "Reprint required", value: true }, - { label: "Campaign tracking", text: "Limited", value: true }, - ], - howToSteps: [ - "Create one dynamic menu QR and place it on your printed surfaces.", - "Send scanners to your current menu, order page, or daily specials page.", - "Update the destination when the menu or campaign changes instead of replacing the code.", - ], - workflowTitle: "What a good restaurant QR setup should handle", - workflowIntro: - "The QR code is not the product. The workflow behind it is. A good restaurant setup keeps print stable while operations stay flexible.", - workflowCards: [ - { - title: "Stable table cards", - description: "Keep one printed QR on tables and point it to the current menu, lunch card, or ordering page.", - }, - { - title: "Seasonal offers", - description: "Swap specials, tasting menus, or holiday landing pages without touching the printed material.", - }, - { - title: "Placement tracking", - description: "Use different menu or campaign destinations by location so you can compare tables, windows, and takeaway inserts.", - }, - ], - checklistTitle: "Restaurant QR checklist", - checklist: [ - "Use a mobile-first landing page instead of a hard-to-read PDF where possible.", - "Keep the same printed QR on every stable surface you do not want to replace often.", - "Use CTA copy like 'Scan for menu' or 'Scan for today's specials' so the scan intent is obvious.", - "Pair campaign placements with trackable destinations when you test takeaway or window traffic.", - ], - supportLinks: [ - { - href: "/dynamic-qr-code-generator", - title: "Commercial parent: Dynamic QR Code Generator", - description: "Best fit when the real need is editing the destination after print.", - }, - { - href: "/blog/qr-code-restaurant-menu", - title: "Restaurant menu guide", - description: "Existing editorial asset with menu placement and implementation basics.", - }, - { - href: "/use-cases/payment-qr-codes", - title: "Sibling page: Payment QR Codes", - description: "Useful when the same physical surfaces need an up-to-date post-scan payment action.", - }, - ], - faq: [ - { - question: "Should a restaurant menu QR code be static or dynamic?", - answer: "Use a dynamic QR code when the menu destination may change. That lets you update the landing page without replacing your printed materials.", - }, - { - question: "What should a restaurant menu QR code link to?", - answer: "Link to a mobile-friendly menu page, ordering page, or a short service hub that helps customers reach the right menu fast.", - }, - { - question: "Can I use one restaurant QR code in multiple places?", - answer: "Yes. One stable code can be reused across table cards, flyers, and takeaway materials, especially when the destination is managed dynamically.", - }, - ], - }, - "business-card-qr-codes": { - ...bySlug("business-card-qr-codes"), - eyebrow: "Business Cards", - titleSuffix: "for Contact Sharing, Bookings, and Portfolio Links", - metaDescription: - "Use business card QR codes to share a current contact page, vCard, booking link, or portfolio without reprinting cards.", - intro: - "Business card QR codes are most useful when your contact destination changes faster than your print inventory.", - answer: - "A business card QR code should send people to the best next action today, whether that is saving your contact, opening a booking link, or visiting a current profile page.", - whenToUse: [ - "Your role, booking link, or portfolio changes more often than your printed cards.", - "You want one card to work for networking, sales follow-up, and contact saving.", - "You need a cleaner handoff than asking people to type a URL from a small card.", - ], - comparisonItems: [ - { label: "Destination flexibility", text: "Fixed once printed", value: true }, - { label: "Contact updates", text: "New cards needed", value: true }, - { label: "Action routing", text: "Single fixed page", value: true }, - ], - howToSteps: [ - "Choose the real action you want after the scan: save contact, book time, or view work.", - "Generate a QR code that sends people to that destination or to a vCard-capable landing page.", - "Keep the print the same and update the linked destination when your details evolve.", - ], - workflowTitle: "Where business card QR codes pay off", - workflowIntro: - "Printed cards still work. The problem is that the destination behind them often gets stale first.", - workflowCards: [ - { - title: "Current contact flow", - description: "Send scanners to a vCard or current contact page so the next step is saving your details, not typing them.", - }, - { - title: "Role or profile updates", - description: "Update the destination if you change company, title, offer, or booking link while old cards are still in circulation.", - }, - { - title: "Context-aware follow-up", - description: "Point event-specific cards or team variants to the most relevant landing page instead of one generic homepage.", - }, - ], - checklistTitle: "Business card QR checklist", - checklist: [ - "Pick one primary post-scan action instead of trying to send every scanner to everything at once.", - "Make the landing page useful on mobile because most business-card scans happen on phones.", - "Use CTA text such as 'Scan to save my contact' or 'Scan to book a call'.", - "Test the print size and contrast before ordering a large run.", - ], - supportLinks: [ - { - href: "/dynamic-qr-code-generator", - title: "Commercial parent: Dynamic QR Code Generator", - description: "Use when the printed card stays constant but the best destination changes.", - }, - { - href: "/tools/vcard-qr-code", - title: "vCard QR Code tool", - description: "Free tool for contact-saving workflows when a vCard is the best immediate action.", - }, - { - href: "/use-cases/event-qr-codes", - title: "Sibling page: Event QR Codes", - description: "Another workflow where temporary destinations and scan context matter.", - }, - ], - faq: [ - { - question: "What should a business card QR code link to?", - answer: "The best destination is the one next step you want most: a vCard, booking page, contact hub, or current portfolio page.", - }, - { - question: "Do business card QR codes need to be dynamic?", - answer: "They should be dynamic if your destination may change over the life of the printed card. That keeps old cards useful longer.", - }, - { - question: "Can a business card QR code send people straight to contact saving?", - answer: "Yes. A vCard QR or a landing page with clear save-contact options is often the simplest and most practical post-scan action.", - }, - ], - }, - "event-qr-codes": { - ...bySlug("event-qr-codes"), - eyebrow: "Events", - titleSuffix: "for Check-In, Schedules, Booths, and Campaign Tracking", - metaDescription: - "Use event QR codes for schedules, check-in flows, and trackable campaign placements across signs, flyers, and booths.", - intro: - "Event QR codes work best when you separate operational QR flows from promotional ones and keep your printed placements easy to manage.", - answer: - "A good event QR setup uses different QR destinations for different jobs: operations, attendee utility, and campaign measurement should not all depend on one code.", - whenToUse: [ - "Your event schedule, map, or resources may change close to event day.", - "You want to compare booth, banner, flyer, or badge placements instead of treating every scan as one bucket.", - "You need one event QR system that supports both attendee utility and marketing follow-up.", - ], - comparisonItems: [ - { label: "Schedule changes", text: "New print may be needed", value: true }, - { label: "Placement reporting", text: "Weak by default", value: true }, - { label: "Operational vs campaign flows", text: "Often mixed", value: true }, - ], - howToSteps: [ - "Split event QR codes by purpose: check-in, attendee info, and campaign placements.", - "Use trackable destinations for banners, booth assets, and flyers where placement performance matters.", - "Keep fast-changing resources on destinations you can update without replacing the printed code.", - ], - workflowTitle: "Event workflows worth designing on purpose", - workflowIntro: - "Events generate scans in very different contexts. Treating them as one generic QR use case leaves both operations and measurement weaker.", - workflowCards: [ - { - title: "Operational QR flows", - description: "Use dedicated QR paths for check-in, schedules, maps, and attendee resources that may shift before or during the event.", - }, - { - title: "Booth and banner tracking", - description: "Track scans from distinct placements so you can compare booth creatives, sponsor zones, or call-to-action angles.", - }, - { - title: "Post-event follow-up", - description: "Route scanners to the most relevant recap, booking, or lead capture page after the event without changing the printed assets.", - }, - ], - checklistTitle: "Event QR checklist", - checklist: [ - "Do not force one QR code to handle operations, schedule updates, and lead-gen at the same time.", - "Use descriptive CTA copy like 'Scan for agenda' or 'Scan for booth resources'.", - "Track campaign placements separately so booth banners and flyers are comparable.", - "Test glare, print size, and placement distance on the real event materials before the event starts.", - ], - supportLinks: [ - { - href: "/qr-code-tracking", - title: "Commercial parent: QR Code Tracking", - description: "Best fit when the priority is measuring placement and scan context across the event.", - }, - { - href: "/tools/event-qr-code", - title: "Event QR Code tool", - description: "Useful for save-the-date and calendar workflows that sit alongside broader event QR strategy.", - }, - { - href: "/use-cases/flyer-qr-codes", - title: "Sibling page: Flyer QR Codes", - description: "Useful when event promotion depends on measurable printed distribution before event day.", - }, - ], - faq: [ - { - question: "Should an event use one QR code or several?", - answer: "Several is usually better. Separate operational QR codes from campaign QR codes so schedules, check-in, and attribution do not compete for one destination.", - }, - { - question: "Can event QR codes be updated after print?", - answer: "Yes, if the destination is managed dynamically. That is useful for schedules, resource hubs, and post-event follow-up pages.", - }, - { - question: "How do I measure which event placement performs best?", - answer: "Use distinct destinations or tagged URLs for each placement so banner, booth, badge, and flyer traffic can be compared cleanly.", - }, - ], - }, - "flyer-qr-codes": { - ...bySlug("flyer-qr-codes"), - eyebrow: "Print Campaigns", - titleSuffix: "for Promotions, Posters, and Offline Campaign Testing", - metaDescription: - "Use flyer QR codes to keep print campaigns measurable, compare placements, and change the destination without reprinting every batch.", - intro: - "Flyer QR codes work best when the printed asset can stay in circulation while the offer, landing page, or attribution model keeps evolving.", - answer: - "A flyer QR code should connect one printed call to action with a destination you can update and a scan trail you can compare across placements, neighborhoods, or campaign waves.", - whenToUse: [ - "You run local flyers, direct mail, posters, or leave-behind materials with changing offers.", - "You want to compare placement performance instead of treating every scan like one generic campaign.", - "You need campaign flexibility after the flyer run has already been distributed.", - ], - comparisonItems: [ - { label: "Offer updates", text: "New print run needed", value: true }, - { label: "Placement attribution", text: "Often unclear", value: true }, - { label: "Creative testing", text: "Weak by default", value: true }, - ], - howToSteps: [ - "Create one flyer QR flow per offer or placement cluster, not one code for every campaign forever.", - "Use a dynamic destination or tagged URL so the landing page can change without replacing the print.", - "Track scan context by distribution point, neighborhood, or creative version before deciding what scales.", - ], - workflowTitle: "What flyer QR codes should help you measure", - workflowIntro: - "Flyers are easy to print and hard to evaluate unless the QR setup is designed for comparison from the beginning.", - workflowCards: [ - { - title: "Placement-aware campaigns", - description: "Split codes or destinations by region, venue type, or distribution partner so scans can be compared without guesswork.", - }, - { - title: "Offer iteration after print", - description: "Keep the same flyer in circulation while you change the landing page, schedule, or campaign CTA behind the code.", - }, - { - title: "Print-to-signup reporting", - description: "Use flyer scans as the first step in a measurable path toward signup, booking, coupon claim, or lead capture.", - }, - ], - checklistTitle: "Flyer QR checklist", - checklist: [ - "Write one clear scan CTA on the flyer instead of forcing the code to explain itself.", - "Use separate tracking logic for high-volume placements rather than one generic destination.", - "Match the flyer promise to the first screen after the scan.", - "Review scan performance by placement before printing the next batch.", - ], - supportLinks: [ - { - href: "/qr-code-for-marketing-campaigns", - title: "Commercial parent: QR Codes for Marketing Campaigns", - description: "Best fit when your flyer is part of a broader offline-to-online campaign system.", - }, - { - href: "/blog/utm-parameter-qr-codes", - title: "UTM Parameters with QR Codes", - description: "Support article for comparing flyer locations, campaign bursts, and creative versions.", - }, - { - href: "/use-cases/coupon-qr-codes", - title: "Sibling page: Coupon QR Codes", - description: "Useful when flyer distribution is meant to drive a specific redeemable offer.", - }, - ], - faq: [ - { - question: "Should a flyer QR code be dynamic?", - answer: "Yes, if the landing page, offer, or campaign tracking may change after printing. That keeps the flyer useful longer and avoids waste.", - }, - { - question: "How do I track flyer QR codes by location?", - answer: "Use distinct destinations or campaign tags by placement so scans from each distribution point can be compared cleanly.", - }, - { - question: "What should a flyer QR code link to?", - answer: "Link to the one next action promised on the flyer, such as a signup page, offer page, booking page, or campaign landing page.", - }, - ], - }, - "packaging-qr-codes": { - ...bySlug("packaging-qr-codes"), - eyebrow: "Packaging", - titleSuffix: "for Product Support, Inserts, and Post-Purchase Journeys", - metaDescription: - "Use packaging QR codes to route buyers into manuals, product support, onboarding, or post-purchase offers while keeping scans measurable.", - intro: - "Packaging QR codes are most valuable when they do more than send users to a homepage. They should support a product journey after purchase and give you visibility into what people actually scan.", - answer: - "A packaging QR code should connect the physical product to a useful post-purchase destination such as setup help, manuals, registration, support, or follow-up content that can be updated later.", - whenToUse: [ - "You need product packaging, labels, or inserts to send users to changing support or onboarding pages.", - "You want scan visibility by product line, SKU family, or campaign batch.", - "You need a better bridge from physical packaging into post-purchase education or retention.", - ], - comparisonItems: [ - { label: "Manual updates", text: "Requires reprint", value: true }, - { label: "Post-purchase reporting", text: "Minimal", value: true }, - { label: "Product-line comparison", text: "Hard to organize", value: true }, - ], - howToSteps: [ - "Map each packaging QR to one useful post-purchase job such as setup, manuals, support, or product registration.", - "Use a destination structure that can change as documentation, support paths, or campaign links evolve.", - "Review scans by product line or package type so packaging placements become a reporting surface instead of a blind spot.", - ], - workflowTitle: "Packaging QR workflows worth building deliberately", - workflowIntro: - "Once a package is shipped, the QR code becomes part of the customer experience. The supporting flow should be stable enough for print but flexible enough for the business.", - workflowCards: [ - { - title: "Support and setup routing", - description: "Send new customers to the right setup guide, manual, warranty flow, or help entry point without forcing them to search.", - }, - { - title: "Batch or product analytics", - description: "Track which products, inserts, or packaging lines drive scans so you can see where post-purchase engagement actually happens.", - }, - { - title: "Offer and content updates", - description: "Swap destinations after launch when manuals, app links, retention offers, or onboarding content change.", - }, - ], - checklistTitle: "Packaging QR checklist", - checklist: [ - "Make the first scanned destination obviously relevant to the product in hand.", - "Avoid routing every package to the same generic homepage.", - "Use analytics naming that lets product lines or batches be reviewed later.", - "Test print size, contrast, and material finish on real packaging samples.", - ], - supportLinks: [ - { - href: "/qr-code-analytics", - title: "Commercial parent: QR Code Analytics", - description: "Best fit when packaging scans need to become a measurable post-purchase signal.", - }, - { - href: "/bulk-qr-code-generator", - title: "Bulk QR Code Generator", - description: "Useful when packaging programs need many codes across SKUs, inserts, or recurring runs.", - }, - { - href: "/use-cases/coupon-qr-codes", - title: "Sibling page: Coupon QR Codes", - description: "Useful when packaging scans need to trigger a measurable offer or retention prompt.", - }, - ], - faq: [ - { - question: "What should a packaging QR code link to?", - answer: "The best destination is usually a post-purchase action such as setup help, manuals, support, registration, or a product-specific resource hub.", - }, - { - question: "Can packaging QR codes be tracked?", - answer: "Yes. With a trackable QR setup you can review how packaging scans perform by product line, batch, placement, or destination.", - }, - { - question: "Should packaging QR codes be dynamic?", - answer: "They should be dynamic when product documentation, app links, support flows, or promotional destinations may change after the packaging is printed.", - }, - ], - }, - "real-estate-sign-qr-codes": { - ...bySlug("real-estate-sign-qr-codes"), - eyebrow: "Real Estate", - titleSuffix: "for Listings, Brochures, and Open-House Routing", - metaDescription: - "Use real estate sign QR codes to route buyers to the current listing experience and compare sign, brochure, and open-house performance.", - intro: - "Real estate sign QR codes are strongest when listing traffic stays current even as inventory, open-house schedules, or brochure links change.", - answer: - "A real estate sign QR code should connect a passerby to the right listing, brochure, or inquiry flow today while keeping enough tracking context to compare sign performance over time.", - whenToUse: [ - "You need signs, window displays, or property brochures to point to live listing information.", - "You want to compare scans from signs, flyers, open houses, or brokerage materials.", - "You need listing routes that can change after print when the property status or CTA changes.", - ], - comparisonItems: [ - { label: "Listing updates", text: "Static links get stale", value: true }, - { label: "Sign performance", text: "Usually opaque", value: true }, - { label: "Property routing", text: "One fixed page", value: true }, - ], - howToSteps: [ - "Connect each sign QR to the right listing, brochure, or lead flow instead of a generic homepage.", - "Use trackable routing when the same property appears on signs, flyers, and open-house materials.", - "Change the destination when the listing status, CTA, or follow-up flow changes without replacing printed signs.", - ], - workflowTitle: "Where real estate QR systems become useful", - workflowIntro: - "Real estate print assets stay in the field while listing status and buyer next steps change. The QR setup should reflect that reality.", - workflowCards: [ - { - title: "Live listing routing", - description: "Keep signs useful even if the preferred listing page, brochure path, or inquiry CTA changes after installation.", - }, - { - title: "Source comparison", - description: "Compare sign traffic against property flyers, open-house materials, and office displays without merging everything into one bucket.", - }, - { - title: "Lead-ready handoff", - description: "Route scanners to the current listing hub, brochure request, or showing inquiry page instead of a dead-end listing snapshot.", - }, - ], - checklistTitle: "Real estate sign QR checklist", - checklist: [ - "Use a mobile-first listing page because most sign scans happen on phones.", - "Name tracking sources so sign, flyer, and open-house scans can be reviewed separately.", - "Update the destination when the property status or lead path changes.", - "Test scan distance and contrast on the actual sign material before production.", - ], - supportLinks: [ - { - href: "/qr-code-tracking", - title: "Commercial parent: QR Code Tracking", - description: "Best fit when the goal is comparing real-world property placements and scan context.", - }, - { - href: "/qr-code-for-marketing-campaigns", - title: "QR Codes for Marketing Campaigns", - description: "Useful when property promotion sits inside a broader local acquisition campaign.", - }, - { - href: "/use-cases/flyer-qr-codes", - title: "Sibling page: Flyer QR Codes", - description: "Useful when listing promotion depends on both sign traffic and printed collateral.", - }, - ], - faq: [ - { - question: "What should a real estate sign QR code link to?", - answer: "It should link to the current listing experience, brochure page, or inquiry flow rather than a generic homepage or a static PDF that goes stale quickly.", - }, - { - question: "Can I track real estate sign QR code scans?", - answer: "Yes. A trackable setup can help compare sign scans against other property materials such as flyers or open-house handouts.", - }, - { - question: "Should real estate QR codes be dynamic?", - answer: "Yes, when listing details, CTA flows, or follow-up destinations may change while the sign remains in the field.", - }, - ], - }, - "feedback-qr-codes": { - ...bySlug("feedback-qr-codes"), - eyebrow: "Feedback", - titleSuffix: "for Reviews, In-Store Feedback, and Follow-Up Journeys", - metaDescription: - "Use feedback QR codes to capture customer responses, route high-intent users into review flows, and measure which placements get feedback.", - intro: - "Feedback QR codes work best when they remove friction from the review or response step and still let you measure which placements actually drive action.", - answer: - "A feedback QR code should make it easy for customers to leave a response in the moment while giving your team enough context to compare locations, surfaces, or follow-up performance.", - whenToUse: [ - "You want table cards, receipts, packaging inserts, or in-store prompts to collect feedback fast.", - "You need a cleaner path from offline service moments into reviews or internal feedback collection.", - "You want to compare where feedback requests actually convert instead of placing the same prompt everywhere.", - ], - comparisonItems: [ - { label: "Feedback routing", text: "Often generic", value: true }, - { label: "Placement reporting", text: "Weak by default", value: true }, - { label: "Review flow control", text: "Hard to tune", value: true }, - ], - howToSteps: [ - "Place feedback QR codes where the customer can act immediately after the experience, not hours later.", - "Route the scan into the right feedback or review flow for that context.", - "Track scans and responses by placement so you know which surfaces deserve continued print inventory.", - ], - workflowTitle: "Feedback QR flows that are worth measuring", - workflowIntro: - "Feedback requests perform differently depending on timing, location, and the post-scan experience. The QR flow should reflect that.", - workflowCards: [ - { - title: "Moment-of-service feedback", - description: "Capture responses while the customer is still on site, at the table, or inside the post-purchase moment.", - }, - { - title: "Review routing", - description: "Separate internal feedback collection from external review requests so the business controls the next step more clearly.", - }, - { - title: "Placement comparison", - description: "Compare table cards, receipts, packaging inserts, and counter displays to see where customers actually respond.", - }, - ], - checklistTitle: "Feedback QR checklist", - checklist: [ - "Ask for one simple next action after the scan instead of combining review, survey, and support in one step.", - "Place feedback prompts where the service experience is still fresh.", - "Name or tag locations so scan and response performance can be reviewed later.", - "Use a short, obvious CTA such as 'Scan to leave feedback' or 'Scan to rate your visit'.", - ], - supportLinks: [ - { - href: "/qr-code-tracking", - title: "Commercial parent: QR Code Tracking", - description: "Best fit when you need to compare feedback placements and understand scan context.", - }, - { - href: "/blog/trackable-qr-codes", - title: "Trackable QR Codes", - description: "Support article for teams that want a measurable review or response program across multiple placements.", - }, - { - href: "/use-cases/coupon-qr-codes", - title: "Sibling page: Coupon QR Codes", - description: "Useful when the same offline surfaces support both feedback collection and post-visit offers.", - }, - ], - faq: [ - { - question: "What is a feedback QR code?", - answer: "A feedback QR code sends customers to a review, survey, or response form so they can give feedback immediately after a visit or purchase.", - }, - { - question: "Can feedback QR codes be tracked?", - answer: "Yes. A trackable setup can show which placements, locations, or materials generate the most scans and responses.", - }, - { - question: "Where should I place a feedback QR code?", - answer: "Place it where the customer can act right after the experience, such as on table cards, receipts, counters, packaging inserts, or post-service handouts.", - }, - ], - }, - "payment-qr-codes": { - ...bySlug("payment-qr-codes"), - eyebrow: "Payments", - titleSuffix: "for Mobile Checkout, Counter Payments, and Printed Prompts", - metaDescription: - "Use payment QR codes to route customers into a mobile payment action that stays current even when links or workflows change.", - intro: - "Payment QR codes are most useful when the printed prompt stays simple while the underlying payment destination can change with the business.", - answer: - "A payment QR code should move a scanner directly into the intended payment action on mobile without forcing the business to replace printed prompts every time the payment flow changes.", - whenToUse: [ - "You use printed payment prompts on counters, tables, invoices, or leave-behind materials.", - "You need a mobile-first payment path instead of asking customers to type a long URL.", - "You want flexibility when the payment link, provider, or landing flow changes over time.", - ], - comparisonItems: [ - { label: "Payment destination", text: "Fixed once printed", value: true }, - { label: "Provider changes", text: "Reprint required", value: true }, - { label: "Post-scan routing", text: "Limited", value: true }, - ], - howToSteps: [ - "Decide which payment action the code should trigger: direct payment, checkout page, invoice page, or service deposit.", - "Generate one QR per real payment context instead of one generic payment code for everything.", - "Use a destination that can be updated when your payment provider or checkout flow changes.", - ], - workflowTitle: "Payment QR workflows that stay practical after print", - workflowIntro: - "Payment prompts live on physical surfaces longer than the payment links behind them. The QR workflow should absorb that change instead of forcing reprints.", - workflowCards: [ - { - title: "Counter and table payments", - description: "Use printed QR prompts to move a customer into a fast mobile payment step without manual URL entry.", - }, - { - title: "Invoice and leave-behind flows", - description: "Attach payment actions to printed materials that may remain in circulation after a provider or link update.", - }, - { - title: "Context-specific routing", - description: "Send different payment scenarios to the right checkout or follow-up path instead of one catch-all destination.", - }, - ], - checklistTitle: "Payment QR checklist", - checklist: [ - "Make the scan CTA specific so users know they are opening a payment action.", - "Use a mobile-first checkout or payment screen.", - "Keep one QR per payment context when the follow-up steps differ.", - "Update the destination if provider links or invoice flows change after print.", - ], - supportLinks: [ - { - href: "/dynamic-qr-code-generator", - title: "Commercial parent: Dynamic QR Code Generator", - description: "Best fit when the printed payment prompt must survive future destination changes.", - }, - { - href: "/tools/paypal-qr-code", - title: "PayPal QR Code tool", - description: "Useful for direct payment-oriented workflows when PayPal is the intended post-scan action.", - }, - { - href: "/use-cases/restaurant-menu-qr-codes", - title: "Sibling page: Restaurant Menu QR Codes", - description: "Useful when table cards combine service information and a later payment or ordering action.", - }, - ], - faq: [ - { - question: "What should a payment QR code link to?", - answer: "It should link to the actual mobile payment action you want the user to take, such as a checkout page, invoice page, or direct payment destination.", - }, - { - question: "Should payment QR codes be dynamic?", - answer: "Yes, when the payment destination, provider, or checkout flow may change after the printed code is already in use.", - }, - { - question: "Where do payment QR codes work best?", - answer: "They work best on printed surfaces where a fast mobile payment step is valuable, such as counters, invoices, tables, service documents, or leave-behind materials.", - }, - ], - }, - "coupon-qr-codes": { - ...bySlug("coupon-qr-codes"), - eyebrow: "Offers", - titleSuffix: "for Measurable Discounts, Redemptions, and Local Promotions", - metaDescription: - "Use coupon QR codes to connect printed offers with measurable scans, current discount pages, and cleaner redemption reporting.", - intro: - "Coupon QR codes are strongest when the discount path stays current and your team can see which print placements actually generate redemptions.", - answer: - "A coupon QR code should connect one printed offer to a landing or redemption flow you can update later while preserving enough tracking context to compare placements and promotion waves.", - whenToUse: [ - "You run discounts on flyers, receipts, inserts, posters, or local print campaigns.", - "You want to compare which printed offer placements drive scans or redemptions.", - "You need the offer destination to stay current even if the promotion changes after print.", - ], - comparisonItems: [ - { label: "Offer changes", text: "Static links go stale", value: true }, - { label: "Redemption visibility", text: "Often weak", value: true }, - { label: "Placement comparison", text: "Usually manual", value: true }, - ], - howToSteps: [ - "Create one coupon QR flow per actual offer or placement group instead of mixing promotions together.", - "Use a destination or coupon page that can change after distribution if the offer window shifts.", - "Review scan and redemption context by flyer, receipt, package insert, or local placement before scaling the next campaign.", - ], - workflowTitle: "Coupon QR systems that improve the next campaign", - workflowIntro: - "Printed offers are only useful if the path behind them stays live and the results can be reviewed later. A coupon QR should support both.", - workflowCards: [ - { - title: "Offer routing after print", - description: "Keep the same printed discount prompt alive while the landing page, code, or campaign framing changes.", - }, - { - title: "Placement reporting", - description: "Compare where coupons get scanned or redeemed so posters, flyers, inserts, and receipts stop being one blended source.", - }, - { - title: "Redemption-focused follow-up", - description: "Route the scan into a path that makes redemption easy instead of forcing the user to search for the offer again.", - }, - ], - checklistTitle: "Coupon QR checklist", - checklist: [ - "Write the offer clearly on the printed asset so the QR code reinforces one promise.", - "Use distinct tracking for major placements or campaign waves.", - "Keep the redemption page or coupon path mobile-friendly.", - "Update the destination when the offer changes instead of leaving dead promotions in circulation.", - ], - supportLinks: [ - { - href: "/qr-code-tracking", - title: "Commercial parent: QR Code Tracking", - description: "Best fit when the value comes from comparing placements and measuring offer performance.", - }, - { - href: "/blog/trackable-qr-codes", - title: "Trackable QR Codes", - description: "Support article for teams that want a more measurable coupon or discount program.", - }, - { - href: "/use-cases/flyer-qr-codes", - title: "Sibling page: Flyer QR Codes", - description: "Useful when the coupon is part of a measurable flyer or local promotion program.", - }, - ], - faq: [ - { - question: "What is a coupon QR code?", - answer: "A coupon QR code sends users to an offer or redemption page so the discount can be claimed without typing a URL or code manually.", - }, - { - question: "Can coupon QR codes be tracked?", - answer: "Yes. A trackable setup helps compare scans and coupon performance across placements such as flyers, posters, inserts, or receipts.", - }, - { - question: "Should a coupon QR code be dynamic?", - answer: "Yes, when the promotion, landing page, or redemption flow may change while the printed asset is still in circulation.", - }, - ], - }, -}; - -export function getUseCasePage(slug: string): UseCasePageContent | undefined { - return useCasePageContent[slug]; -} +import type { FAQItem } from "@/lib/types"; + +export type CommercialPageLink = { + href: string; + title: string; + description: string; + accent: string; +}; + +export type UseCaseLink = { + slug: string; + href: string; + title: string; + cluster: string; + summary: string; + parentHref: string; + parentTitle: string; + ctaLabel: string; +}; + +export type SupportResourceLink = { + href: string; + title: string; + description: string; +}; + +export type UseCasePageContent = UseCaseLink & { + eyebrow: string; + titleSuffix: string; + metaDescription: string; + intro: string; + answer: string; + whenToUse: string[]; + comparisonItems: { + label: string; + value: boolean; + text?: string; + }[]; + howToSteps: string[]; + workflowTitle: string; + workflowIntro: string; + workflowCards: { + title: string; + description: string; + }[]; + checklistTitle: string; + checklist: string[]; + supportLinks: SupportResourceLink[]; + faq: FAQItem[]; +}; + +export const commercialPages: CommercialPageLink[] = [ + { + href: "/dynamic-qr-code-generator", + title: "Dynamic QR Code Generator", + description: "Edit the destination after print and keep one QR live across changing campaigns.", + accent: "from-blue-600 to-cyan-500", + }, + { + href: "/qr-code-tracking", + title: "QR Code Tracking", + description: "Measure scans by placement, device, and timing when you need proof instead of guesswork.", + accent: "from-indigo-600 to-blue-500", + }, + { + href: "/qr-code-analytics", + title: "QR Code Analytics", + description: "Turn raw scans into placement, campaign, and post-print reporting your team can actually use.", + accent: "from-slate-900 to-cyan-600", + }, + { + href: "/custom-qr-code-generator", + title: "Custom QR Code Generator", + description: "Match printed QR codes to your brand system without losing scannability.", + accent: "from-sky-600 to-indigo-500", + }, + { + href: "/bulk-qr-code-generator", + title: "Bulk QR Code Generator", + description: "Create large sets for labels, event materials, and repeatable offline workflows.", + accent: "from-cyan-600 to-sky-500", + }, + { + href: "/qr-code-for-marketing-campaigns", + title: "QR Codes for Marketing Campaigns", + description: "Plan campaign QR workflows around attribution, creative testing, and print distribution.", + accent: "from-slate-800 to-blue-600", + }, +]; + +export const allUseCases: UseCaseLink[] = [ + { + slug: "restaurant-menu-qr-codes", + href: "/use-cases/restaurant-menu-qr-codes", + title: "Restaurant Menu QR Codes", + cluster: "restaurants", + summary: "Keep printed table cards useful when menu links, prices, specials, or hours change.", + parentHref: "/dynamic-qr-code-generator", + parentTitle: "Dynamic QR Code Generator", + ctaLabel: "Create your restaurant menu QR", + }, + { + slug: "business-card-qr-codes", + href: "/use-cases/business-card-qr-codes", + title: "Business Card QR Codes", + cluster: "business-cards", + summary: "Send contacts to a current profile, booking page, or vCard without reprinting cards.", + parentHref: "/dynamic-qr-code-generator", + parentTitle: "Dynamic QR Code Generator", + ctaLabel: "Create your business card QR", + }, + { + slug: "event-qr-codes", + href: "/use-cases/event-qr-codes", + title: "Event QR Codes", + cluster: "events", + summary: "Split operational and campaign QR flows so schedules and tracking stay manageable on event day.", + parentHref: "/qr-code-tracking", + parentTitle: "QR Code Tracking", + ctaLabel: "Create your event QR code", + }, + { + slug: "flyer-qr-codes", + href: "/use-cases/flyer-qr-codes", + title: "Flyer QR Codes", + cluster: "print-campaigns", + summary: "Compare placements, rotate offers, and keep flyer campaigns measurable after print goes out.", + parentHref: "/qr-code-for-marketing-campaigns", + parentTitle: "QR Codes for Marketing Campaigns", + ctaLabel: "Create your flyer QR code", + }, + { + slug: "packaging-qr-codes", + href: "/use-cases/packaging-qr-codes", + title: "Packaging QR Codes", + cluster: "packaging", + summary: "Route scans from packaging, inserts, and labels into manuals, support, and product analytics.", + parentHref: "/qr-code-analytics", + parentTitle: "QR Code Analytics", + ctaLabel: "Create your packaging QR code", + }, + { + slug: "real-estate-sign-qr-codes", + href: "/use-cases/real-estate-sign-qr-codes", + title: "Real Estate Sign QR Codes", + cluster: "real-estate", + summary: "Keep listing routes current and compare sign, brochure, and open-house traffic with cleaner reporting.", + parentHref: "/qr-code-tracking", + parentTitle: "QR Code Tracking", + ctaLabel: "Create your real estate QR code", + }, + { + slug: "feedback-qr-codes", + href: "/use-cases/feedback-qr-codes", + title: "Feedback QR Codes", + cluster: "feedback", + summary: "Capture in-store feedback, route happy customers to review flows, and measure which placements get responses.", + parentHref: "/qr-code-tracking", + parentTitle: "QR Code Tracking", + ctaLabel: "Create your feedback QR code", + }, + { + slug: "payment-qr-codes", + href: "/use-cases/payment-qr-codes", + title: "Payment QR Codes", + cluster: "payments", + summary: "Send scanners straight into a mobile payment action without making printed payment prompts go stale.", + parentHref: "/dynamic-qr-code-generator", + parentTitle: "Dynamic QR Code Generator", + ctaLabel: "Create your payment QR code", + }, + { + slug: "coupon-qr-codes", + href: "/use-cases/coupon-qr-codes", + title: "Coupon QR Codes", + cluster: "offers", + summary: "Tie coupon placements to measurable scans so you know which print offers actually get redeemed.", + parentHref: "/qr-code-tracking", + parentTitle: "QR Code Tracking", + ctaLabel: "Create your coupon QR code", + }, +]; + +export const featuredUseCases: UseCaseLink[] = allUseCases.filter((item) => + [ + "restaurant-menu-qr-codes", + "business-card-qr-codes", + "flyer-qr-codes", + "packaging-qr-codes", + "real-estate-sign-qr-codes", + "feedback-qr-codes", + ].includes(item.slug), +); + +export const upcomingUseCaseIdeas: SupportResourceLink[] = [ + { + href: "/bulk-qr-code-generator", + title: "Product label workflows", + description: "Best next cluster once packaging analytics and bulk import pages are live together.", + }, + { + href: "/qr-code-for-marketing-campaigns", + title: "Brochure and trade-show campaigns", + description: "Natural second-wave expansion for print attribution once flyer workflows are established.", + }, + { + href: "/dynamic-qr-code-generator", + title: "Table ordering and service flows", + description: "High-fit hospitality expansion after menu and payment journeys have performance data.", + }, +]; + +export const supportResources: SupportResourceLink[] = [ + { + href: "/learn/use-cases", + title: "Learn: Use Cases", + description: "Editorial pillar page for educational browsing and broader QR workflow discovery.", + }, + { + href: "/blog/dynamic-vs-static-qr-codes", + title: "Dynamic vs Static QR Codes", + description: "Explainer for the operational difference between fixed and editable QR destinations.", + }, + { + href: "/blog/utm-parameter-qr-codes", + title: "UTM Parameters with QR Codes", + description: "Reference guide for campaign naming, placement attribution, and offline measurement.", + }, +]; + +function bySlug(slug: string): UseCaseLink { + const match = allUseCases.find((item) => item.slug === slug); + + if (!match) { + throw new Error(`Unknown use case slug: ${slug}`); + } + + return match; +} + +export const useCasePageContent: Record = { + "restaurant-menu-qr-codes": { + ...bySlug("restaurant-menu-qr-codes"), + eyebrow: "Restaurants", + titleSuffix: "for Restaurants, Cafes, and Changing Menus", + metaDescription: + "Use restaurant menu QR codes to keep printed table cards useful when menu links, pricing, or specials change.", + intro: + "Restaurant menu QR codes work best when the printed code stays the same but the menu destination can change as your service changes.", + answer: + "A restaurant menu QR code should point to a mobile-friendly menu that you can update without replacing every printed card, flyer, or table tent.", + whenToUse: [ + "Your menu link changes seasonally, weekly, or during service.", + "You want one printed QR on tables, windows, takeaway inserts, or flyers.", + "You need to route customers to the right menu, order flow, or special page without reprinting.", + ], + comparisonItems: [ + { label: "Menu destination", text: "Fixed once printed", value: true }, + { label: "Last-minute updates", text: "Reprint required", value: true }, + { label: "Campaign tracking", text: "Limited", value: true }, + ], + howToSteps: [ + "Create one dynamic menu QR and place it on your printed surfaces.", + "Send scanners to your current menu, order page, or daily specials page.", + "Update the destination when the menu or campaign changes instead of replacing the code.", + ], + workflowTitle: "What a good restaurant QR setup should handle", + workflowIntro: + "The QR code is not the product. The workflow behind it is. A good restaurant setup keeps print stable while operations stay flexible.", + workflowCards: [ + { + title: "Stable table cards", + description: "Keep one printed QR on tables and point it to the current menu, lunch card, or ordering page.", + }, + { + title: "Seasonal offers", + description: "Swap specials, tasting menus, or holiday landing pages without touching the printed material.", + }, + { + title: "Placement tracking", + description: "Use different menu or campaign destinations by location so you can compare tables, windows, and takeaway inserts.", + }, + ], + checklistTitle: "Restaurant QR checklist", + checklist: [ + "Use a mobile-first landing page instead of a hard-to-read PDF where possible.", + "Keep the same printed QR on every stable surface you do not want to replace often.", + "Use CTA copy like 'Scan for menu' or 'Scan for today's specials' so the scan intent is obvious.", + "Pair campaign placements with trackable destinations when you test takeaway or window traffic.", + ], + supportLinks: [ + { + href: "/dynamic-qr-code-generator", + title: "Commercial parent: Dynamic QR Code Generator", + description: "Best fit when the real need is editing the destination after print.", + }, + { + href: "/blog/qr-code-restaurant-menu", + title: "Restaurant menu guide", + description: "Existing editorial asset with menu placement and implementation basics.", + }, + { + href: "/use-cases/payment-qr-codes", + title: "Sibling page: Payment QR Codes", + description: "Useful when the same physical surfaces need an up-to-date post-scan payment action.", + }, + ], + faq: [ + { + question: "Should a restaurant menu QR code be static or dynamic?", + answer: "Use a dynamic QR code when the menu destination may change. That lets you update the landing page without replacing your printed materials.", + }, + { + question: "What should a restaurant menu QR code link to?", + answer: "Link to a mobile-friendly menu page, ordering page, or a short service hub that helps customers reach the right menu fast.", + }, + { + question: "Can I use one restaurant QR code in multiple places?", + answer: "Yes. One stable code can be reused across table cards, flyers, and takeaway materials, especially when the destination is managed dynamically.", + }, + ], + }, + "business-card-qr-codes": { + ...bySlug("business-card-qr-codes"), + eyebrow: "Business Cards", + titleSuffix: "for Contact Sharing, Bookings, and Portfolio Links", + metaDescription: + "Use business card QR codes to share a current contact page, vCard, booking link, or portfolio without reprinting cards.", + intro: + "Business card QR codes are most useful when your contact destination changes faster than your print inventory.", + answer: + "A business card QR code should send people to the best next action today, whether that is saving your contact, opening a booking link, or visiting a current profile page.", + whenToUse: [ + "Your role, booking link, or portfolio changes more often than your printed cards.", + "You want one card to work for networking, sales follow-up, and contact saving.", + "You need a cleaner handoff than asking people to type a URL from a small card.", + ], + comparisonItems: [ + { label: "Destination flexibility", text: "Fixed once printed", value: true }, + { label: "Contact updates", text: "New cards needed", value: true }, + { label: "Action routing", text: "Single fixed page", value: true }, + ], + howToSteps: [ + "Choose the real action you want after the scan: save contact, book time, or view work.", + "Generate a QR code that sends people to that destination or to a vCard-capable landing page.", + "Keep the print the same and update the linked destination when your details evolve.", + ], + workflowTitle: "Where business card QR codes pay off", + workflowIntro: + "Printed cards still work. The problem is that the destination behind them often gets stale first.", + workflowCards: [ + { + title: "Current contact flow", + description: "Send scanners to a vCard or current contact page so the next step is saving your details, not typing them.", + }, + { + title: "Role or profile updates", + description: "Update the destination if you change company, title, offer, or booking link while old cards are still in circulation.", + }, + { + title: "Context-aware follow-up", + description: "Point event-specific cards or team variants to the most relevant landing page instead of one generic homepage.", + }, + ], + checklistTitle: "Business card QR checklist", + checklist: [ + "Pick one primary post-scan action instead of trying to send every scanner to everything at once.", + "Make the landing page useful on mobile because most business-card scans happen on phones.", + "Use CTA text such as 'Scan to save my contact' or 'Scan to book a call'.", + "Test the print size and contrast before ordering a large run.", + ], + supportLinks: [ + { + href: "/dynamic-qr-code-generator", + title: "Commercial parent: Dynamic QR Code Generator", + description: "Use when the printed card stays constant but the best destination changes.", + }, + { + href: "/tools/vcard-qr-code", + title: "vCard QR Code tool", + description: "Free tool for contact-saving workflows when a vCard is the best immediate action.", + }, + { + href: "/use-cases/event-qr-codes", + title: "Sibling page: Event QR Codes", + description: "Another workflow where temporary destinations and scan context matter.", + }, + ], + faq: [ + { + question: "What should a business card QR code link to?", + answer: "The best destination is the one next step you want most: a vCard, booking page, contact hub, or current portfolio page.", + }, + { + question: "Do business card QR codes need to be dynamic?", + answer: "They should be dynamic if your destination may change over the life of the printed card. That keeps old cards useful longer.", + }, + { + question: "Can a business card QR code send people straight to contact saving?", + answer: "Yes. A vCard QR or a landing page with clear save-contact options is often the simplest and most practical post-scan action.", + }, + ], + }, + "event-qr-codes": { + ...bySlug("event-qr-codes"), + eyebrow: "Events", + titleSuffix: "for Check-In, Schedules, Booths, and Campaign Tracking", + metaDescription: + "Use event QR codes for schedules, check-in flows, and trackable campaign placements across signs, flyers, and booths.", + intro: + "Event QR codes work best when you separate operational QR flows from promotional ones and keep your printed placements easy to manage.", + answer: + "A good event QR setup uses different QR destinations for different jobs: operations, attendee utility, and campaign measurement should not all depend on one code.", + whenToUse: [ + "Your event schedule, map, or resources may change close to event day.", + "You want to compare booth, banner, flyer, or badge placements instead of treating every scan as one bucket.", + "You need one event QR system that supports both attendee utility and marketing follow-up.", + ], + comparisonItems: [ + { label: "Schedule changes", text: "New print may be needed", value: true }, + { label: "Placement reporting", text: "Weak by default", value: true }, + { label: "Operational vs campaign flows", text: "Often mixed", value: true }, + ], + howToSteps: [ + "Split event QR codes by purpose: check-in, attendee info, and campaign placements.", + "Use trackable destinations for banners, booth assets, and flyers where placement performance matters.", + "Keep fast-changing resources on destinations you can update without replacing the printed code.", + ], + workflowTitle: "Event workflows worth designing on purpose", + workflowIntro: + "Events generate scans in very different contexts. Treating them as one generic QR use case leaves both operations and measurement weaker.", + workflowCards: [ + { + title: "Operational QR flows", + description: "Use dedicated QR paths for check-in, schedules, maps, and attendee resources that may shift before or during the event.", + }, + { + title: "Booth and banner tracking", + description: "Track scans from distinct placements so you can compare booth creatives, sponsor zones, or call-to-action angles.", + }, + { + title: "Post-event follow-up", + description: "Route scanners to the most relevant recap, booking, or lead capture page after the event without changing the printed assets.", + }, + ], + checklistTitle: "Event QR checklist", + checklist: [ + "Do not force one QR code to handle operations, schedule updates, and lead-gen at the same time.", + "Use descriptive CTA copy like 'Scan for agenda' or 'Scan for booth resources'.", + "Track campaign placements separately so booth banners and flyers are comparable.", + "Test glare, print size, and placement distance on the real event materials before the event starts.", + ], + supportLinks: [ + { + href: "/qr-code-tracking", + title: "Commercial parent: QR Code Tracking", + description: "Best fit when the priority is measuring placement and scan context across the event.", + }, + { + href: "/tools/event-qr-code", + title: "Event QR Code tool", + description: "Useful for save-the-date and calendar workflows that sit alongside broader event QR strategy.", + }, + { + href: "/use-cases/flyer-qr-codes", + title: "Sibling page: Flyer QR Codes", + description: "Useful when event promotion depends on measurable printed distribution before event day.", + }, + ], + faq: [ + { + question: "Should an event use one QR code or several?", + answer: "Several is usually better. Separate operational QR codes from campaign QR codes so schedules, check-in, and attribution do not compete for one destination.", + }, + { + question: "Can event QR codes be updated after print?", + answer: "Yes, if the destination is managed dynamically. That is useful for schedules, resource hubs, and post-event follow-up pages.", + }, + { + question: "How do I measure which event placement performs best?", + answer: "Use distinct destinations or tagged URLs for each placement so banner, booth, badge, and flyer traffic can be compared cleanly.", + }, + ], + }, + "flyer-qr-codes": { + ...bySlug("flyer-qr-codes"), + eyebrow: "Print Campaigns", + titleSuffix: "for Promotions, Posters, and Offline Campaign Testing", + metaDescription: + "Use flyer QR codes to keep print campaigns measurable, compare placements, and change the destination without reprinting every batch.", + intro: + "Flyer QR codes work best when the printed asset can stay in circulation while the offer, landing page, or attribution model keeps evolving.", + answer: + "A flyer QR code should connect one printed call to action with a destination you can update and a scan trail you can compare across placements, neighborhoods, or campaign waves.", + whenToUse: [ + "You run local flyers, direct mail, posters, or leave-behind materials with changing offers.", + "You want to compare placement performance instead of treating every scan like one generic campaign.", + "You need campaign flexibility after the flyer run has already been distributed.", + ], + comparisonItems: [ + { label: "Offer updates", text: "New print run needed", value: true }, + { label: "Placement attribution", text: "Often unclear", value: true }, + { label: "Creative testing", text: "Weak by default", value: true }, + ], + howToSteps: [ + "Create one flyer QR flow per offer or placement cluster, not one code for every campaign forever.", + "Use a dynamic destination or tagged URL so the landing page can change without replacing the print.", + "Track scan context by distribution point, neighborhood, or creative version before deciding what scales.", + ], + workflowTitle: "What flyer QR codes should help you measure", + workflowIntro: + "Flyers are easy to print and hard to evaluate unless the QR setup is designed for comparison from the beginning.", + workflowCards: [ + { + title: "Placement-aware campaigns", + description: "Split codes or destinations by region, venue type, or distribution partner so scans can be compared without guesswork.", + }, + { + title: "Offer iteration after print", + description: "Keep the same flyer in circulation while you change the landing page, schedule, or campaign CTA behind the code.", + }, + { + title: "Print-to-signup reporting", + description: "Use flyer scans as the first step in a measurable path toward signup, booking, coupon claim, or lead capture.", + }, + ], + checklistTitle: "Flyer QR checklist", + checklist: [ + "Write one clear scan CTA on the flyer instead of forcing the code to explain itself.", + "Use separate tracking logic for high-volume placements rather than one generic destination.", + "Match the flyer promise to the first screen after the scan.", + "Review scan performance by placement before printing the next batch.", + ], + supportLinks: [ + { + href: "/qr-code-for-marketing-campaigns", + title: "Commercial parent: QR Codes for Marketing Campaigns", + description: "Best fit when your flyer is part of a broader offline-to-online campaign system.", + }, + { + href: "/blog/utm-parameter-qr-codes", + title: "UTM Parameters with QR Codes", + description: "Support article for comparing flyer locations, campaign bursts, and creative versions.", + }, + { + href: "/use-cases/coupon-qr-codes", + title: "Sibling page: Coupon QR Codes", + description: "Useful when flyer distribution is meant to drive a specific redeemable offer.", + }, + ], + faq: [ + { + question: "Should a flyer QR code be dynamic?", + answer: "Yes, if the landing page, offer, or campaign tracking may change after printing. That keeps the flyer useful longer and avoids waste.", + }, + { + question: "How do I track flyer QR codes by location?", + answer: "Use distinct destinations or campaign tags by placement so scans from each distribution point can be compared cleanly.", + }, + { + question: "What should a flyer QR code link to?", + answer: "Link to the one next action promised on the flyer, such as a signup page, offer page, booking page, or campaign landing page.", + }, + ], + }, + "packaging-qr-codes": { + ...bySlug("packaging-qr-codes"), + eyebrow: "Packaging", + titleSuffix: "for Product Support, Inserts, and Post-Purchase Journeys", + metaDescription: + "Use packaging QR codes to route buyers into manuals, product support, onboarding, or post-purchase offers while keeping scans measurable.", + intro: + "Packaging QR codes are most valuable when they do more than send users to a homepage. They should support a product journey after purchase and give you visibility into what people actually scan.", + answer: + "A packaging QR code should connect the physical product to a useful post-purchase destination such as setup help, manuals, registration, support, or follow-up content that can be updated later.", + whenToUse: [ + "You need product packaging, labels, or inserts to send users to changing support or onboarding pages.", + "You want scan visibility by product line, SKU family, or campaign batch.", + "You need a better bridge from physical packaging into post-purchase education or retention.", + ], + comparisonItems: [ + { label: "Manual updates", text: "Requires reprint", value: true }, + { label: "Post-purchase reporting", text: "Minimal", value: true }, + { label: "Product-line comparison", text: "Hard to organize", value: true }, + ], + howToSteps: [ + "Map each packaging QR to one useful post-purchase job such as setup, manuals, support, or product registration.", + "Use a destination structure that can change as documentation, support paths, or campaign links evolve.", + "Review scans by product line or package type so packaging placements become a reporting surface instead of a blind spot.", + ], + workflowTitle: "Packaging QR workflows worth building deliberately", + workflowIntro: + "Once a package is shipped, the QR code becomes part of the customer experience. The supporting flow should be stable enough for print but flexible enough for the business.", + workflowCards: [ + { + title: "Support and setup routing", + description: "Send new customers to the right setup guide, manual, warranty flow, or help entry point without forcing them to search.", + }, + { + title: "Batch or product analytics", + description: "Track which products, inserts, or packaging lines drive scans so you can see where post-purchase engagement actually happens.", + }, + { + title: "Offer and content updates", + description: "Swap destinations after launch when manuals, app links, retention offers, or onboarding content change.", + }, + ], + checklistTitle: "Packaging QR checklist", + checklist: [ + "Make the first scanned destination obviously relevant to the product in hand.", + "Avoid routing every package to the same generic homepage.", + "Use analytics naming that lets product lines or batches be reviewed later.", + "Test print size, contrast, and material finish on real packaging samples.", + ], + supportLinks: [ + { + href: "/qr-code-analytics", + title: "Commercial parent: QR Code Analytics", + description: "Best fit when packaging scans need to become a measurable post-purchase signal.", + }, + { + href: "/bulk-qr-code-generator", + title: "Bulk QR Code Generator", + description: "Useful when packaging programs need many codes across SKUs, inserts, or recurring runs.", + }, + { + href: "/use-cases/coupon-qr-codes", + title: "Sibling page: Coupon QR Codes", + description: "Useful when packaging scans need to trigger a measurable offer or retention prompt.", + }, + ], + faq: [ + { + question: "What should a packaging QR code link to?", + answer: "The best destination is usually a post-purchase action such as setup help, manuals, support, registration, or a product-specific resource hub.", + }, + { + question: "Can packaging QR codes be tracked?", + answer: "Yes. With a trackable QR setup you can review how packaging scans perform by product line, batch, placement, or destination.", + }, + { + question: "Should packaging QR codes be dynamic?", + answer: "They should be dynamic when product documentation, app links, support flows, or promotional destinations may change after the packaging is printed.", + }, + ], + }, + "real-estate-sign-qr-codes": { + ...bySlug("real-estate-sign-qr-codes"), + eyebrow: "Real Estate", + titleSuffix: "for Listings, Brochures, and Open-House Routing", + metaDescription: + "Use real estate sign QR codes to route buyers to the current listing experience and compare sign, brochure, and open-house performance.", + intro: + "Real estate sign QR codes are strongest when listing traffic stays current even as inventory, open-house schedules, or brochure links change.", + answer: + "A real estate sign QR code should connect a passerby to the right listing, brochure, or inquiry flow today while keeping enough tracking context to compare sign performance over time.", + whenToUse: [ + "You need signs, window displays, or property brochures to point to live listing information.", + "You want to compare scans from signs, flyers, open houses, or brokerage materials.", + "You need listing routes that can change after print when the property status or CTA changes.", + ], + comparisonItems: [ + { label: "Listing updates", text: "Static links get stale", value: true }, + { label: "Sign performance", text: "Usually opaque", value: true }, + { label: "Property routing", text: "One fixed page", value: true }, + ], + howToSteps: [ + "Connect each sign QR to the right listing, brochure, or lead flow instead of a generic homepage.", + "Use trackable routing when the same property appears on signs, flyers, and open-house materials.", + "Change the destination when the listing status, CTA, or follow-up flow changes without replacing printed signs.", + ], + workflowTitle: "Where real estate QR systems become useful", + workflowIntro: + "Real estate print assets stay in the field while listing status and buyer next steps change. The QR setup should reflect that reality.", + workflowCards: [ + { + title: "Live listing routing", + description: "Keep signs useful even if the preferred listing page, brochure path, or inquiry CTA changes after installation.", + }, + { + title: "Source comparison", + description: "Compare sign traffic against property flyers, open-house materials, and office displays without merging everything into one bucket.", + }, + { + title: "Lead-ready handoff", + description: "Route scanners to the current listing hub, brochure request, or showing inquiry page instead of a dead-end listing snapshot.", + }, + ], + checklistTitle: "Real estate sign QR checklist", + checklist: [ + "Use a mobile-first listing page because most sign scans happen on phones.", + "Name tracking sources so sign, flyer, and open-house scans can be reviewed separately.", + "Update the destination when the property status or lead path changes.", + "Test scan distance and contrast on the actual sign material before production.", + ], + supportLinks: [ + { + href: "/qr-code-tracking", + title: "Commercial parent: QR Code Tracking", + description: "Best fit when the goal is comparing real-world property placements and scan context.", + }, + { + href: "/qr-code-for-marketing-campaigns", + title: "QR Codes for Marketing Campaigns", + description: "Useful when property promotion sits inside a broader local acquisition campaign.", + }, + { + href: "/use-cases/flyer-qr-codes", + title: "Sibling page: Flyer QR Codes", + description: "Useful when listing promotion depends on both sign traffic and printed collateral.", + }, + ], + faq: [ + { + question: "What should a real estate sign QR code link to?", + answer: "It should link to the current listing experience, brochure page, or inquiry flow rather than a generic homepage or a static PDF that goes stale quickly.", + }, + { + question: "Can I track real estate sign QR code scans?", + answer: "Yes. A trackable setup can help compare sign scans against other property materials such as flyers or open-house handouts.", + }, + { + question: "Should real estate QR codes be dynamic?", + answer: "Yes, when listing details, CTA flows, or follow-up destinations may change while the sign remains in the field.", + }, + ], + }, + "feedback-qr-codes": { + ...bySlug("feedback-qr-codes"), + eyebrow: "Feedback", + titleSuffix: "for Reviews, In-Store Feedback, and Follow-Up Journeys", + metaDescription: + "Use feedback QR codes to capture customer responses, route high-intent users into review flows, and measure which placements get feedback.", + intro: + "Feedback QR codes work best when they remove friction from the review or response step and still let you measure which placements actually drive action.", + answer: + "A feedback QR code should make it easy for customers to leave a response in the moment while giving your team enough context to compare locations, surfaces, or follow-up performance.", + whenToUse: [ + "You want table cards, receipts, packaging inserts, or in-store prompts to collect feedback fast.", + "You need a cleaner path from offline service moments into reviews or internal feedback collection.", + "You want to compare where feedback requests actually convert instead of placing the same prompt everywhere.", + ], + comparisonItems: [ + { label: "Feedback routing", text: "Often generic", value: true }, + { label: "Placement reporting", text: "Weak by default", value: true }, + { label: "Review flow control", text: "Hard to tune", value: true }, + ], + howToSteps: [ + "Place feedback QR codes where the customer can act immediately after the experience, not hours later.", + "Route the scan into the right feedback or review flow for that context.", + "Track scans and responses by placement so you know which surfaces deserve continued print inventory.", + ], + workflowTitle: "Feedback QR flows that are worth measuring", + workflowIntro: + "Feedback requests perform differently depending on timing, location, and the post-scan experience. The QR flow should reflect that.", + workflowCards: [ + { + title: "Moment-of-service feedback", + description: "Capture responses while the customer is still on site, at the table, or inside the post-purchase moment.", + }, + { + title: "Review routing", + description: "Separate internal feedback collection from external review requests so the business controls the next step more clearly.", + }, + { + title: "Placement comparison", + description: "Compare table cards, receipts, packaging inserts, and counter displays to see where customers actually respond.", + }, + ], + checklistTitle: "Feedback QR checklist", + checklist: [ + "Ask for one simple next action after the scan instead of combining review, survey, and support in one step.", + "Place feedback prompts where the service experience is still fresh.", + "Name or tag locations so scan and response performance can be reviewed later.", + "Use a short, obvious CTA such as 'Scan to leave feedback' or 'Scan to rate your visit'.", + ], + supportLinks: [ + { + href: "/qr-code-tracking", + title: "Commercial parent: QR Code Tracking", + description: "Best fit when you need to compare feedback placements and understand scan context.", + }, + { + href: "/blog/trackable-qr-codes", + title: "Trackable QR Codes", + description: "Support article for teams that want a measurable review or response program across multiple placements.", + }, + { + href: "/use-cases/coupon-qr-codes", + title: "Sibling page: Coupon QR Codes", + description: "Useful when the same offline surfaces support both feedback collection and post-visit offers.", + }, + ], + faq: [ + { + question: "What is a feedback QR code?", + answer: "A feedback QR code sends customers to a review, survey, or response form so they can give feedback immediately after a visit or purchase.", + }, + { + question: "Can feedback QR codes be tracked?", + answer: "Yes. A trackable setup can show which placements, locations, or materials generate the most scans and responses.", + }, + { + question: "Where should I place a feedback QR code?", + answer: "Place it where the customer can act right after the experience, such as on table cards, receipts, counters, packaging inserts, or post-service handouts.", + }, + ], + }, + "payment-qr-codes": { + ...bySlug("payment-qr-codes"), + eyebrow: "Payments", + titleSuffix: "for Mobile Checkout, Counter Payments, and Printed Prompts", + metaDescription: + "Use payment QR codes to route customers into a mobile payment action that stays current even when links or workflows change.", + intro: + "Payment QR codes are most useful when the printed prompt stays simple while the underlying payment destination can change with the business.", + answer: + "A payment QR code should move a scanner directly into the intended payment action on mobile without forcing the business to replace printed prompts every time the payment flow changes.", + whenToUse: [ + "You use printed payment prompts on counters, tables, invoices, or leave-behind materials.", + "You need a mobile-first payment path instead of asking customers to type a long URL.", + "You want flexibility when the payment link, provider, or landing flow changes over time.", + ], + comparisonItems: [ + { label: "Payment destination", text: "Fixed once printed", value: true }, + { label: "Provider changes", text: "Reprint required", value: true }, + { label: "Post-scan routing", text: "Limited", value: true }, + ], + howToSteps: [ + "Decide which payment action the code should trigger: direct payment, checkout page, invoice page, or service deposit.", + "Generate one QR per real payment context instead of one generic payment code for everything.", + "Use a destination that can be updated when your payment provider or checkout flow changes.", + ], + workflowTitle: "Payment QR workflows that stay practical after print", + workflowIntro: + "Payment prompts live on physical surfaces longer than the payment links behind them. The QR workflow should absorb that change instead of forcing reprints.", + workflowCards: [ + { + title: "Counter and table payments", + description: "Use printed QR prompts to move a customer into a fast mobile payment step without manual URL entry.", + }, + { + title: "Invoice and leave-behind flows", + description: "Attach payment actions to printed materials that may remain in circulation after a provider or link update.", + }, + { + title: "Context-specific routing", + description: "Send different payment scenarios to the right checkout or follow-up path instead of one catch-all destination.", + }, + ], + checklistTitle: "Payment QR checklist", + checklist: [ + "Make the scan CTA specific so users know they are opening a payment action.", + "Use a mobile-first checkout or payment screen.", + "Keep one QR per payment context when the follow-up steps differ.", + "Update the destination if provider links or invoice flows change after print.", + ], + supportLinks: [ + { + href: "/dynamic-qr-code-generator", + title: "Commercial parent: Dynamic QR Code Generator", + description: "Best fit when the printed payment prompt must survive future destination changes.", + }, + { + href: "/tools/paypal-qr-code", + title: "PayPal QR Code tool", + description: "Useful for direct payment-oriented workflows when PayPal is the intended post-scan action.", + }, + { + href: "/use-cases/restaurant-menu-qr-codes", + title: "Sibling page: Restaurant Menu QR Codes", + description: "Useful when table cards combine service information and a later payment or ordering action.", + }, + ], + faq: [ + { + question: "What should a payment QR code link to?", + answer: "It should link to the actual mobile payment action you want the user to take, such as a checkout page, invoice page, or direct payment destination.", + }, + { + question: "Should payment QR codes be dynamic?", + answer: "Yes, when the payment destination, provider, or checkout flow may change after the printed code is already in use.", + }, + { + question: "Where do payment QR codes work best?", + answer: "They work best on printed surfaces where a fast mobile payment step is valuable, such as counters, invoices, tables, service documents, or leave-behind materials.", + }, + ], + }, + "coupon-qr-codes": { + ...bySlug("coupon-qr-codes"), + eyebrow: "Offers", + titleSuffix: "for Measurable Discounts, Redemptions, and Local Promotions", + metaDescription: + "Use coupon QR codes to connect printed offers with measurable scans, current discount pages, and cleaner redemption reporting.", + intro: + "Coupon QR codes are strongest when the discount path stays current and your team can see which print placements actually generate redemptions.", + answer: + "A coupon QR code should connect one printed offer to a landing or redemption flow you can update later while preserving enough tracking context to compare placements and promotion waves.", + whenToUse: [ + "You run discounts on flyers, receipts, inserts, posters, or local print campaigns.", + "You want to compare which printed offer placements drive scans or redemptions.", + "You need the offer destination to stay current even if the promotion changes after print.", + ], + comparisonItems: [ + { label: "Offer changes", text: "Static links go stale", value: true }, + { label: "Redemption visibility", text: "Often weak", value: true }, + { label: "Placement comparison", text: "Usually manual", value: true }, + ], + howToSteps: [ + "Create one coupon QR flow per actual offer or placement group instead of mixing promotions together.", + "Use a destination or coupon page that can change after distribution if the offer window shifts.", + "Review scan and redemption context by flyer, receipt, package insert, or local placement before scaling the next campaign.", + ], + workflowTitle: "Coupon QR systems that improve the next campaign", + workflowIntro: + "Printed offers are only useful if the path behind them stays live and the results can be reviewed later. A coupon QR should support both.", + workflowCards: [ + { + title: "Offer routing after print", + description: "Keep the same printed discount prompt alive while the landing page, code, or campaign framing changes.", + }, + { + title: "Placement reporting", + description: "Compare where coupons get scanned or redeemed so posters, flyers, inserts, and receipts stop being one blended source.", + }, + { + title: "Redemption-focused follow-up", + description: "Route the scan into a path that makes redemption easy instead of forcing the user to search for the offer again.", + }, + ], + checklistTitle: "Coupon QR checklist", + checklist: [ + "Write the offer clearly on the printed asset so the QR code reinforces one promise.", + "Use distinct tracking for major placements or campaign waves.", + "Keep the redemption page or coupon path mobile-friendly.", + "Update the destination when the offer changes instead of leaving dead promotions in circulation.", + ], + supportLinks: [ + { + href: "/qr-code-tracking", + title: "Commercial parent: QR Code Tracking", + description: "Best fit when the value comes from comparing placements and measuring offer performance.", + }, + { + href: "/blog/trackable-qr-codes", + title: "Trackable QR Codes", + description: "Support article for teams that want a more measurable coupon or discount program.", + }, + { + href: "/use-cases/flyer-qr-codes", + title: "Sibling page: Flyer QR Codes", + description: "Useful when the coupon is part of a measurable flyer or local promotion program.", + }, + ], + faq: [ + { + question: "What is a coupon QR code?", + answer: "A coupon QR code sends users to an offer or redemption page so the discount can be claimed without typing a URL or code manually.", + }, + { + question: "Can coupon QR codes be tracked?", + answer: "Yes. A trackable setup helps compare scans and coupon performance across placements such as flyers, posters, inserts, or receipts.", + }, + { + question: "Should a coupon QR code be dynamic?", + answer: "Yes, when the promotion, landing page, or redemption flow may change while the printed asset is still in circulation.", + }, + ], + }, +}; + +export function getUseCasePage(slug: string): UseCasePageContent | undefined { + return useCasePageContent[slug]; +} diff --git a/src/lib/hash.ts b/src/lib/hash.ts index ec2e90c..df9381f 100644 --- a/src/lib/hash.ts +++ b/src/lib/hash.ts @@ -1,49 +1,49 @@ -import crypto from 'crypto'; -import { env } from './env'; - -/** - * Hash an IP address for privacy - * Uses a salt from environment variables to ensure consistent hashing - */ -export function hashIP(ip: string): string { - const salt = env.IP_SALT || 'default-salt-change-in-production'; - return crypto - .createHash('sha256') - .update(ip + salt) - .digest('hex') - .substring(0, 16); // Use first 16 chars for storage efficiency -} - -/** - * Generate a random slug for QR codes - */ -export function generateSlug(title?: string): string { - const base = title - ? title.toLowerCase().replace(/[^a-z0-9]+/g, '-').substring(0, 20) - : 'qr'; - const random = Math.random().toString(36).substring(2, 8); - return `${base}-${random}`; -} - -/** - * Generate a secure API key - */ -export function generateApiKey(): string { - return 'qrm_' + crypto.randomBytes(32).toString('hex'); -} - -/** - * Hash a password (for comparison with bcrypt hashed passwords) - */ -export async function hashPassword(password: string): Promise { - const bcrypt = await import('bcryptjs'); - return bcrypt.hash(password, 12); -} - -/** - * Compare a plain password with a hashed password - */ -export async function comparePassword(password: string, hash: string): Promise { - const bcrypt = await import('bcryptjs'); - return bcrypt.compare(password, hash); +import crypto from 'crypto'; +import { env } from './env'; + +/** + * Hash an IP address for privacy + * Uses a salt from environment variables to ensure consistent hashing + */ +export function hashIP(ip: string): string { + const salt = env.IP_SALT || 'default-salt-change-in-production'; + return crypto + .createHash('sha256') + .update(ip + salt) + .digest('hex') + .substring(0, 16); // Use first 16 chars for storage efficiency +} + +/** + * Generate a random slug for QR codes + */ +export function generateSlug(title?: string): string { + const base = title + ? title.toLowerCase().replace(/[^a-z0-9]+/g, '-').substring(0, 20) + : 'qr'; + const random = Math.random().toString(36).substring(2, 8); + return `${base}-${random}`; +} + +/** + * Generate a secure API key + */ +export function generateApiKey(): string { + return 'qrm_' + crypto.randomBytes(32).toString('hex'); +} + +/** + * Hash a password (for comparison with bcrypt hashed passwords) + */ +export async function hashPassword(password: string): Promise { + const bcrypt = await import('bcryptjs'); + return bcrypt.hash(password, 12); +} + +/** + * Compare a plain password with a hashed password + */ +export async function comparePassword(password: string, hash: string): Promise { + const bcrypt = await import('bcryptjs'); + return bcrypt.compare(password, hash); } \ No newline at end of file diff --git a/src/lib/qr.ts b/src/lib/qr.ts index ff15f2e..3f78b16 100644 --- a/src/lib/qr.ts +++ b/src/lib/qr.ts @@ -1,227 +1,227 @@ -import { z } from 'zod'; -import QRCode from 'qrcode'; -import { db } from './db'; -import { generateSlug, hashIP } from './hash'; -import { getCountryFromHeaders, parseUserAgent } from './geo'; -import { ContentType, QRType, QRStatus } from '@prisma/client'; -import Redis from 'ioredis'; -import { env } from './env'; - -// Redis client (optional) -let redis: Redis | null = null; -if (env.REDIS_URL) { - try { - redis = new Redis(env.REDIS_URL); - } catch (error) { - console.warn('Redis connection failed, falling back to direct DB writes'); - } -} - -// Validation schemas -const qrContentSchema = z.object({ - url: z.string().url().optional(), - phone: z.string().optional(), - email: z.string().email().optional(), - message: z.string().optional(), - text: z.string().optional(), - // VCARD fields - firstName: z.string().optional(), - lastName: z.string().optional(), - organization: z.string().optional(), - title: z.string().optional(), - // GEO fields - latitude: z.number().optional(), - longitude: z.number().optional(), - label: z.string().optional(), -}); - -const qrStyleSchema = z.object({ - foregroundColor: z.string().default('#000000'), - backgroundColor: z.string().default('#FFFFFF'), - cornerStyle: z.enum(['square', 'rounded']).default('square'), - size: z.number().min(100).max(1000).default(200), -}); - -const createQRSchema = z.object({ - title: z.string().min(1).max(100), - type: z.nativeEnum(QRType).default(QRType.DYNAMIC), - contentType: z.nativeEnum(ContentType).default(ContentType.URL), - content: qrContentSchema, - tags: z.array(z.string()).default([]), - style: qrStyleSchema.default({}), -}); - -export async function createQR(userId: string, data: z.infer) { - const validated = createQRSchema.parse(data); - - const slug = generateSlug(validated.title); - - const qrCode = await db.qRCode.create({ - data: { - userId, - title: validated.title, - type: validated.type, - contentType: validated.contentType, - content: validated.content, - tags: validated.tags, - style: validated.style, - slug, - status: QRStatus.ACTIVE, - }, - }); - - return qrCode; -} - -export async function updateQR(id: string, userId: string, data: Partial>) { - const qrCode = await db.qRCode.findFirst({ - where: { id, userId }, - }); - - if (!qrCode) { - throw new Error('QR Code not found'); - } - - const updateData: any = {}; - - if (data.title) updateData.title = data.title; - if (data.content) updateData.content = data.content; - if (data.tags) updateData.tags = data.tags; - if (data.style) updateData.style = data.style; - - return db.qRCode.update({ - where: { id }, - data: updateData, - }); -} - -export async function generateQRCodeSVG(content: string, style: any = {}): Promise { - const options = { - type: 'svg' as const, - width: style.size || 200, - color: { - dark: style.foregroundColor || '#000000', - light: style.backgroundColor || '#FFFFFF', - }, - margin: 2, - }; - - return QRCode.toString(content, options); -} - -export async function generateQRCodePNG(content: string, style: any = {}): Promise { - const options = { - width: style.size || 200, - color: { - dark: style.foregroundColor || '#000000', - light: style.backgroundColor || '#FFFFFF', - }, - margin: 2, - }; - - return QRCode.toBuffer(content, options); -} - -export function getQRContent(qr: any): string { - const { contentType, content } = qr; - - switch (contentType) { - case 'URL': - return content.url || ''; - case 'PHONE': - return `tel:${content.phone || ''}`; - case 'SMS': - const message = content.message ? `?body=${encodeURIComponent(content.message)}` : ''; - return `sms:${content.phone || ''}${message}`; - case 'WHATSAPP': - const whatsappMessage = content.message ? `?text=${encodeURIComponent(content.message)}` : ''; - return `https://wa.me/${content.phone || ''}${whatsappMessage}`; - case 'VCARD': - return `BEGIN:VCARD -VERSION:3.0 -FN:${content.firstName || ''} ${content.lastName || ''} -ORG:${content.organization || ''} -TITLE:${content.title || ''} -EMAIL:${content.email || ''} -TEL:${content.phone || ''} -END:VCARD`; - case 'GEO': - const lat = content.latitude || 0; - const lon = content.longitude || 0; - const label = content.label ? `?q=${encodeURIComponent(content.label)}` : ''; - return `geo:${lat},${lon}${label}`; - case 'TEXT': - return content.text || ''; - default: - return content.url || ''; - } -} - -export async function trackScan(qrId: string, request: Request) { - const headers = request.headers; - const ip = headers.get('x-forwarded-for') || headers.get('x-real-ip') || '127.0.0.1'; - const userAgent = headers.get('user-agent'); - const referrer = headers.get('referer'); - const dnt = headers.get('dnt'); - - // Respect Do Not Track - if (dnt === '1') { - // Only increment aggregate counter, skip detailed tracking - return; - } - - const ipHash = hashIP(ip); - const country = getCountryFromHeaders(headers); - const { device, os } = parseUserAgent(userAgent); - - // Parse UTM parameters from referrer - let utmSource: string | null = null; - let utmMedium: string | null = null; - let utmCampaign: string | null = null; - - if (referrer) { - try { - const url = new URL(referrer); - utmSource = url.searchParams.get('utm_source'); - utmMedium = url.searchParams.get('utm_medium'); - utmCampaign = url.searchParams.get('utm_campaign'); - } catch (e) { - // Invalid referrer URL - } - } - - // Check if this is a unique scan (same IP hash within 24 hours) - const dayAgo = new Date(Date.now() - 24 * 60 * 60 * 1000); - const existingScan = await db.qRScan.findFirst({ - where: { - qrId, - ipHash, - ts: { gte: dayAgo }, - }, - }); - - const isUnique = !existingScan; - - const scanData = { - qrId, - ipHash, - userAgent, - device, - os, - country, - referrer, - utmSource, - utmMedium, - utmCampaign, - isUnique, - }; - - // Fire-and-forget tracking - if (redis) { - // Queue to Redis for background processing - redis.lpush('qr_scans', JSON.stringify(scanData)).catch(console.error); - } else { - // Direct database write - db.qRScan.create({ data: scanData }).catch(console.error); - } +import { z } from 'zod'; +import QRCode from 'qrcode'; +import { db } from './db'; +import { generateSlug, hashIP } from './hash'; +import { getCountryFromHeaders, parseUserAgent } from './geo'; +import { ContentType, QRType, QRStatus } from '@prisma/client'; +import Redis from 'ioredis'; +import { env } from './env'; + +// Redis client (optional) +let redis: Redis | null = null; +if (env.REDIS_URL) { + try { + redis = new Redis(env.REDIS_URL); + } catch (error) { + console.warn('Redis connection failed, falling back to direct DB writes'); + } +} + +// Validation schemas +const qrContentSchema = z.object({ + url: z.string().url().optional(), + phone: z.string().optional(), + email: z.string().email().optional(), + message: z.string().optional(), + text: z.string().optional(), + // VCARD fields + firstName: z.string().optional(), + lastName: z.string().optional(), + organization: z.string().optional(), + title: z.string().optional(), + // GEO fields + latitude: z.number().optional(), + longitude: z.number().optional(), + label: z.string().optional(), +}); + +const qrStyleSchema = z.object({ + foregroundColor: z.string().default('#000000'), + backgroundColor: z.string().default('#FFFFFF'), + cornerStyle: z.enum(['square', 'rounded']).default('square'), + size: z.number().min(100).max(1000).default(200), +}); + +const createQRSchema = z.object({ + title: z.string().min(1).max(100), + type: z.nativeEnum(QRType).default(QRType.DYNAMIC), + contentType: z.nativeEnum(ContentType).default(ContentType.URL), + content: qrContentSchema, + tags: z.array(z.string()).default([]), + style: qrStyleSchema.default({}), +}); + +export async function createQR(userId: string, data: z.infer) { + const validated = createQRSchema.parse(data); + + const slug = generateSlug(validated.title); + + const qrCode = await db.qRCode.create({ + data: { + userId, + title: validated.title, + type: validated.type, + contentType: validated.contentType, + content: validated.content, + tags: validated.tags, + style: validated.style, + slug, + status: QRStatus.ACTIVE, + }, + }); + + return qrCode; +} + +export async function updateQR(id: string, userId: string, data: Partial>) { + const qrCode = await db.qRCode.findFirst({ + where: { id, userId }, + }); + + if (!qrCode) { + throw new Error('QR Code not found'); + } + + const updateData: any = {}; + + if (data.title) updateData.title = data.title; + if (data.content) updateData.content = data.content; + if (data.tags) updateData.tags = data.tags; + if (data.style) updateData.style = data.style; + + return db.qRCode.update({ + where: { id }, + data: updateData, + }); +} + +export async function generateQRCodeSVG(content: string, style: any = {}): Promise { + const options = { + type: 'svg' as const, + width: style.size || 200, + color: { + dark: style.foregroundColor || '#000000', + light: style.backgroundColor || '#FFFFFF', + }, + margin: 2, + }; + + return QRCode.toString(content, options); +} + +export async function generateQRCodePNG(content: string, style: any = {}): Promise { + const options = { + width: style.size || 200, + color: { + dark: style.foregroundColor || '#000000', + light: style.backgroundColor || '#FFFFFF', + }, + margin: 2, + }; + + return QRCode.toBuffer(content, options); +} + +export function getQRContent(qr: any): string { + const { contentType, content } = qr; + + switch (contentType) { + case 'URL': + return content.url || ''; + case 'PHONE': + return `tel:${content.phone || ''}`; + case 'SMS': + const message = content.message ? `?body=${encodeURIComponent(content.message)}` : ''; + return `sms:${content.phone || ''}${message}`; + case 'WHATSAPP': + const whatsappMessage = content.message ? `?text=${encodeURIComponent(content.message)}` : ''; + return `https://wa.me/${content.phone || ''}${whatsappMessage}`; + case 'VCARD': + return `BEGIN:VCARD +VERSION:3.0 +FN:${content.firstName || ''} ${content.lastName || ''} +ORG:${content.organization || ''} +TITLE:${content.title || ''} +EMAIL:${content.email || ''} +TEL:${content.phone || ''} +END:VCARD`; + case 'GEO': + const lat = content.latitude || 0; + const lon = content.longitude || 0; + const label = content.label ? `?q=${encodeURIComponent(content.label)}` : ''; + return `geo:${lat},${lon}${label}`; + case 'TEXT': + return content.text || ''; + default: + return content.url || ''; + } +} + +export async function trackScan(qrId: string, request: Request) { + const headers = request.headers; + const ip = headers.get('x-forwarded-for') || headers.get('x-real-ip') || '127.0.0.1'; + const userAgent = headers.get('user-agent'); + const referrer = headers.get('referer'); + const dnt = headers.get('dnt'); + + // Respect Do Not Track + if (dnt === '1') { + // Only increment aggregate counter, skip detailed tracking + return; + } + + const ipHash = hashIP(ip); + const country = getCountryFromHeaders(headers); + const { device, os } = parseUserAgent(userAgent); + + // Parse UTM parameters from referrer + let utmSource: string | null = null; + let utmMedium: string | null = null; + let utmCampaign: string | null = null; + + if (referrer) { + try { + const url = new URL(referrer); + utmSource = url.searchParams.get('utm_source'); + utmMedium = url.searchParams.get('utm_medium'); + utmCampaign = url.searchParams.get('utm_campaign'); + } catch (e) { + // Invalid referrer URL + } + } + + // Check if this is a unique scan (same IP hash within 24 hours) + const dayAgo = new Date(Date.now() - 24 * 60 * 60 * 1000); + const existingScan = await db.qRScan.findFirst({ + where: { + qrId, + ipHash, + ts: { gte: dayAgo }, + }, + }); + + const isUnique = !existingScan; + + const scanData = { + qrId, + ipHash, + userAgent, + device, + os, + country, + referrer, + utmSource, + utmMedium, + utmCampaign, + isUnique, + }; + + // Fire-and-forget tracking + if (redis) { + // Queue to Redis for background processing + redis.lpush('qr_scans', JSON.stringify(scanData)).catch(console.error); + } else { + // Direct database write + db.qRScan.create({ data: scanData }).catch(console.error); + } } \ No newline at end of file diff --git a/src/lib/rateLimit.ts b/src/lib/rateLimit.ts index f4cf0b5..91fc582 100644 --- a/src/lib/rateLimit.ts +++ b/src/lib/rateLimit.ts @@ -1,229 +1,229 @@ -/** - * Simple in-memory rate limiter - * For production with multiple servers, consider using Redis/Upstash - */ - -interface RateLimitEntry { - count: number; - resetAt: number; -} - -// Store rate limit data in memory -const rateLimitStore = new Map(); - -// Cleanup old entries every 5 minutes -setInterval(() => { - const now = Date.now(); - const entries = Array.from(rateLimitStore.entries()); - for (const [key, entry] of entries) { - if (entry.resetAt < now) { - rateLimitStore.delete(key); - } - } -}, 5 * 60 * 1000); - -export interface RateLimitConfig { - /** - * Maximum number of requests allowed in the window - */ - maxRequests: number; - - /** - * Time window in seconds - */ - windowSeconds: number; - - /** - * Unique identifier for this rate limiter (e.g., 'login', 'signup') - */ - name: string; -} - -export interface RateLimitResult { - success: boolean; - limit: number; - remaining: number; - reset: number; -} - -/** - * Check if a request should be rate limited - * - * @param identifier - Unique identifier for the client (e.g., IP address, email) - * @param config - Rate limit configuration - * @returns RateLimitResult - */ -export function rateLimit( - identifier: string, - config: RateLimitConfig -): RateLimitResult { - const key = `${config.name}:${identifier}`; - const now = Date.now(); - const windowMs = config.windowSeconds * 1000; - - let entry = rateLimitStore.get(key); - - // Create new entry if doesn't exist or expired - if (!entry || entry.resetAt < now) { - entry = { - count: 0, - resetAt: now + windowMs, - }; - rateLimitStore.set(key, entry); - } - - // Increment counter - entry.count++; - - const remaining = Math.max(0, config.maxRequests - entry.count); - const success = entry.count <= config.maxRequests; - - return { - success, - limit: config.maxRequests, - remaining, - reset: entry.resetAt, - }; -} - -/** - * Get client identifier from request (IP address) - */ -export function getClientIdentifier(request: Request): string { - // Try to get real IP from headers (for proxies/load balancers) - const forwardedFor = request.headers.get('x-forwarded-for'); - if (forwardedFor) { - return forwardedFor.split(',')[0].trim(); - } - - const realIp = request.headers.get('x-real-ip'); - if (realIp) { - return realIp; - } - - // Fallback (this won't work well in production behind a proxy) - return 'unknown'; -} - -/** - * Predefined rate limit configurations - */ -export const RateLimits = { - // Auth endpoints - // Login: 5 attempts per 15 minutes - LOGIN: { - name: 'login', - maxRequests: 5, - windowSeconds: 15 * 60, - }, - - // Signup: 3 accounts per hour - SIGNUP: { - name: 'signup', - maxRequests: 3, - windowSeconds: 60 * 60, - }, - - // Password reset: 3 attempts per hour - PASSWORD_RESET: { - name: 'password-reset', - maxRequests: 3, - windowSeconds: 60 * 60, - }, - - // QR Code endpoints - // Create QR: 20 per minute - QR_CREATE: { - name: 'qr-create', - maxRequests: 20, - windowSeconds: 60, - }, - - // Modify QR: 30 per minute - QR_MODIFY: { - name: 'qr-modify', - maxRequests: 30, - windowSeconds: 60, - }, - - // Delete all QRs: 3 per hour - QR_DELETE_ALL: { - name: 'qr-delete-all', - maxRequests: 3, - windowSeconds: 60 * 60, - }, - - // Bulk create: 3 per hour - BULK_CREATE: { - name: 'bulk-create', - maxRequests: 3, - windowSeconds: 60 * 60, - }, - - // User settings endpoints - // Profile update: 10 per minute - PROFILE_UPDATE: { - name: 'profile-update', - maxRequests: 10, - windowSeconds: 60, - }, - - // Password change: 5 per hour - PASSWORD_CHANGE: { - name: 'password-change', - maxRequests: 5, - windowSeconds: 60 * 60, - }, - - // Account delete: 2 per day - ACCOUNT_DELETE: { - name: 'account-delete', - maxRequests: 2, - windowSeconds: 24 * 60 * 60, - }, - - // Analytics endpoints - // Analytics summary: 30 per minute - ANALYTICS: { - name: 'analytics', - maxRequests: 30, - windowSeconds: 60, - }, - - // Stripe endpoints - // Checkout session: 5 per minute - STRIPE_CHECKOUT: { - name: 'stripe-checkout', - maxRequests: 5, - windowSeconds: 60, - }, - - // Customer portal: 10 per minute - STRIPE_PORTAL: { - name: 'stripe-portal', - maxRequests: 10, - windowSeconds: 60, - }, - - // Cancel subscription: 3 per hour - STRIPE_CANCEL: { - name: 'stripe-cancel', - maxRequests: 3, - windowSeconds: 60 * 60, - }, - - // Newsletter endpoints - // Newsletter subscribe: 5 per hour (prevent spam) - NEWSLETTER_SUBSCRIBE: { - name: 'newsletter-subscribe', - maxRequests: 5, - windowSeconds: 60 * 60, - }, - - // General API: 100 requests per minute - API: { - name: 'api', - maxRequests: 100, - windowSeconds: 60, - }, -}; +/** + * Simple in-memory rate limiter + * For production with multiple servers, consider using Redis/Upstash + */ + +interface RateLimitEntry { + count: number; + resetAt: number; +} + +// Store rate limit data in memory +const rateLimitStore = new Map(); + +// Cleanup old entries every 5 minutes +setInterval(() => { + const now = Date.now(); + const entries = Array.from(rateLimitStore.entries()); + for (const [key, entry] of entries) { + if (entry.resetAt < now) { + rateLimitStore.delete(key); + } + } +}, 5 * 60 * 1000); + +export interface RateLimitConfig { + /** + * Maximum number of requests allowed in the window + */ + maxRequests: number; + + /** + * Time window in seconds + */ + windowSeconds: number; + + /** + * Unique identifier for this rate limiter (e.g., 'login', 'signup') + */ + name: string; +} + +export interface RateLimitResult { + success: boolean; + limit: number; + remaining: number; + reset: number; +} + +/** + * Check if a request should be rate limited + * + * @param identifier - Unique identifier for the client (e.g., IP address, email) + * @param config - Rate limit configuration + * @returns RateLimitResult + */ +export function rateLimit( + identifier: string, + config: RateLimitConfig +): RateLimitResult { + const key = `${config.name}:${identifier}`; + const now = Date.now(); + const windowMs = config.windowSeconds * 1000; + + let entry = rateLimitStore.get(key); + + // Create new entry if doesn't exist or expired + if (!entry || entry.resetAt < now) { + entry = { + count: 0, + resetAt: now + windowMs, + }; + rateLimitStore.set(key, entry); + } + + // Increment counter + entry.count++; + + const remaining = Math.max(0, config.maxRequests - entry.count); + const success = entry.count <= config.maxRequests; + + return { + success, + limit: config.maxRequests, + remaining, + reset: entry.resetAt, + }; +} + +/** + * Get client identifier from request (IP address) + */ +export function getClientIdentifier(request: Request): string { + // Try to get real IP from headers (for proxies/load balancers) + const forwardedFor = request.headers.get('x-forwarded-for'); + if (forwardedFor) { + return forwardedFor.split(',')[0].trim(); + } + + const realIp = request.headers.get('x-real-ip'); + if (realIp) { + return realIp; + } + + // Fallback (this won't work well in production behind a proxy) + return 'unknown'; +} + +/** + * Predefined rate limit configurations + */ +export const RateLimits = { + // Auth endpoints + // Login: 5 attempts per 15 minutes + LOGIN: { + name: 'login', + maxRequests: 5, + windowSeconds: 15 * 60, + }, + + // Signup: 3 accounts per hour + SIGNUP: { + name: 'signup', + maxRequests: 3, + windowSeconds: 60 * 60, + }, + + // Password reset: 3 attempts per hour + PASSWORD_RESET: { + name: 'password-reset', + maxRequests: 3, + windowSeconds: 60 * 60, + }, + + // QR Code endpoints + // Create QR: 20 per minute + QR_CREATE: { + name: 'qr-create', + maxRequests: 20, + windowSeconds: 60, + }, + + // Modify QR: 30 per minute + QR_MODIFY: { + name: 'qr-modify', + maxRequests: 30, + windowSeconds: 60, + }, + + // Delete all QRs: 3 per hour + QR_DELETE_ALL: { + name: 'qr-delete-all', + maxRequests: 3, + windowSeconds: 60 * 60, + }, + + // Bulk create: 3 per hour + BULK_CREATE: { + name: 'bulk-create', + maxRequests: 3, + windowSeconds: 60 * 60, + }, + + // User settings endpoints + // Profile update: 10 per minute + PROFILE_UPDATE: { + name: 'profile-update', + maxRequests: 10, + windowSeconds: 60, + }, + + // Password change: 5 per hour + PASSWORD_CHANGE: { + name: 'password-change', + maxRequests: 5, + windowSeconds: 60 * 60, + }, + + // Account delete: 2 per day + ACCOUNT_DELETE: { + name: 'account-delete', + maxRequests: 2, + windowSeconds: 24 * 60 * 60, + }, + + // Analytics endpoints + // Analytics summary: 30 per minute + ANALYTICS: { + name: 'analytics', + maxRequests: 30, + windowSeconds: 60, + }, + + // Stripe endpoints + // Checkout session: 5 per minute + STRIPE_CHECKOUT: { + name: 'stripe-checkout', + maxRequests: 5, + windowSeconds: 60, + }, + + // Customer portal: 10 per minute + STRIPE_PORTAL: { + name: 'stripe-portal', + maxRequests: 10, + windowSeconds: 60, + }, + + // Cancel subscription: 3 per hour + STRIPE_CANCEL: { + name: 'stripe-cancel', + maxRequests: 3, + windowSeconds: 60 * 60, + }, + + // Newsletter endpoints + // Newsletter subscribe: 5 per hour (prevent spam) + NEWSLETTER_SUBSCRIBE: { + name: 'newsletter-subscribe', + maxRequests: 5, + windowSeconds: 60 * 60, + }, + + // General API: 100 requests per minute + API: { + name: 'api', + maxRequests: 100, + windowSeconds: 60, + }, +}; diff --git a/src/lib/stripe.ts b/src/lib/stripe.ts index 8a7a890..278253f 100644 --- a/src/lib/stripe.ts +++ b/src/lib/stripe.ts @@ -1,80 +1,80 @@ -import Stripe from 'stripe'; - -// Use a placeholder during build time, real key at runtime -const stripeKey = process.env.STRIPE_SECRET_KEY || 'sk_test_placeholder_for_build'; - -export const stripe = new Stripe(stripeKey, { - apiVersion: '2025-10-29.clover', - typescript: true, -}); - -// Runtime validation (will throw when actually used in production if not set) -export function validateStripeKey() { - if (!process.env.STRIPE_SECRET_KEY) { - throw new Error('STRIPE_SECRET_KEY is not set'); - } -} - -export const STRIPE_PLANS = { - FREE: { - name: 'Free / Starter', - price: 0, - currency: 'EUR', - interval: 'month', - features: [ - '3 dynamische QR-Codes', - 'Basis-Tracking (Scans + Standort)', - 'Einfache Designs', - 'Unbegrenzte statische QR-Codes', - ], - limits: { - dynamicQRCodes: 3, - staticQRCodes: -1, // unlimited - teamMembers: 1, - }, - priceId: null, // No Stripe price for free plan - }, - PRO: { - name: 'Pro', - price: 9, - priceYearly: 90, - currency: 'EUR', - interval: 'month', - features: [ - '50 QR Codes', - 'Branding (Colors)', - 'Detailed Analytics (Date, Device, City)', - 'CSV Export', - 'SVG/PNG Download', - ], - limits: { - dynamicQRCodes: 50, - staticQRCodes: -1, - teamMembers: 1, - }, - priceId: process.env.STRIPE_PRICE_ID_PRO_MONTHLY, - priceIdYearly: process.env.STRIPE_PRICE_ID_PRO_YEARLY, - }, - BUSINESS: { - name: 'Business', - price: 29, - priceYearly: 290, - currency: 'EUR', - interval: 'month', - features: [ - '500 QR-Codes', - 'Everything from Pro', - 'Bulk QR Generation (up to 1,000)', - 'Priority Support', - ], - limits: { - dynamicQRCodes: 500, - staticQRCodes: -1, - teamMembers: 1, - }, - priceId: process.env.STRIPE_PRICE_ID_BUSINESS_MONTHLY, - priceIdYearly: process.env.STRIPE_PRICE_ID_BUSINESS_YEARLY, - }, -} as const; - -export type PlanType = keyof typeof STRIPE_PLANS; +import Stripe from 'stripe'; + +// Use a placeholder during build time, real key at runtime +const stripeKey = process.env.STRIPE_SECRET_KEY || 'sk_test_placeholder_for_build'; + +export const stripe = new Stripe(stripeKey, { + apiVersion: '2025-10-29.clover', + typescript: true, +}); + +// Runtime validation (will throw when actually used in production if not set) +export function validateStripeKey() { + if (!process.env.STRIPE_SECRET_KEY) { + throw new Error('STRIPE_SECRET_KEY is not set'); + } +} + +export const STRIPE_PLANS = { + FREE: { + name: 'Free / Starter', + price: 0, + currency: 'EUR', + interval: 'month', + features: [ + '3 dynamische QR-Codes', + 'Basis-Tracking (Scans + Standort)', + 'Einfache Designs', + 'Unbegrenzte statische QR-Codes', + ], + limits: { + dynamicQRCodes: 3, + staticQRCodes: -1, // unlimited + teamMembers: 1, + }, + priceId: null, // No Stripe price for free plan + }, + PRO: { + name: 'Pro', + price: 9, + priceYearly: 90, + currency: 'EUR', + interval: 'month', + features: [ + '50 QR Codes', + 'Branding (Colors)', + 'Detailed Analytics (Date, Device, City)', + 'CSV Export', + 'SVG/PNG Download', + ], + limits: { + dynamicQRCodes: 50, + staticQRCodes: -1, + teamMembers: 1, + }, + priceId: process.env.STRIPE_PRICE_ID_PRO_MONTHLY, + priceIdYearly: process.env.STRIPE_PRICE_ID_PRO_YEARLY, + }, + BUSINESS: { + name: 'Business', + price: 29, + priceYearly: 290, + currency: 'EUR', + interval: 'month', + features: [ + '500 QR-Codes', + 'Everything from Pro', + 'Bulk QR Generation (up to 1,000)', + 'Priority Support', + ], + limits: { + dynamicQRCodes: 500, + staticQRCodes: -1, + teamMembers: 1, + }, + priceId: process.env.STRIPE_PRICE_ID_BUSINESS_MONTHLY, + priceIdYearly: process.env.STRIPE_PRICE_ID_BUSINESS_YEARLY, + }, +} as const; + +export type PlanType = keyof typeof STRIPE_PLANS; diff --git a/src/lib/testimonial-data.ts b/src/lib/testimonial-data.ts index 037f5f0..df57c81 100644 --- a/src/lib/testimonial-data.ts +++ b/src/lib/testimonial-data.ts @@ -1,58 +1,58 @@ -export type Testimonial = { - id: string; - rating: number; - title: string; - content: string; - author: { - name: string; - location?: string; - company?: string; - role?: string; - }; - date: string; - datePublished: string; - verified: boolean; - featured: boolean; - useCase?: string; -}; - -export type AggregateRating = { - ratingValue: number; - reviewCount: number; - bestRating: number; - worstRating: number; -}; - -export const testimonials: Testimonial[] = [ - { - id: "pottery-claudia-knuth-001", - rating: 5, - title: "Perfect for my pottery", - content: "I use QR-Master for my pottery as a link to my homepage and as a digital business card. I place the codes directly on my pottery pieces so interested customers can instantly access my website. Reliable and practical – a great solution!", - author: { - name: "Claudia", - company: "Hotshpotsh", - location: "Texas" - }, - date: "January 2026", - datePublished: "2026-01-15T00:00:00Z", - verified: true, - featured: true, - useCase: "pottery" - } -]; - -export function getAggregateRating(): AggregateRating { - const ratings = testimonials.map(t => t.rating); - const avgRating = ratings.reduce((a, b) => a + b, 0) / ratings.length; - return { - ratingValue: Number(avgRating.toFixed(1)), - reviewCount: testimonials.length, - bestRating: 5, - worstRating: 1 - }; -} - -export function getFeaturedTestimonials(): Testimonial[] { - return testimonials.filter(t => t.featured); -} +export type Testimonial = { + id: string; + rating: number; + title: string; + content: string; + author: { + name: string; + location?: string; + company?: string; + role?: string; + }; + date: string; + datePublished: string; + verified: boolean; + featured: boolean; + useCase?: string; +}; + +export type AggregateRating = { + ratingValue: number; + reviewCount: number; + bestRating: number; + worstRating: number; +}; + +export const testimonials: Testimonial[] = [ + { + id: "pottery-claudia-knuth-001", + rating: 5, + title: "Perfect for my pottery", + content: "I use QR-Master for my pottery as a link to my homepage and as a digital business card. I place the codes directly on my pottery pieces so interested customers can instantly access my website. Reliable and practical – a great solution!", + author: { + name: "Claudia", + company: "Hotshpotsh", + location: "Texas" + }, + date: "January 2026", + datePublished: "2026-01-15T00:00:00Z", + verified: true, + featured: true, + useCase: "pottery" + } +]; + +export function getAggregateRating(): AggregateRating { + const ratings = testimonials.map(t => t.rating); + const avgRating = ratings.reduce((a, b) => a + b, 0) / ratings.length; + return { + ratingValue: Number(avgRating.toFixed(1)), + reviewCount: testimonials.length, + bestRating: 5, + worstRating: 1 + }; +} + +export function getFeaturedTestimonials(): Testimonial[] { + return testimonials.filter(t => t.featured); +} diff --git a/src/styles/globals.css b/src/styles/globals.css index 20ff7b3..e6a86fc 100644 --- a/src/styles/globals.css +++ b/src/styles/globals.css @@ -1,200 +1,200 @@ -@tailwind base; -@tailwind components; -@tailwind utilities; - -@layer utilities { - - /* Floating blob animation for hero background */ - @keyframes blob { - - 0%, - 100% { - transform: translate(0, 0) scale(1); - } - - 25% { - transform: translate(20px, -30px) scale(1.1); - } - - 50% { - transform: translate(-20px, 20px) scale(0.9); - } - - 75% { - transform: translate(30px, 10px) scale(1.05); - } - } - - .animate-blob { - animation: blob 20s ease-in-out infinite; - } - - .animation-delay-2000 { - animation-delay: 2s; - } - - .animation-delay-4000 { - animation-delay: 4s; - } - - .animation-delay-6000 { - animation-delay: 6s; - } -} - -:root { - --foreground-rgb: 0, 0, 0; - --background-start-rgb: 255, 255, 255; - --background-end-rgb: 255, 255, 255; - color-scheme: light; -} - -* { - box-sizing: border-box; - padding: 0; - margin: 0; -} - -html, -body { - max-width: 100vw; - overflow-x: hidden; - font-family: 'Inter', system-ui, -apple-system, sans-serif; - scroll-behavior: smooth; -} - -body { - color: rgb(var(--foreground-rgb)); - background: linear-gradient(to bottom, - transparent, - rgb(var(--background-end-rgb))) rgb(var(--background-start-rgb)); -} - -a { - color: inherit; - text-decoration: none; -} - -/* Custom scrollbar */ -::-webkit-scrollbar { - width: 6px; -} - -::-webkit-scrollbar-track { - background: #f1f1f1; -} - -::-webkit-scrollbar-thumb { - background: #c1c1c1; - border-radius: 3px; -} - -::-webkit-scrollbar-thumb:hover { - background: #a8a8a8; -} - -/* Focus styles for accessibility */ -.focus-ring { - @apply focus:outline-none focus:ring-2 focus:ring-primary-500 focus:ring-offset-2; -} - -/* Card styles */ -.card { - @apply bg-white rounded-xl shadow-sm border border-gray-200 p-6; -} - -.card-hover { - @apply transition-all duration-200 hover:shadow-md hover:border-gray-300; -} - -/* Button styles */ -.btn-primary { - @apply bg-primary-600 text-white px-4 py-2 rounded-lg font-medium hover:bg-primary-700 focus-ring transition-colors; -} - -.btn-secondary { - @apply bg-gray-100 text-gray-900 px-4 py-2 rounded-lg font-medium hover:bg-gray-200 focus-ring transition-colors; -} - -.btn-outline { - @apply border border-gray-300 text-gray-700 px-4 py-2 rounded-lg font-medium hover:bg-gray-50 focus-ring transition-colors; -} - -/* Input styles */ -.input { - @apply w-full px-3 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-primary-500 focus:border-transparent; -} - -/* Badge styles */ -.badge { - @apply inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium; -} - -.badge-success { - @apply bg-success-100 text-success-800; -} - -.badge-warning { - @apply bg-warning-100 text-warning-800; -} - -.badge-info { - @apply bg-info-100 text-info-800; -} - -.badge-gray { - @apply bg-gray-100 text-gray-800; -} - -/* Loading spinner */ -.spinner { - @apply animate-spin rounded-full border-2 border-gray-300 border-t-primary-600; -} - -/* Skeleton loading */ -.skeleton { - @apply animate-pulse bg-gray-200 rounded; -} - -/* Gradient backgrounds */ -.gradient-primary { - background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); -} - -.gradient-success { - background: linear-gradient(135deg, #84fab0 0%, #8fd3f4 100%); -} - -/* Chart container */ -.chart-container { - position: relative; - height: 300px; - width: 100%; -} - -/* Blog post spacing overrides */ -.prose h2 { - margin-top: 1.75rem !important; - margin-bottom: 0.875rem !important; - padding-top: 0.875rem !important; - font-size: 2.25rem !important; - line-height: 2.5rem !important; -} - -.prose p { - margin-bottom: 0.875rem !important; -} - -.prose ul { - margin-top: 0.875rem !important; - margin-bottom: 0.875rem !important; -} - -.prose blockquote { - margin-top: 1.25rem !important; - margin-bottom: 1.25rem !important; -} - -.prose .lead { - margin-bottom: 1.25rem !important; +@tailwind base; +@tailwind components; +@tailwind utilities; + +@layer utilities { + + /* Floating blob animation for hero background */ + @keyframes blob { + + 0%, + 100% { + transform: translate(0, 0) scale(1); + } + + 25% { + transform: translate(20px, -30px) scale(1.1); + } + + 50% { + transform: translate(-20px, 20px) scale(0.9); + } + + 75% { + transform: translate(30px, 10px) scale(1.05); + } + } + + .animate-blob { + animation: blob 20s ease-in-out infinite; + } + + .animation-delay-2000 { + animation-delay: 2s; + } + + .animation-delay-4000 { + animation-delay: 4s; + } + + .animation-delay-6000 { + animation-delay: 6s; + } +} + +:root { + --foreground-rgb: 0, 0, 0; + --background-start-rgb: 255, 255, 255; + --background-end-rgb: 255, 255, 255; + color-scheme: light; +} + +* { + box-sizing: border-box; + padding: 0; + margin: 0; +} + +html, +body { + max-width: 100vw; + overflow-x: hidden; + font-family: 'Inter', system-ui, -apple-system, sans-serif; + scroll-behavior: smooth; +} + +body { + color: rgb(var(--foreground-rgb)); + background: linear-gradient(to bottom, + transparent, + rgb(var(--background-end-rgb))) rgb(var(--background-start-rgb)); +} + +a { + color: inherit; + text-decoration: none; +} + +/* Custom scrollbar */ +::-webkit-scrollbar { + width: 6px; +} + +::-webkit-scrollbar-track { + background: #f1f1f1; +} + +::-webkit-scrollbar-thumb { + background: #c1c1c1; + border-radius: 3px; +} + +::-webkit-scrollbar-thumb:hover { + background: #a8a8a8; +} + +/* Focus styles for accessibility */ +.focus-ring { + @apply focus:outline-none focus:ring-2 focus:ring-primary-500 focus:ring-offset-2; +} + +/* Card styles */ +.card { + @apply bg-white rounded-xl shadow-sm border border-gray-200 p-6; +} + +.card-hover { + @apply transition-all duration-200 hover:shadow-md hover:border-gray-300; +} + +/* Button styles */ +.btn-primary { + @apply bg-primary-600 text-white px-4 py-2 rounded-lg font-medium hover:bg-primary-700 focus-ring transition-colors; +} + +.btn-secondary { + @apply bg-gray-100 text-gray-900 px-4 py-2 rounded-lg font-medium hover:bg-gray-200 focus-ring transition-colors; +} + +.btn-outline { + @apply border border-gray-300 text-gray-700 px-4 py-2 rounded-lg font-medium hover:bg-gray-50 focus-ring transition-colors; +} + +/* Input styles */ +.input { + @apply w-full px-3 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-primary-500 focus:border-transparent; +} + +/* Badge styles */ +.badge { + @apply inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium; +} + +.badge-success { + @apply bg-success-100 text-success-800; +} + +.badge-warning { + @apply bg-warning-100 text-warning-800; +} + +.badge-info { + @apply bg-info-100 text-info-800; +} + +.badge-gray { + @apply bg-gray-100 text-gray-800; +} + +/* Loading spinner */ +.spinner { + @apply animate-spin rounded-full border-2 border-gray-300 border-t-primary-600; +} + +/* Skeleton loading */ +.skeleton { + @apply animate-pulse bg-gray-200 rounded; +} + +/* Gradient backgrounds */ +.gradient-primary { + background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); +} + +.gradient-success { + background: linear-gradient(135deg, #84fab0 0%, #8fd3f4 100%); +} + +/* Chart container */ +.chart-container { + position: relative; + height: 300px; + width: 100%; +} + +/* Blog post spacing overrides */ +.prose h2 { + margin-top: 1.75rem !important; + margin-bottom: 0.875rem !important; + padding-top: 0.875rem !important; + font-size: 2.25rem !important; + line-height: 2.5rem !important; +} + +.prose p { + margin-bottom: 0.875rem !important; +} + +.prose ul { + margin-top: 0.875rem !important; + margin-bottom: 0.875rem !important; +} + +.prose blockquote { + margin-top: 1.25rem !important; + margin-bottom: 1.25rem !important; +} + +.prose .lead { + margin-bottom: 1.25rem !important; } \ No newline at end of file diff --git a/src/types/analytics.ts b/src/types/analytics.ts index 1a7e8da..55aafa1 100644 --- a/src/types/analytics.ts +++ b/src/types/analytics.ts @@ -1,50 +1,50 @@ -export type TrendType = 'up' | 'down' | 'flat'; - -export interface TrendData { - trend: TrendType; - percentage: number; - isNegative?: boolean; - isNew?: boolean; // When growing from 0 previous data -} - -export interface AnalyticsSummary { - totalScans: number; - uniqueScans: number; - avgScansPerQR: number; - mobilePercentage: number; - topCountry: string; - topCountryPercentage: number; - scansTrend?: TrendData; - avgScansTrend?: TrendData; - comparisonPeriod: 'week' | 'month'; - comparisonDays: number; -} - -export interface CountryStats { - country: string; - count: number; - percentage: number; - trend: TrendType; - trendPercentage: number; - isNew?: boolean; -} - -export interface QRPerformance { - id: string; - title: string; - type: string; - totalScans: number; - uniqueScans: number; - conversion: number; - trend: TrendType; - trendPercentage: number; - isNew?: boolean; -} - -export interface AnalyticsResponse { - summary: AnalyticsSummary; - deviceStats: Record; - countryStats: CountryStats[]; - dailyScans: Record; - qrPerformance: QRPerformance[]; -} +export type TrendType = 'up' | 'down' | 'flat'; + +export interface TrendData { + trend: TrendType; + percentage: number; + isNegative?: boolean; + isNew?: boolean; // When growing from 0 previous data +} + +export interface AnalyticsSummary { + totalScans: number; + uniqueScans: number; + avgScansPerQR: number; + mobilePercentage: number; + topCountry: string; + topCountryPercentage: number; + scansTrend?: TrendData; + avgScansTrend?: TrendData; + comparisonPeriod: 'week' | 'month'; + comparisonDays: number; +} + +export interface CountryStats { + country: string; + count: number; + percentage: number; + trend: TrendType; + trendPercentage: number; + isNew?: boolean; +} + +export interface QRPerformance { + id: string; + title: string; + type: string; + totalScans: number; + uniqueScans: number; + conversion: number; + trend: TrendType; + trendPercentage: number; + isNew?: boolean; +} + +export interface AnalyticsResponse { + summary: AnalyticsSummary; + deviceStats: Record; + countryStats: CountryStats[]; + dailyScans: Record; + qrPerformance: QRPerformance[]; +} diff --git a/tailwind.config.js b/tailwind.config.js index f6a8cf8..ff6ca4f 100644 --- a/tailwind.config.js +++ b/tailwind.config.js @@ -1,69 +1,69 @@ -/** @type {import('tailwindcss').Config} */ -module.exports = { - content: [ - './src/pages/**/*.{js,ts,jsx,tsx,mdx}', - './src/components/**/*.{js,ts,jsx,tsx,mdx}', - './src/app/**/*.{js,ts,jsx,tsx,mdx}', - ], - theme: { - extend: { - colors: { - primary: { - 50: '#eff6ff', - 100: '#dbeafe', - 200: '#bfdbfe', - 300: '#93c5fd', - 400: '#60a5fa', - 500: '#3b82f6', - 600: '#2563eb', - 700: '#1d4ed8', - 800: '#1e40af', - 900: '#1e3a8a', - }, - success: { - 50: '#f0fdf4', - 100: '#dcfce7', - 200: '#bbf7d0', - 300: '#86efac', - 400: '#4ade80', - 500: '#22c55e', - 600: '#16a34a', - 700: '#15803d', - 800: '#166534', - 900: '#14532d', - }, - warning: { - 50: '#fff7ed', - 100: '#ffedd5', - 200: '#fed7aa', - 300: '#fdba74', - 400: '#fb923c', - 500: '#f97316', - 600: '#ea580c', - 700: '#c2410c', - 800: '#9a3412', - 900: '#7c2d12', - }, - info: { - 50: '#faf5ff', - 100: '#f3e8ff', - 200: '#e9d5ff', - 300: '#d8b4fe', - 400: '#c084fc', - 500: '#a855f7', - 600: '#8b5cf6', - 700: '#7c3aed', - 800: '#6b21a8', - 900: '#581c87', - } - }, - fontFamily: { - sans: ['Inter', 'system-ui', 'sans-serif'], - }, - borderRadius: { - 'xl': '14px', - } - }, - }, - plugins: [], +/** @type {import('tailwindcss').Config} */ +module.exports = { + content: [ + './src/pages/**/*.{js,ts,jsx,tsx,mdx}', + './src/components/**/*.{js,ts,jsx,tsx,mdx}', + './src/app/**/*.{js,ts,jsx,tsx,mdx}', + ], + theme: { + extend: { + colors: { + primary: { + 50: '#eff6ff', + 100: '#dbeafe', + 200: '#bfdbfe', + 300: '#93c5fd', + 400: '#60a5fa', + 500: '#3b82f6', + 600: '#2563eb', + 700: '#1d4ed8', + 800: '#1e40af', + 900: '#1e3a8a', + }, + success: { + 50: '#f0fdf4', + 100: '#dcfce7', + 200: '#bbf7d0', + 300: '#86efac', + 400: '#4ade80', + 500: '#22c55e', + 600: '#16a34a', + 700: '#15803d', + 800: '#166534', + 900: '#14532d', + }, + warning: { + 50: '#fff7ed', + 100: '#ffedd5', + 200: '#fed7aa', + 300: '#fdba74', + 400: '#fb923c', + 500: '#f97316', + 600: '#ea580c', + 700: '#c2410c', + 800: '#9a3412', + 900: '#7c2d12', + }, + info: { + 50: '#faf5ff', + 100: '#f3e8ff', + 200: '#e9d5ff', + 300: '#d8b4fe', + 400: '#c084fc', + 500: '#a855f7', + 600: '#8b5cf6', + 700: '#7c3aed', + 800: '#6b21a8', + 900: '#581c87', + } + }, + fontFamily: { + sans: ['Inter', 'system-ui', 'sans-serif'], + }, + borderRadius: { + 'xl': '14px', + } + }, + }, + plugins: [], } \ No newline at end of file diff --git a/tsconfig.json b/tsconfig.json index b1814a0..f97bfc2 100644 --- a/tsconfig.json +++ b/tsconfig.json @@ -1,28 +1,28 @@ -{ - "compilerOptions": { - "target": "es5", - "lib": ["dom", "dom.iterable", "es6"], - "allowJs": true, - "skipLibCheck": true, - "strict": true, - "noEmit": true, - "esModuleInterop": true, - "module": "esnext", - "moduleResolution": "bundler", - "resolveJsonModule": true, - "isolatedModules": true, - "jsx": "preserve", - "incremental": true, - "plugins": [ - { - "name": "next" - } - ], - "baseUrl": ".", - "paths": { - "@/*": ["./src/*"] - } - }, - "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"], - "exclude": ["node_modules"] +{ + "compilerOptions": { + "target": "es5", + "lib": ["dom", "dom.iterable", "es6"], + "allowJs": true, + "skipLibCheck": true, + "strict": true, + "noEmit": true, + "esModuleInterop": true, + "module": "esnext", + "moduleResolution": "bundler", + "resolveJsonModule": true, + "isolatedModules": true, + "jsx": "preserve", + "incremental": true, + "plugins": [ + { + "name": "next" + } + ], + "baseUrl": ".", + "paths": { + "@/*": ["./src/*"] + } + }, + "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"], + "exclude": ["node_modules"] } \ No newline at end of file diff --git a/twitter-x-30-day-content-plan.md b/twitter-x-30-day-content-plan.md index 2930249..a3a2ef9 100644 --- a/twitter-x-30-day-content-plan.md +++ b/twitter-x-30-day-content-plan.md @@ -1,272 +1,272 @@ -# 30-Day X/Twitter Content Plan for QR Master - -Use this as a `30-day X/Twitter content plan` for a founder-led QR Master account. It is written in English and optimized for reach first, with product relevance built in. - -## Positioning for the Month - -`Dynamic QR codes for measurable offline marketing, without creepy tracking.` - -## Audience Focus - -Primary audience for Days 1-15: -`Restaurants / hospitality` - -Secondary audience for Days 16-30: -`Agencies / offline marketers / retail operators` - -## CTA Rule for the Whole Month - -- Most posts: `Reply with a keyword`, `follow for more`, or `DM me` -- Only light link usage -- Put direct product CTA mainly in replies, profile, and pinned post - -## 30-Day Plan - -### Day 1 - -**Post type:** Founder positioning post -**Hook:** `Most QR codes are dead the moment they get printed.` -**Angle:** Static QR codes create reprint costs and broken customer journeys. -**CTA:** `If you run offline marketing, follow this account. I’m breaking down how to fix it.` - -### Day 2 - -**Post type:** Short insight post -**Hook:** `A restaurant menu should not require a reprint every time one dish changes.` -**Angle:** Dynamic QR codes for menus and specials. -**CTA:** `Reply “menu” if you want me to post the exact setup.` - -### Day 3 - -**Post type:** Teardown -**Hook:** `3 mistakes I see on restaurant QR menus all the time:` -**Angle:** Bad placement, no fallback page, no analytics. -**CTA:** `Want me to roast your menu QR? Reply with a screenshot.` - -### Day 4 - -**Post type:** Thread -**Hook:** `How restaurants can update menus without reprinting tables, flyers, or window signs:` -**Angle:** 5-step workflow using one dynamic QR. -**CTA:** `I can turn this into a checklist if people want it.` - -### Day 5 - -**Post type:** Contrarian post -**Hook:** `Unpopular opinion: “free QR code generators” are expensive.` -**Angle:** Hidden cost is reprints, lost scans, no attribution. -**CTA:** `Agree or disagree?` - -### Day 6 - -**Post type:** Demo video -**Hook:** `Change the destination after print. That’s the whole game.` -**Angle:** Quick screen recording showing edit-after-print. -**CTA:** `DM me “edit” and I’ll send the workflow.` - -### Day 7 - -**Post type:** Founder story -**Hook:** `We started building QR Master because most QR tools felt like toys.` -**Angle:** Needed analytics, bulk creation, privacy-first tracking. -**CTA:** `What’s one thing you hate about current QR tools?` - -### Day 8 - -**Post type:** Pain-to-fix post -**Hook:** `If your flyer has a QR code but no tracking, you’re guessing.` -**Angle:** Offline campaigns need measurable scans. -**CTA:** `Reply “track” if you want a simple attribution template.` - -### Day 9 - -**Post type:** Restaurant-specific post -**Hook:** `Today’s special changes. Your printed QR shouldn’t.` -**Angle:** Daily menu operations. -**CTA:** `Restaurant owners: how often do you update menus?` - -### Day 10 - -**Post type:** Roast / audit -**Hook:** `This QR code placement is killing conversions.` -**Angle:** Explain why low-visibility placements fail. -**CTA:** `Send me your flyer/menu/poster and I’ll break it down.` - -### Day 11 - -**Post type:** Thread -**Hook:** `5 QR code mistakes that make restaurant marketing look cheap:` -**Angle:** Visual clutter, dead links, bad landing pages, no tracking, wrong CTA. -**CTA:** `I’ll post 5 fixes tomorrow if this gets traction.` - -### Day 12 - -**Post type:** Build in public -**Hook:** `One thing founders underestimate: people don’t want “a QR code.” They want a workflow.` -**Angle:** Product insight from building. -**CTA:** `What simple tool became critical in your business?` - -### Day 13 - -**Post type:** Short proof post -**Hook:** `One QR code. Multiple seasonal campaigns. Zero reprints.` -**Angle:** Reuse same printed asset with changing destination. -**CTA:** `This is one of the biggest underrated offline growth hacks.` - -### Day 14 - -**Post type:** Demo video -**Hook:** `From printed table card to measurable scan funnel in under 30 seconds:` -**Angle:** Show QR creation + analytics preview. -**CTA:** `If you want more product breakdowns, follow.` - -### Day 15 - -**Post type:** Summary / recap -**Hook:** `The biggest restaurant QR lesson so far:` -**Angle:** Most businesses don’t need more print, they need more flexibility. -**CTA:** `Next week I’m switching to agencies and offline marketers.` - -### Day 16 - -**Post type:** Agency-focused post -**Hook:** `If your agency runs flyer or poster campaigns without QR attribution, you’re underreporting impact.` -**Angle:** Agencies need scan data to prove ROI. -**CTA:** `Reply “agency” if you want my offline attribution framework.` - -### Day 17 - -**Post type:** Contrarian post -**Hook:** `The problem is not the QR code. The problem is the dead destination behind it.` -**Angle:** Static link is the failure point. -**CTA:** `This is where most campaigns quietly lose money.` - -### Day 18 - -**Post type:** Thread -**Hook:** `How to make offline campaigns actually measurable:` -**Angle:** QR + UTM + landing page + analytics naming structure. -**CTA:** `I can turn this into a swipe file.` - -### Day 19 - -**Post type:** Audit post -**Hook:** `3 reasons most poster QR campaigns don’t convert:` -**Angle:** Weak CTA, poor mobile page, no tracking structure. -**CTA:** `Want a poster teardown series?` - -### Day 20 - -**Post type:** Demo video -**Hook:** `Bulk-create hundreds of QR codes from a spreadsheet.` -**Angle:** Show CSV/Excel workflow for agencies or retail. -**CTA:** `DM me “bulk” if that would save your team time.` - -### Day 21 - -**Post type:** Founder hot take -**Hook:** `“Just put a QR code on it” is bad marketing advice.` -**Angle:** QR is distribution, not strategy. -**CTA:** `What matters more: placement, offer, or landing page?` - -### Day 22 - -**Post type:** Mini case format -**Hook:** `Campaign idea: one printed asset, three different destinations over 30 days.` -**Angle:** Explain how one QR can support multiple campaign phases. -**CTA:** `This is why dynamic matters more than design.` - -### Day 23 - -**Post type:** Thread -**Hook:** `How I’d structure QR tracking for an agency campaign with flyers, packaging, and in-store signage:` -**Angle:** Naming conventions, attribution logic, reporting. -**CTA:** `If useful, I’ll post the naming template.` - -### Day 24 - -**Post type:** Privacy wedge post -**Hook:** `You can measure scans without turning people into surveillance data.` -**Angle:** Privacy-first analytics as a business advantage. -**CTA:** `Too many teams think analytics has to mean creepy.` - -### Day 25 - -**Post type:** Teardown -**Hook:** `This flyer has a QR code. But it still won’t tell you what worked.` -**Angle:** Missing attribution structure. -**CTA:** `Reply with “audit” and I’ll post a fixed version.` - -### Day 26 - -**Post type:** Retail / packaging post -**Hook:** `Packaging QR codes get interesting when you can change the destination later.` -**Angle:** Product updates, campaigns, support pages, seasonal promos. -**CTA:** `Retail operators: are you using QR for support, promo, or repeat purchase?` - -### Day 27 - -**Post type:** Build in public -**Hook:** `One thing we keep seeing: people buy QR tools for “generation” and stay for “management.”` -**Angle:** Product-market insight. -**CTA:** `That distinction matters more than most founders think.` - -### Day 28 - -**Post type:** Demo video -**Hook:** `Here’s what “measurable offline workflow” actually looks like in practice:` -**Angle:** Create, edit, track, compare placements. -**CTA:** `If this kind of content is useful, I’ll make it a weekly series.` - -### Day 29 - -**Post type:** Hero thread -**Hook:** `Most offline marketing teams don’t have a traffic problem. They have a measurement problem.` -**Angle:** Big thesis thread connecting restaurants, agencies, retail, and dynamic QR logic. -**CTA:** `If you work in offline marketing, this is the framework.` - -### Day 30 - -**Post type:** Month-end recap + soft CTA -**Hook:** `30 days of talking to people about QR workflows taught me this:` -**Angle:** Summarize 5 strongest lessons from the month. -**CTA:** `If you want, next I’ll publish the full playbook: hooks, setup, and attribution templates.` - -## Weekly Cadence - -- `Mon`: strong opinion or positioning -- `Tue`: practical educational post -- `Wed`: teardown or audit -- `Thu`: thread -- `Fri`: product proof or demo -- `Sat`: founder insight / build in public -- `Sun`: recap or lighter conversation post - -## Content Mix - -- `8 threads` -- `6 teardown/audit posts` -- `5 demo videos` -- `6 short contrarian/value posts` -- `5 founder/build-in-public posts` - -## Reply Strategy - -Every day, add: - -- `10-15 replies` to founders, marketers, restaurant-tech, local business, retail ops, and agency accounts -- Focus on posts about: offline marketing, menus, customer journeys, attribution, retail campaigns, print, local growth -- Use replies to seed your core themes: - - reprint cost - - edit after print - - measurable offline - - privacy-first analytics - - bulk workflows - -## Optional Next Step - -If needed, this can be expanded into: - -1. fully written tweets for all 30 days -2. 8 full threads written out -3. a Notion-style content calendar with posting times and CTAs +# 30-Day X/Twitter Content Plan for QR Master + +Use this as a `30-day X/Twitter content plan` for a founder-led QR Master account. It is written in English and optimized for reach first, with product relevance built in. + +## Positioning for the Month + +`Dynamic QR codes for measurable offline marketing, without creepy tracking.` + +## Audience Focus + +Primary audience for Days 1-15: +`Restaurants / hospitality` + +Secondary audience for Days 16-30: +`Agencies / offline marketers / retail operators` + +## CTA Rule for the Whole Month + +- Most posts: `Reply with a keyword`, `follow for more`, or `DM me` +- Only light link usage +- Put direct product CTA mainly in replies, profile, and pinned post + +## 30-Day Plan + +### Day 1 + +**Post type:** Founder positioning post +**Hook:** `Most QR codes are dead the moment they get printed.` +**Angle:** Static QR codes create reprint costs and broken customer journeys. +**CTA:** `If you run offline marketing, follow this account. I’m breaking down how to fix it.` + +### Day 2 + +**Post type:** Short insight post +**Hook:** `A restaurant menu should not require a reprint every time one dish changes.` +**Angle:** Dynamic QR codes for menus and specials. +**CTA:** `Reply “menu” if you want me to post the exact setup.` + +### Day 3 + +**Post type:** Teardown +**Hook:** `3 mistakes I see on restaurant QR menus all the time:` +**Angle:** Bad placement, no fallback page, no analytics. +**CTA:** `Want me to roast your menu QR? Reply with a screenshot.` + +### Day 4 + +**Post type:** Thread +**Hook:** `How restaurants can update menus without reprinting tables, flyers, or window signs:` +**Angle:** 5-step workflow using one dynamic QR. +**CTA:** `I can turn this into a checklist if people want it.` + +### Day 5 + +**Post type:** Contrarian post +**Hook:** `Unpopular opinion: “free QR code generators” are expensive.` +**Angle:** Hidden cost is reprints, lost scans, no attribution. +**CTA:** `Agree or disagree?` + +### Day 6 + +**Post type:** Demo video +**Hook:** `Change the destination after print. That’s the whole game.` +**Angle:** Quick screen recording showing edit-after-print. +**CTA:** `DM me “edit” and I’ll send the workflow.` + +### Day 7 + +**Post type:** Founder story +**Hook:** `We started building QR Master because most QR tools felt like toys.` +**Angle:** Needed analytics, bulk creation, privacy-first tracking. +**CTA:** `What’s one thing you hate about current QR tools?` + +### Day 8 + +**Post type:** Pain-to-fix post +**Hook:** `If your flyer has a QR code but no tracking, you’re guessing.` +**Angle:** Offline campaigns need measurable scans. +**CTA:** `Reply “track” if you want a simple attribution template.` + +### Day 9 + +**Post type:** Restaurant-specific post +**Hook:** `Today’s special changes. Your printed QR shouldn’t.` +**Angle:** Daily menu operations. +**CTA:** `Restaurant owners: how often do you update menus?` + +### Day 10 + +**Post type:** Roast / audit +**Hook:** `This QR code placement is killing conversions.` +**Angle:** Explain why low-visibility placements fail. +**CTA:** `Send me your flyer/menu/poster and I’ll break it down.` + +### Day 11 + +**Post type:** Thread +**Hook:** `5 QR code mistakes that make restaurant marketing look cheap:` +**Angle:** Visual clutter, dead links, bad landing pages, no tracking, wrong CTA. +**CTA:** `I’ll post 5 fixes tomorrow if this gets traction.` + +### Day 12 + +**Post type:** Build in public +**Hook:** `One thing founders underestimate: people don’t want “a QR code.” They want a workflow.` +**Angle:** Product insight from building. +**CTA:** `What simple tool became critical in your business?` + +### Day 13 + +**Post type:** Short proof post +**Hook:** `One QR code. Multiple seasonal campaigns. Zero reprints.` +**Angle:** Reuse same printed asset with changing destination. +**CTA:** `This is one of the biggest underrated offline growth hacks.` + +### Day 14 + +**Post type:** Demo video +**Hook:** `From printed table card to measurable scan funnel in under 30 seconds:` +**Angle:** Show QR creation + analytics preview. +**CTA:** `If you want more product breakdowns, follow.` + +### Day 15 + +**Post type:** Summary / recap +**Hook:** `The biggest restaurant QR lesson so far:` +**Angle:** Most businesses don’t need more print, they need more flexibility. +**CTA:** `Next week I’m switching to agencies and offline marketers.` + +### Day 16 + +**Post type:** Agency-focused post +**Hook:** `If your agency runs flyer or poster campaigns without QR attribution, you’re underreporting impact.` +**Angle:** Agencies need scan data to prove ROI. +**CTA:** `Reply “agency” if you want my offline attribution framework.` + +### Day 17 + +**Post type:** Contrarian post +**Hook:** `The problem is not the QR code. The problem is the dead destination behind it.` +**Angle:** Static link is the failure point. +**CTA:** `This is where most campaigns quietly lose money.` + +### Day 18 + +**Post type:** Thread +**Hook:** `How to make offline campaigns actually measurable:` +**Angle:** QR + UTM + landing page + analytics naming structure. +**CTA:** `I can turn this into a swipe file.` + +### Day 19 + +**Post type:** Audit post +**Hook:** `3 reasons most poster QR campaigns don’t convert:` +**Angle:** Weak CTA, poor mobile page, no tracking structure. +**CTA:** `Want a poster teardown series?` + +### Day 20 + +**Post type:** Demo video +**Hook:** `Bulk-create hundreds of QR codes from a spreadsheet.` +**Angle:** Show CSV/Excel workflow for agencies or retail. +**CTA:** `DM me “bulk” if that would save your team time.` + +### Day 21 + +**Post type:** Founder hot take +**Hook:** `“Just put a QR code on it” is bad marketing advice.` +**Angle:** QR is distribution, not strategy. +**CTA:** `What matters more: placement, offer, or landing page?` + +### Day 22 + +**Post type:** Mini case format +**Hook:** `Campaign idea: one printed asset, three different destinations over 30 days.` +**Angle:** Explain how one QR can support multiple campaign phases. +**CTA:** `This is why dynamic matters more than design.` + +### Day 23 + +**Post type:** Thread +**Hook:** `How I’d structure QR tracking for an agency campaign with flyers, packaging, and in-store signage:` +**Angle:** Naming conventions, attribution logic, reporting. +**CTA:** `If useful, I’ll post the naming template.` + +### Day 24 + +**Post type:** Privacy wedge post +**Hook:** `You can measure scans without turning people into surveillance data.` +**Angle:** Privacy-first analytics as a business advantage. +**CTA:** `Too many teams think analytics has to mean creepy.` + +### Day 25 + +**Post type:** Teardown +**Hook:** `This flyer has a QR code. But it still won’t tell you what worked.` +**Angle:** Missing attribution structure. +**CTA:** `Reply with “audit” and I’ll post a fixed version.` + +### Day 26 + +**Post type:** Retail / packaging post +**Hook:** `Packaging QR codes get interesting when you can change the destination later.` +**Angle:** Product updates, campaigns, support pages, seasonal promos. +**CTA:** `Retail operators: are you using QR for support, promo, or repeat purchase?` + +### Day 27 + +**Post type:** Build in public +**Hook:** `One thing we keep seeing: people buy QR tools for “generation” and stay for “management.”` +**Angle:** Product-market insight. +**CTA:** `That distinction matters more than most founders think.` + +### Day 28 + +**Post type:** Demo video +**Hook:** `Here’s what “measurable offline workflow” actually looks like in practice:` +**Angle:** Create, edit, track, compare placements. +**CTA:** `If this kind of content is useful, I’ll make it a weekly series.` + +### Day 29 + +**Post type:** Hero thread +**Hook:** `Most offline marketing teams don’t have a traffic problem. They have a measurement problem.` +**Angle:** Big thesis thread connecting restaurants, agencies, retail, and dynamic QR logic. +**CTA:** `If you work in offline marketing, this is the framework.` + +### Day 30 + +**Post type:** Month-end recap + soft CTA +**Hook:** `30 days of talking to people about QR workflows taught me this:` +**Angle:** Summarize 5 strongest lessons from the month. +**CTA:** `If you want, next I’ll publish the full playbook: hooks, setup, and attribution templates.` + +## Weekly Cadence + +- `Mon`: strong opinion or positioning +- `Tue`: practical educational post +- `Wed`: teardown or audit +- `Thu`: thread +- `Fri`: product proof or demo +- `Sat`: founder insight / build in public +- `Sun`: recap or lighter conversation post + +## Content Mix + +- `8 threads` +- `6 teardown/audit posts` +- `5 demo videos` +- `6 short contrarian/value posts` +- `5 founder/build-in-public posts` + +## Reply Strategy + +Every day, add: + +- `10-15 replies` to founders, marketers, restaurant-tech, local business, retail ops, and agency accounts +- Focus on posts about: offline marketing, menus, customer journeys, attribution, retail campaigns, print, local growth +- Use replies to seed your core themes: + - reprint cost + - edit after print + - measurable offline + - privacy-first analytics + - bulk workflows + +## Optional Next Step + +If needed, this can be expanded into: + +1. fully written tweets for all 30 days +2. 8 full threads written out +3. a Notion-style content calendar with posting times and CTAs diff --git a/vercel.json b/vercel.json index 96f0aff..aa5cfdb 100644 --- a/vercel.json +++ b/vercel.json @@ -1,11 +1,11 @@ -{ - "buildCommand": "prisma generate && next build", - "outputDirectory": ".next", - "framework": "nextjs", - "installCommand": "npm install", - "build": { - "env": { - "NODE_OPTIONS": "--max-old-space-size=4096" - } - } +{ + "buildCommand": "prisma generate && next build", + "outputDirectory": ".next", + "framework": "nextjs", + "installCommand": "npm install", + "build": { + "env": { + "NODE_OPTIONS": "--max-old-space-size=4096" + } + } } \ No newline at end of file