import PackageManagers from "../../../../components/PackageManagers.astro"; export const devDeps = "@alchemy.run/frontend-frameworks"; GCP.Website.ReactRouter deploys a React Router
v8 app in framework mode to Cloud Run. Alchemy runs your own
vite build and serves the app from a Node server.
Install
The build integration ships separately. It only runs at deploy time, so a dev dependency is enough:
Docker has to be running when you deploy. The image is built on your machine.
Deploy the site
// alchemy.run.ts
import * as Alchemy from "alchemy";
import * as GCP from "@alchemy.run/gcp";
import * as Effect from "effect/Effect";
export const Website = GCP.Website.ReactRouter("Website");
export default Alchemy.Stack(
"MySite",
{ providers: GCP.providers(), state: GCP.state() },
Effect.gen(function* () {
const site = yield* Website;
return { url: site.url };
}),
); Run alchemy deploy. site.url is the Cloud Run service URL.
Pass environment variables
// alchemy.run.ts
-export const Website = GCP.Website.ReactRouter("Website");
+export const Website = GCP.Website.ReactRouter("Website", {
+ env: {
+ GREETING: "Hello from Cloud Run!",
+ },
+}); Loaders read it from process.env:
// app/routes/home.tsx
export function loader() {
return { greeting: process.env.GREETING ?? "Hello!" };
} Configure Vite
Your vite.config.ts needs no adapter. React Server Components are
not supported yet: the build fails with a clear error if it emits more
than one server entry.
Tune Cloud Run
export const Website = GCP.Website.ReactRouter("Website", {
scaling: { minInstanceCount: 1 },
resources: { limits: { cpu: "1", memory: "1Gi" } },
}); One warm instance means no cold start for the first visitor. See Websites for the other settings.
Local development
alchemy dev runs the framework's dev server with hot reload and
creates nothing in the cloud. Wrap the site in Alchemy.remote() to
deploy it for real during dev.
Where next
- Websites — the settings every site shares.
- Website reference — every prop.