alchemy

Alchemy

Alchemy is an embeddable, TypeScript-native Infrastructure-as-Code (IaC) library for modeling Resources that are Created, Updated and Deleted automatically.

Unlike similar tools like Pulumi, Terraform, and CloudFormation, Alchemy is implemented in pure ESM-native TypeScript code.

Resources are simple memoized async functions that can run in any JavaScript runtime, including the browser, serverless functions and durable workflows.

import alchemy from "alchemy";

// initialize the app (with default state $USER)
const app = await alchemy("cloudflare-worker");

// create a Cloudflare Worker
export const worker = await Worker("worker", {
  name: "my-worker",
  entrypoint: "./src/index.ts",
  bindings: {
    COUNTER: counter,
    STORAGE: storage,
    AUTH_STORE: authStore,
    GITHUB_CLIENT_ID: alchemy.secret(process.env.GITHUB_CLIENT_ID),
    GITHUB_CLIENT_SECRET: alchemy.secret(process.env.GITHUB_CLIENT_SECRET),
  },
});

// finalize the alchemy app (triggering deletion of orphaned resources)
await app.finalize();

Features

• JS-native - no second language, toolchains, processes, services, etc. to lug around.
• Async-native - resources are just async functions - no complex abstraction to learn.
• ESM-native - built exclusively on ESM, with a slight preference for modern JS runtimes like Bun.
• Embeddable - runs in any JavaScript/TypeScript environment, including the browser!
• Extensible - implement your own resources with a simple function.
• AI-first - alchemy actively encourages you to use LLMs to create/copy/fork/modify resources to fit your needs. No more waiting around for a provider to be implemented, just do it yourself in a few minutes.
• No service - state files are stored locally in your project and can be easily inspected, modified, checked into your repo, etc.
• No strong opinions - structure your codebase however you want, store state anywhere - we don't care!

Examples

• CloudFlare Worker with Queue, R2 Bucket, Durable Objects, Workflows and RPC: examples/cloudflare-worker/
• CloudFlare Worker Bootstrap with Queue and R2 End-to-End Testing: examples/cloudflare-worker-bootstrap/
• CloudFlare ViteJS Website + API Backend with Durable Objects: examples/cloudflare-vite/
• CloudFlare TanStack Start Application Deployment: examples/cloudflare-tanstack-start/
• CloudFlare RedwoodJS Application with D1 Database: examples/cloudflare-redwood/
• CloudFlare React Router Application Deployment: examples/cloudflare-react-router/
• CloudFlare Nuxt 3 Application with Pipeline and R2 Bucket: examples/cloudflare-nuxt-pipeline/
• CloudFlare SvelteKit Application with KV and R2 Storage: examples/cloudflare-sveltekit/
• Deploy an AWS Lambda Function with a DynamoDB Table and IAM Role: examples/aws-app/

Getting Started

See the Getting Started Guide.