Initial Setup
Recommended first steps (2–3 minutes):
- Set your default hourly rate.
- Confirm your due date threshold (overdue days).
- Review your tax defaults (if you charge tax).
- Do a quick Export once you’ve added a few test entries, so you understand backups.
Default Hourly Rate
Billwright can pre-fill labor rate fields using your default hourly rate. You can still override rates per job when needed.
Due Date Threshold
The due date threshold is used to help prevent jobs from going unchecked. When a new job is created, Billwright sets a default due date based on your threshold. After creation, due dates are user-owned and can be edited per job.
Taxes (if applicable)
If you collect tax, set your tax defaults in Customers so jobs start with the correct tax behavior. Taxes can be adjusted in customer after creating a new customer from job entry.
Settings
- Default hourly rate: Used as the starting labor rate for new jobs.
- Due date threshold: Used to compute the initial due date for new jobs.
Note: Changes in settings do not automatically rewrite locked jobs unless you explicitly change those jobs.
Customers
Customer setup is optional but recommended as they are auto created during job entry if they do not already exist. Using customers lets you:
- Track job history per customer
- Apply customer-specific defaults (where supported)
- Track customer credit from overpayments
- Tax defaults: Set your standard tax rules so new jobs start correctly.
Best practice
- Create the customer first, then create jobs under that customer for cleaner reporting.
- Use consistent naming (e.g., “Smith, John” vs “John Smith”) so searches and exports stay clean.
Jobs
A job is the container for everything: dates, customer, description, labor, materials, payments, and invoice output.
Creating a job
- Enter customer - or - if you use customer records select one by typing the first part of their name.
- Enter a clear description (this carries through to invoices and reports).
- Set job date and due date as needed.
Job card overview
- Job Date: When the job was created/assigned.
- Due Date: When you want to revisit/collect/close the job.
- Amounts: Totals, paid/remaining, tax (if applicable) depending on your configuration.
Labor & Materials
Labor
- Enter hours and rate to calculate labor totals.
Materials
- Add materials line items (description, quantity, cost/price as supported).
- Materials can be included in invoice totals.
Keep descriptions invoice-friendly (what you’d want the customer to see).
Payments & Customer Credit
Record payments against the job to track what’s been paid and what remains.
Partial payments
- Billwright supports partial payments so you can track progress payments.
- Remaining balance is calculated from totals minus payments.
Overpayments and credit
If a payment exceeds what is currently owed, Billwright can treat the extra as customer credit (where supported). Customer credit can be applied to future jobs for that customer.
Best practice: Keep a note in the customer record when credit is created, so the context is easy to recall later.
Due Dates
How the default due date is set
When a job is created, Billwright sets an initial due date using: Job Date + Due Date Threshold
Editing a due date
- Open the job and tap the due date field to choose a new date.
- Due dates do not auto-recalculate after creation; they remain stable unless you change them.
Invoices
Billwright can generate simple PDF invoices for customers.
Invoice contents
- Customer and job details
- Labor and materials (as configured)
- Taxes (if enabled)
- Payments and remaining balance (where supported)
Best practice
- Review the job details before generating the invoice.
- Export periodically to ensure you always have a backup of your job data.
Reports
Reports help you quickly see job status (unpaid, partially paid, paid, overdue) and totals for the period you care about.
- Use reports to follow up on unpaid or overdue jobs.
- Use exports for deeper analysis in spreadsheets if needed.
Export / Import (Backup & Restore)
This is your backup system. Export regularly, especially before updates or device changes.
Export
- Export saves your Billwright data to a file you control.
- Store exports somewhere safe (device storage, a computer, or your preferred backup method).
Import
- Import restores data from a previously exported file.
- Only import files you trust.
Best practice
- Keep multiple exports over time (a few “restore points”).
- Name your exports with a date so they’re easy to identify.
Locking Jobs
Locking prevents accidental edits after a job is finalized or paid.
- Locked jobs become read-only for key fields (including dates and amounts).
- Use locking to preserve historical accuracy and avoid accidental changes.
- A job is automatically locked when the balance is paid in full. Any credit applied to the job is moved to the customers record.
About & Support
The About dialog shows version information and provides the official ways to report issues or send feedback.
Reporting issues (recommended)
- Open About and use the support link provided there to reach the developer.
- Email support is provided in About, include:
- What you were doing
- What you expected
- What happened instead
- Steps to reproduce (if possible)
Helpful details to include
- App version (shown in About)
- Device model / Android version
- A screenshot if the issue is visual
Privacy Policy
Billwright is designed to be offline-first. Review the privacy policy here: