chore: add deployment for native hosting by chanceaclark · Pull Request #2835 · bigcommerce/catalyst

chanceaclark · 2026-01-22T23:32:30Z

What/Why?

Testing

Migration

changeset-bot · 2026-01-22T23:32:34Z

⚠️ No Changeset found

Latest commit: 635906f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

vercel · 2026-01-22T23:32:35Z

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

Project	Deployment	Actions	Updated (UTC)
catalyst	Ready	Preview, Comment	Mar 18, 2026 6:47pm

chanceaclark · 2026-01-29T21:50:42Z

.github/workflows/native-hosting.yml

+      - name: Install Catalyst CLI
+        run: pnpm add @bigcommerce/catalyst@alpha @opennextjs/cloudflare
+        working-directory: core


If this is our example gh-action, should we conditionally run this if it's already installed?

I was thinking about this earlier this morning, I say we keep it until the create-catalyst CLI installs Native Hosting deps for you; technically if someone follows documentation correctly, they won't need this step but right now there's not a huge risk to leaving it in (unless we ship a breaking change to the CLI on alpha, or something similar, which installing @whatever could actually break things)

.github/workflows/native-hosting.yml

chanceaclark · 2026-01-29T22:02:46Z

.github/workflows/native-hosting.yml

+      - name: Catalyst Build
+        run: pnpm run build
+        working-directory: core
+        # These environment variables are required for the build step to succeed
+        env:
+          AUTH_SECRET: ${{ secrets.NATIVE_HOSTING_AUTH_SECRET }}
+          BIGCOMMERCE_CHANNEL_ID: ${{ vars.NATIVE_HOSTING_BIGCOMMERCE_CHANNEL_ID }}
+          BIGCOMMERCE_STORE_HASH: ${{ vars.NATIVE_HOSTING_BIGCOMMERCE_STORE_HASH }}
+          BIGCOMMERCE_STOREFRONT_TOKEN: ${{ secrets.NATIVE_HOSTING_BIGCOMMERCE_STOREFRONT_TOKEN }}
+          BIGCOMMERCE_PROJECT_UUID: ${{ secrets.NATIVE_HOSTING_BIGCOMMERCE_PROJECT_UUID }}
+          OPEN_NEXT_DEBUG: true
+
+      - name: Catalyst Deploy
+        run: |
+          pnpm run deploy \
+            --secret BIGCOMMERCE_STORE_HASH=${{ vars.NATIVE_HOSTING_BIGCOMMERCE_STORE_HASH }} \
+            --secret BIGCOMMERCE_STOREFRONT_TOKEN=${{ secrets.NATIVE_HOSTING_BIGCOMMERCE_STOREFRONT_TOKEN }} \
+            --secret BIGCOMMERCE_CHANNEL_ID=${{ vars.NATIVE_HOSTING_BIGCOMMERCE_CHANNEL_ID }} \
+            --secret AUTH_SECRET=${{ secrets.NATIVE_HOSTING_AUTH_SECRET }} \
+            --secret OPEN_NEXT_ERROR_LOG_LEVEL=debug
+        working-directory: core
+        # These environment variables are for the deploy command only
+        # Added here to avoid polluting the run script with additional flags
+        env:
+          BIGCOMMERCE_ACCESS_TOKEN: ${{ secrets.NATIVE_HOSTING_BIGCOMMERCE_ACCESS_TOKEN }}
+          BIGCOMMERCE_PROJECT_UUID: ${{ secrets.NATIVE_HOSTING_BIGCOMMERCE_PROJECT_UUID }}
+          BIGCOMMERCE_STORE_HASH: ${{ vars.NATIVE_HOSTING_BIGCOMMERCE_STORE_HASH }}


I think the conversation we are having in Slack is crucial to this mess.

I think building during the deploy command will resolve having two commands.

The separation of CLI environment variables vs. Build-time environment variables vs. runtime environment variables is a topic of conversation.

- Remove pull_request trigger (no preview deployments) - Add concurrency group to prevent parallel deploys - Remove jq package.json mutation, use pnpm exec directly - Add separate generate step for GraphQL types - Fix env vars to CATALYST_* namespace for CLI commands - Remove --framework flag (removed in alpha) - Add --prebuilt to deploy (skip redundant build) - Add BIGCOMMERCE_API_HOST for integration API

github-actions · 2026-03-18T18:48:18Z

Bundle Size Report

Comparing against baseline from f3075ef (2026-03-18).

No bundle size changes detected.

github-actions · 2026-03-18T18:59:24Z

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	92	94	91	95

Category Scores

Category	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
Performance	78	88	77	91
Accessibility	95	95	95	95
Best Practices	100	100	95	100
SEO	100	100	100	100

Core Web Vitals

Metric	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
LCP	3.5 s	3.9 s	3.4 s	3.5 s
CLS	0	0.039	0	0.002
FCP	1.1 s	1.2 s	1.2 s	1.2 s
TBT	0 ms	10 ms	0 ms	0 ms
Max Potential FID	50 ms	60 ms	50 ms	50 ms
Time to Interactive	3.5 s	3.9 s	3.4 s	3.6 s

Full Unlighthouse report →

chanceaclark force-pushed the chore/native-hosting-deployment branch 3 times, most recently from 1874cbb to 34ab11c Compare January 22, 2026 23:38

vercel bot deployed to Preview January 22, 2026 23:41 View deployment

chanceaclark force-pushed the chore/native-hosting-deployment branch from 34ab11c to 55d7370 Compare January 22, 2026 23:45

vercel bot deployed to Preview January 22, 2026 23:47 View deployment

chanceaclark force-pushed the chore/native-hosting-deployment branch from 55d7370 to 080a96c Compare January 22, 2026 23:50

vercel bot deployed to Preview January 22, 2026 23:53 View deployment

chanceaclark force-pushed the chore/native-hosting-deployment branch from 080a96c to 5deedda Compare January 22, 2026 23:57

vercel bot deployed to Preview January 23, 2026 00:00 View deployment

chanceaclark force-pushed the chore/native-hosting-deployment branch 2 times, most recently from bf2eea0 to 6751f5b Compare January 23, 2026 00:09

vercel bot deployed to Preview January 23, 2026 00:11 View deployment

chanceaclark force-pushed the chore/native-hosting-deployment branch from 6751f5b to 3b845ca Compare January 28, 2026 18:30

vercel bot deployed to Preview January 28, 2026 18:32 View deployment

chanceaclark force-pushed the chore/native-hosting-deployment branch from 3b845ca to 2d04f60 Compare January 28, 2026 20:06

vercel bot deployed to Preview January 28, 2026 20:08 View deployment

chanceaclark force-pushed the chore/native-hosting-deployment branch from 2d04f60 to edb20d5 Compare January 28, 2026 20:14

vercel bot deployed to Preview January 28, 2026 20:16 View deployment

chanceaclark commented Jan 29, 2026

View reviewed changes

chanceaclark force-pushed the chore/native-hosting-deployment branch from edb20d5 to 3667a9b Compare January 29, 2026 22:04

vercel bot deployed to Preview January 29, 2026 22:07 View deployment

vercel bot deployed to Preview February 13, 2026 20:57 View deployment

chanceaclark force-pushed the chore/native-hosting-deployment branch from 47c486b to e001d8e Compare February 13, 2026 20:59

vercel bot deployed to Preview February 13, 2026 21:01 View deployment

chanceaclark force-pushed the chore/native-hosting-deployment branch from e001d8e to ae567fe Compare February 20, 2026 00:48

vercel bot deployed to Preview February 20, 2026 00:50 View deployment

chanceaclark force-pushed the chore/native-hosting-deployment branch from ae567fe to 4ed085f Compare February 20, 2026 00:56

vercel bot deployed to Preview February 20, 2026 00:58 View deployment

chanceaclark force-pushed the chore/native-hosting-deployment branch from 4ed085f to 228ff5a Compare February 20, 2026 21:40

vercel bot deployed to Preview February 20, 2026 21:43 View deployment

matthewvolk changed the base branch from canary to alpha March 17, 2026 17:54

matthewvolk force-pushed the chore/native-hosting-deployment branch from 228ff5a to 5e2bc7a Compare March 17, 2026 17:57

vercel bot deployed to Preview March 17, 2026 17:59 View deployment

jorgemoya force-pushed the alpha branch from 8794db1 to 062918c Compare March 18, 2026 18:43

chanceaclark and others added 2 commits March 18, 2026 13:46

chore: add deployment for native hosting

a30225c

matthewvolk force-pushed the chore/native-hosting-deployment branch from 5e2bc7a to 635906f Compare March 18, 2026 18:46

vercel bot deployed to Preview March 18, 2026 18:47 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

chore: add deployment for native hosting#2835

chore: add deployment for native hosting#2835
chanceaclark wants to merge 2 commits intoalphafrom
chore/native-hosting-deployment

chanceaclark commented Jan 22, 2026

Uh oh!

changeset-bot bot commented Jan 22, 2026 •

edited

Loading

Uh oh!

vercel bot commented Jan 22, 2026 •

edited

Loading

Uh oh!

chanceaclark Jan 29, 2026

Uh oh!

matthewvolk Mar 17, 2026

Uh oh!

Uh oh!

Uh oh!

chanceaclark Jan 29, 2026

Uh oh!

github-actions bot commented Mar 18, 2026

Uh oh!

github-actions bot commented Mar 18, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

chanceaclark commented Jan 22, 2026

What/Why?

Testing

Migration

Uh oh!

changeset-bot bot commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

vercel bot commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chanceaclark Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

matthewvolk Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

chanceaclark Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Mar 18, 2026

Bundle Size Report

Uh oh!

github-actions bot commented Mar 18, 2026

Unlighthouse Performance Comparison — Vercel

Summary Score

Category Scores

Core Web Vitals

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

changeset-bot bot commented Jan 22, 2026 •

edited

Loading

vercel bot commented Jan 22, 2026 •

edited

Loading