Skip to content

Setup

You need:

Add the provider

Section titled “Add the provider”

Install @alchemy.run/boat:

Terminal window
pnpm add @alchemy.run/boat@latest

Then add Boat.providers() next to your cloud’s providers:

alchemy.run.ts
import * as Boat from "@alchemy.run/boat";
import * as Cloudflare from "@alchemy.run/cloudflare";
import * as Alchemy from "alchemy";
import * as Effect from "effect/Effect";
import * as Layer from "effect/Layer";


export default Alchemy.Stack(
  "MyApp",
  {
    providers: Layer.mergeAll(Cloudflare.providers(), Boat.providers()),
    state: Cloudflare.state(),
  },
  Effect.gen(function* () {
    return {};
  }),
);

Sign in

Section titled “Sign in”
Terminal window
pnpm alchemy profile edit --add Boat

Pick Browser sign-in and enter your Boat account’s email. Alchemy opens a Boat page: sign in there the way you signed up (GitHub, Google or an email code), and type the code your terminal shows. Alchemy stores the API key Boat issues, which lasts a year and renews itself before it expires.

To paste a key from the dashboard’s API Keys tab instead, pick API key. Give it the admin preset: deploying creates keys for your Workers and Functions.

Deploy from CI

Section titled “Deploy from CI”

Set BOAT_API_KEY, and Alchemy uses it instead of your profile:

Terminal window
BOAT_API_KEY=boat_... pnpm alchemy deploy

See Account & API keys.

Next, build the tutorial.