Skip to content

Asmit1211/BillBlitz

Repository files navigation

๐Ÿš€ BillBlitz - Blitz Your Bills in Seconds!

Professional GST Invoice Generator for Modern Businesses

BillBlitz is a lightning-fast, professional invoice generator designed for malls, supermarkets, pharmacies, electronics stores, and small businesses. Generate GST-compliant invoices with dynamic tax calculations, custom business details, and instant PDF downloads.


๐ŸŽฏ Problem Solved

Traditional invoicing is slow, error-prone, and lacks flexibility. Small businesses struggle with:

  • โŒ Manual GST calculations for different product categories
  • โŒ Time-consuming invoice creation process
  • โŒ Lack of professional invoice templates
  • โŒ No support for different business types
  • โŒ Complex software with steep learning curves

BillBlitz solves all these problems with a simple, intuitive interface that generates professional invoices in seconds!


โœจ Standout Features

๐ŸŽจ Modern UI/UX

  • Clean, professional SaaS-style interface
  • Responsive design for all devices
  • Real-time invoice preview
  • Smooth animations and loading states
  • Celebratory confetti on successful PDF generation

๐Ÿงฎ Smart GST Calculations

  • Dynamic GST rates based on business type:
    • ๐Ÿ“Š Electronics: 18% GST
    • ๐Ÿ’Š Pharmacy: 12% GST
    • ๐Ÿช General Store: 0% GST
    • ๐Ÿ’Ž Luxury Store: 28% GST
  • Automatic CGST/SGST split for intra-state sales
  • IGST calculation for inter-state sales
  • Real-time tax calculations

๐Ÿข Complete Business Details

  • Branch/Location information
  • Full business address
  • Contact number and GSTIN
  • Cashier name and counter number
  • Custom business name support

๐Ÿ“„ Professional PDF Generation

  • Clean, GST-compliant invoice format
  • Proper formatting with Indian currency
  • All business details included
  • Professional layout and typography

๐ŸŽฎ User Experience

  • Loading animations during PDF generation
  • Success feedback with confetti animation
  • One-click invoice reset
  • Real-time preview updates
  • Intuitive form validation

๐Ÿช Business Flexibility

BillBlitz adapts to different business types with ease:

Business Type GST Rate Use Cases
Electronics 18% Mobile stores, computer shops, appliance stores
Pharmacy 12% Medical stores, drug stores, health centers
General Store 0% Grocery stores, convenience stores, daily needs
Luxury Store 28% Jewelry, premium goods, luxury items
Custom Variable Any business with custom name and details

Easy to extend: Adding new business types with different GST rates is just a few lines of code!


๐ŸŽฎ How It Works

1. Setup Business Details

  • Select your business type (Electronics, Pharmacy, etc.)
  • Enter branch, address, contact details
  • Add GSTIN, cashier name, and counter info

2. Configure Invoice

  • Auto-generated invoice number
  • Select payment mode (Cash, UPI, Card, Bank Transfer)
  • Choose tax type (CGST+SGST or IGST)

3. Add Products

  • Enter product name, quantity, and price
  • Real-time calculation of line totals
  • Easy product removal with one click

4. Generate & Download

  • Live preview updates as you type
  • Professional PDF generation with loading animation
  • Instant download with success celebration
  • GST-compliant format ready for business use

๐Ÿš€ Tech Stack

Frontend

  • โš›๏ธ React 18 - Modern React with hooks
  • ๐ŸŽจ TypeScript - Type-safe development
  • ๐Ÿ’จ Tailwind CSS - Utility-first styling
  • ๐ŸŽญ Shadcn/UI - Beautiful, accessible components
  • โšก Vite - Lightning-fast build tool

PDF Generation

  • ๐Ÿ“„ jsPDF - Client-side PDF generation
  • ๐Ÿ“Š jsPDF-AutoTable - Professional table layouts

State Management

  • ๐Ÿช React Hooks - useState, useMemo for state
  • ๐Ÿ”„ Custom Hooks - Reusable invoice logic

UI/UX

  • ๐ŸŽจ Lucide React - Beautiful icons
  • โœจ Custom Animations - Loading spinners, confetti
  • ๐Ÿ“ฑ Responsive Design - Works on all devices

๐Ÿ“ธ Screenshots

Dashboard Invoice Preview Mobile View PDF Download

๐Ÿ”ง Quick Setup

Prerequisites

  • Node.js 18+ installed
  • npm or yarn package manager

Installation

# Clone the repository
git clone https://github.com/Asmit1211/BillBlitz.git

# Navigate to project directory
cd BillBlitz

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

Environment Setup

No environment variables required! BillBlitz works out of the box.

Usage

  1. Open http://localhost:8080 in your browser
  2. Fill in your business details
  3. Add products to your invoice
  4. Download professional PDF invoices instantly!

๐ŸŽ‰ Hackathon Ready

โœ… All Requirements Met

  • โœ… Professional GST invoice generation
  • โœ… Dynamic tax calculations
  • โœ… Multiple business type support
  • โœ… Custom business details
  • โœ… PDF download functionality
  • โœ… Responsive design
  • โœ… Modern UI/UX

โœ… Multiple Custom Features

  • โœ… Real-time invoice preview
  • โœ… Loading animations and success feedback
  • โœ… Confetti celebration on PDF generation
  • โœ… Custom business name support
  • โœ… Professional invoice formatting
  • โœ… Mobile-responsive design
  • โœ… One-click reset functionality

โœ… Professional Presentation

  • โœ… Clean, modern interface
  • โœ… Professional color scheme
  • โœ… Consistent typography
  • โœ… Smooth animations
  • โœ… Intuitive user flow

โœ… Demo Screenshots Included

  • โœ… Dashboard overview
  • โœ… Invoice preview
  • โœ… PDF generation
  • โœ… Mobile responsiveness

โœ… Clear Documentation

  • โœ… Comprehensive README
  • โœ… Setup instructions
  • โœ… Feature explanations
  • โœ… Technical details
  • โœ… Usage examples

๐ŸŒŸ Future Enhancements

  • ๐Ÿ” User authentication and data persistence
  • ๐Ÿ“Š Invoice history and analytics
  • ๐ŸŽจ Custom invoice templates
  • ๐Ÿ“ง Email invoice functionality
  • ๐Ÿ”— Integration with payment gateways
  • ๐Ÿ“ฑ Mobile app version
  • ๐ŸŒ Multi-language support

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

๐Ÿ“ž Support

If you have any questions or need support, please open an issue on GitHub or contact the developer.


Built with โค๏ธ by Asmit Samal
Final Year BSc CS | Mumbai University
MERN Stack Developer


๐Ÿ† BillBlitz - Making Professional Invoicing Accessible to Everyone!

Transform your business invoicing experience with BillBlitz - where speed meets professionalism.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages