Volt-Base is a Bun-first generator for a modular Discord.js bot. It provides TypeScript and JavaScript project variants, slash and optional prefix commands, strict configuration, structured logging, transactional module loading, tests, and a locked CI baseline.
This repository is a production-oriented starter, not a managed bot platform. Operators remain responsible for Discord application configuration, secret storage, capacity planning, alerting, backups for application data, and testing their own command logic.
| Component | Supported version |
|---|---|
| Bun | 1.3.14 |
| Discord.js | 14.26.4 |
| TypeScript variant | 7.0.2 |
| Production host | Linux; other platforms are development conveniences only |
Dependencies are deliberately pinned. Dependabot proposes updates, and CI validates the complete generator matrix before an update can merge.
bunx create-volt-base my-bot
cd my-bot
bun run check
bun run devRun bunx create-volt-base --help for language, prefix-command, install, Git, output-directory, and
non-interactive options. The default install produces and retains bun.lock; commit it before
enabling the generated CI workflow. If generation used --no-install, run bun install first.
Copy .env.example to .env and provide a Discord bot token. Never pass a token as a CLI argument
or commit .env.
- TypeScript and checked JavaScript variants protected by generator contract tests.
- Slash commands and optional legacy prefix commands with feature-derived Discord intents.
- Strict loaders that validate modules before replacing live registries.
- Centralized interaction errors, bounded cooldown state, lifecycle timeouts, and graceful shutdown.
- JSON logging with secret redaction, liveness/readiness probes, and bounded Prometheus metrics.
- Biome, Bun tests, locked installs, dependency audit, CodeQL, dependency review, and secret scanning.
Development uses bun --hot, which reloads the module graph. Treat it as a development feature;
production should use bun run start under a supervisor and should restart after deployments.
bun install --frozen-lockfile
bun run check
bun run audit
bun run package:verifybun run check is the authoritative local gate: root/template typechecks, template tests, the full
generator variant suite, linting, and committed CLI build parity. CI executes the same gate.
- Architecture
- Production deployment and rollback
- Operations and troubleshooting
- Incident response
- Release process
- Generated-project upgrades
- Security policy
- Architecture decisions
- Contributing
MIT. See LICENSE.