README

Niteo Salary Calculator

A web app to calculate a salary of a Niteo employee. Written in Elm programming language it runs entirely on the client side. You can see it in action on https://niteo.co/salary-calculator.

Installation

npm install salary-calculator

Usage

There are several scenarios. Pick the one that suits you the best.

Serve from a sub-directory

Assuming you have a website at https://example.com/ with content served from the public/ directory and want the calculator to be available at https://example.com/salary-calculator/, the easiest way is to copy (or link) the dist directory, like this:

cp -r node_modules/salary-calculator/dist/ public/salary-calculator

Embedding in custom HTML document

If you want to customize the stylesheet or want to embed it in your own HTML page, the easiest way is again to copy the dist/ directory and then use a <script> tag to import the dist/salary-calculator.js script. It exposes a global variable SalaryCalculator referencing the object with init method. This method takes a single argument - an HTML node where the app should be mounted. You also have to provide a Bootstrap compatible stylesheet. The complete HTML can look like this:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width">
    <title>Salary Calculator custom integration</title>
    <link
      href="https://stackpath.bootstrapcdn.com/bootswatch/4.3.1/darkly/bootstrap.min.css"
      rel="stylesheet"
      integrity="sha384-w+8Gqjk9Cuo6XH9HKHG5t5I1VR4YBNdPt/29vwgfZR485eoEJZ8rJRbm3TR32P6k"
      crossorigin="anonymous"
    >
    <script src="salary-calculator/salary-calculator.js" charset="utf-8">
    </script>
  </head>
  <body>
    <div id="salary-calculator-container">
    </div>
    <script charset="utf-8">
      SalaryCalculator.init(
        document.getElementById("salary-calculator-container")
      )
    </script>
  </body>
</html>

Using CommonJS or ES6 modules

You can also use it as a CommonJS module:

const SalaryCalculator = require("salary-calculator");

or ES6:

import * as SalaryCalculator from "salary-calculator"

This way it won't set any globals. The variable will be scoped to the module. Also you don't need to copy anything - just install and import. Otherwise it works the same as the HTML script tag.

What is the purpose of this project?

At Niteo we believe in open and fair way of doing business. That's why the salary system is completely transparent. Using this app you can see who earns how much and why. We hope other companies can use it for the same purpose.

Hacking

Contributions are welcome.

Prerequisites

You need to have Nix installed. Once you do, running nix-shell will drop you into a shell that has all the tooling required for development ready for you.

Additionally, to not have to remember to run nix-shell you can install http://direnv.com/ and you will be dropped into the Nix shell automatically when cd-ing into the project.

Local development

git clone git@github.com:teamniteo/salarycalc.git && cd salarycalc
nix-shell or direnv allow.
To start development server with hot reloading run make run.
To update currency rates, base salaries and location factors, run make config.
When you are happy with your code, run make to compile a production-optimized code in dist/ directory.

It will also run tests (with coverage analysis) and linters.

Contributing

Thanks for your interest in our project. We are open to learn about any issues and for your pull requests.

Usage no npm install needed!