Shadow — WhatsApp Bot

A modular WhatsApp bot powered by Mira — fast, pluggable, and production-ready.

---

Table of contents

• Features
• Quick Start
• Configuration
• Command structure
• Contributing
• License

---

Features

• Modular command loader (commands/*) with categories.
• Admin-check utilities and group management suite (promote/demote/kick/tagall/hidetag).
• Interactive help menu with image.
• Multi-session support (multi-file auth state).
• Ready for production with PM2 or Docker.

---

Quick Start

# clone
git clone https://github.com/lee-min-seo-official/shadow.git
cd shadow

# install
npm install

# run
node index.js

# run with pm2 for long time
pm2 start index.js --name shadow

---

Configuration

• Yes, it is not very difficult to understand!
• Easy to change prefix, OWNER details trough one file (config.js).
• Only one file and all things updates.
• Mods supported.
• Economy supported (pending).

---

Command Structure

commands/
  utility/
    help.js
    ping.js
  group/
    kick.js
    promote.js
    demote.js
    tagall.js

• Note: you can add more folders as categories and js files in them.
• Below is the example of command structure:

module.exports = {
  name: 'ping',
  aliases: ['p'],
  description: 'Check latency',
  execute: async (sock, m, args, context) => { ... }
};

Contributing

Fork the repository, and try to make some tests for improvements.

---

License

MIT © 2025 Lee Min Seo

---