glyria.js

The Discord bot framework with a clean DX — built on top of discord.js.

File-based commands, auto-imports, Embed V2 support, and zero boilerplate out of the box.

Quick start

npm install @glyria/bot
npx glyria init

Fill in your .env:

TOKEN=your_bot_token_here

Start your bot:

npm run dev

Why glyria.js?

Zero boilerplate

// src/index.ts — that's it
const client = new GlyriaClient({
  intents: [GatewayIntentBits.Guilds]
})

await client.login()

File-based commands

Drop a file in src/commands/ — it's automatically loaded and registered on Discord.

// src/commands/ping.ts — no imports needed
export default new GlyriaCommand()
  .setName("ping")
  .setDescription("Pong!")
  .execute(async (ctx) => {
    await ctx.reply({ content: "Pong!" })
  })

Subcommands & groups

export default new GlyriaCommand()
  .setName("moderation")
  .setDescription("Moderation commands")
  .addSubCommand((cmd) =>
    cmd
      .setName("ban")
      .setDescription("Ban a user")
      .addUserOption((option) =>
        option.setName("user").setDescription("User to ban").setRequired(true)
      )
      .execute(async (ctx) => { /* handle ban */ })
  )
  .addSubCommandGroup((group) =>
    group
      .setName("config")
      .setDescription("Configuration")
      .addSubCommand((cmd) =>
        cmd
          .setName("logs")
          .setDescription("Configure logs")
          .addBooleanOption((option) =>
            option.setName("enabled").setDescription("Enable logs").setRequired(true)
          )
          .execute(async (ctx) => { /* handle logs config */ })
      )
  )

Embed V2 builder

First-class support for Discord's new Components V2 system:

const embed = new EmbedV2Builder()
  .container({ accentColor: 0x5865F2 })
    .textDisplay("# Hello!")
    .separator({ spacing: "large" })
    .section()
      .textDisplay("Choose your role")
      .buttonAccessory({ label: "Pick", customId: "role_picker", style: "primary" })
    .end()
    .actionRow()
      .button({ label: "Confirm", customId: "confirm", style: "success" })
      .button({ label: "Cancel", customId: "cancel", style: "danger" })
    .end()
  .end()
  .build()

await ctx.reply({ ...embed })

Styled replies

await ctx.g.reply.success("User banned successfully!")
await ctx.g.reply.error("You don't have permission.")
await ctx.g.reply.info("Here are the details...")

Auto-imports

Every glyria.js utility is available globally — no import needed anywhere:

// GlyriaClient, GlyriaCommand, GlyriaEvent, EmbedV2Builder,
// GlyriaBus, createReplyableContext, GatewayIntentBits, Events...
// all available without a single import line

CLI

| Command | Description | |---|---| | npx glyria init | Scaffold a new project | | npm run dev | Start in dev mode with hot reload | | npm run build | Compile for production | | npm run start | Start in production mode | | npm run generate | Regenerate auto-imports |

Configuration

// glyria.config.ts
export default defineGlyriaConfig({
  theme: {
    embedV2: {
      primaryColor: "#5865F2",
      successColor: "#57F287",
      errorColor: "#ED4245",
      footer: {
        text: "My Bot • v1.0"
      }
    }
  }
})

Support

• 📖 Documentation — js.glyria.app
• 💬 Discord — discord.gg/FMTdrdNJx5
• 🐛 Issues — GitHub Issues

Requirements

• Node.js 22.x or higher
• TypeScript 6.x
• discord.js 14.x (installed automatically)

License

MIT — Glyria