Overview
NubeSDK
Build powerful e-commerce apps for the Nuvemshop ecosystem — secure by design, fast to develop, and ready to scale.
What is NubeSDK?
NubeSDK is the official toolkit for building third-party applications that run directly inside Nuvemshop storefronts and checkouts. Apps are hosted inside Web Workers in the browser — an isolated sandbox that guarantees two applications can never interfere with each other or with the store itself.
Instead of manipulating the DOM, your app communicates with the platform through a structured event system and renders UI into predefined slots. The result is a safer, more stable ecosystem where every app is a first-class citizen.
Why NubeSDK
Built for security, speed, and developer happiness
Everything you need to build reliable storefront and checkout apps.
Secure & Isolated
Every app runs in its own Web Worker sandbox — no DOM access, no interference with other apps, no risk to store stability. Merchants install with confidence.
Event-Driven Architecture
No fragile DOM manipulation. Subscribe to meaningful commerce events like cart:update and shipping:select — your apps stay resilient across theme changes.
TypeScript + JSX
Fully typed events, state, and components. Write UI with familiar JSX syntax or a lightweight declarative API. Autocompletion and compile-time safety included.
Theme-Aware Styling
Built-in theme tokens for colors, typography, and spacing. Your app looks native on every store — zero custom CSS per merchant.
Ship in Minutes
One command to scaffold. Hot reload in development. Testing and linting out of the box. Chrome DevTools extension for real-time debugging.
Your Path
From idea to the App Store
Four steps to go from zero to a published application.
Create
Register your app in the Partner Portal and scaffold the project
Develop
Build features with events, components, and theme-aware styling
Test
Debug with DevTools, run unit tests, and validate on a demo store
Publish
Submit for homologation and launch on the Nuvemshop App Store
Possibilities
Extend every part of the shopping journey
Storefront and checkout — 40+ insertion points for pixel-perfect placement.
Product Pages
Badges, stock counters, size guides, custom fields
Cart
Validation, upsells, line item details, summaries
Checkout
Custom forms, shipping labels, payment info, coupons
Shipping
Option selection, label overrides, delivery estimates
Overlays
Banners, modals, corner widgets, toasts, drawers
import type { NubeSDK } from "@tiendanube/nube-sdk-types"; export function App(nube: NubeSDK) { nube.on("cart:update", handler); // React to commerce events nube.send("cart:validate", modifier); // Dispatch actions nube.render("slot_name", component); // Place UI in slots nube.getState(); // Read current state nube.getBrowserAPIs(); // Storage & navigation }
Architecture
Simple, powerful, and safe
Your app runs in a Web Worker and communicates with the store through a structured event bus. One function, one object, infinite possibilities.
Everything Included
Features at a glance
A complete toolkit — from UI components to browser APIs.
Commerce Events
Cart, checkout, shipping, coupons, orders
UI Slots
40+ storefront and checkout insertion points
Component Library
Buttons, fields, accordions, modals, toasts
CSS-in-JS Styling
styled(), StyleSheet.create(), keyframes
Theme Tokens
Colors, typography, spacing per store
Browser APIs
Async storage with TTL, navigation, iframes
SVG Support
Full primitives for custom graphics
DevTools Extension
Inspect state, events, and slots live
Ready to build?
Set up your first NubeSDK app in under 10 minutes.
Start Building