// the find
Shopify/shopify-api-js
Shopify Admin API Library for Node. Accelerate development with support for authentication, graphql proxy, webhooks
This is Shopify's official Node.js library for building Shopify apps — OAuth, Admin API (REST + GraphQL), Storefront API, webhooks, and billing. It's been superseded: the repo now points to shopify-app-js as the maintained home. If you're starting a new Shopify app today, you should go there instead.
The runtime adapter pattern (Node, Cloudflare Workers, Web API) is genuinely well done — you write once and swap the runtime shim, which is rare for an official SDK. The GraphQL codegen preset with `#graphql` tag support gives you full type safety on your queries without a separate codegen config. Session handling covers both online and offline tokens cleanly, with the JWT session ID pattern for embedded apps. The migration guides from v5 through v9 are detailed and honest about breaking changes.
This repo is archived in everything but the git sense — last push was April 2024 and the README explicitly tells you to go elsewhere. Any issue you file here will get redirected. The REST resource layer is a legacy concern; Shopify is clearly pushing everyone to GraphQL, and the REST client in here will eventually become a dead end. The session storage abstraction is deliberately left for you to implement, which means you're writing boilerplate for every new project. The 'future flags' mechanism for opt-in behavior changes is a nice idea but adds cognitive overhead when you're trying to figure out what version of an API you're actually running.