English Français العربية

QRcodly

السجل الرسمي أخرى

Create, manage, and share QR codes and short URLs

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع QRcodly؟

  • 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http qrcodly 'https://mcp.qrcodly.de/mcp' --header 'Authorization: <Bearer token for API authentication (format: Bearer <your-api-key>)>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "qrcodly": {
            "type": "http",
            "url": "https://mcp.qrcodly.de/mcp",
            "headers": {
                "Authorization": "<Bearer token for API authentication (format: Bearer <your-api-key>)>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. QRcodly
  2. Features
  3. Monorepo Structure
  4. Tech Stack
  5. Prerequisites
  6. Quick Start
  7. Available Scripts
  8. Local Services (Docker Compose)
  9. Contributing
  10. License

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

LayerTechnologies
FrontendNext.js, React, TypeScript, Tailwind CSS, shadcn/ui, Zustand, TanStack Query, next-intl
BackendFastify, TypeScript, Drizzle ORM, tsyringe (DI), Zod, Nodemailer, Handlebars
DatabaseMySQL, Redis
StorageS3 / MinIO
AuthClerk
BillingStripe
AnalyticsUmami, PostHog
MonitoringAxiom, Sentry

Prerequisites

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

ScriptDescription
pnpm run start:devStart backend and frontend in development mode
pnpm run backend:devStart backend only (runs migrations first)
pnpm run frontend:devStart frontend only
pnpm run buildBuild all apps
pnpm run build:shared-packageBuild the shared package only
pnpm run lintLint all workspaces
pnpm run formatFormat all files with Prettier
pnpm run cleanClean build artifacts across all apps

Local Services (Docker Compose)

ServicePortDetails
MySQL3306Credentials: root / root, database: qrcodly
Redis6379—
MinIO (S3)9000 (API), 9001 (Console)Credentials: minio / testtest
phpMyAdmin8081—
Umami Analytics3001—

Contributing

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

License

This project is licensed under the MIT License.

الأسئلة الشائعة

ما هو QRcodly؟

Create, manage, and share QR codes and short URLs

كيف أثبّت QRcodly؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http qrcodly 'https://mcp.qrcodly.de/mcp' --header 'Authorization: <Bearer token for API authentication (format: Bearer <your-api-key>)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج QRcodly إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل QRcodly مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون QRcodly؟

ينشره FloB95. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.