chore: add deployment for native hosting

[chanceaclark]

What/Why?

Adds CI/CD for deploying the Catalyst storefront to BigCommerce Native Hosting using the @bigcommerce/catalyst alpha CLI and @opennextjs/cloudflare.

This PR includes:

• Native Hosting workflow (.github/workflows/native-hosting.yml) — builds and deploys the storefront on pushes to canary and on PRs
• Proxy-to-middleware conversion step — automatically converts Next.js 16's proxy.ts to middleware.ts at build time (renames the file, swaps the export, adds runtime: 'experimental-edge') so the OpenNext/Cloudflare build works without maintaining a separate middleware.ts in the repo
• Alpha CLI + changeset pre-release setup — versions @bigcommerce/catalyst as 1.0.0-alpha.x with changesets in pre mode
• CLI improvements included in alpha — auth commands, logs command, --prebuilt deploy, credential resolution, deployment error mapping, telemetry updates, and removal of the dev command

Testing

• Workflow runs on PR open/sync and push to canary
• Verify the "Convert proxy.ts to middleware.ts" step correctly transforms the file before the Next.js build
• Confirm catalyst build and catalyst deploy --prebuilt succeed with the configured secrets/vars

Migration

N/A

[changeset-bot]

⚠️ No Changeset found

Latest commit: 1acbcfe

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]

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

Project	Deployment	Actions	Updated (UTC)
catalyst	Ready	Preview, Comment	Mar 26, 2026 11:11pm

[chanceaclark]

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

[matthewvolk]

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-actions]

Bundle Size Report

Comparing against baseline from 620ac0e (2026-03-26).

No bundle size changes detected.

[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	92	93	91	94

Category Scores

Category	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
Performance	77	78	74	76
Accessibility	95	95	95	98
Best Practices	100	100	95	95
SEO	100	100	100	100

Core Web Vitals

Metric	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
LCP	3.5 s	4.0 s	4.4 s	4.4 s
CLS	0	0.194	0.037	0.192
FCP	1.2 s	1.2 s	1.2 s	1.2 s
TBT	0 ms	0 ms	0 ms	0 ms
Max Potential FID	50 ms	50 ms	50 ms	40 ms
Time to Interactive	3.6 s	4.0 s	4.4 s	4.4 s

Full Unlighthouse report →