# Shopify/js-buy-sdk

The JS Buy SDK is a lightweight library that allows you to build ecommerce into any website. It is based on Shopify's API and provides the ability to retrieve products and collections from your shop, add products to a cart, and checkout.

Repository: https://github.com/Shopify/js-buy-sdk
Canonical: https://ross.abutalabs.com/products/js-buy-sdk
Homepage: https://shopify.github.io/js-buy-sdk
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2026-03-27T20:09:55+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 74, release rhythm 40, longevity 100
- inputs: {"age_days": 3894, "days_push": 159, "days_rel": 435, "gap_med": 6.5, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1018, forks 268 (observed 2026-08-28T04:03:14.788565+00:00)

## What it is
A lightweight JavaScript SDK for embedding Shopify ecommerce into any website, providing product retrieval, cart management, and checkout via Shopify's Storefront API. It was deprecated by Shopify in January 2025, with v3.0 as a final stopgap release using Cart APIs.

## Use cases
- add shopify products to a custom website
- build a headless shopify storefront in javascript
- retrieve products and collections from a shopify shop
- add items to a cart and checkout from a web app
- embed ecommerce into an existing site without a full rebuild

## When to choose
- maintaining an existing integration that already uses the JS Buy SDK and only needs the v3.0 Cart API stopgap
- a legacy project where migrating to the Storefront API Client is not yet feasible

## When to avoid
- starting a new Shopify headless project - use the Storefront API Client instead
- you need ongoing updates, support, or new Shopify API features
- your checkout flows rely on the deprecated Checkout APIs past the July 2025 deadline

## Facets
- artifact type: library
- maturity: abandoned
- function: sdk, http-client, graphql-client
- domain: e-commerce, web-development, apis
- platform: browser
- tags: shopify, storefront-api, ecommerce, deprecated, cart-api, checkout, nodejs, javascript

## Member repositories
- Shopify/js-buy-sdk (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:14.788565+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:09:26.836127+00:00, confidence not recorded.
  - readme: https://github.com/Shopify/js-buy-sdk (fetched 2026-08-28T04:03:14.788565+00:00, sha ef4f4c44b3ba)
  - homepage: https://shopify.github.io/js-buy-sdk (fetched 2026-08-29T13:09:49.992308+00:00, sha a22ecc098ec4)
- Data as of 2026-08-30T08:39:29.467469+00:00.