QuickInvoice 📄

A modern, professional invoice management system built with PHP, MySQL, and Bootstrap. Create, manage, and track invoices with ease!

✨ Features

🎯 Core Functionality

• Invoice Creation: Create professional invoices with custom items and tax calculations
• Client Management: Store and manage client information with contact details
• Real-time Calculations: Automatic total calculations as you type
• PDF Generation: Generate and download invoices as PDF files
• Email Integration: Send invoices directly to clients via email

📊 Analytics & Reports

• Dashboard Analytics: Overview of invoices, revenue, and client statistics
• Custom Reports: Filter reports by date ranges and generate insights
• Revenue Tracking: Monthly revenue trends and performance metrics
• Client Analytics: Top clients by revenue and invoice count

🎨 User Experience

• Modern UI: Clean, responsive design with Bootstrap 5
• Real-time Updates: Live calculations and instant feedback
• Print-Ready: Professional invoice layouts for printing
• Mobile Friendly: Responsive design works on all devices

⚙️ Customization

• Company Settings: Customize company information and branding
• Tax Configuration: Set default tax rates and currency
• Invoice Numbering: Custom invoice number prefixes
• Multi-Currency: Support for USD, EUR, GBP, CAD, AUD

🚀 Quick Start

Prerequisites

• PHP 7.4 or higher
• MySQL 5.7 or higher
• Web server (Apache/Nginx)
• XAMPP, WAMP, or similar local development environment

Installation

1. Clone the repository

   git clone https://github.com/AhmedShaikh0/QuickInvoice.git
   cd QuickInvoice

2. Set up the database

   • Create a new MySQL database named quickinvoice
   • The application will automatically create tables on first run

3. Configure database connection

   • Edit config/database.php
   • Update database credentials:

   define('DB_HOST', 'localhost');
   define('DB_USER', 'your_username');
   define('DB_PASS', 'your_password');
   define('DB_NAME', 'quickinvoice');

4. Access the application

   • Navigate to http://localhost/QuickInvoice
   • The system will automatically initialize the database

📁 Project Structure

QuickInvoice/
├── api/                    # API endpoints
│   ├── add-client.php
│   ├── save-invoice.php
│   ├── get-statistics.php
│   └── ...
├── assets/                 # Frontend assets
│   ├── css/
│   │   └── style.css
│   └── js/
│       └── main.js
├── config/                 # Configuration files
│   └── database.php
├── includes/               # Shared functions
│   ├── functions.php
│   └── footer.php
├── index.php              # Dashboard
├── clients.php            # Client management
├── create-invoice.php     # Invoice creation
├── invoices.php           # Invoice listing
├── reports.php            # Analytics & reports
├── settings.php           # Application settings
└── README.md

🎯 Key Features Explained

Invoice Management

• Dynamic Item Addition: Add unlimited invoice items with real-time calculations
• Tax Calculations: Automatic tax computation with customizable rates
• Status Tracking: Track invoice status (draft, sent, paid, overdue)
• PDF Export: Generate professional PDF invoices for printing

Client Management

• Comprehensive Profiles: Store client details including address, phone, email
• Company Information: Track both individual and company clients
• Quick Actions: Create invoices directly from client profiles
• Search & Filter: Find clients quickly with search functionality

Analytics Dashboard

• Revenue Tracking: Monitor total revenue and average invoice amounts
• Status Distribution: Visual breakdown of invoice statuses
• Top Clients: Identify your most valuable clients
• Date Filtering: Analyze data for specific time periods

🛠️ Technology Stack

• Backend: PHP 8.0+
• Database: MySQL 5.7+
• Frontend: HTML5, CSS3, JavaScript
• UI Framework: Bootstrap 5.3
• Charts: Chart.js for analytics
• Icons: Font Awesome 6.0

📊 Database Schema

Tables

• clients: Client information and contact details
• invoices: Invoice headers and totals
• invoice_items: Individual invoice line items
• settings: Application configuration

🎨 Screenshots

Dashboard

Invoice Creation

Reports

🔧 Configuration

Company Settings

• Navigate to Settings → Company Information
• Update company name, address, contact details
• Set default tax rate and currency
• Configure invoice number prefix

Database Settings

• Edit config/database.php for database connection
• Ensure proper permissions for database user
• Backup database regularly

🚀 Deployment

Local Development

1. Use XAMPP, WAMP, or similar local server
2. Place project in htdocs or www directory
3. Access via http://localhost/QuickInvoice

Production Deployment

1. Upload files to web server
2. Configure database connection
3. Set proper file permissions
4. Enable HTTPS for security

🤝 Contributing

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

Development Setup

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📝 License

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

👨‍💻 Developer

Ahmed Shaikh

• GitHub: @AhmedShaikh0

🙏 Acknowledgments

• Bootstrap for the amazing UI framework
• Chart.js for beautiful analytics charts
• Font Awesome for the icons
• The PHP community for excellent documentation

📞 Support

If you have any questions or need help:

1. Check the Issues page
2. Create a new issue if your problem isn't already listed
3. Contact me directly via GitHub

---

⭐ Star this repository if you find it helpful!

Made with ❤️ by Ahmed Shaikh