Project Structure

Understand how Disflow organizes your bot project.

Directory Layout

Project Structure

my-bot/
├── commands/          # Your slash commands
│   ├── ping.js
│   ├── hello.js
│   └── dice.js
│
├── emoji/             # Custom emoji dictionary
│   └── emoji.js
│
├── vals/              # Global values
│   └── values.js
│
├── utils/             # Helper files (optional)
│   └── events.js
│
├── .env               # Bot token
├── index.js           # Entry point
└── package.json

📂 commands/

Every .js file in this folder automatically becomes a slash command.

Auto-Loading

✅ All .js files are loaded automatically
✅ Commands register to Discord on startup
✅ No manual registration needed
✅ Hot reload support (restart to see changes)

Example Structure

commands/
├── ping.js              # /ping command
├── hello.js             # /hello command
├── moderation/
│   ├── ban.js           # /ban command
│   └── kick.js          # /kick command
└── fun/
    ├── dice.js          # /dice command
    └── 8ball.js         # /8ball command

😀 emoji/

Define custom emoji shortcuts for your bot.

emoji/emoji.js

// emoji/emoji.js
export default {
  wave: '👋',
  check: '✅',
  cross: '❌',
  loading: '⏳',
  tada: '🎉',
  
  // Custom server emojis
  customEmoji: '<:name:id>',
  animatedEmoji: '<a:name:id>'
}

Usage in Commands

bot.command.new('test', 'Test', async function() {
  await this.reply(`${this.emoji.wave} Hello!`);
  // Output: 👋 Hello!
});

📊 vals/

Store global configuration values for your bot.

vals/values.js

// vals/values.js
export default {
  bot: {
    name: 'My Bot',
    version: '1.0.0',
    prefix: '!'
  },
  
  colors: {
    primary: 0x00d9ff,
    success: 0x00ff00,
    error: 0xff0000
  },
  
  limits: {
    maxUsers: 100,
    cooldown: 5000
  }
}

Usage in Commands

bot.command.new('info', 'Bot info', async function() {
  await this.reply({
    embeds: [{
      title: this.vals.bot.name,
      description: `Version ${this.vals.bot.version}`,
      color: this.vals.colors.primary
    }]
  });
});

⚡ index.js

The entry point of your bot - keep it simple!

index.js

import { createBot } from 'disflow';
 
// That's it! Bot starts automatically
await createBot();

✨ No configuration needed! Disflow handles client creation, login, command loading, and more.

Project Structure

Directory Layout

📂 commands/

Auto-Loading

Example Structure

😀 emoji/

Usage in Commands

📊 vals/

Usage in Commands

⚡ index.js

💡 Best Practices

✅ Do

❌ Don't