QRcodly

QRcodly is a free, open-source QR code generator and management platform. Create, customize, and track QR codes for URLs, contact details, Wi-Fi credentials, and more.

Features

• Multiple QR code types — URL, vCard, Wi-Fi, Email, Calendar Event, Location, Plain Text
• Full customization — colors, sizes, backgrounds, and custom icon uploads
• Export formats — PNG, JPEG, SVG
• URL shortening & analytics — shorten links and track scans
• Templates — save and reuse QR code configurations
• Custom domains — use your own domain for short URLs (Cloudflare integration)
• Internationalization — 8 languages (EN, DE, ES, FR, IT, NL, PL, RU)
• Authentication — powered by Clerk
• Browser extension — generate QR codes from any page

Monorepo Structure

qrcodly/
├── apps/
│   ├── backend/            # Fastify REST API
│   ├── frontend/           # Next.js web application
│   └── browser-extension/  # Vite-based browser extension
├── packages/
│   ├── shared/             # Zod schemas, DTOs, and shared utilities
│   ├── eslint-config/      # Shared ESLint configuration
│   └── typescript-config/  # Shared TypeScript configuration
└── docker-compose.yaml     # Local development services

See per-app READMEs for architecture details: Backend · Frontend · Browser Extension · Shared Package

Tech Stack

Prerequisites

• Node.js >= 22.11
• pnpm >= 9.15
• Docker (for local development services)

Quick Start

# 1. Clone the repository
git clone https://github.com/FloB95/qrcodly.git
cd qrcodly

# 2. Install dependencies
pnpm install

# 3. Start local services (MySQL, Redis, MinIO, Umami)
docker-compose up -d

# 4. Set up environment variables
cp apps/backend/.env.example apps/backend/.env
cp apps/frontend/.env.example apps/frontend/.env
# Edit both .env files with your configuration (Clerk keys, etc.)

# 5. Start development servers
pnpm run start:dev
# Backend API → http://localhost:5001
# Frontend   → http://localhost:3000

Available Scripts

Local Services (Docker Compose)

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines and setup instructions.

License

This project is licensed under the MIT License.