Documentation

1. Create an account

Sign up at app.getflarely.dev with GitHub. Free tier includes 500 events/month — no credit card required.

2. Create a project and add a destination

In the dashboard, click New Project, give it a name, paste your Discord or Slack webhook URL, and save.

3. Send your first event

curl -X POST https://app.getflarely.dev/v1/ingest \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Payment failed",
    "message": "Stripe charge declined: insufficient funds",
    "level": "error",
    "source": "billing-service"
  }'

You should see the alert in your Discord or Slack channel within seconds.

curl

curl -X POST https://app.getflarely.dev/v1/ingest \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Payment failed",
    "message": "Stripe charge declined: insufficient funds",
    "level": "error",
    "source": "billing-service",
    "fingerprint": "payment-fail-user-42"
  }'

JavaScript / TypeScript

await fetch("https://app.getflarely.dev/v1/ingest", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    title: "Payment failed",
    message: error.message,
    level: "error",
    source: "billing-service",
    fingerprint: `payment-fail-${userId}`,
  }),
});

Python

import requests

requests.post(
  "https://app.getflarely.dev/v1/ingest",
  headers={"Authorization": "Bearer sk_live_your_key_here"},
  json={
    "title": "Payment failed",
    "message": str(e),
    "level": "error",
    "source": "billing-service",
  }
)

Go

payload := map[string]string{
  "title":  "Payment failed",
  "level":  "error",
  "source": "billing-service",
  "message": err.Error(),
}
body, _ := json.Marshal(payload)

req, _ := http.NewRequest("POST", "https://app.getflarely.dev/v1/ingest", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer sk_live_your_key_here")
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)

Requirements

• Node.js 20+
• Redis (local, Docker, or Upstash free tier)

Install

git clone https://github.com/flarely/flarely.git
cd flarely
npm install
cp .env.example .env
# Edit .env with your Redis URL and other settings
npm run setup    # interactive wizard — creates project + API key
npm run build && npm start

Environment variables

Deploy to Fly.io

cp fly.toml.example fly.toml
fly apps create <your-app-name>
fly volumes create flarely_data --size 1 --app <your-app-name>

fly secrets set \
  REDIS_URL=<your-redis-url> \
  BULLBOARD_USER=admin \
  BULLBOARD_PASS=<strong-password>

fly deploy

# First-time setup
fly ssh console -C "node dist/cli/setup.js"