> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cadanapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Add the gross-to-net salary calculator to your website

## Quick Start

Copy and paste this snippet into your web page:

```html HTML theme={null}
<div style="width:900px">
  <script async src="https://widgets.cadanapay.com/calculators/salary.js?key=YOUR_PUBLIC_API_KEY"></script>
</div>
```

The widget automatically loads and replaces the script tag. Users can immediately start calculating salaries for 150+ countries. All styling is isolated with Shadow DOM — no conflicts with your existing CSS.

**Before you start:**

* Get your Public API key from your [Dashboard](https://app.cadanapay.com)
* Add your domain to the API key's whitelist

<Note>
  For security, Cadana enforces domain whitelisting to ensure your embedded calculator only renders on trusted websites you own and control. The widget displays an error if loaded from an unauthorized domain.
</Note>

<Warning>
  Use your **public** Cadana API key (prefix `cdpk_`). Never embed a secret or server-side key in client-side code.
</Warning>

***

## Widget URLs

| Environment | URL                                                       |
| :---------- | :-------------------------------------------------------- |
| Production  | `https://widgets.cadanapay.com/calculators/salary.js`     |
| Staging     | `https://dev-widgets.cadanapay.com/calculators/salary.js` |

ESM versions are also available at the same paths with `.mjs` extension.

<Tip>
  Use the staging URL for testing and development. The production URL should only be used for live websites.
</Tip>

**Try it first:** [Interactive demo](https://dev-widgets.cadanapay.com/demo/salary-calculator.html) — experiment with themes, config, and settings before implementing. You can copy the generated code directly into your website.

For more control over integration, see [Full Integration Options](/tools/calculator/full-integration).