Skip to content

feat(docs): deploy previews with Alchemy Website.Nextjs - #48

Merged
cooper (czxtm) merged 7 commits into
mainfrom
feat/docs-website-nextjs
Sep 4, 2026
Merged

feat(docs): deploy previews with Alchemy Website.Nextjs#48
cooper (czxtm) merged 7 commits into
mainfrom
feat/docs-website-nextjs

Conversation

@czxtm

@czxtm cooper (czxtm) commented Sep 2, 2026

Copy link
Copy Markdown
Member

Summary

  • Upgrade Alchemy to 2.0.0-beta.70 and deploy docs via Cloudflare.Website.Nextjs (and web via Cloudflare.Website.Vite), dropping the wrangler pre-bundle path and the beta.57 patch.
  • Fix docs PR previews: share the docs-preview GitHub environment so new docs-pr-N environments no longer sit in action_required, skip custom hostnames the zone wildcard does not cover, capture the Alchemy URL, and smoke-check /docs/quick-start.

Test plan

  • bun install --frozen-lockfile succeeds with the updated lockfile
  • GitHub Deploy Docs workflow on this PR reaches success (not action_required)
  • Sticky PR comment includes a live preview URL
  • Preview / and /docs/quick-start return 200

Preview: https://stackpanel-docs-pr-48.drkmttr.workers.dev

Replace the wrangler pre-bundle and beta.57 patch with Cloudflare.Website.Nextjs on alchemy 2.0.0-beta.70 so OpenNext dynamic routes survive deploy. PR docs previews share the docs-preview environment, skip custom hostnames that the zone wildcard does not cover, and smoke-check /docs/quick-start.
npx next build invokes npm, which rejects this repo's catalog: protocol with EOVERRIDE and aborts the Website.Nextjs pipeline.
R2 incremental cache plus run_worker_first caused OpenNext to SSR on miss and 500 every route. Use the read-only static-assets cache and serve prerendered HTML from ASSETS first.
@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Docs preview pr-48 has been destroyed.

html/body were transparent, so the article showed the browser chrome while the sidebar used bg-fd-card. Use the themed background and swap the nav logo for light/dark.
Alchemy has no 2.0.0-rc yet; latest is beta.76 and it requires effect 4.0.0-rc.112. Point Next.js deploys at @alchemy.run/frontend-frameworks and put the bun build command in open-next.config.ts.
@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Preview pr-48 has been destroyed.

Nested local.<stage> hostnames are outside the *.stackpanel.com
wildcard and failed Alchemy zone inference.
…ples and templates

- Added .envrc files pinning nix-direnv 3.1.0 for the basic, cloudflare, and multi-app examples.
- Added .envrc templates for devenv, haumea, default, and minimal Nix flake templates.
- Added VS Code launch and task configs for attaching the Bun debugger to alchemy dev.
- Added generated stackpanel.code-workspace with YAML schema mappings for the web app.
- Removed the stray Nix store symlink at apps/stackpanel-go/result.
@czxtm
cooper (czxtm) merged commit 2dfe92a into main Sep 4, 2026
15 checks passed
@linear-code

linear-code Bot commented Sep 4, 2026

Copy link
Copy Markdown

ENG-663

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant