Registry / web-framework / zumito-framework

zumito-framework

library1.15.4jsnpmunverified

A Discord.js bot framework designed to accelerate Discord bot development by providing built-in command handling, event handling, and a modular architecture. The framework is written in TypeScript and ships with type definitions, enabling type-safe development. It uses Discord.js as its underlying library and Express for a web server component. Current stable version: 1.15.4, released in February 2026. The framework is actively maintained with frequent bug fixes and feature updates, following a monthly release cadence. Key differentiators include a focus on DRY principles, a module-based system for easy extensibility, and comprehensive documentation at docs.zumito.dev.

web-framework http-networking communication

npm install zumito-framework

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ZUMITO-FRAMEWORK

zumito-framework

web-frameworkjavascriptv1.15.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Framework

✓ import { Framework } from 'zumito-framework'

✗ const Framework = require('zumito-framework');

ESM-only; require() will fail because the package is type: module and exports ES modules.

Module

✓ import { Module } from 'zumito-framework'

✗ import Module from 'zumito-framework';

Module is a named export, not default.

Command

✓ import { Command } from 'zumito-framework'

Named export, used for defining slash commands.

Shows how to initialize the framework, create a module, and define a slash command.

import { Framework, Module, Command } from 'zumito-framework'; import { Client, GatewayIntentBits } from 'discord.js'; const client = new Client({ intents: [GatewayIntentBits.Guilds] }); class PingCommand extends Command { constructor() { super({ name: 'ping', description: 'Replies with Pong!' }); } async execute(interaction) { await interaction.reply('Pong!'); } } class MyModule extends Module { constructor() { super({ name: 'my-module', commands: [new PingCommand()] }); } } const framework = new Framework({ client, token: process.env.DISCORD_TOKEN ?? '', modules: [new MyModule()], }); framework.start();

Debug

Known issues

breakingSince v1.14.0, the Framework constructor requires a `load` callback option; omitting it will cause a runtime error on startup.

fix

Add a `load` callback to the options object passed to the Framework constructor.

affects: >=1.14.0

gotchaConfig file loading changed in v1.14.1 to use pathToFileURL for compatibility; if you use a custom config file loader, ensure it handles file:// URLs.

fix

Update any custom config file loading logic to use pathToFileURL (Node's URL) for Windows path compatibility.

affects: 1.14.1

breakingThe `webServer.port` is now optional since v1.14.3; previously it was required. Existing code that relies on the port being defined may break if not set.

fix

When using a custom web server port, explicitly set `webServer.port` in the framework options.

affects: <1.14.3

deprecatedDirect use of `require()` for importing the package has been deprecated since v1.14.4 and will be removed in a future version.

fix

Switch to ES module imports (import statements) and ensure your project uses 'type': 'module' in package.json.

affects: >=1.14.4

Errors

Common errors & fixes

TypeError: Framework is not a constructor

Using CommonJS require() which returns an object with named exports, not the Framework class directly.

fix

Use named import: import { Framework } from 'zumito-framework'

Error: Cannot find module 'discord.js'

The package requires discord.js as a peer dependency, but it's not installed.

fix

Install discord.js: npm install discord.js

TypeError: module.exports is not a function

Attempting to use Framework as a default export when it's a named export.

fix

Use named import: import { Framework } from 'zumito-framework'

Upgrade

Version history

1.15.4latest on npm

Audit

Dependencies

discord.jsrequiredCore dependency for interacting with the Discord API

expressoptionalUsed for the built-in web server component

Agent activity

44 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/ZumitoTeam/zumito-framework ↗

packagehttps://www.npmjs.com/package/zumito-framework ↗

homepagehttps://zumito.dev ↗