Nordcom Commerce

The Packages tab hosts authored narrative docs for every workspace package. Each entry explains purpose, API shape, and when to reach for it. The generated per-symbol API reference for the same workspace lives in the Reference tab.

Core packages

Package	Description
`@nordcom/commerce-cms`	The CMS toolkit: field descriptors, the editor the admin mounts at `/cms`, the block render layer, and the shared cache taxonomy. Content rows live in Convex.
`@nordcom/commerce-convex`	The Convex deployment: schema, table definitions, and the `db/` + `cms/` server functions.
`@nordcom/commerce-db`	The data-access seam over Convex. The only workspace that calls the Convex `db/*` functions. Exposes `ShopService`, `UserService`, `ReviewService`, `FeatureFlagService`.
`@nordcom/commerce-errors`	Typed, code-tagged error hierarchy shared by every package and app. Every `throw` in the platform uses a class from here.
`@nordcom/commerce-marketing-common`	Shared utilities for marketing logic across storefront and landing app.

Shopify packages

Package	Description
`@nordcom/commerce-shopify-graphql`	`gql.tada` setup, Apollo client factory (`ShopifyApolloApiClient`), and the `@inContext` document transform.
`@nordcom/commerce-shopify-html`	HTML/template rendering utilities for Shopify content (metafields, rich text).

TagTree packages

The @tagtree/* family provides typed, namespace-safe cache tags for Next.js tag-based cache invalidation. Each package covers one integration point.

Package	Description
`@tagtree/core`	Base tag schema, `safeCacheTag`, and the tag-builder primitives. All other `@tagtree/*` packages build on this.
`@tagtree/next`	Next.js-specific tag helpers — `unstable_cache` wrappers and page-level tag utilities.
`@tagtree/shopify`	Tag schema for Shopify entities (products, collections, orders). Used in Shopify webhook handlers.

UI packages

Package	Description
`react-payment-brand-icons`	SVG icon set for payment brand logos. Zero-dep React components.

Cart packages

The @nordcom/cart-* family handles shopping cart state and Shopify cart mutations.

Package	Description
`@nordcom/cart-core`	Framework-agnostic cart state model and mutation helpers.

Concept

@nordcom/commerce-test-convex (the local Convex backend launcher + canonical seed fixtures) and @nordcom/commerce-utils are internal dev/test utilities with no stable public API.

Continue exploring

Reference

API Reference

Generated per-symbol pages for every exported function, class, and type.

Concepts

Caching

How the TagTree packages are used for tag-based cache invalidation.

Concepts

CMS

How the CMS package integrates with the storefront via the Convex read functions.

Concepts

Errors