Welcome to Selwise

What You Can Build With Selwise

Selwise provides storefront personalization, widgets, recommendations, search, and analytics with one runtime contract across web and mobile surfaces.

Three Integration Models

• CDN / script-tag: fastest onboarding with global runtime access.
• npm package: framework-owned lifecycle and explicit instance management.
• React Native SDK: headless mobile runtime with scoped API-key authentication.

Quick Start

CDN

<script
  src="https://widget.selwise.com/client.js"
  data-site-key="YOUR_SITE_KEY"
  data-api-url="https://api.selwise.com/api/v1"
></script>

npm

npm install @selwise/widget

import Selwise from '@selwise/widget';

const widget = new Selwise();
await widget.init({
  siteKey: 'YOUR_SITE_KEY',
  apiUrl: 'https://api.selwise.com/api/v1',
  exposeGlobal: true,
});

React Native

npm install @selwise/react-native @react-native-async-storage/async-storage

import Selwise from '@selwise/react-native';

const sdk = new Selwise();
await sdk.init({
  siteKey: 'YOUR_SITE_KEY',
  apiUrl: 'https://api.selwise.com/api/v1',
  apiKey: 'YOUR_MOBILE_API_KEY',
});

Start Here

• Installation
• Platform Playbooks
• CDN Integration
• npm Integration
• React Native Integration
• Initialization
• Verification
• Integration Troubleshooting

Runtime API Docs

• Public API
• Event Cookbook
• Event Reference
• Data Layer
• Consent Management
• Mobile Auth