메뉴
Wire @internal/web to durable-objects workers—workspace dep, alchemy.run.ts ReactRouter bindings, and env patterns. Use when adding `workspace:*` for a worker, editing apps/web/alchemy.run.ts, or debugging missing worker types after a new package.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Fork and template gotchas (env import, routes, typegen, forms, D1, Turbo, HMR, new DO packages). Use when working on apps/web or durable-objects, or when behavior diverges from this stack’s conventions.
Repo-root commands, typegen and typecheck cadence, lint, deploy, adding packages with bun, and Alchemy app layout. Use at the start of a task, before PR, or when choosing turbo/typegen commands.
Turborepo task configuration patterns for monorepo management. Use when configuring turbo.json tasks, setting up task dependencies, managing cache inputs/outputs, or working with cross-package dependencies in the monorepo.
Alchemy + env files — repo-root `.env.local` (dev), `.env.staging` (staging / PR preview deploys), `.env.production` (prod / CI), optional per-package `.env.local`, and package-local Alchemy apps. Use when adding secrets or non-secret vars (must also update turbo.json globalEnv + deploy workflow env maps), or debugging missing env in local/CI/preview. Never use a plain `.env` file. `.env.example` is human documentation only — no script reads it for all keys.
React Router v8 routing patterns and environment variable configuration. Use whenever you touch React Router–related code (routes, links, params, loaders, actions, route config, middleware, or env in route context).
Auth worker setup for Better Auth, OAuth, admin bootstrap, and env/secrets. Use when configuring auth for a fork, setting redirect URIs, or debugging auth env.
| name | web-alchemy-bindings |
| description | Wire @internal/web to durable-objects workers—workspace dep, alchemy.run.ts ReactRouter bindings, and env patterns. Use when adding `workspace:*` for a worker, editing apps/web/alchemy.run.ts, or debugging missing worker types after a new package. |
durable-objects/<pkg> worker or DO to the web app’s ReactRouter bindings.workspace:* worker dependency, fixing how env in workers/app.ts lines up with imports in alchemy.run.ts.Dependency — apps/web/package.json: "<package-name>": "workspace:*". bun install from repo root.
Import — apps/web/alchemy.run.ts: import { … } from "<package-name>/alchemy".
Bindings — Pass each binding into ReactRouter("…", { bindings: { …, CHATROOM: chatroomWorker, … } }) using the names your workers/app.ts reads from this.env (e.g. this.env.CHATROOM). D1: import mainDb from @internal/db/alchemy and set DB: mainDb (D1 is defined in packages/db/alchemy.run.ts, not inlined in web).
In route code — Prefer import { env } from "cloudflare:workers" for bindings, not React Router context (multiworker-gotchas, workers-patterns.mdc).
If you are tempted to add include lines in tsconfig.cloudflare.json that point at another package’s workers/app.ts, don’t—multiple declare global { type Env } sources break the web Env. Types follow your normal imports; no need to list durable-objects/… in include.
Verify — bun run typegen and bun run typecheck from root.
Typed HTTP from web — Add WorkerBindingRegistry.HonoClients row + bindingHonoClient(env.YOUR_BINDING) — binding-hono-client.
binding-hono-client — bindingHonoClient, WorkerBindingRegistry, worker clientApp RPC.
durable-object-package — worker package layout.
worker-rpc-turbo — workers/rpc.ts, Turbo dev / destroy, cross-worker types.