Quick start

npm install a widget in 3 lines.

The official Idukki SDK is now on npm. Thin loader-only package (~30 LOC published), all widget code stays on the CDN, all updates pull in automatically.

ESM + CommonJS, drop into Vite, Webpack, esbuild, Rollup, Next, Nuxt, Astro, Vercel, Netlify
Framework-agnostic, same call signature in React, Vue, Angular, Svelte, plain JS
No build step, the loader fetches the latest CDN runtime, you get bug fixes for free
Treeshakeable, only the loader entry point is included in your bundle

@idukki/widget-sdk

npm · ESM + CJS · framework-agnostic

v1.0.0

1Install

bash

npm i @idukki/widget-sdk

2Mount

Minimal, pass your gallery GUID:

import { IddukkiWidget } from '@idukki/widget-sdk';

IddukkiWidget.load('YOUR_GALLERY_GUID');

With business GUID + a specific container:

IddukkiWidget.load('YOUR_GALLERY_GUID', {
  bguid: 'YOUR_BUSINESS_GUID',
  container: document.getElementById('my-widget-slot'),
});

3Drop in any framework

import { useEffect } from 'react';
import { IddukkiWidget } from '@idukki/widget-sdk';

export default function GallerySection() {
  useEffect(() => {
    IddukkiWidget.load('YOUR_GALLERY_GUID');
  }, []);

  return <div id="my-widget-slot" />;
}

Your gallery GUID lives in the Idukki dashboard → Widget Settings → Embed Code.View on npm →

Developers

Build on Idukki

The UGC API your team wished existed.

OAuth 2, schema-validated REST + webhooks, single-file SDKs in TypeScript and Python, edge-rendered HTML payloads for headless / Composable storefronts.

Read the docs Talk to the platform team

Developers

Build on Idukki

npm SDK

npm SDK
npm i
Public REST API
OpenAPI 3.1
Webhooks
HMAC-SHA256 signed

Public REST APIlive

npm i
@idukki/widget-sdk
37 KB
Widget runtime · ESM
OAuth 2
Auth + PKCE flows
OpenAPI 3.1
Machine-readable schema

01
npm SDK
@idukki/widget-sdk on npm. Loader-only package, 30 LOC published, all real widget code lives on the CDN so updates ship automatically.
- npm i @idukki/widget-sdk
- IddukkiWidget.load(GUID, options)
- React + Vue + Angular + vanilla examples in README
02
Public REST API
Read + write every UGC object: sources, posts, rights, layouts, experiments, reports.
- OpenAPI 3.1 schema you can import into Postman / Insomnia
- Cursor + offset pagination
- Per-token rate limiting
03
Webhooks
Subscribe to source changes, rights state, experiment winners, revenue events.
- HMAC-SHA256 signed payloads
- 12 typed event types
- Replay + filter in the dashboard
04
Single-file SDKs
TypeScript, Python and the framework-agnostic JS bundle. Drop into Next, Remix, Hydrogen, Astro, SvelteKit.
- Auto-generated from the OpenAPI spec
- < 10 KB SDK size
- Typed responses + retry helpers
05
Edge-rendered HTML
Every layout renders as a hydrated component or a server-rendered HTML payload from the API. Composable-friendly.
- Streaming server response
- Signed image URLs
- < 50ms TTFB at the edge
06
Marketplace listing
Build an integration on the API, list it in our marketplace, get co-marketed on launch.
- Co-marketed launch on /whats-new
- Joint customer-success motion
- Sandbox workspace + test data

"A 37 KB ESM bundle. CLS 0.001 P75. INP under 200ms. We finally have a UGC widget that doesn’t fight the rest of our perf budget."

Devon S. · Staff Engineer, Arc Electronics

Get an API key + sandbox

A real human replies within one business day with a sandbox workspace, an API key and a 30-minute call to walk through your stack.

Sandbox with seeded UGC, products, experiments
API key + webhook secret
Slack channel with the platform team for design partners

4-min setupDTC + B2B brands37 KB runtimeReal G2 reviews

Stop renting six tools. Ship one.

Spin up your first widget in 4 minutes. Migrate from Bazaarvoice, EmbedSocial, Tolstoy or Videowise in a day. Your CFO will love us. Your CRO already does.

Start 14-day free trial Book a 30-min demo