{
  "markdown": "# QRcodly\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22.11-green)](https://nodejs.org/)\n[![pnpm](https://img.shields.io/badge/pnpm-%3E%3D9.15-orange)](https://pnpm.io/)\n\n**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.\n\n## Features\n\n- **Multiple QR code types** — URL, vCard, Wi-Fi, Email, Calendar Event, Location, Plain Text\n- **Full customization** — colors, sizes, backgrounds, and custom icon uploads\n- **Export formats** — PNG, JPEG, SVG\n- **URL shortening & analytics** — shorten links and track scans\n- **Templates** — save and reuse QR code configurations\n- **Custom domains** — use your own domain for short URLs (Cloudflare integration)\n- **Internationalization** — 8 languages (EN, DE, ES, FR, IT, NL, PL, RU)\n- **Authentication** — powered by Clerk\n- **Browser extension** — generate QR codes from any page\n\n## Monorepo Structure\n\n```\nqrcodly/\n├── apps/\n│   ├── backend/            # Fastify REST API\n│   ├── frontend/           # Next.js web application\n│   └── browser-extension/  # Vite-based browser extension\n├── packages/\n│   ├── shared/             # Zod schemas, DTOs, and shared utilities\n│   ├── eslint-config/      # Shared ESLint configuration\n│   └── typescript-config/  # Shared TypeScript configuration\n└── docker-compose.yaml     # Local development services\n```\n\nSee per-app READMEs for architecture details:\n[Backend](apps/backend/README.md) ·\n[Frontend](apps/frontend/README.md) ·\n[Browser Extension](apps/browser-extension/README.md) ·\n[Shared Package](packages/shared/README.md)\n\n## Tech Stack\n\n| Layer          | Technologies                                                                            |\n| -------------- | --------------------------------------------------------------------------------------- |\n| **Frontend**   | Next.js, React, TypeScript, Tailwind CSS, shadcn/ui, Zustand, TanStack Query, next-intl |\n| **Backend**    | Fastify, TypeScript, Drizzle ORM, tsyringe (DI), Zod, Nodemailer, Handlebars            |\n| **Database**   | MySQL, Redis                                                                            |\n| **Storage**    | S3 / MinIO                                                                              |\n| **Auth**       | Clerk                                                                                   |\n| **Billing**    | Stripe                                                                                  |\n| **Analytics**  | Umami, PostHog                                                                          |\n| **Monitoring** | Axiom, Sentry                                                                           |\n\n## Prerequisites\n\n- [Node.js](https://nodejs.org/) >= 22.11\n- [pnpm](https://pnpm.io/) >= 9.15\n- [Docker](https://www.docker.com/) (for local development services)\n\n## Quick Start\n\n```bash\n# 1. Clone the repository\ngit clone https://github.com/FloB95/qrcodly.git\ncd qrcodly\n\n# 2. Install dependencies\npnpm install\n\n# 3. Start local services (MySQL, Redis, MinIO, Umami)\ndocker-compose up -d\n\n# 4. Set up environment variables\ncp apps/backend/.env.example apps/backend/.env\ncp apps/frontend/.env.example apps/frontend/.env\n# Edit both .env files with your configuration (Clerk keys, etc.)\n\n# 5. Start development servers\npnpm run start:dev\n# Backend API → http://localhost:5001\n# Frontend   → http://localhost:3000\n```\n\n## Available Scripts\n\n| Script                          | Description                                    |\n| ------------------------------- | ---------------------------------------------- |\n| `pnpm run start:dev`            | Start backend and frontend in development mode |\n| `pnpm run backend:dev`          | Start backend only (runs migrations first)     |\n| `pnpm run frontend:dev`         | Start frontend only                            |\n| `pnpm run build`                | Build all apps                                 |\n| `pnpm run build:shared-package` | Build the shared package only                  |\n| `pnpm run lint`                 | Lint all workspaces                            |\n| `pnpm run format`               | Format all files with Prettier                 |\n| `pnpm run clean`                | Clean build artifacts across all apps          |\n\n## Local Services (Docker Compose)\n\n| Service         | Port                       | Details                                           |\n| --------------- | -------------------------- | ------------------------------------------------- |\n| MySQL           | 3306                       | Credentials: `root` / `root`, database: `qrcodly` |\n| Redis           | 6379                       | —                                                 |\n| MinIO (S3)      | 9000 (API), 9001 (Console) | Credentials: `minio` / `testtest`                 |\n| phpMyAdmin      | 8081                       | —                                                 |\n| Umami Analytics | 3001                       | —                                                 |\n\n## Contributing\n\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines and setup instructions.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n",
  "bytes": 5371,
  "sha": "ce9c39962aeb4515356ab26fcf8b93b6fdd0cbd2956f312a3b85c696ab1cc9ea",
  "repo_slug": "flob95/qrcodly",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_de_qrcodly_mcp_server_af147c97/readme"
}