⚡ Volt-Base

A Bun-first Discord bot starter template.

📖 Introduction

Volt-Base is a modular, high-performance Discord bot boilerplate designed for Bun. It comes pre-configured with hot-reloading, an event/command handler, and a clean project structure to help you build scalable bots instantly.

🚀 Getting Started

Prerequisites

• Bun installed.

Installation

To create a new project:

bun create volt-base@latest

This will launch the interactive CLI to set up your bot.

Running Development

bun run dev

This starts the bot in hot-reload mode. Changes to commands and events will automatically reload!

📂 Project Structure

├── bot/
│   ├── commands/   # Slash commands
│   ├── events/     # Event listeners
│   ├── prefix/     # Legacy prefix commands (optional)
│   ├── components/ # Button/Modal handlers
│   └── loaders/    # Logic for loading modules
├── config/         # Environment & Constants
└── utils/          # Logger, Hot-reload logic

✨ Features

• Hot-Reloading: Edit commands/events while the bot is running.
• Pino Logger: Structured, pretty logging.
• TypeScript: Full type safety.
• Modular Loaders: Scalable architecture.

🤝 Contributing

Contributions are welcome! Pull requests will be reviewed.

Made with ❤️ by Volt-Base Team.