salary-calculator
v0.1.1-2024-02-07T13-35-44.0
Published
Elm engine running the Niteo Salary Calculator
Downloads
85
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 [email protected]:teamniteo/salarycalc.git && cd salarycalc
nix-shell
ordirenv 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 indist/
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.