Skip to content

sobhanaz/tecsoqr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

60 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

TECSOQR - Custom QR Code Generator

TECSO Team React TypeScript Vite

A professional, feature-rich QR code generator built with modern web technologies. Create beautiful, customizable QR codes for your business and personal needs.

Live Demo | TECSO Team

✨ Features

  • Custom Content Types: URLs, text, contact information, WiFi credentials
  • Advanced Styling: Custom colors, gradients, and design options
  • Logo Integration: Add your company logo to QR codes
  • Responsive Design: Works perfectly on desktop, tablet, and mobile
  • High Quality: Adjustable error correction levels for optimal scanning
  • Export Options: Download QR codes as PNG, SVG, or share directly
  • PWA Support: Install as a progressive web app for offline access
  • 🌟 Neon Mode: GitHub-inspired cyberpunk theme with animated gradients and glow effects

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

# Clone the repository
git clone https://github.com/sobhanaz/tecsoqr.git
cd tecsoqr

# Install dependencies
npm install

# Start development server
npm run dev

Build for Production

# Build the project
npm run build

# Preview production build
npm run preview

πŸ› οΈ Tech Stack

  • Frontend Framework: React 19.1.1 with TypeScript
  • Build Tool: Vite 7.1.2
  • UI Library: Chakra UI with custom theme
  • QR Generation: qrcode.react library
  • Icons: React Icons
  • Image Export: html-to-image
  • PWA: Vite PWA plugin

πŸ“¦ Project Structure

tecsoqr/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/          # React components
β”‚   β”‚   β”œβ”€β”€ ContentTabs.tsx # Tab navigation
β”‚   β”‚   β”œβ”€β”€ QRForm.tsx      # QR customization form
β”‚   β”‚   β”œβ”€β”€ QRPreview.tsx   # QR code preview
β”‚   β”‚   └── Navbar.tsx      # Navigation header
β”‚   β”œβ”€β”€ App.tsx            # Main application component
β”‚   β”œβ”€β”€ main.tsx           # Application entry point
β”‚   β”œβ”€β”€ theme.ts           # Chakra UI theme configuration
β”‚   └── index.css          # Global styles
β”œβ”€β”€ public/                # Static assets
β”œβ”€β”€ package.json           # Dependencies and scripts
└── vite.config.ts        # Vite configuration

🎨 Customization

The application uses Chakra UI with a custom theme. To modify the styling:

  1. Edit src/theme.ts for theme customization
  2. Modify src/index.css for global styles
  3. Update component-specific styles in individual component files

🌟 Neon Mode

TECSOQR features a stunning GitHub-inspired neon theme that transforms the interface into a cyberpunk experience:

Activation

  • Click the ⚑ bolt icon in the navbar to toggle Neon Mode
  • Your preference is automatically saved in localStorage
  • Works seamlessly with both light and dark color modes

Features

  • Animated Hero Section: Floating badges with neon glow effects
  • Gradient Text: Dynamic color transitions on headings
  • Neon Cards: Glassmorphic containers with animated borders
  • GitHub-style Elements: Star buttons, gradient backgrounds, and subtle grid overlay
  • Responsive Glow: Hover effects and interactive animations
  • Accessibility Maintained: All neon effects preserve readability and contrast

Technical Implementation

  • CSS-in-JS with Emotion for dynamic styling
  • Chakra UI theme variants for consistent neon styling
  • React Context for global neon state management
  • CSS custom properties for optimal performance

πŸ“± PWA Features

This application is a Progressive Web App (PWA) with:

  • Offline functionality
  • Install to home screen
  • Automatic updates
  • Manifest file for app-like experience

🌐 Deployment

GitHub Pages

The project is configured for automatic deployment to GitHub Pages:

npm run build
# Deploys to https://sobhanaz.github.io/tecsoqr/

Cloudflare Pages

For deployment to Cloudflare Pages:

npm run build
# Deploy dist folder to Cloudflare Pages

🀝 Contributing

We welcome contributions! Please feel free to submit pull requests, create issues, or suggest new features.

Development Guidelines

  1. Follow TypeScript best practices
  2. Use Chakra UI components for consistency
  3. Maintain responsive design principles
  4. Write meaningful commit messages
  5. Test across different devices and browsers

πŸ“„ License

This project is developed and maintained by TECSO Team - an innovative IT company based in Iran, specializing in delivering cutting-edge smart technology solutions.

TECSO Team combines expertise in software development, cybersecurity, and user-centric design to address modern challenges. Our mission is to bridge technological gaps, enhance economic growth, and provide seamless, scalable solutions for local and international markets.

πŸ”— Useful Links


Built with ❀️ by TECSO Team

Empowering businesses through innovative technology solutions

About

TeCSO QR is a modern, responsive QR code generator built with React, TypeScript, and Vite. Easily create customizable QR codes for URLs, text, WiFi, or contacts with real-time previews, theme options, and PWA support for seamless mobile use. Developed by TECSO Team for quick, scalable QR solutions.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors