Skip to content

The-LukeZ/honocord

Repository files navigation

Honocord - Imagine an interactions bot

Honocord is a powerful, type-safe library for building Discord bots using interactions with the Hono web framework.

What is Honocord?

Honocord bridges Discord's Interaction API with Hono's lightweight web framework, allowing you to build fast, serverless Discord bots that run on edge platforms like Cloudflare Workers, or traditional Node.js environments.

Key Features

  • 🚀 Edge-First Design - Optimized for Cloudflare Workers with async interaction handling
  • 📘 Fully Type-Safe - Built with TypeScript using discord-api-types for complete type safety (I hope at least)
  • 🎯 Handler-Based Architecture - Clean, modular system for commands, components, and modals
  • ⚡ Hono Integration - Leverages Hono's lightweight, fast routing capabilities
  • 🔧 Flexible Deployment - Works with Cloudflare Workers, Bun, Node.js, and more
  • 🎨 Rich Builders - Re-exports Discord.js builders for creating embeds, buttons, modals, and more
  • 🤖 Autocomplete Support - Built-in autocomplete helper for slash commands
  • 🔐 Secure by Default - Automatic signature verification for Discord interactions

Disclaimer: Yes, AI helped me build this - the the focus on helped.

Wiki

Refer to the Wiki for detailed guides on getting started, building handlers, deployment, and more.

Also get familiar with Discord.js and Discord API Concepts.

Getting Help

If you encounter issues or have questions:

  • Check the Examples repo
  • Review the documentation pages
  • Open an issue on GitHub

Examples

Browse the Examples repo for complete, working implementations:

  • cloudflare-workers - Basic bot on Cloudflare Workers
  • custom-hono-integration - Integration with existing Hono apps (with Bun)

About

Package for Discord Interactions with Hono

Topics

Resources

License

Stars

Watchers

Forks