seyfert-bot-starter

  create-seyfert-bot my-bot
        |
        v
  [ src/index.ts ]  [ src/commands/ ]  [ .env ]  [ biome ]
        |                  |               |          |
        +----- Seyfert 5 ----+------ dotenv -----+----+

A total starter for a modern Seyfert Discord bot. One command, zero config.

get the bot running

bunx create-seyfert-bot my-bot
cd my-bot

cp .env.example .env     # add your BOT_TOKEN
bun install
bun run dev

Your bot is ready. That's the whole onboarding.

what you get

my-bot
|-- package.json        # seyfert 5, dotenvx, bun scripts
|-- tsconfig.json       # strict, decorator-ready
|-- biome.json          # formatting + linting
|-- .env.example        # BOT_TOKEN / CLIENT_ID
|-- src
|   |-- index.ts        # client bootstrap, ready event
|   `-- commands
|       `-- ping.ts     # first slash command
`-- README.md           # scaffolded with your name

the parts

| part | duty | | ---- | ---- | | src/index.ts | builds the client, sets intents + locations, logs in | | src/commands/ | every file here is auto-registered on startup | | @dotenvx/dotenvx | loads .env before the client boots | | biome.json | shared lint + format rules, spaces/2 | | scripts | dev/start/lint/typecheck/format |

why this over hand-typing

| issue | starter | | ----- | ------- | | decorator tsconfig flags missing | already enabled | | .env never loaded | dotenvx imported up top | | commands need the right locations | wired in index.ts | | lint/deps drift | pinned biome.json + versions |

add a command

// src/commands/hello.ts
import { Command, type CommandContext, Declare } from "seyfert";

@Declare({
  name: "hello",
  description: "Wave back",
})
export default class HelloCommand extends Command {
  run(ctx: CommandContext) {
    return ctx.write({ content: "Hello there!" });
  }
}

Restart bun run dev and it registers itself.

install instead of scaffold?

create-seyfert-bot copies the template. If you want the template as a reference tree instead, read src/template/ in the repo.

development of this package

git clone https://github.com/knownasrazi/seyfert-bot-starter.git
cd seyfert-bot-starter
bun install
bun run release

license

MIT + Razi

one command in. one bot working.