Skip to content

Latest commit

ย 

History

31 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Discord Bot Template Banner

๐Ÿค– Discord Bot Template

Production-Ready Discord.js Starter

GitHub Release License Discord.js Node.js JavaScript

A clean, scalable and production-ready Discord.js v14 starter template.

Built to help developers create modern Discord bots using a modular architecture and development best practices.


๐ŸŒธ Overview

The Discord Bot Template is an open-source starter project created and maintained by The Server Boutique.

Instead of beginning every Discord bot from scratch, this template provides a clean project structure, organised folders and modern development practices that make new projects faster to build and easier to maintain.

Whether you're creating a small community bot or a large production application, this template provides a strong foundation.


โœจ Features

  • ๐Ÿค– Discord.js v14
  • โšก Slash command ready
  • ๐Ÿ“‚ Modular folder structure
  • ๐Ÿงฉ Event-driven architecture
  • โš™๏ธ Environment variable support
  • ๐Ÿ“ Configuration system
  • ๐Ÿ“œ Logging support
  • ๐Ÿ›ก๏ธ Best-practice project structure
  • ๐Ÿ“š Beginner-friendly organisation
  • โ™ป๏ธ Easy to extend and customise
  • ๐Ÿงช Built with testing in mind
  • ๐Ÿ“– Fully documented

๐Ÿ“‚ Project Structure

discord-bot-template/
โ”‚
โ”œโ”€โ”€ docs/
โ”œโ”€โ”€ examples/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ commands/
โ”‚   โ”œโ”€โ”€ config/
โ”‚   โ”œโ”€โ”€ events/
โ”‚   โ”œโ”€โ”€ handlers/
โ”‚   โ”œโ”€โ”€ utils/
โ”‚   โ””โ”€โ”€ index.js
โ”‚
โ”œโ”€โ”€ tests/
โ”œโ”€โ”€ .env.example
โ”œโ”€โ”€ CHANGELOG.md
โ”œโ”€โ”€ CODE_OF_CONDUCT.md
โ”œโ”€โ”€ CONTRIBUTING.md
โ”œโ”€โ”€ LICENSE
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ SECURITY.md
โ””โ”€โ”€ package.json

๐Ÿš€ Getting Started

Clone the repository

git clone https://github.com/theserverboutique/discord-bot-template.git

Install dependencies

npm install

Rename

.env.example

to

.env

Add your bot token and configuration values.

Start the bot

npm start

๐Ÿ“ฆ Included Components

Component Description
๐Ÿค– Slash Commands Ready for command development
โšก Events Modular event loading
โš™๏ธ Configuration Centralised configuration files
๐Ÿ“‚ Handlers Clean loading architecture
๐Ÿงฐ Utilities Shared helper functions
๐ŸŒฑ Environment Secure .env configuration
๐Ÿ“œ Logging Structured console logging
๐Ÿ›ก๏ธ Best Practices Clean project organisation

๐ŸŽฏ Project Goals

This template is designed to:

  • Encourage clean project architecture.
  • Reduce repetitive setup.
  • Provide a scalable starting point.
  • Follow modern Discord.js conventions.
  • Help developers learn good project structure.
  • Remain lightweight and easy to customise.

๐Ÿ—บ๏ธ Roadmap

๐Ÿšง Current

  • Slash command handler
  • Event handler
  • Configuration system
  • Environment variables
  • Basic utilities
  • Logging
  • Documentation

๐Ÿ”ฎ Planned

  • Permission framework
  • Command cooldown system
  • Database examples
  • Component handler
  • Error management improvements
  • TypeScript edition
  • CI workflows
  • Expanded documentation

๐Ÿงช Development

This repository is intended to become the recommended starting point for projects built by The Server Boutique.

Future releases will continue improving scalability, documentation and developer experience while remaining beginner friendly.


๐Ÿค Contributing

Contributions, bug reports and feature suggestions are always welcome.

Please read CONTRIBUTING.md before opening a pull request.


๐Ÿ“„ License

Released under the MIT License.

See LICENSE for full details.


๐ŸŒธ About The Server Boutique

The Server Boutique is a boutique Discord development studio specialising in:

  • ๐Ÿค– Custom Discord bots
  • ๐Ÿก Discord server design
  • โš™๏ธ Community automation
  • ๐Ÿ“ฆ Open-source developer tools
  • ๐Ÿ“š Documentation and community resources

If this template helps you, consider supporting future development or exploring our services.

โ˜•

Ko-fi

https://ko-fi.com/theserverboutique


๐ŸŒธ Built with care by The Server Boutique

Beautiful communities โ€ข Thoughtful systems โ€ข Production-ready code

About

A clean, scalable Discord.js starter template with slash commands, event handling and reusable project structure.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages