Astro

​

Installation

npm install alchemy astro @astrojs/cloudflare

​

Configuration

import alchemy from "alchemy/cloudflare/astro";
import { defineConfig } from "astro/config";

export default defineConfig({
  output: "server",
  adapter: alchemy(),
});

import alchemy from "alchemy";
import { Astro, D1Database } from "alchemy/cloudflare";

const app = await alchemy("my-astro-app");

const db = await D1Database("database", {
  name: `${app.name}-${app.stage}-db`,
});

const website = await Astro("website", {
  bindings: {
    DB: db,
  },
});

console.log({
  url: website.url,
});

await app.finalize();

npm exec tsx alchemy.run.ts

​

Configuration Options

​

Properties

• output (optional): Astro output mode
  • "server" - Server-side rendering (default if adapter is used)
  • "static" - Static site generation
  • Auto-detected from astro.config.mjs
• bindings: Cloudflare bindings (KV, R2, D1, etc.)
• build: Build command override
  • Default: astro build
• dev: Dev command override
  • Default: astro dev
• entrypoint: Worker entrypoint path
  • Default: dist/_worker.js/index.js (server mode)
• assets: Static assets directory
  • Default: dist

​

Static vs Server Mode

​

Static Site

import { defineConfig } from "astro/config";

export default defineConfig({
  output: "static",
});

const website = await Astro("website", {
  output: "static",
});

​

Server-Side Rendering

import alchemy from "alchemy/cloudflare/astro";
import { defineConfig } from "astro/config";

export default defineConfig({
  output: "server",
  adapter: alchemy(),
});

​

Accessing Bindings

---
const db = Astro.locals.runtime.env.DB;
const result = await db.prepare("SELECT * FROM users").all();
---

<h1>Users: {result.results.length}</h1>

​

Local Development

• Configures platform proxy for local bindings
• Ignores .alchemy directory from file watching
• Provides development environment access

npm run dev

​

Related Resources

• Website - Base resource for web applications
• D1 Database - SQL database
• KV Namespace - Key-value storage