Bill of Quantities (BoQ) Web App

A simple yet powerful web application for contractors to create and manage Bills of Quantities for construction projects.

Features

• Project Management: Create and save multiple construction projects
• Item Management: Add, edit, and delete items with descriptions, quantities, units, and rates
• Automatic Calculations: Instantly calculate item totals and project grand totals
• Export Options: Download your BoQ as PDF or CSV
• Local Storage: All projects are saved in your browser's local storage
• Responsive Design: Works on desktop, tablet, and mobile devices

How to Use

1. Create a New Project:

   • Enter a project name and date
   • Add items using the form at the top

2. Manage Items:

   • Fill in the description, quantity, unit, and rate for each item
   • Click "Add Item" to add it to your BoQ
   • Use the "Delete" button to remove items

3. Save Your Project:

   • Click the "Save Project" button to store your project in local storage

4. Export Your BoQ:

   • Click "Export" and choose either PDF or CSV format

5. Load Saved Projects:

   • Click "Save Project" to open the saved projects modal
   • Select a project to load or delete

Technical Details

This application is built using:

• HTML5
• CSS3 with Bootstrap 5
• Vanilla JavaScript
• jsPDF for PDF generation

Browser Compatibility

The BoQ Web App works in all modern browsers:

• Chrome
• Firefox
• Safari
• Edge

Local Development

To run this application locally:

1. Clone or download this repository
2. Open index.html in your web browser
3. No server or build process is required

Data Privacy

All data is stored locally in your browser using localStorage. No data is sent to any server.

License

This project is open source and available for personal and commercial use.