Skip to content
khrannasPublic

About

Utility Tools that serving my need

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎨 KHRa-Util

License: MIT HTML5 CSS3 JavaScript Tailwind CSS

A comprehensive suite of web-based utilities for creating professional digital assets with sophisticated design tools and intelligent automation.

✨ Overview

KHRa-Util is a powerful collection of client-side web utilities designed for creating high-quality digital assets. Featuring a sophisticated business card designer with premium templates and an advanced QR code generator with intelligent logo integration, this suite provides professional-grade tools that work entirely in your browser.

🌟 Key Highlights

  • πŸ”’ Privacy-First: No registration required - all processing happens client-side
  • 🎯 Professional Quality: Export-ready assets suitable for print and digital use
  • πŸ“± Cross-Platform: Works seamlessly on any modern browser
  • πŸš€ Smart Automation: Intelligent color matching and layout optimization
  • πŸ“ Responsive Design: Mobile-friendly interface that adapts to any screen size
  • ⚑ Zero Setup: Start creating immediately - no installation required

πŸ› οΈ Tools

1. πŸ“‡ Name Card Designer

Location: util/name-card.html

Create stunning professional business cards with our sophisticated designer featuring 5 premium templates and advanced customization options.

Features:

  • 5 Premium Templates:

    • πŸ™οΈ Urban Explorer - Modern city-inspired design
    • 🧭 Nomad's Compass - Adventure-themed layout
    • ✨ The Minimalist - Clean, elegant simplicity
    • πŸ’ͺ The Bold - Strong, impactful design
    • 🎭 The Elegant - Sophisticated luxury styling
  • Advanced Capabilities:

    • πŸ‘οΈ Real-time preview with responsive scaling
    • πŸ–ΌοΈ Custom logo upload with intelligent placement
    • πŸ“± QR code integration with smart color matching
    • πŸ–¨οΈ High-quality PNG export at 3x resolution (optimal for printing)
    • 🎨 Automatic color palette extraction and matching

Technical Stack:

  • Styling: Tailwind CSS for responsive design
  • QR Generation: QR Code Styling library
  • Export: html2canvas for high-quality image generation
  • Typography: Google Fonts integration

2. πŸ“± QR Code Generator

Location: util/qr-code.html

Generate professional QR codes with advanced styling options and intelligent logo integration capabilities.

Features:

  • Smart Logo Integration:

    • 🎨 Intelligent color palette extraction from uploaded logos
    • πŸ”„ Automatic color synchronization
    • πŸ“ Optimal logo placement and sizing
  • 6 Professional Dot Styles:

    • ⬛ Squares - Classic square dots
    • β­• Dots - Circular dot pattern
    • πŸ”˜ Rounded - Softly rounded squares
    • β­• Extra-Rounded - Highly rounded design
    • 🎩 Classy - Elegant styling
    • 🎭 Classy-Rounded - Premium rounded elegance
  • Advanced Options:

    • πŸ“ Text integration with color synchronization
    • πŸ“ 1024x1024 high-resolution export
    • πŸ–±οΈ Intuitive drag & drop interface
    • 🎨 Real-time preview and customization

Technical Stack:

  • Styling: Tailwind CSS for modern UI
  • QR Generation: QR Code Styling library with advanced options
  • Export: html2canvas for crisp image output
  • Typography: Inter Font for clean readability

πŸš€ Getting Started

Quick Start

  1. Clone or download this repository
  2. Open any tool directly in your web browser:
    • For business cards: Open util/name-card.html
    • For QR codes: Open util/qr-code.html
  3. Start creating immediately - no setup required!

Local Development

# Clone the repository
git clone https://github.com/yourusername/khra-util.git

# Navigate to the project directory
cd khra-util

# Open with a local server (optional, for development)
# Using Python 3
python -m http.server 8000

# Using Node.js (if you have http-server installed)
npx http-server

# Then open http://localhost:8000 in your browser

Usage Examples

Creating a Business Card:

  1. Open util/name-card.html
  2. Select your preferred template
  3. Fill in your contact information
  4. Upload your logo (optional)
  5. Generate a QR code for easy sharing
  6. Export as high-resolution PNG

Generating QR Codes:

  1. Open util/qr-code.html
  2. Enter your text/URL
  3. Upload a logo for branding (optional)
  4. Choose your preferred dot style
  5. Customize colors and appearance
  6. Export as 1024x1024 PNG

πŸ”§ Technical Details

Dependencies

Tool Primary Dependencies
Name Card Designer Tailwind CSS, QR Code Styling, html2canvas, Google Fonts
QR Code Generator Tailwind CSS, QR Code Styling, html2canvas, Inter Font

Browser Compatibility

  • βœ… Chrome 80+
  • βœ… Firefox 75+
  • βœ… Safari 13+
  • βœ… Edge 80+

Performance

  • Client-side processing: No server requests for core functionality
  • Optimized exports: High-quality output with efficient compression
  • Responsive design: Smooth performance across device sizes

πŸ“„ License

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

MIT License

Copyright (c) 2024 KHRa-Util

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🀝 Contributing

We welcome contributions to KHRa-Util! Here's how you can help:

How to Contribute:

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

Contribution Guidelines:

  • πŸ“ Follow existing code style and conventions
  • πŸ§ͺ Test your changes across multiple browsers
  • πŸ“– Update documentation for new features
  • πŸ› Include bug fixes with reproduction steps
  • ✨ Keep commits focused and descriptive

Areas for Contribution:

  • 🎨 New business card templates
  • πŸ”§ Additional QR code styling options
  • 🌐 Internationalization support
  • πŸ“± Mobile UX improvements
  • 🎯 Performance optimizations
  • πŸ“š Documentation enhancements

πŸ“ž Support


Made with ❀️ for the creative community

⭐ Star this project if you find it helpful!

About

Utility Tools that serving my need

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages