User Manual

Welcome to Interior Works! This app is designed to help interior designers, contractors, and design studios manage their project finances entirely offline.

1. Download Interior Works from the Google Play Store
2. Open the app — you'll be prompted to set a 4-digit PIN on first launch
3. Go to Settings → Company Details and fill in your company name, address, GSTIN, and bank details
4. Add your first client under the Clients section
5. Create your first Site and start tracking!

Interior Works uses a local 4-digit PIN to protect your data. No internet or account is needed.

1. On first launch, enter a 4-digit PIN of your choice
2. Confirm the PIN by entering it again
3. Your PIN is securely hashed (SHA-256) and stored on your device
4. On subsequent opens, enter your PIN to unlock the app

Forgot your PIN? Tap "Forgot PIN?" on the login screen. This will reset your PIN without deleting any data. You'll be prompted to set a new PIN.

Lockout protection: After 5 incorrect attempts, you'll be locked out for 30 seconds.

Navigate to Settings from the bottom nav bar or side menu. Here you can configure:

1. Company Name & Address — appears on your PDF letterhead
2. Phone & Email — contact details on documents
3. GSTIN — your GST Identification Number for tax compliance
4. Logo — upload your company logo (used on PDFs)
5. Bank Details — bank name, account number, IFSC, UPI ID for payment info on invoices
6. Invoice & Quotation Prefix — e.g., "INV" or "QUO" with auto-incrementing counters
7. GST Settings — enable/disable GST, set default rate and type

Clients are the people or companies you do interior work for. Each site is linked to a client.

1. Go to Clients from the dashboard or navigation
2. Tap the + button to add a new client
3. Fill in: Name, Contact Person, Phone, Email, Address, GSTIN, PAN Number
4. Tap Save

You can edit or delete clients from the list. Note: Deleting a client with linked sites will show a warning.

Sites represent your interior design projects. Each site tracks all financial data — quotations, invoices, expenses, and vendor bills.

1. Navigate to Sites and tap the + FAB
2. Enter site name (e.g., "Sharma Residence")
3. Select the client from the dropdown
4. Enter the site address
5. Set the start date and optional end date
6. Status defaults to Ongoing — you can change to Completed or On Hold later
7. Tap Save

The Site Detail page shows a complete financial summary — quoted amount, invoiced, balance, labour costs, material costs, vendor bills, and net P&L.

Use the filter chips on the Sites list to view only Ongoing, Completed, or On Hold projects.

Register your workers and set their default rates for quick labour entry.

1. Go to Employees
2. Tap + to add a new employee
3. Enter: Name, Phone, Designation (e.g., Carpenter, Painter)
4. Set default rate and unit (per Day or per Hour)
5. Toggle Active status — inactive employees won't appear in labour entry dropdowns

Create professional quotations for your clients with dynamic line items, GST calculations, and branded PDF export.

1. From a site's detail page or the Quotations menu, tap New Quotation
2. The quotation number is auto-generated (e.g., QUO-2526-001)
3. Add line items — each with description, quantity, unit, and rate. Amount is auto-calculated.
4. Add a discount (flat amount or percentage)
5. Enable GST if applicable — choose CGST+SGST or IGST and select the rate
6. Set the "Valid Until" date
7. Add any notes or terms & conditions
8. Tap Save Draft to save, or Save & Generate PDF to create the PDF immediately

The generated PDF includes your company letterhead, client details, line items, GST breakup, grand total, terms, and bank details. You can share it directly via WhatsApp, email, or any other app.

Record advance payments received from clients against a quotation.

1. Navigate to Advances → New Advance
2. Select the site and quotation
3. The form shows: Quotation total, advances received so far, and remaining balance
4. Enter the advance amount (cannot exceed remaining balance)
5. Select payment mode: Cash, NEFT, UPI, Cheque, or RTGS
6. Enter reference number and received date
7. Tap Save

Advances remain "unsettled" until you create an invoice and settle them. This ensures accurate bookkeeping.

Generate invoices from quotations and settle advance payments in one atomic transaction.

1. Navigate to Invoices → New Invoice
2. Select the site — line items and GST are auto-populated from the quotation
3. Invoice number is auto-generated (e.g., INV-2526-001)
4. Set the due date
5. In the "Advances to Settle" section, check the advances you want to deduct
6. The balance due is calculated live: Grand Total − Selected Advances
7. Tap Save & Generate PDF
8. Optionally, tap Mark as Fully Settled to close the invoice

Important: When you settle an invoice, the app updates the invoice status and marks all selected advances as settled in a single database transaction. This ensures data consistency.

Track daily labour costs per site and per employee.

1. Go to Expenses → Labour → New Entry
2. Select the site and employee
3. Choose unit: Days or Hours
4. Enter quantity (e.g., 1.5 days) — rate is pre-filled from employee default
5. Amount is auto-calculated (quantity × rate)
6. Optionally add a description
7. Tap Save or Add Another to log multiple entries quickly

The month, year, and financial year are automatically computed from the work date and stored with each entry for report generation.

Record material purchases linked to specific sites.

1. Go to Expenses → Material → New Entry
2. Select the site
3. Enter item name — autocomplete suggests previously used items
4. Optionally enter the vendor/supplier name
5. Enter quantity and select unit (nos, sqft, rft, bags, kg, ltr, box, set)
6. Enter rate — amount is auto-calculated
7. Optionally enter bill number and purchase date
8. Tap Save

Manage your vendors (suppliers, contractors, electricians, plumbers) with full invoice and payment tracking.

1. Add Vendor: Go to Vendors → tap + → enter name, category, phone, GSTIN, bank details
2. Vendor Invoice: Tap a vendor → New Invoice → add line items, GST, attach bill image
3. Vendor Advance: Record partial payments against a vendor invoice
4. Balance Payment: Record final settlement of a vendor invoice
5. Vendor Ledger: View all invoices and payments for a vendor in chronological order

All vendor payments are processed in atomic transactions — when you record an advance, the vendor invoice's paid amount and balance are updated simultaneously.

Interior Works provides comprehensive reports for financial analysis and record-keeping.

1. Monthly P&L: Select a month — view income, expenses, net profit, and expense breakdown chart
2. Annual P&L: Select financial year — 12-month bar chart, site-wise profitability table
3. Site Reports: Advance report, expense report, and settlement status per site
4. Employee Report: Labour summary per employee with date range filter
5. Vendor Report: Payables summary, overdue bills, and payment history

Export options: Every report can be exported as a PDF or CSV file. Use the share sheet to send reports via WhatsApp, email, or save to any app. Optionally back up to Google Drive.

Protect your data with Google Drive backup. Your entire database can be backed up and restored with one tap.

1. Go to Settings → Backup & Restore
2. Sign in with your Google account
3. Tap Backup Now to upload your database to Google Drive
4. To restore on a new device, sign in and tap Restore from Drive

What gets backed up: Your complete ObjectBox database file — all sites, clients, quotations, invoices, expenses, vendors, and settings.

PDF backups: After generating any PDF (quotation, invoice, report), a "Backup to Drive" option appears in the SnackBar. This is optional and non-blocking.