louise-toolkit

Everything you need to build editable sites on Astro + Cloudflare Workers: content, commerce, media, forms, auth, and AI, as composable V8-native primitives.

Louise is the toolkit for building sites on Astro + Cloudflare Workers: the whole surface, not only content. Editing the live page in place is the headline (no separate administration app, no JSON forms for prose), but it's one of ~two dozen primitives: content, db, media, forms, commerce, email, queues, ai, analytics, realtime, workflows, health, worker, plus opt-in auth/security, alongside a SolidJS + ProseKit inline-edit client, Louise Settings (a registry-driven settings surface), the generic api/louise/* handlers, and the daisyUI editor theme, as granular, tree-shakeable subpath exports. The core primitives are framework-agnostic (they run in any Worker or a unit test); the batteries target Astro on Cloudflare.

Full guide and API reference: docs.louisetoolkit.org

Install

pnpm add louise-toolkit

Louise's heavier dependencies are optional peers. Install only what the exports you use require:

| If you use… | Install | | ----------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | | louise-toolkit/db, /content, /media, /editor, /forms, /incidents, but not /content/define, which is drizzle-free | drizzle-orm | | louise-toolkit/client | solid-js prosekit @prosekit/pm | | louise-toolkit/client/settings | @tanstack/solid-query (+ the client peers) | | louise-toolkit/auth | better-auth (@better-auth/passkey for passkeys) | | louise-toolkit/browser | @cloudflare/puppeteer | | louise-toolkit/stega | @vercel/stega | | louise-toolkit/astro | astro | | /security, /worker, /email, /queues, /errors, /commerce, /ai, /analytics, /realtime, /workflows, /health, /schema | (no peers) |

The core primitives are dependency-injected: you pass in your Cloudflare bindings (D1, R2, Queues, Email), and Louise never reaches for cloudflare:workers itself.

Exports

| Subpath | What it is | | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | louise-toolkit/client | The inline edit-on-the-page client + ProseKit rich-text editor, icons, blocks | | louise-toolkit/client/settings | Louise Settings, the registry-driven settings surface: shell (mountSettings), framework panels, data layer | | louise-toolkit/editor | Framework-generic api/louise/* handlers (save/settings/pages/media/forms/submissions/seed) | | louise-toolkit/forms | defineForm → derived table + capture route + validation + review columns; optional TanStack adapter | | louise-toolkit/content | Collections, codegen, patch/validation, structure, webhooks | | louise-toolkit/content/define | The drizzle-free half of content: defineCollection + field/collection types, for describing content without the DB layer | | louise-toolkit/db | Thin Drizzle-over-D1 helper + framework-owned pages/inquiries/media/submissions/site_settings columns | | louise-toolkit/media | R2 media: magic-byte-sniffed uploads, asset registry (alt/caption/dims), cfImage transforms, delete-safety scan | | louise-toolkit/auth | Better Auth factory + guard/handler + generateAuthSchemaSql (and the louise command-line tool) | | louise-toolkit/security | sanitize, rate-limit, secrets, security headers | | louise-toolkit/worker | composeWorker to compose editor + site routes over an SSR fallthrough; withEdgeCache, withHealing | | louise-toolkit/ai | Workers AI helpers: alt text, rewrite, SEO suggestions, embeddings + semantic search (best-effort; no-op without env.AI) | | louise-toolkit/analytics | Cookieless Core Web Vitals beacon + Analytics Engine query helpers (real-user monitoring) | | louise-toolkit/realtime | Per-page live editing session over a Durable Object: presence + the authed WebSocket upgrade route | | louise-toolkit/workflows | Cloudflare Workflows helpers: durable, resumable multi-step pipelines (for example, the publish pipeline) | | louise-toolkit/health | Site-health summary (broken links, alt/SEO gaps, Core Web Vitals) persisted over KV | | louise-toolkit/schema | Standard Schema validator: the s builder + standardValidate (hand-rolled, zero-dependency) | | louise-toolkit/astro | Optional Astro glue: edit-mode middleware factory, catalog loader, form → astro:env schema | | louise-toolkit/browser | Cache-first OG-image render + link checker (Cloudflare Browser Rendering) | | louise-toolkit/commerce | Shared commerce primitives: money helpers + webhook-signature crypto | | louise-toolkit/commerce/stripe | Stripe glue: Payment Element / PaymentIntents, invoices, webhooks (raw fetch, no SDK) | | louise-toolkit/commerce/square | Square /v2 catalog, orders, payments, customers, loyalty, subscriptions + webhook verification | | louise-toolkit/commerce/square-web | Browser-side Square Web Payments SDK loader + card mount (tokenizes in-page, so the PAN never reaches your Worker) | | louise-toolkit/commerce/fourthwall | Fourthwall storefront/catalog + webhook verification | | louise-toolkit/email | Cloudflare Email Sending (env.EMAIL.send) + the transactional-mail shell: masthead, button, rows, paste-this-link fallback | | louise-toolkit/queues | Cloudflare Queues producer + batch consumer | | louise-toolkit/stega | @vercel/stega visual-editing tagging + a dependency-free stripper | | louise-toolkit/errors | LouiseError and typed subclasses | | louise-toolkit/incidents | The report every failure becomes, its fingerprint, and the site's D1 record of incidents (ADR 0022) | | louise-toolkit/theme/louise.css, /theme/fonts.css | the daisyUI "louise" editor theme |

Quick start

// A Cloudflare Worker endpoint — bindings are passed in, never imported.
import { db } from "louise-toolkit/db";
import { sendEmail } from "louise-toolkit/email";

export default {
  async fetch(req: Request, env: Env) {
    const orm = db(env.DB); // Drizzle over your D1 binding
    await sendEmail(env.EMAIL, {
      from: "[email protected]",
      to: "[email protected]",
      subject: "Hello from the edge",
      html: "<p>Sent V8-natively.</p>",
    });
    return new Response("ok");
  },
};

Making a field inline-editable is a marker plus the client:

<h1 data-louise-field="settings:1:heroHeadline">Your Studio</h1>

import { mountLouise } from "louise-toolkit/client";
mountLouise(); // no-op unless the page rendered edit-mode markers

See the Quickstart to go from zero to editable, then the Getting Started guide for the full wiring (edit mode, the save endpoint, rich text, Louise Settings, media, theme).

Contributing / building

This package is developed in the louise-toolkit workspace with Vite+. It's packaged with vp pack (tsdown / Rolldown: multi-entry, .d.ts, tree-shaking).

vp install
vp pack            # build → dist/
vp test            # Vitest
vp check           # Oxlint + Oxfmt + type-check

Credits

Bundled (redistributed with this package, so its notice ships here): icons from Phosphor Icons (MIT © Phosphor Icons), inlined at build time. See THIRD_PARTY_NOTICES.md.

Built on (peer dependencies you install yourself, not redistributed here): ProseKit + ProseMirror for rich text, SolidJS for the client, and Drizzle ORM over Cloudflare D1.

License

MIT © BowenLabs