Contact person: Cleartax Land Tax Calculator Development

Phone:Show

Email:Show

Location: Melbourne, Australia

Budget: Recommended by industry experts

Time to start: As soon as possible

Project description:
"Land Tax Calculator – Developer Requirements ([login to view URL])
1) Project Goal

Develop a Land Tax Calculator for [login to view URL] that replicates the logic and accuracy of our existing Excel model, making it publicly accessible and free to use.
The calculator should be:

Accurate and fast

Mobile-friendly and visually consistent with our brand

Easy to maintain and update annually (without coding knowledge)

For inspiration and reference, visit: [login to view URL]

2) Scope & Deliverables

In Scope

Public-facing calculator (single web page + optional embeddable version)

Logic replication from our Excel file for all Australian states and territories

Results displayed clearly with tiered breakdown and explanatory notes

Editable configuration files for thresholds and rates

SEO-friendly setup and analytics integration

Documentation for future maintenance

Deliverables

Functional and styled web calculator

Calculation logic (engine) based on Excel formulas

Configuration files for yearly rate updates

Admin/update guide

QA parity testing against Excel results

Deployment on [login to view URL] (via shortcode, iframe, or embedded React app)

3) Key Features & User Flow

Inputs (minimum):

State/Territory: ACT, NSW, NT, QLD, SA, TAS, VIC, WA

Tax Year: Default to current financial year, with ability to select prior years if applicable

Aggregate Land Value (AUD): Allow user to enter one or multiple property values (if supported in Excel)

Optional toggles:

Principal Residence Exemption

Foreign or Absentee Surcharge

Trust/Company checkbox (if relevant in Excel model)

Regional concessions or other state-specific conditions

Outputs:

Total Land Tax payable

Detailed breakdown: base + marginal tiers + surcharges

Effective rate (% of land value)

Notes/explanations: short summary of applicable rules for that state

Download/Print option (PDF or print-friendly view)

Deep-link sharing: generate sharable URL with input values

UX Flow:

User selects state and enters land value

Optional toggles (PR exemption, surcharge, etc.)

Clicks Calculate

System displays result card with detailed breakdown

Option to print or share result link

4) Calculation Engine

Source of truth: The Excel model provided by Clear Tax

Parity requirement: The web calculator must match Excel results exactly across test cases

Design:

Stateless, modular calculation engine

Thresholds and rates stored externally (config file, not hardcoded)

Clean separation between UI and logic

Edge cases: Follow Excel rounding and boundary logic precisely

Aggregation: Must apply same aggregation logic as in Excel

5) Configuration & Updating

Annual rates, thresholds, and surcharges to be stored in editable JSON/YAML files

Developer to create an update guide explaining how to modify rates for new financial years

Optional: non-public “Rates Inspector” mode for internal review of thresholds

6) Validation & Error Handling

Numeric input only for land value (with $ formatting)

Prevent negative or unrealistic numbers

Friendly error messages for missing inputs

Graceful fallback if data for selected year/state is missing (“Data not available for this year”)

7) Data Structure Example

Input JSON

{
"state": "VIC",
"financialYear": "2025-26",
"landValue": 1250000,
"isPrincipalResidence": false,
"isForeignOwner": false,
"isAbsenteeOwner": false
}


Output JSON

{
"totalTax": 15350,
"effectiveRate": 0.0123,
"breakdown": [
{"label": "Base amount", "amount": 8750},
{"label": "Marginal tier", "amount": 5800, "details": {"rate": "0.8%", "range": "$1.0m–$1.3m"}},
{"label": "Foreign surcharge", "amount": 0}
],
"notes": [
"VIC 2025–26 thresholds applied.",
"Principal residence exemption not selected."
]
}

8) UI/UX Requirements

Design: Clean, minimal, and consistent with Clear Tax brand palette

Input controls: Dropdowns and sliders for state and year; formatted number inputs for value

Tooltips: Small “i” icons to explain key terms (we’ll provide copy)

Responsive: Works seamlessly on desktop, tablet, and mobile

Accessibility: WCAG 2.1 AA compliant

Performance: Sub-200ms calculation time

9) SEO & Analytics

Dedicated SEO-optimised page: /tools/land-tax-calculator

Add structured data (Calculator schema)

Integrate Google Analytics 4 events:

Calculator viewed

Calculation executed

Error encountered

Result shared

10) Tech Stack & Integration

Frontend: React, [login to view URL], or equivalent modern JS framework

Embedding: via shortcode (WordPress) or iframe for easy integration

Hosting: Client-side app (no backend processing required)

Maintenance: Config files can be updated annually by non-developers

11) Testing & Quality Assurance

Developer to test all states and tiers against the Excel source

Provide automated test cases to ensure parity

Conduct manual testing across browsers (Chrome, Safari, Edge) and devices

Lighthouse score targets:

Performance ≥ 90

Accessibility ≥ 95

SEO ≥ 95

12) Security & Privacy

No personal data stored or transmitted

All calculations occur locally in the browser

Share links contain only state, year, and land value — no sensitive data

13) Legal Disclaimer

Below the result, include:

“This calculator provides a general estimate based on published state rules and Clear Tax’s internal methodology. It does not constitute tax advice. Please seek personalised advice before making financial decisions.”

Include links to Terms of Use and Privacy Policy.

14) Handover & Documentation

Editor Guide: How to update rates/thresholds

Developer README: Setup, config structure, deployment steps

Test matrix: 3–5 sample test cases per state showing expected results

15) Timeline & Acceptance

Acceptance criteria:

Results match Excel exactly

All major states functional and validated

SEO, responsiveness, and accessibility targets achieved

Documentation complete

Timeline: Please propose delivery milestones (e.g., Week 1–Design, Week 2–Logic, Week 3–Integration, Week 4–Testing).

16) Optional Enhancements (Post-MVP)

Compare two scenarios (e.g., different years or values)

Save scenarios to local storage

Export results as PDF

Add trend visualisation (bar chart for each state)

17) Assets Provided
Excel file with calculations and test data
Clear Tax branding (fonts, colours, logo)
FAQ and disclaimer content
Test cases for validation

Developer to Provide:

Proposed tech stack and hosting approach
Estimated cost and delivery timeline
Maintenance proposal for annual rate updates
Examples of similar calculator projects previously built" (client-provided description)