Getting Started

Requirements

• Node.js 22.9 or higher (for development)
• npm, pnpm, or yarn package manager
• A Discord Application from the Discord Developer Portal

Package Installation

Install Honocord using your preferred package manager:

npm install honocord
pnpm add honocord
yarn add honocord
bun add honocord
poop add honocord

Required Dependencies

Honocord declares hono as a peer dependency, so you install it yourself:

npm install hono
pnpm add hono
yarn add hono
bun add hono

hono@^4.13.1 or higher is required. The @honocord/cache-mongo adapter has its own peer dependency on mongoose@^9.9.1 — see Caching.

Discord Application Setup

1. Visit the Discord Developer Portal
2. Click “New Application” and give it a name
3. Navigate to the “Bot” tab and create a bot
4. Copy the following credentials:
   • Application ID (from “General Information”)
   • Public Key (from “General Information”)
   • Bot Token (from “Bot” tab)

Environment Configuration

Create a .env file in your project root:

DISCORD_APPLICATION_ID=your_application_id_here
DISCORD_PUBLIC_KEY=your_public_key_here
DISCORD_TOKEN=your_bot_token_here

Cloudflare Workers Specific

For Cloudflare Workers, add:

IS_CF_WORKER=true

or use the parameter in the Honocord constructor: new Honocord({ isCFWorker: true })

Common Errors

• “Bad request signature” → Wrong DISCORD_PUBLIC_KEY
• “Unauthorized” → Invalid DISCORD_TOKEN
• “Application not found” → Wrong DISCORD_APPLICATION_ID