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 setup1,400+ brands37 KB runtime5.0 G2

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