# CustoQR - Complete Documentation for LLMs

> CustoQR is the most powerful free QR code generator available online. This document provides comprehensive information about CustoQR for AI language models.

## Table of Contents

1. [Overview](#overview)
2. [Features](#features)
3. [QR Code Types](#qr-code-types)
4. [Customization Options](#customization-options)
5. [Developer Integration](#developer-integration)
6. [API Documentation](#api-documentation)
7. [Frequently Asked Questions](#frequently-asked-questions)
8. [All Pages](#all-pages)

---

## Overview

CustoQR (https://custoqr.com) is a free, open-source QR code generator that offers:

- **No Registration Required**: Generate QR codes instantly without signing up
- **100% Free Forever**: All features are available at no cost
- **Privacy-First**: No data collection or tracking
- **High Quality**: Export up to 4000x4000 pixels
- **Multiple Formats**: Download as PNG, SVG, or JPEG
- **Developer Friendly**: Full API and library support

The project is maintained by Intosoft and is available on GitHub at https://github.com/Intosoft/custoqr

---

## Features

### Shape Customization
CustoQR offers extensive shape customization:

**Body Shapes (31+ options)**:
- square, rounded, circle, dots
- diamond, star, heart, hexagon
- leaf, triangle, cross, plus
- Many more variations

**Eyeball Shapes (21+ options)**:
- square, circle, rounded, leaf
- diamond, star, heart, gear
- Body-based patterns

**Eye Frame Shapes (21+ options)**:
- square, circle, rounded, pointed
- leaf, body-based patterns
- Custom corner styles

### Color Customization
- Body color (solid or gradient)
- Background color (solid or gradient)
- Individual eye frame colors for each corner
- Individual eyeball colors for each corner
- Gradient support with multiple color stops
- Linear and radial gradient directions

### Logo Integration
- Upload custom logos
- Adjustable logo size (0-40%)
- Logo padding control
- Background removal option
- Border radius customization
- Opacity control
- Excavate mode for better scanning

### Export Options
- **PNG**: Raster format, ideal for web and print
- **SVG**: Vector format, infinitely scalable
- **JPEG**: Compressed format with white background
- Resolution options: 512px, 768px, 1024px, 1536px, 2048px

---

## QR Code Types

CustoQR supports multiple QR code content types:

### 1. URL QR Codes
**Page**: https://custoqr.com/url-to-qr-code
- Encode any website URL
- Supports HTTPS and HTTP
- Ideal for marketing, business cards, posters

### 2. Text QR Codes
**Page**: https://custoqr.com/text-to-qr-code
- Encode plain text messages
- Up to 2953 characters
- Useful for notes, instructions

### 3. WiFi QR Codes
**Page**: https://custoqr.com/wifi-qr-code
- Network name (SSID)
- Password
- Security type (WPA/WPA2, WEP, None)
- Hidden network support
- Instant connection for guests

### 4. vCard QR Codes
**Page**: https://custoqr.com/vcard-qr-code
- Full name, organization
- Phone numbers (work, mobile, home)
- Email addresses
- Physical address
- Website URL
- Job title
- Notes

### 5. Email QR Codes
**Page**: https://custoqr.com/email-qr-code
- Email address
- Subject line
- Body text
- Opens default email client

### 6. Phone QR Codes
**Page**: https://custoqr.com/phone-qr-code
- Phone number with country code
- Initiates phone call on scan

### 7. SMS QR Codes
**Page**: https://custoqr.com/sms-qr-code
- Phone number
- Pre-filled message
- Opens messaging app

### 8. Location QR Codes
**Page**: https://custoqr.com/location-qr-code
- Latitude and longitude
- Opens in maps application
- Perfect for directions, meetup points

---

## Customization Options

### Error Correction Levels
QR codes use Reed-Solomon error correction:
- **L (Low)**: ~7% recovery capacity
- **M (Medium)**: ~15% recovery capacity
- **Q (Quartile)**: ~25% recovery capacity
- **H (High)**: ~30% recovery capacity (recommended for logos)

### Padding
- Adjustable quiet zone around QR code
- Range: 0-50 pixels
- Recommended: 20+ pixels for reliable scanning

### Size Options
- Preview: 400x400 pixels
- Download: 512px to 2048px
- Custom sizes via API

---

## Developer Integration

### NPM Package
```bash
npm install @intosoft/qrcode
# or
yarn add @intosoft/qrcode
```

### Supported Frameworks
- **Vanilla JavaScript**: Direct DOM manipulation
- **React**: Component-based integration
- **Vue**: Vue 3 composition API support
- **Angular**: Angular module integration
- **React Native**: Mobile app support
- **Node.js**: Server-side generation
- **iOS (Swift)**: Native Swift package
- **Android (Kotlin)**: Kotlin/Java library

### Basic Usage (JavaScript)
```javascript
import { generateSVGString } from '@intosoft/qrcode';

const svg = generateSVGString({
  value: 'https://custoqr.com',
  length: 400,
  colors: {
    body: '#000000',
    background: '#ffffff'
  },
  shapes: {
    body: 'rounded',
    eyeball: 'circle',
    eyeFrame: 'rounded'
  }
});

document.getElementById('qr-container').innerHTML = svg;
```

### React Component
```jsx
import { QRCode } from '@intosoft/qrcode/react';

function App() {
  return (
    <QRCode
      value="https://custoqr.com"
      size={300}
      bodyColor="#000000"
      bgColor="#ffffff"
      bodyShape="rounded"
    />
  );
}
```

---

## API Documentation

Full API documentation: https://custoqr.com/api
Developer docs: https://custoqr.com/docs

### Configuration Options

| Property | Type | Default | Description |
|----------|------|---------|-------------|
| value | string | required | Content to encode |
| length | number | 400 | Size in pixels |
| padding | number | 20 | Quiet zone padding |
| errorCorrectionLevel | 'L'/'M'/'Q'/'H' | 'H' | Error correction |
| colors.body | string/gradient | '#000000' | Body color |
| colors.background | string/gradient | '#ffffff' | Background color |
| colors.eyeball | object | {} | Eyeball colors per corner |
| colors.eyeFrame | object | {} | Eye frame colors per corner |
| shapes.body | string | 'square' | Body module shape |
| shapes.eyeball | string | 'square' | Eyeball shape |
| shapes.eyeFrame | string | 'square' | Eye frame shape |
| logo.url | string | undefined | Logo image URL |
| logo.size | number | 20 | Logo size percentage |

---

## Frequently Asked Questions

### Is CustoQR really free?
Yes! CustoQR is 100% free forever. No hidden fees, no premium plans, no limitations. All features are available to everyone.

### Do I need to create an account?
No registration or sign-up is required. Simply visit the website, customize your QR code, and download it instantly.

### What file formats can I download?
You can download QR codes in PNG, SVG, and JPEG formats. SVG is recommended for print materials as it's infinitely scalable.

### Can I add my logo to the QR code?
Yes! You can embed your company logo in the center of the QR code. We recommend using logos that are 20-30% of the QR code size for optimal scanning.

### How many shapes are available?
CustoQR offers 31+ body shapes, 21+ eyeball shapes, and 21+ eye frame shapes, giving you thousands of possible combinations.

### Will the QR codes expire?
No! QR codes generated by CustoQR never expire. They contain static content encoded directly in the image.

### Is my data saved?
No. CustoQR is privacy-first. All QR code generation happens in your browser, and no data is sent to or stored on our servers.

### Can I use CustoQR for commercial purposes?
Yes! QR codes generated with CustoQR can be used for any purpose, including commercial use, without attribution required.

---

## All Pages

### Main Pages
- Home: https://custoqr.com
- Free QR Generator: https://custoqr.com/free-qr-code-generator
- QR Scanner: https://custoqr.com/scan
- Features: https://custoqr.com/features
- Pricing: https://custoqr.com/pricing
- Documentation: https://custoqr.com/docs
- API: https://custoqr.com/api
- Blog: https://custoqr.com/blog
- FAQ: https://custoqr.com/faq

### QR Code Type Pages
- URL to QR: https://custoqr.com/url-to-qr-code
- Text to QR: https://custoqr.com/text-to-qr-code
- WiFi QR: https://custoqr.com/wifi-qr-code
- vCard QR: https://custoqr.com/vcard-qr-code
- Email QR: https://custoqr.com/email-qr-code
- Phone QR: https://custoqr.com/phone-qr-code
- SMS QR: https://custoqr.com/sms-qr-code
- Location QR: https://custoqr.com/location-qr-code
- QR Code Types: https://custoqr.com/qr-code-types

### Informational Pages
- About: https://custoqr.com/about
- Why CustoQR: https://custoqr.com/why-custoqr
- Compare: https://custoqr.com/compare
- Use Cases: https://custoqr.com/use-cases
- Gallery: https://custoqr.com/gallery
- History of QR Codes: https://custoqr.com/history-of-qr-codes
- How to Scan QR Code: https://custoqr.com/how-to-scan-qr-code
- Static vs Dynamic: https://custoqr.com/static-vs-dynamic-qr-codes

### Legal & Support
- Support: https://custoqr.com/support
- Privacy Policy: https://custoqr.com/privacy
- Terms of Service: https://custoqr.com/terms

### Developer Resources
- Sitemap: https://custoqr.com/sitemap.xml
- Sitemap Page: https://custoqr.com/sitemap
- GitHub: https://github.com/Intosoft/custoqr
- NPM: https://www.npmjs.com/package/@intosoft/qrcode

---

## Technical Information

- **Framework**: Next.js 15 (App Router)
- **UI Library**: React 19
- **Styling**: Tailwind CSS 4
- **QR Library**: @intosoft/qrcode
- **Hosting**: Vercel
- **License**: MIT

---

## Contact & Support

- **Website**: https://custoqr.com
- **GitHub Issues**: https://github.com/Intosoft/custoqr/issues
- **Support Page**: https://custoqr.com/support
- **Organization**: Intosoft (https://github.com/Intosoft)

---

*Last updated: January 2026*
*Version: 1.0.0*