Skip to content

jeevan-vj/nz-salary-calculator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 

Repository files navigation

NZ Salary Calculator

A modern web application for calculating New Zealand salary tax deductions and take-home pay.

Features

  • Real-time PAYE tax calculations
  • Support for different pay periods (weekly, fortnightly, monthly, yearly)
  • KiwiSaver contribution calculator
  • Student loan repayment calculator
  • ACC levy calculations
  • Interactive salary distribution chart
  • Dark/Light theme support
  • Mobile-responsive design
  • SEO optimized with meta tags and sitemap
  • Accessibility compliant

Tech Stack

  • Framework: Next.js
  • Language: TypeScript
  • Styling: Tailwind CSS
  • Animations: Framer Motion
  • State Management: React Hooks
  • SEO: Dynamic meta tags, Sitemap generation
  • Data Visualization: Custom charts

Tax Calculations

  • Up-to-date 2023-2024 tax brackets
  • PAYE tax rates
  • ACC levy (1.39%)
  • KiwiSaver contributions (configurable rate)
  • Student loan repayments (12% of income)

Development

  1. Clone the repository
  2. Install dependencies:

Getting Started

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Roadmap

Enhanced Tax Scenarios

  • Multiple income sources calculator
  • Secondary tax rate calculations
  • Overtime and holiday pay calculations
  • Tax credit calculations
  • Different tax years comparison

Advanced Salary Analysis

  • Salary comparison with industry averages
  • Cost of living adjustments by region
  • Inflation impact calculator
  • Saving goals calculator
  • Net worth tracker

KiwiSaver Enhancements

  • KiwiSaver growth projections
  • Employer contribution calculator
  • First home withdrawal calculator
  • Different fund type comparisons
  • Government contribution calculations

Export & Reporting

  • PDF report generation
  • Email results functionality
  • Save calculations history
  • Compare multiple scenarios
  • Data export in CSV/Excel

Visualization Improvements

  • User Preferences
  • Save favorite calculations
  • Custom tax scenarios
  • Personalized dashboard
  • User accounts integration
  • Calculation history

Mobile & Accessibility

  • Screen reader optimizations
  • Keyboard navigation
  • High contrast mode
  • Font size controls
  • ARIA labels enhancement

Integration Features

  • Share results on social media
  • Integration with accounting software
  • Calendar reminders for tax dates
  • API endpoints for calculations
  • Webhook support

Educational Content

  • Tax tips and guides
  • Interactive tutorials
  • FAQ section
  • Tax updates notifications
  • Video explanations

Progressive Web App Features

  • Offline support
  • Push notifications
  • App-like experience
  • Auto-updates
  • Install prompts