Bot SDK

Build a self-hosted Verdant bot.

Bots run in your own process and post through Verdant's scoped API. The SDK shapes safe feed cards and channel cards while the server still validates the final payload.

Minimal release card

import { VerdantBot, card, styled } from "@verdant/bot";

const bot = new VerdantBot({
  token: process.env.VERDANT_BOT_TOKEN,
  baseUrl: "https://api.verdant.chat",
});

await bot.feeds.postAnnouncement(process.env.FEED_ID, card()
  .title(styled("v0.0.261 is live", { color: "success" }))
  .text("Release notes are ready.")
  .button("Discuss release", { channelId: process.env.CHANGE_LOGS_ID })
);
Rendered example

v0.0.261 is live

Release notes are ready.