Skip to content

docs(website): install preview packages on main and PR sites - #2123

Merged
BlankParticle merged 1 commit into
blank/drop-dead-cloudflare-tools-secretsfrom
blank/website-preview-install-urls
Oct 7, 2026
Merged

BlankParticle merged 1 commit into
blank/drop-dead-cloudflare-tools-secretsfrom
blank/website-preview-install-urls

Conversation

@BlankParticle

@BlankParticle BlankParticle commented Oct 7, 2026 •

Copy link
Copy Markdown
Member

On main.alchemy.run and PR website previews, install commands for alchemy and every @alchemy.run/* package point at the preview registry for that commit. Production installs @latest.

-pnpm add -D @alchemy.run/frontend-frameworks @vercel/nft
+pnpm add -D https://pkg.alchemy.run/@alchemy.run/frontend-frameworks/pr:2119:ecb0c16 @vercel/nft
Site PREVIEW_PACKAGE_TAG (website.yml) Install spec
PR preview pr:<N>:<short-sha> https://pkg.alchemy.run/<pkg>/pr:<N>:<short-sha>
main.alchemy.run <sha> https://pkg.alchemy.run/<pkg>/<sha>
alchemy.run unset <pkg>@latest
  • website/plugins/preview-install.ts: an Expressive Code plugin that rewrites those packages on install lines in every code block (fences, <Code>, and the pages' pkgs/devDeps exports).
  • The landing page's install line uses the same spec.

@BlankParticle
BlankParticle added this pull request to stack #2122 October 7, 2026 14:34
@BlankParticle BlankParticle changed the title feat(website): install previews from pkg.alchemy.run on main and PR sites feat(website): install preview packages on main and PR sites Oct 7, 2026
@BlankParticle BlankParticle added the deploy-website Deploy the website preview for this PR label Oct 7, 2026
@BlankParticle
BlankParticle marked this pull request as ready for review October 7, 2026 14:37
@alchemy-version-bot

alchemy-version-bot Bot commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Website Preview Deployed

URL: https://pr-2123-alchemy-website-preview.testing-2b2.workers.dev

Built from commit f78151e.


This comment updates automatically with each push.

website.yml sets PREVIEW_PACKAGE_TAG for non-production deploys (<sha> on
main, pr:<N>:<short-sha> on PRs). An Expressive Code plugin rewrites install
commands for alchemy and every @alchemy.run/* package to the preview registry
under that tag, or to @latest on npm when it isn't set. The landing page's
install line uses the same spec.
@BlankParticle
BlankParticle force-pushed the blank/website-preview-install-urls branch from 9a2c8ed to f78151e Compare October 7, 2026 14:50
@BlankParticle BlankParticle changed the title feat(website): install preview packages on main and PR sites docs(website): install preview packages on main and PR sites Oct 7, 2026
@BlankParticle
BlankParticle merged commit 5dfd92e into main Oct 7, 2026
2 checks passed
@BlankParticle
BlankParticle deleted the blank/website-preview-install-urls branch October 7, 2026 16:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

deploy-website Deploy the website preview for this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant