Skip to content

Webisso/qr-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”² QR Code Generator

QR Generator React Tailwind CSS License

Modern, fully client-side, multi-language QR code generator

🌐 Demo | πŸ“– API Docs | πŸ› Issues


✨ Features

🎯 17 Different QR Code Types

Type Description
πŸ”— URL Website links
πŸ“ Text Plain text content
πŸ“§ Email Email address, subject, and body
πŸ“ž Phone Initiate phone calls
πŸ’¬ SMS Send SMS messages
πŸ“Ά WiFi Auto-connect to WiFi networks
πŸ‘€ vCard Share contact information
πŸ“ Location GPS coordinates
πŸ’š WhatsApp WhatsApp messages
β‚Ώ Bitcoin Cryptocurrency payment addresses
πŸ“… Event Calendar events
πŸ“± App App Store/Play Store links
πŸ” 2FA/OTP Two-factor authentication
🎫 Coupon Discount coupons
⭐ Review Google/Yelp reviews
πŸ“‹ Clipboard Copy to clipboard
πŸ†” UPI India payment system

🎨 Full Customization

  • Colors: Foreground, background, and gradient support
  • Dot Styles: Square, rounded, extra-rounded, dots
  • Corner Styles: Square, dot, extra-rounded
  • Logo: Add custom logo to center with size adjustment
  • Error Correction: L, M, Q, H levels
  • Size & Margin: Full control

🌍 43 Language Support

English, Turkish, German, French, Spanish, Italian, Portuguese, Russian, Chinese, Japanese, Korean, Arabic, and many more...

πŸ“₯ Multiple Export Formats

  • PNG (transparent background)
  • JPEG
  • SVG (vector)
  • WebP

πŸ”Œ API Support

Programmatic QR code generation via URL parameters:

https://webisso.github.io/qr-generator/generate?type=url&data=https://example.com

πŸš€ Quick Start

Requirements

  • Node.js 18+
  • npm or yarn

Installation

# Clone the repository
git clone https://github.com/webisso/qr-generator.git

# Navigate to project directory
cd qr-generator

# Install dependencies
npm install --legacy-peer-deps

# Start development server
npm start

Open http://localhost:3000 in your browser.

Production Build

# Create optimized build
npm run build

# Serve build folder
npx serve -s build

πŸ“– Usage

Web Interface

  1. Select QR Type: Choose the desired QR code type from the left panel
  2. Enter Information: Fill in the required fields based on the selected type
  3. Customize: Add colors, styles, and logo
  4. Download: Export in PNG, JPEG, SVG, or WebP format

API Usage

Simple URL QR Code

/generate?type=url&data=https://google.com

Customized QR Code

/generate?type=url&data=https://example.com&size=400&color=3B82F6&dots=rounded&corners=dot

WiFi QR Code

/generate?type=wifi&ssid=MyNetwork&password=12345&encryption=WPA

vCard QR Code

/generate?type=vcard&name=John%20Doe&phone=+1234567890&email=john@example.com

Auto Download

/generate?type=url&data=https://example.com&download=true&format=png

API Parameters

Parameter Description Default Options
type QR code type url url, text, email, phone, sms, wifi, vcard, location, whatsapp, bitcoin, event
data Main content - -
size Size (px) 300 100-1000
margin Margin 10 0-50
color Foreground color 000000 Hex (without #)
bg Background color ffffff Hex (without #)
dots Dot style rounded square, rounded, dots, extra-rounded
corners Corner style dot square, dot, extra-rounded
ec Error correction H L, M, Q, H
logo Logo URL - Valid image URL
download Auto download false true, false
format Download format png png, jpeg, svg, webp

πŸ—οΈ Project Structure

qr-generator/
β”œβ”€β”€ public/
β”‚   β”œβ”€β”€ index.html
β”‚   └── manifest.json
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ ui/                    # shadcn/ui components
β”‚   β”‚   β”‚   β”œβ”€β”€ button.jsx
β”‚   β”‚   β”‚   β”œβ”€β”€ card.jsx
β”‚   β”‚   β”‚   β”œβ”€β”€ input.jsx
β”‚   β”‚   β”‚   β”œβ”€β”€ select.jsx
β”‚   β”‚   β”‚   β”œβ”€β”€ slider.jsx
β”‚   β”‚   β”‚   β”œβ”€β”€ tabs.jsx
β”‚   β”‚   β”‚   └── ...
β”‚   β”‚   β”œβ”€β”€ QRGenerator/           # QR generator components
β”‚   β”‚   β”‚   β”œβ”€β”€ QRGenerator.jsx
β”‚   β”‚   β”‚   β”œβ”€β”€ QRTypeSelector.jsx
β”‚   β”‚   β”‚   β”œβ”€β”€ QRDataForm.jsx
β”‚   β”‚   β”‚   β”œβ”€β”€ QRCustomization.jsx
β”‚   β”‚   β”‚   └── QRPreview.jsx
β”‚   β”‚   β”œβ”€β”€ Header/
β”‚   β”‚   β”‚   └── Header.jsx
β”‚   β”‚   β”œβ”€β”€ Footer/
β”‚   β”‚   β”‚   └── Footer.jsx
β”‚   β”‚   └── LanguageSelector/
β”‚   β”‚       └── LanguageSelector.jsx
β”‚   β”œβ”€β”€ pages/
β”‚   β”‚   β”œβ”€β”€ ApiGenerator.jsx       # API endpoint page
β”‚   β”‚   β”œβ”€β”€ ApiDocs.jsx            # API documentation
β”‚   β”‚   └── index.js
β”‚   β”œβ”€β”€ locales/                   # Language files
β”‚   β”‚   β”œβ”€β”€ en-US.json
β”‚   β”‚   β”œβ”€β”€ tr.json
β”‚   β”‚   └── ... (43 languages)
β”‚   β”œβ”€β”€ lib/
β”‚   β”‚   └── utils.js               # Utility functions
β”‚   β”œβ”€β”€ i18n.js                    # i18n configuration
β”‚   β”œβ”€β”€ App.js
β”‚   β”œβ”€β”€ App.css
β”‚   └── index.js
β”œβ”€β”€ craco.config.js                # CRACO configuration
β”œβ”€β”€ tailwind.config.js             # Tailwind configuration
β”œβ”€β”€ postcss.config.js
└── package.json

πŸ› οΈ Technologies

Technology Description
React 19 UI framework
Tailwind CSS 3 Utility-first CSS
Radix UI Headless UI components
qr-code-styling QR code generation library
i18next Internationalization
React Router Client-side routing
Lucide React Icon library
CRACO CRA configuration override

🌐 Deployment

GitHub Pages

# Install gh-pages package
npm install gh-pages --save-dev --legacy-peer-deps

# Add homepage to package.json
# "homepage": "https://webisso.github.io/qr-generator"

# Deploy
npm run build
npx gh-pages -d build

Vercel / Netlify

  1. Connect your GitHub repository
  2. Build command: npm run build
  3. Output directory: build
  4. Deploy!

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License. See the LICENSE file for details.


πŸ‘¨β€πŸ’» Developer


⭐ If you like this project, don't forget to give it a star!

About

Modern, fully client-side, multi-language QR code generator

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors