Awesome
Shopify API and app tools for JavaScript
This repository contains packages you can use to interact with Shopify's APIs. You can use these packages to create clients for those APIs directly, or to create apps using TypeScript / JavaScript.
It is organized as a monorepo, which includes multiple packages that can be used together.
Packages
The packages in this repository can be used to extend Shopify in different ways:
API clients
These packages make it easy to interact with Shopify's APIs if you have the required access tokens.
| Package | Latest version | Description |
|---|---|---|
@shopify/admin-api-client |  | Client for the GraphQL and REST Admin APIs. |
@shopify/storefront-api-client |  | Client for the GraphQL Storefront API. |
@shopify/graphql-client |  | Generic GraphQL API client. |
@shopify/api-codegen-preset |  | Codegen preset for Shopify APIs. Automatically integrates with the clients above. |
Apps and middlewares
These packages make it easy to create Shopify apps with TS / JS using different tech stacks.
| Package | Latest version | Description |
|---|---|---|
@shopify/shopify-api |  | Framework and runtime agnostic library for Shopify OAuth, APIs, webhooks, and more. |
@shopify/shopify-app-remix |  | Implementation of @shopify/shopify-api to make it easy to create apps using Remix. |
@shopify/shopify-app-express |  | Implementation of @shopify/shopify-api to make it easy to create apps using Express. |
Session storage
These packages provide database-specific implementations to manage @shopify/shopify-api sessions.
| Package | Latest version | Description |
|---|---|---|
@shopify/shopify-app-session-storage |  | Provides the interfaces used by the app middleware packages to write custom packages. |
@shopify/shopify-app-session-storage-drizzle |  | Drizzle implementation of the session storage interface. |
@shopify/shopify-app-session-storage-dynamodb |  | DynamoDB implementation of the session storage interface. |
@shopify/shopify-app-session-storage-kv |  | Cloudflare KV implementation of the session storage interface. |
@shopify/shopify-app-session-storage-memory |  | Memory implementation of the session storage interface. |
@shopify/shopify-app-session-storage-mongodb |  | MongoDB implementation of the session storage interface. |
@shopify/shopify-app-session-storage-mysql |  | Mysql implementation of the session storage interface. |
@shopify/shopify-app-session-storage-postgresql |  | PostgreSQL implementation of the session storage interface. |
@shopify/shopify-app-session-storage-prisma |  | Prisma implementation of the session storage interface. |
@shopify/shopify-app-session-storage-redis |  | Redis implementation of the session storage interface. |
@shopify/shopify-app-session-storage-sqlite |  | SQLite implementation of the session storage interface. |
Developing in this repo
We use pnpm to develop this package, and we recommend using it for development to ensure your environment is consistent with ours.
To get started, install the dependencies, and build the packages:
cd shopify-app-js
pnpm install
pnpm build
Once the packages are built, you'll be able to make changes. Note that if you're working on multiple packages, you'll need to build them for changes to affect other packages.
We aim to add test coverage for every change to help prevent regressions. You can run the whole suite by running this at the root:
pnpm test
[!NOTE] Make sure to run
buildbeforetestto ensure the internal dependencies are available.
If you're only working on one package, you can build and run tests individually:
cd packages/<package>
pnpm build
pnpm test
When you're ready to test a package in an app, you can build it, and install it with a file: protocol in e.g. a Remix app:
cd packages/<package>
pnpm build
cd <app folder>
pnpm add "file:<path to shopify-app-js>/packages/<package>"
shopify app dev
To update the local package, run pnpm build in the package folder, and restart your app.