# Install

## With a bundler (npm)

```bash
npm install @swiftware/gamma-sdk
```

```js
import {gamma} from '@swiftware/gamma-sdk';
```

The package ships ESM, CJS, and TypeScript types — works with Vite, webpack,
Rollup, esbuild, Next.js, etc.

## No build step (drop-in script)

If your game is plain HTML/JS with no bundler, use the single drop-in file. It
exposes a global `gamma`:

```html
<script src="https://cdn.jsdelivr.net/npm/@swiftware/gamma-sdk/dist/gamma-sdk.min.js"></script>
<script>
  gamma.ready().then(() => {
    gamma.getCoins().then((balance) => console.log('Balance:', balance));
  });
</script>
```

You can also self-host the file — copy `dist/gamma-sdk.min.js` from the package
next to your game and reference it locally.

## Requirements

- Any modern browser. The SDK is ~6 KB minified.
- Host app **GammaSDK ≥ 1.1.0** for `getCoinValue` (older hosts fall back to
  sensible defaults automatically).

Next: [Quickstart →](./quickstart.md)