Version Packages (canary)

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to canary, this PR will be updated.

Releases

@bigcommerce/catalyst@1.0.0

Major Changes

• #3077 a45ab43 Thanks @jorgemoya! - Introducing the Catalyst CLI (@bigcommerce/catalyst) — a single command-line tool for scaffolding, building, and deploying your Catalyst storefront to BigCommerce's Native Hosting infrastructure.

  Highlights

  • Scaffold a storefront — catalyst create downloads a clean, standalone project (flattened from core/, workspace: dependencies resolved to published versions, fresh git repo) via tarball extraction and connects it to your BigCommerce store. The package manager is auto-detected from npm_config_user_agent.
  • Browser-based authentication — Run catalyst auth login to authenticate via an OAuth device code flow. Credentials are stored locally in .bigcommerce/project.json for use by all subsequent commands. CI/CD environments can use --store-hash and --access-token flags or environment variables instead.
  • Project & channel management — Create, link, and list BigCommerce infrastructure projects with catalyst project, and connect storefront channels with catalyst channel.
  • Build & deploy — catalyst build runs the OpenNext Cloudflare build pipeline (deriving the Wrangler compatibility_date dynamically) and generates deployment artifacts. catalyst deploy bundles, uploads, and deploys your storefront with real-time progress streaming. Pass runtime secrets with --secret KEY=VALUE; environment variables are auto-detected as deploy secrets.
  • Persisted deployment env vars — Manage deployment environment variables across deploys with catalyst env (list and remove; values are masked).
  • Custom domains — Add, list, check the status of, and remove custom domains for a Native Hosting project with catalyst domains.
  • Local preview — catalyst start launches a local Cloudflare Workers preview of your built storefront via the OpenNext adapter.
  • Live & historical logs — catalyst logs tail streams real-time application logs with color-coded levels and auto-reconnect; catalyst logs query retrieves historical logs.
  • In-place upgrades — catalyst upgrade upgrades a project to a newer version via a resilient 3-way merge (git merge-tree, falling back to per-file git merge-file), producing resolvable conflict markers instead of ever aborting.
  • Smart credential resolution — Configuration is resolved in priority order: CLI flags → --env-file → process environment variables → .bigcommerce/project.json.
  • Telemetry — Anonymous usage telemetry with session and correlation IDs for support. Opt out anytime with catalyst telemetry disable.

  Commands

  Command	Description
  catalyst create	Scaffold and connect a Catalyst storefront to your BigCommerce store
  catalyst auth	Authenticate, sign out, and verify stored credentials
  catalyst project	Create, link, and list infrastructure projects
  catalyst channel	Connect a storefront channel to your project
  catalyst build	Build your Catalyst project for deployment
  catalyst deploy	Build and deploy to BigCommerce Native Hosting
  catalyst env	Manage persisted deployment environment variables
  catalyst domains	Manage custom domains for a Native Hosting project
  catalyst start	Start a local Cloudflare Workers preview
  catalyst logs	Stream live logs and query historical logs
  catalyst upgrade	Upgrade a project to a newer version via 3-way merge
  catalyst version	Display CLI, Node.js, and platform info
  catalyst telemetry	View or change telemetry collection status

  Getting started

  cd core
  pnpm add @bigcommerce/catalyst@latest @opennextjs/cloudflare@1.17.3
  pnpm catalyst auth login
  pnpm catalyst project create
  pnpm catalyst deploy --secret BIGCOMMERCE_STORE_HASH=<hash> --secret BIGCOMMERCE_STOREFRONT_TOKEN=<token>

  For full documentation, see the Native Hosting Overview and CLI Reference.

@bigcommerce/create-catalyst@2.0.0

Major Changes

• #3077 a45ab43 Thanks @jorgemoya! - Reduce create-catalyst to a thin wrapper that delegates to catalyst create. pnpm create catalyst / npx create-catalyst still scaffold a project — now by invoking @bigcommerce/catalyst under the hood — so the scaffolding UX is unchanged. The standalone init, integration, and telemetry subcommands are removed; use catalyst channel link and catalyst telemetry from the consolidated CLI instead.

Patch Changes

• Updated dependencies [a45ab43]:
  • @bigcommerce/catalyst@1.0.0

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
catalyst	Ready	Preview, Comment	Jul 1, 2026 10:47pm

[github-actions]

Unlighthouse Performance Comparison — Vercel

Comparing PR preview deployment Unlighthouse scores vs production Unlighthouse scores.

Summary Score

Aggregate score across all categories as reported by Unlighthouse.

	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
Score	90	93	92	95

Category Scores

Category	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
Performance	71	89	71	79
Accessibility	95	98	95	92
Best Practices	100	100	100	100
SEO	88	100	100	100

Core Web Vitals

Metric	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
LCP	4.8 s	3.7 s	4.4 s	5.6 s
CLS	0.037	0	0.037	0
FCP	1.2 s	1.2 s	1.2 s	1.1 s
TBT	0 ms	10 ms	30 ms	0 ms
Max Potential FID	50 ms	70 ms	70 ms	50 ms
Time to Interactive	4.8 s	3.7 s	6.1 s	5.6 s

Full Unlighthouse report →

[github-actions]

Bundle Size Report

Comparing against baseline from a45ab43 (2026-07-02).

No bundle size changes detected.