npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@devs_des1re/djs-kit

v0.0.7

Published

A command-line interface tool for creating Discord.js v14 bots with a complete project structure, permission system, and MongoDB integration.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

devs_des1redevs_des1re

Keywords

Readme

@devs_des1re/djs-kit

A command-line interface tool for creating Discord.js v14 bots with a complete project structure, permission system, and MongoDB integration.

Badges

Version Downloads License Node Version Discord.js Version Build Status PRs Welcome

Table of Contents

Overview

@devs_des1re/djs-kit is a scaffolding tool that generates a production-ready Discord.js bot project. It creates an organized codebase with support for slash commands, prefix commands, buttons, select menus, modals, and MongoDB database integration. The generated bot includes a built-in permission system that allows you to restrict commands to specific roles or users.

Features

Complete Discord.js v14 Support The generated bot uses Discord.js v14 with full support for all modern Discord features including slash commands, buttons, select menus, modals, and context menus.

Modular Architecture The project structure separates components into dedicated folders for commands, events, buttons, dropdowns, modals, and utilities, making the codebase easy to maintain and scale.

Permission System Every command and interaction can be restricted to specific Discord roles or users using simple arrays in the command configuration.

Database Integration MongoDB with Mongoose ODM is pre-configured and ready to use. The connection is established automatically when the bot starts.

Multiple Package Manager Support The CLI works with npm, yarn, pnpm, and bun. Choose your preferred package manager during setup.

Installation

Global Installation

npm install -g @devs_des1re/djs-kit

Using npx (No Installation Required)

npx @devs_des1re/djs-kit create

Verifying Installation

djs-kit --version

Quick Start

Create your first Discord bot in four commands:

npx @devs_des1re/djs-kit create
cd djs-kit
npm run deploy
npm start

Usage

Interactive Mode

djs-kit create

You will be prompted for:

  • Bot name (use . for current directory)
  • Description
  • Discord Bot Token
  • Discord Client ID
  • Discord Guild ID
  • MongoDB URI
  • Package manager (npm, yarn, pnpm, bun)
  • Install dependencies (yes/no)

Non-Interactive Mode

djs-kit create --yes

Custom Output Directory

djs-kit create --output ./my-projects

Command Help

djs-kit create --help

Data

The generated bot uses configuration properties in each command and interaction file to control behavior and permissions.

disabled

The disabled property determines whether a command or interaction handler is active.

When set to false, the command is enabled and available for use. This is the default setting.

When set to true, the command is disabled and will not be loaded into the bot or executable by users.

This property is useful for temporarily disabling commands without deleting the file, deprecating old commands while keeping the code for reference, or disabling commands during maintenance or testing.

roles

The roles property restricts command usage to specific Discord role IDs. Users must have at least one of the specified roles to use the command.

When an empty array is provided, there are no role restrictions and anyone can use the command. This is the default setting.

When an array of role IDs is provided, only users who have at least one of those roles can execute the command.

To get a role ID, enable Developer Mode in Discord settings, then right-click on a role in server settings and click Copy ID.

users

The users property restricts command usage to specific Discord user IDs. Only the specified users can use the command.

When an empty array is provided, there are no user restrictions and anyone can use the command. This is the default setting.

When an array of user IDs is provided, only the specified users can execute the command.

To get a user ID, enable Developer Mode in Discord settings, then right-click on any user and click Copy ID.

Combined Restrictions

When both roles and users arrays are provided with values, the user must satisfy both conditions. They must have at least one of the specified roles and also be one of the specified users.

When roles is empty and users has values, only the specified users can use the command with no role requirements.

When users is empty and roles has values, only users with the specified roles can use the command with no user restrictions.

When both arrays are empty, anyone can use the command with no restrictions.

Permission Hierarchy

The permission system checks roles first, then users. If a command has both restrictions, the user must pass both checks. If a user fails either check, they receive a permission denied message.

Commands that are disabled take precedence over permission checks. A disabled command will not be loaded at all, regardless of the user's roles or user ID.

Troubleshooting

Bot Doesn't Start

Verify that all required environment variables are set in the .env file. Ensure your Discord token is valid and the bot has the required intents enabled in the Discord Developer Portal.

Commands Not Appearing

Run npm run deploy to register slash commands with Discord. For guild commands, verify the DISCORD_GUILD_ID is correct. Global commands can take up to an hour to propagate.

Permission Errors

Ensure the bot has the necessary permissions in your Discord server including Send Messages, Embed Links, Use Slash Commands, Read Message History, and for moderation commands, Manage Messages.

MongoDB Connection Errors

Verify the MONGODB_URI is correct. The bot will continue running even without a database connection, but features that require the database will not work.

Contributing

Contributions are welcome. Please open an issue or submit a pull request on GitHub.

License

This project is licensed under the MIT License.