README

💷 Tax Calculator UK (2021/22) 💷

This package give you an income tax breakdown based on a yearly salary.

Installation

You can install the package via npm or yarn.

npm install tax-calculator-uk

yarn add tax-calculator-uk

Setup

You will need to import the package into your project and create an options object with the following options.

import TaxCalculator from "tax-calculator-uk"

const options = {
    age: 26,
    studentLoanPlan: 1,
    blind: false,
    pensionPercentage: 5
}

const incomeTax = TaxCalculator(60000, options)

Options

age - Number

This options reprents the age of the person you are calculating the income tax form.

studentLoanPlan - Number

This option represents the student loan plan of the person you are calculating the income tax for.

0 - No plan
1 - Plan 1
2 - Plan 2

Plan 1

English and Welsh students who started before 1 September 2012
all Scottish and Northern Irish students
You pay back 9% of your income over the minimum amount of £19,895.

Plan 2

Plan 2 is for English and Welsh students who started on or after 1 September 2012.
You pay back 9% of your income over the minimum amount of £27,295.

No plan

No repayments will be made as you have no student loan

blind - Boolean

This options represents whether or not the person is blind. Extra tax allowances are allocated for blind individuals.

pensionPercentage - Number

This option represents the percentage of their yearly salary the person is paying into a pension.

getTaxBreakdown

Returns a full breakdown of net income and tax deductions

import TaxCalculator from "tax-calculator-uk"

const incomeTax = incomeTax.getTaxBreakdown()

console.log(incomeTax)

Returns

{
    "netIncome": {
        "yearly": 38108.03,
        "monthly": 3175.67,
        "weekly": 732.85,
        "daily": 104.41
    },
    "personalAllowance": 12500,
    "paye": {
        "rate_0": {
            "tax": 0,
            "carry": 45125
        },
        "rate_20": {
            "tax": 7500,
            "carry": 7625
        },
        "rate_40": {
            "tax": 3050,
            "carry": 0
        },
        "rate_45": {
            "tax": 0,
            "carry": 0
        }
    },
    "nationalInsurance": {
        "rate_0": {
            "tax": 0
        },
        "rate_12": {
            "tax": 4862.88
        },
        "rate_2": {
            "tax": 199.52
        }
    },
    "studentLoan": {
        "plan": "PLAN_1",
        "threshold": 17775,
        "rate": 0.09,
        "repayment": 3800.25
    }
}

󠁧󠁢󠁮󠁩󠁲󠁿

🚧 The figures are only used a rough estimation, happy to accept forks to improve accuracy of figures. 🚧

Usage no npm install needed!