> For the complete documentation index, see [llms.txt](https://crushsuite.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://crushsuite.gitbook.io/docs/developers/readme.md).

# Developer Docs

{% columns fullWidth="true" %}
{% column %}

### CrushSuite For Developers

Headless SDKs, compliance tools, and checkout flows that plug into Shopify or your custom storefront. Build faster with a simple API surface and battle-tested components.
{% endcolumn %}

{% column %}
{% code title="Import the SDK" %}

```
npm install @crushsuite/sdk
```

{% endcode %}

{% code title="Initialize" %}

```
import { createClient } from '@crushsuite/sdk'

export const crushSuiteClient = createClient({
  privateKey: process.env.CRUSH_SUITE_API_KEY!
});
```

{% endcode %}

**API keys:** Contact [CrushSuite Support](https://crushsuite.com/contact) to get your private and sandbox keys. Keep them in server-side environment variables, never in the browser.
{% endcolumn %}
{% endcolumns %}

### Everything you need to build

<table data-view="cards" data-full-width="true"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>API Reference</strong></td><td>Every CrushSuite API endpoint with its requests and responses. Use this if you call the API directly.</td><td>View API reference →</td><td></td><td><a href="https://developers.crushsuite.com/">https://developers.crushsuite.com/</a></td></tr><tr><td><strong>API SDK</strong></td><td>Typed SDK for interfacing with CrushSuite APIs. Run compliance checks, track events, and calculate fees.</td><td>View on npm →</td><td></td><td><a href="https://www.npmjs.com/package/@crushsuite/sdk">https://www.npmjs.com/package/@crushsuite/sdk</a></td></tr><tr><td><strong>React Components</strong></td><td>Prebuilt components for compliance display, age gating, shipping, and club membership flows.</td><td>View on npm →</td><td></td><td><a href="https://www.npmjs.com/package/@crushsuite/sdk">https://www.npmjs.com/package/@crushsuite/sdk</a></td></tr><tr><td><strong>Changelog</strong></td><td>SDK release notes and breaking changes, version by version.</td><td>View changelog →</td><td></td><td><a href="https://github.com/CrushSuite/crush-suite-sdk/blob/main/CHANGELOG.md">https://github.com/CrushSuite/crush-suite-sdk/blob/main/CHANGELOG.md</a></td></tr><tr><td><strong>GitHub</strong></td><td>Source code, issues, and contribution guidelines for the CrushSuite SDK.</td><td>View repo →</td><td></td><td><a href="https://github.com/CrushSuite/crush-suite-sdk">https://github.com/CrushSuite/crush-suite-sdk</a></td></tr></tbody></table>