https://github.com/purchasing-power-parity/purchasing-power-parity

💫 Make your products affordable for everyone around the world.
https://github.com/purchasing-power-parity/purchasing-power-parity

javascript purchasing-power-parity

Last synced: 2 days ago
JSON representation

💫 Make your products affordable for everyone around the world.

• Host: GitHub
• URL: https://github.com/purchasing-power-parity/purchasing-power-parity
• Owner: purchasing-power-parity
• License: mit
• Created: 2017-10-29T14:28:00.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2023-12-20T01:29:38.000Z (12 months ago)
• Last Synced: 2024-12-03T20:02:26.086Z (10 days ago)
• Topics: javascript, purchasing-power-parity
• Language: JavaScript
• Homepage: https://purchasing-power-parity.com
• Size: 137 KB
• Stars: 643
• Watchers: 10
• Forks: 53
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Purchasing Power Parity

[![Build Status](https://travis-ci.org/rwieruch/purchasing-power-parity.svg?branch=master)](https://travis-ci.org/rwieruch/purchasing-power-parity)

Not everyone is able to pay for the default pricings of the western world. Online products should be made affordable for everyone around the world. This package is a simple way to make [Purchasing Power Parity](https://purchasing-power-parity.com) available in your browser. See how it could look like in your application for someone buying your product from another country:



## How to use it?

**Install:**

`npm install purchasing-power-parity`

**Use:**

```js

import fetchPPP from 'purchasing-power-parity';

let originalPrice = 99.99;

let discountPrice;

fetchPPP().then(response => {

  discountPrice = response.ppp.pppConversionFactor * originalPrice;

});

```

If you don't want to use this library, you can also use the [API](https://api.purchasing-power-parity.com/?target=ID) directly where you are able to pass the country code yourself. Otherwise, this library will figure out the location of the user itself.

After all, you can adjust your prices when the `pppConversionFactor` goes below 1 and add an optional banner for your customers to make them aware of it. What other information is in the returned PPP object?

**ppp-object:**

```js

{

  "countryCodeIsoAlpha2": "AR",

  "currenciesCountry": {

    "ARS": {

      "name": "Argentine peso",

      "symbol": "$"

    }

  },

  "countryCodeIsoAlpha3": "ARG",

  "currencyMain": {

    "exchangeRate": 99.148857,

    "name": "Argentine peso",

    "symbol": "$"

  },

  "ppp": 26.526,

  "pppConversionFactor": 0.2675371234990636

}

```

The `currencyMain.exchangeRate` and `ppp` property are used to compute the `pppConversionFactor`.

## Limitations

- runs only in the browser

- takes only USD as baseline

## Who uses PPP?

This node package was inspired by [Wes Bos](https://twitter.com/wesbos) who sells his courses with PPP. There are other people which make their products affordable to everyone around the world by using PPP. You can add your project/company/product/service/... to the list when you are using this package:

- [Road to React](https://roadtoreact.com/)

- ...

## Contribution

The project is in an early stage, so please feel free to contribute to it. It works, but it could be more robust and improved. If you want to know how PPP works, you can read up this [short article](https://www.sapling.com/6218206/calculate-purchasing-power-parity). I would love to see you contributing to it:

- create an Issue

- discuss with maintainers and contributors about the issue

- create a Pull Request if the issue should be solved