https://github.com/jaysonmulwa/taxable
NPM Package - A library of income tax calculation functions from various countries around the world.
https://github.com/jaysonmulwa/taxable
node-module tax
Last synced: 5 months ago
JSON representation
NPM Package - A library of income tax calculation functions from various countries around the world.
- Host: GitHub
- URL: https://github.com/jaysonmulwa/taxable
- Owner: jaysonmulwa
- License: mit
- Created: 2020-08-30T15:46:46.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-06-28T16:45:36.000Z (almost 3 years ago)
- Last Synced: 2025-09-15T14:37:04.469Z (9 months ago)
- Topics: node-module, tax
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/taxable
- Size: 66.4 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://www.codefactor.io/repository/github/jaysonmulwa/taxable)
[](https://github.com/jaysonmulwa/taxable/)
A library of income tax calculation functions from various countries around the world.
## Installation
This is a [Node.js](https://nodejs.org/en/) module available through the
[npm registry](https://www.npmjs.com/).
Before installing, [download and install Node.js](https://nodejs.org/en/download/).
Node.js 0.10 or higher is required.
If this is a brand new project, make sure to create a `package.json` first with
the [`npm init` command](https://docs.npmjs.com/creating-a-package-json-file).
Installation is done using the
[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):
```bash
$ npm install taxable
```
## Full API
### 1. Kenya 
#### Reference
- amount - Amount - Refers to the gross amount.
- takes in a value from (0.00 upwards)
- basic_pay - Basic Pay - Refers to the Basic pay
- takes in a value from (0.00 upwards)
- benefits - Benefits - Refers to allowances and other earnings that contribute to the basic pay.
- takes in a value from (0.00 upwards)
- insurance_relief - Insurance Relief - Refers to the insurance relief offered if it exists.
- takes in a value from (0.00 upwards)
- new_rates - New Rates - Whether or not to use the new rates.
- takes (true, false)
- tier - Tier - This refers to the tier
- takes values (1,2)
- 1 for nssf tier 1
- 2 for both nssf tier 1 and 2
#### Usage Example
```js
const taxable = require("taxable");
let result_1 = taxable.KE.NHIF({ amount: 10000 });
console.log(result_1);
let result_2 = taxable.KE.PAYE({
basicPay: 22000,
benefits: 2000,
insuranceRelief: 0,
}); //All add up to make Gross
console.log(result_2);
let result_3 = taxable.KE.NSSF({ amount: 9000, newRates: true, tier: 2 }); //Amount is Gross Pay or Pensionable amount
console.log(result_3);
```
## Contributing
- Read the Contributing guide
- Contact me jayson.mulwa@gmail.com for assistance
## License
[MIT](LICENSE)