npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

teserakto-shop

v1.0.11

Published

Shop SDK for Teserakto

Downloads

1,206

Readme

Teserakto Shop SDK

The Teserakto Shop SDK allows merchants to embed a fully functional storefront, cart, and checkout into any website using a simple JavaScript integration.

The SDK fetches products and customization settings from the Teserakto API and renders the UI using React.


Features

  • Render a product storefront
  • Embedded shopping cart
  • Customizable checkout flow
  • Remote UI customization
  • Responsive layout (desktop / tablet / phone)
  • Fast client-side rendering

Installation

Option 1 — CDN (Recommended for simple websites)

Add the SDK script to your page.

<script src="https://cdn.teserakto.com/sdk/v1/shop-widget.umd.js"></script>

Add containers where the shop and cart should render.

<div id="teserakto-shop"></div>
<div id="teserakto-cart"></div>

Initialize the SDK.

<script>
TeseraktoShopSDK.init("YOUR_API_KEY", "/checkout");
</script>

Checkout Page

On your checkout page include the checkout container and initialize the checkout SDK.

<div id="teserakto-checkout"></div>

<script src="https://cdn.teserakto.com/sdk/v1/shop-widget.umd.js"></script>

<script>
TeseraktoShopSDK.initCheckout("YOUR_API_KEY");
</script>

Installation via NPM

If you are using React, Vite, Next.js, or another modern framework, install the SDK via npm.

npm install teserakto-shop-sdk

Then import and initialize it.

import { TeseraktoShopSDK } from "teserakto-shop-sdk";

TeseraktoShopSDK.init("YOUR_API_KEY", "/checkout");

Required HTML Containers

The SDK renders into specific DOM containers.

Storefront

<div id="teserakto-shop"></div>

Cart

<div id="teserakto-cart"></div>

Checkout

<div id="teserakto-checkout"></div>

API

init(apiKey, checkoutUrl)

Initializes the storefront and cart.

| Parameter | Type | Description | |-----------|------|-------------| | apiKey | string | Merchant API key | | checkoutUrl | string | URL of the checkout page |

Example:

TeseraktoShopSDK.init("pk_live_123456", "/checkout");

initCheckout(apiKey)

Initializes the checkout page.

| Parameter | Type | Description | |-----------|------|-------------| | apiKey | string | Merchant API key |

Example:

TeseraktoShopSDK.initCheckout("pk_live_123456");

How It Works

When initialized, the SDK performs the following steps:

  1. Fetches products from the Teserakto API
  2. Fetches UI customization settings
  3. Normalizes device-specific configuration
  4. Renders React components into the provided containers

Example Integration

Store Page

<!DOCTYPE html>
<html>
<head>
  <title>My Store</title>
</head>
<body>

<nav> 
    <div>My Store Logo</div>
    <div id="teserakto-cart"></div>
</nav>

<div id="teserakto-shop"></div>

<script src="https://cdn.teserakto.com/sdk/v1/shop-widget.umd.js"></script>

<script>
TeseraktoShopSDK.init("pk_live_123456", "/checkout");
</script>

</body>
</html>

Checkout Page

<!DOCTYPE html>
<html>
<head>
  <title>Checkout</title>
</head>
<body>

<div id="teserakto-checkout"></div>

<script src="https://cdn.teserakto.com/sdk/v1/shop-widget.umd.js"></script>

<script>
TeseraktoShopSDK.initCheckout("pk_live_123456");
</script>

</body>
</html>

Error Handling

If required containers are missing, the SDK will log an error such as:

[TeseraktoShopSDK] No container found for shop or cart

If API requests fail, the SDK displays a fallback error message in the UI.


Development

Install dependencies:

npm install

Run development mode:

npm run dev

Build the SDK:

npm run build

The built files will appear in:

dist/

License

MIT License