Blume: Open-source, Markdown-first documentation powered by Astro and Vite

Blume — fast, AI-ready, markdown-first docsSkip to contentBlume is now publicly available.

Search⌘KEsc

↑↓navigate↵open⌘Jpreview

Latest update, v1.0.3World-class docs foreverything you ship. Fast, AI-ready, and zero-config. Drop Markdown into a folder and ship a production-grade docs site, no app boilerplate to write or maintain. Free and open source, forever. $npx blume init

Read the docsView the code

svg]:h-5 [&>svg]:w-auto">Comet Search⌘K

Get started Introduction Quickstart Authentication SDKs

Sending Messages Templates Batches Scheduling Attachments

Deliverability Domains Webhooks Suppressions

Reference API keys Rate limits Errors

Quickstart Send your first transactional message in minutes. Comet's REST API works with any language — this guide uses the official TypeScript SDK. :first-child]:mt-0! [&>:last-child]:mb-0!">Store your API key in an environment variable — never commit it to source control. Install the SDK Add Comet to your project with your package manager of choice. The SDK ships with TypeScript types and runs on Node, Bun, and Deno. npm install comet

Send a message Create a client with your API key, then call messages.send. Every request returns an id you can use to track delivery. import { Comet } from "comet";

const comet = new Comet(process.env.COMET_API_KEY);

const { id } = await comet.messages.send({ to: "ada@example.com", template: "welcome", });

console.log(`Queued ${id}`);

Use a template Reference a template by slug and pass variables — Comet renders the subject and body server-side, so your app never ships copy. Track delivery Poll the message endpoint, or subscribe to webhooks for real-time delivery, open, click, and bounce events as they happen. Handle webhooks Verify the signature on each request, then react to the event — here we mark a message delivered in our own database. app.post("/webhooks/comet", (req, res) => { const event = comet.webhooks.verify(req);

if (event.type === "message.delivered") { markDelivered(event.data.id);

res.sendStatus(200); });

Next steps Authentication→Webhooks reference→API reference→

On this page Install the SDK Send a message Use a template Track delivery Handle webhooks Next steps

Batteries included. Everything a production docs site needs — zero-config setup, AI, a component library, search, SEO, and i18n — without a plugin to install or a service to wire up.

Zero-config, even the template A folder of Markdown is a complete project — there's no starter to clone and no template to keep in sync with upstream. Navigation is inferred from your files Search, theming, and OG images are on by default Reach for configuration only when you need it

svg]:h-4 [&>svg]:w-auto">Comet Search⌘K Get started Introduction Quickstart Authentication Components

Sending Messages Templates Webhooks

Platform Logs Search Analytics

Get started Introduction Comet is a transactional email & SMS API. Send your first message in minutes, then add templates, webhooks, and analytics as you grow. Quickstart Send your first message

Authentication API keys & scopes

Every request is idempotent — safely retry without sending twice.

What's included Full-text searchOG images & SEODark mode36 locales (i18n) Quickstart→Configuration→

On this page Why Comet What's included Next steps

Interactive API references Drop in an OpenAPI or AsyncAPI spec and Blume renders a full interactive reference — endpoints, schemas, and a live playground. OpenAPI and AsyncAPI specs Interactive “Try it” playground Powered by Scalar, themed to match

svg]:h-4 [&>svg]:w-auto">Comet Search⌘K Messages Send messagePOST Get messageGET Delete messageDEL

Templates List templatesGET Create templatePOST

API reference Get a message GET/messages/{id} Returns a single message by its ID — rendered straight from your OpenAPI spec, with a live “Try it” playground. Path Parameters idstringrequiredThe ID of the message to return.

Responses 200successful operation "id": "msg_01H8...", "to": "ada@example.com", "status": "delivered"

On this page Parameters Responses Schema

A built-in changelog Write each release as a Markdown entry — or point Blume at your GitHub Releases — and every one rolls up into a generated timeline at /changelog. Timeline page and permalinks, newest-first Source entries straight from GitHub Releases RSS feed on by default

svg]:h-4 [&>svg]:w-auto">Comet Search⌘K Changelog comet@2.1.0 July 8, 2026 Release Minor Changes a1f92c3: Add segments — broadcast a message to a saved audience straight from the API. 7c04b1e: Export delivery analytics from the new /analytics/export endpoint.

comet@2.0.4 June 26, 2026 Release Patch Changes 9b3d5a7: Use exponential retry.backoff for webhook retries instead of a fixed interval. 04e8c2f: Fix templates.render dropping default variables.

comet@2.0.0 June 12, 2026 Release Major Changes f31c88a: The v2 API is generally available.

Components, included 30+ accessible components and a curated set of Markdown extensions, usable in any .mdx page...

Blume: Open-source, Markdown-first documentation powered by Astro and Vite

Related Articles

(no title)

Scientists reverse brain aging, with a nasal spray

AI has torched the market for junior programmers

Al Vigier: Canada's AI strategy shouldn't include secret Palantir bills

The Anatomy of an AI-Native Org