Skip to content

harmonix-js/harmonix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Harmonix Banner

Harmonix

The DX-first framework for Discord bots.

npm version npm downloads license discord

🧭 Overview

Harmonix is a modern, TypeScript-first framework designed to help you build powerful, scalable, and maintainable Discord bots. With a strong focus on developer experience, it simplifies your workflow so you can spend less time on boilerplate and more time crafting engaging bot features.

Its modular design, type-safety, and built-in development tools make it a solid foundation whether you're prototyping a small project or building a feature-rich application across multiple servers.

It provides a number of powerful features that make it easier to develop fast, reliable, and context-aware Discord bots, including:

  • 🧠 Fully type-safe with first-class TypeScript support
  • 🧩 Modular design with auto-discovery of commands, events and more
  • 🎯 Built-in context system for intuitive state management
  • πŸ” Built-in HMR (Hot Module Replacement) for a seamless dev experience
  • πŸ”Œ Hook system to customize and extend behavior at runtime
  • 🧰 Developer-first API and DX-focused architecture

πŸ“‘ Table of Contents

Click to expand

πŸš€ Getting Started

Use the following command to scaffold a starter template with all the necessary files and dependencies:

pnpm create harmonix@latest <my-bot>

πŸ€– Development

Harmonix offers a straightforward, user-friendly, and robust solution for writing commands naturally. It automates all repetitive tasks, allowing you to concentrate on developing your bot features.

Example of a commands/ping.ts:

export default defineSlashCommand(
  { description: 'Ping the bot' },
  (interaction) => {
    interaction.reply('Pong!')
  }
)

🀝 Contributing

Harmonix is an open-source framework and like any great open-source project, it thrives on community contributions.

Whether you're fixing a bug, improving the documentation, suggesting ideas, or building something new, your input matters.

Check out our Contributing Guide to get started.

πŸ“„ License & Credits

Published under the MIT license.

About

πŸ€– The DX-first framework for Discord bots.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks