Getting Started

Prerequisites

• A Cloudflare account with Workers, D1, and KV access enabled.
• Bun installed locally.
• Wrangler CLI authenticated with bunx wrangler login.

1. Clone and install

git clone https://github.com/fumi-ops/fumi.git
cd fumi
bun install

2. Run the guided setup

The bun run setup script walks through Cloudflare authentication, D1 database creation, and secret provisioning. You can rerun it at any time if you need to regenerate credentials.

bun run setup

3. Send a test event

Use the JavaScript SDK to emit a test signal:

import { Fumi } from "@fumi/sdk";

const client = new Fumi("your-api-key", "https://your-worker.workers.dev");
await client.track({
  name: "app.boot",
  severity: "info",
  payload: { version: "v0.1.0" },
});

The event should appear in your dashboard timeline within a few seconds. If it does not, check the Worker logs via bunx wrangler tail for ingest errors.

Next steps

• Configure webhooks under Actions to trigger Slack or PagerDuty when critical events arrive.
• Add additional contexts (e.g., staging, production) to group related events.
• Explore more guides at fumi.dev/docs.