alchemy 2.0.0-beta.61 → 2.0.0-beta.63

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-<a href="https://v2.alchemy.run">
+<a href="https://alchemy.run">
   <img src="./images/readme-hero.png" alt="Alchemy — Infrastructure as Effects" width="360" />
 </a>
 
@@ -12,7 +12,7 @@
 
 **Infrastructure-as-Effects** — cloud infrastructure and application logic as a single, type-safe [Effect](https://effect.website) program.
 
-[Docs](https://v2.alchemy.run) · [Tutorial](https://v2.alchemy.run/tutorial/part-1) · [Examples](./examples) · [Discord](https://discord.gg/jwKw8dBJdN)
+[Docs](https://alchemy.run) · [Tutorial](https://alchemy.run/tutorial/part-1) · [Examples](./examples) · [Discord](https://discord.gg/jwKw8dBJdN)
 
 </div>
 
@@ -21,13 +21,13 @@
 A Worker bound to a R2 bucket and serving objects from it:
 
 ```typescript
-const Bucket = Cloudflare.R2Bucket("bucket");
+const Bucket = Cloudflare.R2.Bucket("bucket");
 
 export default Cloudflare.Worker(
   "api",
   { main: import.meta.url },
   Effect.gen(function* () {
-    const bucket = yield* Cloudflare.R2.ReadWrite(Bucket);
+    const bucket = yield* Cloudflare.R2.ReadWriteBucket(Bucket);
     return {
       fetch: Effect.gen(function* () {
         const request = yield* HttpServerRequest;
@@ -35,11 +35,11 @@ export default Cloudflare.Worker(
         return HttpServerResponse.stream(object!.body);
       })
     };
-  }),
+  }).pipe(Effect.provide(Cloudflare.R2.ReadWriteBucketBinding)),
 );
 ```
 
-One `bind()` wires the binding, env var, and typed connection — at deploy time and at runtime.
+One `ReadWriteBucket(Bucket)` call wires the binding, env var, and typed client — at deploy time and at runtime.
 
 ---
 
@@ -53,12 +53,27 @@ One `bind()` wires the binding, env var, and typed connection — at deploy time
 bun add alchemy@next effect@next
 ```
 
+## GitHub Action
+
+Use the root action to deploy `prod` from `main`, deploy PR previews as
+`staging-{number}`, and destroy PR previews when the PR closes:
+
+```yaml
+- uses: alchemy-run/alchemy@v1
+  env:
+    CLOUDFLARE_ACCOUNT_ID: ${{ vars.CLOUDFLARE_ACCOUNT_ID }}
+    CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+The workflow must install the `alchemy` CLI before this action runs.
+
 ## Bootstrap with an AI coding agent
 
 Paste this into Claude Code, Cursor, or any agent that can fetch a URL:
 
 ```
-You are an Alchemy expert. Read https://v2.alchemy.run/llms.txt to load the
+You are an Alchemy expert. Read https://alchemy.run/llms.txt to load the
 full documentation index, then act as my pair on this project.
 
 Goal: help me set up, build, test, and deploy a cloud application with
@@ -72,11 +87,11 @@ dependencies or breaking conventions.
 
 ## Learn more
 
-- [What is Alchemy?](https://v2.alchemy.run/what-is-alchemy) — the framework in 2 minutes
-- [Getting Started](https://v2.alchemy.run/getting-started) — your first Stack
-- [Tutorial](https://v2.alchemy.run/tutorial/part-1) — five-part walkthrough to a tested, CI-deployed app
+- [What is Alchemy?](https://alchemy.run/what-is-alchemy) — the framework in 2 minutes
+- [Getting Started](https://alchemy.run/getting-started) — your first Stack
+- [Tutorial](https://alchemy.run/tutorial/part-1) — five-part walkthrough to a tested, CI-deployed app
 - [Examples](./examples) — runnable projects on AWS and Cloudflare
-- [llms.txt](https://v2.alchemy.run/llms.txt) — agent-ready documentation index
+- [llms.txt](https://alchemy.run/llms.txt) — agent-ready documentation index
 
 > **alchemy** is in alpha. Expect breaking changes. Come hang in our [Discord](https://discord.gg/jwKw8dBJdN).