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

# Overview

> Overview of the Swish SDK's public API surface.

The Swish SDK is available on the storefront as `window.swish` after initialization.

```js theme={null}
const swish = window.swish;

// Or wait for it
document.addEventListener("swish-ready", () => {
  const swish = window.swish;
});
```

## API reference

> [card] [Configuration](https://swish.app/docs/references/sdk/configuration.md)
>
> Options for createSwish() - design tokens, features, components, and
> intents.

> [card] [Intents](https://swish.app/docs/references/sdk/intents.md)
>
> Trigger actions like saving a product, opening a list, or starting a
> checkout.

> [card] [State](https://swish.app/docs/references/sdk/state.md)
>
> Reactive signals for tracking saved item state, context, and counts.

> [card] [Elements](https://swish.app/docs/references/sdk/elements.md)
>
> Drop-in swish-save and swish-drawer custom elements for Liquid themes.

> [card] [Placements](https://swish.app/docs/references/sdk/placements.md)
>
> Insert Swish buttons into your theme using DOM observation.

> [card] [Events](https://swish.app/docs/references/sdk/events.md)
>
> Subscribe to item, list, cart, and notification events.

> [card] [API client](https://swish.app/docs/references/sdk/api-client.md)
>
> Query and mutate saved items, lists, orders, and notifications.

> [card] [Storefront API](https://swish.app/docs/references/sdk/storefront.md)
>
> Load products, images, and recommendations from the Shopify Storefront API.

> [card] [Utilities](https://swish.app/docs/references/sdk/utilities.md)
>
> Clipboard, share URLs, and programmatic UI element creation.

> [card] [Examples](https://swish.app/docs/references/sdk/examples.md)
>
> Save button, header badge, custom wishlist page, and drawer tabs - as
> elements, state helpers, and React.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.