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.
npm install salary-calculatorThere are several scenarios. Pick the one that suits you the best.
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-calculatorIf 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>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.
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.
Contributions are welcome.
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.
-
git clone [email protected]:teamniteo/salarycalc.git && cd salarycalc -
nix-shellordirenv 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
maketo compile a production-optimized code indist/directory.It will also run tests (with coverage analysis) and linters.
Thanks for your interest in our project. We are open to learn about any issues and for your pull requests.