Getting Started
Installation & Setup
Install the SDK and create your first storefront client
Install
npm install @behio/storefront-sdkCreate Client
import { BehioStorefront } from '@behio/storefront-sdk';
const client = new BehioStorefront({
apiKey: 'pk_live_your_key',
});Options
| Option | Type | Default | Description |
|---|---|---|---|
apiKey | string | required | Your public API key (pk_live_...) |
locale | string | — | Default locale for all requests |
currency | string | — | Default currency for all requests |
timeout | number | 30000 | Request timeout in ms |
retries | number | 1 | Retry count on 5xx / network errors |
retryDelay | number | 1000 | Base delay between retries in ms |
fetch | typeof fetch | globalThis.fetch | Custom fetch implementation (for SSR) |
Modules
client.catalog // Products, categories, search, bundles
client.auth // Register, login, tokens
client.cart // Cart items, discounts, gift cards
client.checkout // Create orders
client.orders // Order list, detail, tracking
client.customer // Profile, addresses
client.wishlist // Wishlist management
client.reviews // Product reviews
client.returns // Return requests
client.consent // Cookie consent (GDPR)
client.quotes // B2B quotes
client.pages // CMS pages