Infrastructure as TypeScript

1 month ago 5

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();

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!

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/