djs-builder 0.7.3 → 0.7.5

package/README.md

@@ -73,11 +73,10 @@ const starterOptions = {
 
   // 🌐 Dashboard Configuration (Full docs at the end of this page)
   dashboard: {
-    clientID: "YOUR_DISCORD_CLIENT_ID",        // 🔑 Discord Application Client ID
     clientSecret: "YOUR_DISCORD_CLIENT_SECRET", // 🔐 Discord Application Client Secret
-    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL
-    sessionSecret: "your-super-secret-key",    // 🔒 Session encryption secret
-    port: 3000,                                 // 🌍 Dashboard port (default: 3000)
+    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL (OPTINAL)
+    sessionSecret: "your-super-secret-key", // 🔒 Session encryption secret
+    port: 3000, // 🌍 Dashboard port (OPTINAL / default: 3000)
   },
 };
 
@@ -393,6 +392,1057 @@ console.log(
 
 ---
 
+<details>
+<summary>CreateModal 🔳</summary>
+
+**🔳 CreateModal – Easily create Discord Modals with Text Inputs, Menus, Files, and Labels ✨**
+
+`CreateModal` is a powerful utility to build Discord **Modals**. It supports:
+
+- **Text Inputs** 📝
+- **Select Menus** 🎯 (`string`, `role`, `user`, `channel`)
+- **File Uploads** 📎
+- **Text Displays** 🏷️
+
+---
+
+### 📌 Example Usage:
+
+```js
+const { CreateModal } = require("djs-builder");
+
+const modal = CreateModal({
+  id: "myModal",
+  title: "User Information",
+  components: [
+    {
+      type: "textInput",
+      components: [
+        {
+          label: "Your Name",
+          id: "name",
+          style: 1, // 1: Short, 2: Paragraph
+          placeholder: "Enter your name",
+          required: true,
+          minLength: 2,
+          maxLength: 50,
+        },
+      ],
+    },
+    {
+      type: "menu",
+      components: {
+        type: "string",
+        options: {
+          id: "favoriteColor",
+          placeholder: "Choose your favorite color",
+          min: 1,
+          max: 1,
+          data: [
+            {
+              label: "Red",
+              value: "red",
+              description: "A bold color",
+              emoji: "🔴",
+              default: false,
+            },
+            {
+              label: "Blue",
+              value: "blue",
+              description: "A calm color",
+              emoji: "🔵",
+            },
+          ],
+          label: "label",
+          value: "value",
+          description: "description",
+          emoji: "emoji",
+          disabled: false,
+        },
+      },
+    },
+    {
+      type: "file",
+      components: {
+        id: "avatar",
+        label: "Upload Avatar",
+        description: "Optional avatar image",
+      },
+    },
+    {
+      type: "label",
+      components: {
+        label: "Thank you for your input!",
+      },
+    },
+  ],
+});
+
+// Show the modal
+await interaction.showModal(modal);
+```
+
+---
+
+### 📔 Examples for Each Component Type:
+
+#### 🔹 Text Input Example:
+
+```js
+{
+  type: "textInput",
+  components: [
+    {
+      label: "Your Age",
+      id: "age",
+      style: 1, // Short input
+      placeholder: "Enter your age",
+      required: true,
+      minLength: 1,
+      maxLength: 3,
+      value: "18", // Pre-filled
+    },
+  ],
+},
+```
+
+#### 🔹 Menu Example:
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "string",
+    options: {
+      id: "country",
+      placeholder: "Select your country",
+      min: 1,
+      max: 1,
+      data: [
+        {
+          name: "USA",
+          id: "usa",
+          desc: "United States",
+          icon: "🇺🇸",
+          default: true, // This option is pre-selected
+        },
+        {
+          name: "Canada",
+          id: "canada",
+          desc: "Canada",
+          icon: "🇨🇦",
+        },
+      ],
+      label: "name", // Maps to 'name' field in data
+      value: "id",   // Maps to 'id' field in data
+      description: "desc", // Maps to 'desc' field
+      emoji: "icon", // Maps to 'icon' field
+      disabled: false,
+    },
+  },
+},
+```
+
+#### 🔹 File Example:
+
+```js
+{
+  type: "file",
+  components: {
+    id: "document",
+    label: "Upload Document",
+    description: "Upload a PDF or image",
+  },
+},
+```
+
+#### 🔹 Label Example:
+
+```js
+{
+  type: "label",
+  components: {
+    label: "Please fill out the form above.",
+  },
+},
+```
+
+---
+
+### �📖 Explanation
+
+#### 🔹 Text Input
+
+- `label` → Label for the input field
+- `id` → customId for the input
+- `style` → 1: Short, 2: Paragraph
+- `placeholder` → Placeholder text
+- `required` → true/false
+- `minLength` / `maxLength` → Min/Max characters
+- `value` → Pre-filled value
+
+#### 🔹 Menu
+
+Same as CreateRow select menus.
+
+- `type` → `"string" | "user" | "role" | "channel"`
+- `id` → customId for menu
+- `placeholder` → Text shown before selection
+- `min` / `max` → Min/Max selectable values
+- `data` → Options array (for string select only)
+
+  - `label` → Visible text (maps to the field specified in `label` key)
+  - `value` → Internal value (maps to the field specified in `value` key)
+  - `description` → Short description (maps to the field specified in `description` key)
+  - `emoji` → Option emoji (maps to the field specified in `emoji` key)
+  - `default` → Pre-selected option (true/false in data array)
+
+- `label` → Key in data to use as label (e.g., "name")
+- `value` → Key in data to use as value (e.g., "id")
+- `description` → Key in data to use as description (e.g., "desc")
+- `emoji` → Key in data to use as emoji (e.g., "icon")
+- `disabled` → Disable menu completely
+- `defaultValues` → Pre-selected user/role/channel options (for non-string menus)
+- `channelTypes` → Restrict selectable channel types (for channel menu)
+
+#### 🔹 File
+
+- `id` → customId for the file upload
+- `label` → Label
+- `description` → Description
+
+#### 🔹 Label
+
+- `label` → Text to display
+
+---
+
+### 🔹 Notes
+
+- Supports multiple components in one modal
+- Fully customizable with Discord.js ModalBuilder
+
+</details>
+
+---
+
+<details>
+<summary>CreateComponents 🧩</summary>
+
+**🧩 CreateComponents – Build Advanced Discord UI Components with Containers, Sections & Media ✨**
+
+`CreateComponents` is a powerful utility to build Discord's **new UI components**. It supports:
+
+- **Text Displays** 📝
+- **Separators** ➖
+- **Media Galleries** 🖼️
+- **File Attachments** 📎
+- **Buttons** 🔘
+- **Select Menus** 🎯 (`string`, `role`, `user`, `channel`)
+- **Sections with Accessories** 📦 (Thumbnails & Buttons)
+- **Containers** 📦 (Group all components together)
+
+---
+
+### 📌 Example Usage (Array Mode):
+
+```js
+const { CreateComponents } = require("djs-builder");
+
+const components = await CreateComponents("array", [
+  {
+    type: "text",
+    content: "Welcome to our server! 🎉",
+  },
+  {
+    type: "separator",
+    divider: true,
+    spacing: 1, // 1: Small, 2: Large
+  },
+  {
+    type: "media",
+    links: [
+      "https://example.com/image1.png",
+      {
+        url: "https://example.com/image2.png",
+        description: "A cool image",
+        spoiler: true,
+      },
+    ],
+  },
+  {
+    type: "button",
+    components: [
+      {
+        id: "btn_1",
+        style: 1, // 1: Primary, 2: Secondary, 3: Success, 4: Danger, 5: Link
+        label: "Click Me!",
+        emoji: "🚀",
+      },
+      {
+        id: "btn_2",
+        style: 3,
+        label: "Confirm",
+      },
+    ],
+  },
+]);
+
+// Send the components
+await channel.send({ components });
+```
+
+---
+
+### 📌 Example Usage (Container Mode):
+
+```js
+const { CreateComponents } = require("djs-builder");
+
+const components = await CreateComponents("container", [
+  {
+    type: "text",
+    content: "# 📢 Server Announcement\nWelcome everyone!",
+  },
+  {
+    type: "separator",
+    divider: true,
+  },
+  {
+    type: "section",
+    content: "Check out our latest updates and news!",
+    accessory: {
+      type: "thumbnail",
+      url: "https://example.com/thumbnail.png",
+      description: "News Image",
+    },
+  },
+  {
+    type: "section",
+    content: "**Click below to get your roles!**",
+    accessory: {
+      type: "button",
+      id: "get_roles",
+      style: 1,
+      label: "Get Roles",
+      emoji: "🎭",
+    },
+  },
+  {
+    type: "media",
+    links: ["https://example.com/banner.png"],
+  },
+  {
+    type: "button",
+    components: [
+      { id: "rules", style: 2, label: "📜 Rules", emoji: "📜" },
+      { id: "help", style: 2, label: "❓ Help", emoji: "❓" },
+      { style: 5, label: "🌐 Website", url: "https://example.com" },
+    ],
+  },
+]);
+
+// Send with container
+await channel.send({ components, flags: 32768 }); // flags for components v2
+```
+
+---
+
+### 📜 Examples for Each Component Type:
+
+---
+
+<details>
+<summary>🔹 Text Component Examples</summary>
+
+#### 📌 Simple Text:
+
+```js
+{
+  type: "text",
+  content: "Hello World! 👋",
+}
+```
+
+#### 📌 Text with Markdown:
+
+```js
+{
+  type: "text",
+  content: "# 📢 Announcement\n**Important:** Server maintenance tonight!",
+}
+```
+
+#### 📌 Text with Multiple Lines:
+
+```js
+{
+  type: "text",
+  content: `## 🎮 Game Stats
+  
+**Player:** Ahmed
+**Level:** 50
+**XP:** 12,500 / 15,000
+**Rank:** Diamond 💎`,
+}
+```
+
+#### 📌 Text with Emojis & Formatting:
+
+```js
+{
+  type: "text",
+  content: ">>> 💡 **Tip:** Use `/help` to see all commands!\n\n*This message will auto-delete in 30 seconds*",
+}
+```
+
+</details>
+
+---
+
+<details>
+<summary>➖ Separator Component Examples</summary>
+
+**➖ Separator – Add spacing and dividers between components**
+
+The separator component allows you to add visual breaks between other components with customizable spacing and divider lines.
+
+---
+
+### 📖 Separator Options
+
+| Option    | Type      | Default | Description                                        |
+| --------- | --------- | ------- | -------------------------------------------------- |
+| `type`    | `string`  | —       | Must be `"separator"`                              |
+| `divider` | `boolean` | `false` | Show a horizontal dividing line                    |
+| `spacing` | `number`  | `1`     | Spacing size: `1` (Small) or `2` (Large)           |
+
+---
+
+#### 📌 Simple Divider Line:
+
+```js
+{
+  type: "separator",
+  divider: true,
+}
+```
+**Result:** A thin horizontal line appears between components.
+
+---
+
+#### 📌 Separator without Line (Spacing Only):
+
+```js
+{
+  type: "separator",
+  divider: false,
+  spacing: 2, // Large spacing
+}
+```
+**Result:** Empty space without any visible line - useful for visual grouping.
+
+---
+
+#### 📌 Small Spacing with Divider:
+
+```js
+{
+  type: "separator",
+  divider: true,
+  spacing: 1, // Small spacing (default)
+}
+```
+**Result:** A divider line with minimal padding above and below.
+
+---
+
+#### 📌 Large Spacing with Divider:
+
+```js
+{
+  type: "separator",
+  divider: true,
+  spacing: 2, // Large spacing
+}
+```
+**Result:** A divider line with more padding - creates stronger visual separation.
+
+---
+
+### 💡 When to Use Each Option:
+
+| Scenario                              | `divider` | `spacing` |
+| ------------------------------------- | --------- | --------- |
+| Separate major sections               | `true`    | `2`       |
+| Separate sub-sections                 | `true`    | `1`       |
+| Group related items visually          | `false`   | `1`       |
+| Create breathing room between content | `false`   | `2`       |
+| Minimal separation                    | `false`   | `1`       |
+
+</details>
+
+---
+
+<details>
+<summary>🖼️ Media Gallery Examples</summary>
+
+**🖼️ Media Gallery – Display images in a beautiful gallery format**
+
+The media component creates an image gallery that can display one or multiple images. Each image can be a simple URL string or a detailed object with additional options.
+
+
+---
+
+### 📌 Format 1: Simple String URLs
+
+The simplest way - just pass image URLs as strings:
+
+```js
+{
+  type: "media",
+  links: ["https://example.com/image.png"],
+}
+```
+
+---
+
+### 📌 Format 2: Object with Full Options
+
+For more control, use objects with url, description, and spoiler:
+
+```js
+{
+  type: "media",
+  links: [
+    {
+      url: "https://example.com/image.png",
+      description: "A beautiful sunset",
+      spoiler: false,
+    },
+  ],
+}
+```
+
+---
+
+### 📌 Single Image with Spoiler:
+
+```js
+{
+  type: "media",
+  links: [
+    {
+      url: "https://example.com/spoiler.png",
+      description: "⚠️ Spoiler Alert!",
+      spoiler: true,
+    },
+  ],
+}
+```
+
+---
+
+### 📌 Multiple Images (Simple Strings):
+
+```js
+{
+  type: "media",
+  links: [
+    "https://example.com/image1.png",
+    "https://example.com/image2.png",
+    "https://example.com/image3.png",
+    "https://example.com/image4.png",
+  ],
+}
+```
+**Result:** A 2x2 gallery grid of images.
+
+---
+
+### 📌 Mixed Format (Strings + Objects):
+
+You can mix simple strings with detailed objects in the same array:
+
+```js
+{
+  type: "media",
+  links: [
+    // Simple string - just the URL
+    "https://example.com/public-image.png",
+    
+    // Object with description
+    {
+      url: "https://example.com/special-image.png",
+      description: "Limited Edition Art",
+    },
+    
+    // Object with spoiler
+    {
+      url: "https://example.com/secret-image.png",
+      description: "Secret Content",
+      spoiler: true,
+    },
+    
+    // Another simple string
+    "https://example.com/another-image.png",
+  ],
+}
+```
+
+---
+
+### 📌 Meme/Artwork Gallery with Spoilers:
+
+```js
+{
+  type: "media",
+  links: [
+    {
+      url: "https://example.com/meme1.png",
+      description: "Funny meme #1",
+      spoiler: false,
+    },
+    {
+      url: "https://example.com/meme2.png",
+      description: "Funny meme #2",
+      spoiler: false,
+    },
+    {
+      url: "https://example.com/nsfw-meme.png",
+      description: "⚠️ Slightly inappropriate",
+      spoiler: true, // Hidden behind blur
+    },
+  ],
+}
+```
+
+---
+
+### 💡 Tips for Media Galleries:
+
+| Images Count | Display Layout         |
+| ------------ | ---------------------- |
+| 1 image      | Full width single image |
+| 2 images     | Side by side           |
+| 3 images     | 1 large + 2 small      |
+| 4+ images    | Grid layout            |
+
+- Use `description` for accessibility and context
+- Use `spoiler: true` for sensitive/spoiler content
+- Mix formats freely - strings for quick images, objects for detailed ones
+- Images are displayed in the order provided
+
+</details>
+
+---
+
+<details>
+<summary>📎 File Component Examples</summary>
+
+#### 📌 Simple File Attachment:
+
+```js
+{
+  type: "file",
+  url: "attachment://document.pdf",
+}
+```
+
+
+
+#### 📌 Full Example with File:
+
+```js
+const { CreateComponents } = require("djs-builder");
+const { AttachmentBuilder } = require("discord.js");
+
+const file = new AttachmentBuilder("./myfile.txt", { name: "myfile.txt" });
+
+const components = await CreateComponents("container", [
+  {
+    type: "text",
+    content: "📄 **Here is your requested file:**",
+  },
+  {
+    type: "file",
+    url: "attachment://myfile.txt",
+  },
+]);
+
+await channel.send({ components, files: [file], flags: 32768 });
+```
+
+</details>
+
+---
+
+<details>
+<summary>🔘 Button Component Examples</summary>
+
+#### 📌 Button with Emoji:
+
+```js
+{
+  type: "button",
+  components: [
+    {
+      id: "like_btn",
+      style: 3, // Success (Green)
+      label: "Like",
+      emoji: "👍",
+    },
+  ],
+}
+```
+
+#### 📌 Multiple Buttons in Row:
+
+```js
+{
+  type: "button",
+  components: [
+    { id: "btn_yes", style: 3, label: "Yes", emoji: "✅" },
+    { id: "btn_no", style: 4, label: "No", emoji: "❌" },
+    { id: "btn_maybe", style: 2, label: "Maybe", emoji: "🤔" },
+  ],
+}
+```
+
+#### 📌 All Button Styles:
+
+```js
+{
+  type: "button",
+  components: [
+    { id: "primary", style: 1, label: "Primary", emoji: "🔵" },    // Blue
+    { id: "secondary", style: 2, label: "Secondary", emoji: "⚪" }, // Gray
+    { id: "success", style: 3, label: "Success", emoji: "🟢" },    // Green
+    { id: "danger", style: 4, label: "Danger", emoji: "🔴" },      // Red
+    { style: 5, label: "Link", emoji: "🔗", url: "https://discord.com" }, // Link
+  ],
+}
+```
+
+
+</details>
+
+---
+
+<details>
+<summary>🎯 Menu Component Examples</summary>
+
+#### 📌 String Select Menu (Basic):
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "string",
+    options: {
+      id: "color_select",
+      placeholder: "🎨 Choose a color",
+      data: [
+        { name: "Red", id: "red", icon: "🔴" },
+        { name: "Blue", id: "blue", icon: "🔵" },
+        { name: "Green", id: "green", icon: "🟢" },
+      ],
+      label: "name",
+      value: "id",
+      emoji: "icon",
+    },
+  },
+}
+```
+
+#### 📌 String Select with Description:
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "string",
+    options: {
+      id: "role_select",
+      placeholder: "🎭 Select your role",
+      data: [
+        { name: "Gamer", id: "gamer", desc: "For gaming enthusiasts", icon: "🎮" },
+        { name: "Artist", id: "artist", desc: "For creative people", icon: "🎨" },
+        { name: "Developer", id: "dev", desc: "For coders & programmers", icon: "💻" },
+        { name: "Music Lover", id: "music", desc: "For music fans", icon: "🎵" },
+      ],
+      label: "name",
+      value: "id",
+      description: "desc",
+      emoji: "icon",
+    },
+  },
+}
+```
+
+#### 📌 String Select with Min/Max:
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "string",
+    options: {
+      id: "games_select",
+      placeholder: "🎮 Select your favorite games (2-4)",
+      min: 2,
+      max: 4,
+      data: [
+        { name: "Minecraft", id: "mc", icon: "⛏️" },
+        { name: "Fortnite", id: "fn", icon: "🔫" },
+        { name: "Valorant", id: "val", icon: "🎯" },
+        { name: "League of Legends", id: "lol", icon: "⚔️" },
+        { name: "Rocket League", id: "rl", icon: "🚗" },
+      ],
+      label: "name",
+      value: "id",
+      emoji: "icon",
+    },
+  },
+}
+```
+
+
+#### 📌 User Select (Multiple):
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "user",
+    options: {
+      id: "users_select",
+      placeholder: "👥 Select users to invite (1-5)",
+      min: 1,
+      max: 5,
+    },
+  },
+}
+```
+
+#### 📌 Role Select Menu:
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "role",
+    options: {
+      id: "role_select",
+      placeholder: "🎭 Select a role",
+      min: 1,
+      max: 1,
+    },
+  },
+}
+```
+
+
+#### 📌 Channel Select Menu:
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "channel",
+    options: {
+      id: "channel_select",
+      placeholder: "📢 Select a channel",
+      min: 1,
+      max: 1,
+    },
+  },
+}
+```
+
+#### 📌 Channel Select with Type Filter:
+
+```js
+const { ChannelType } = require("discord.js");
+
+{
+  type: "menu",
+  components: {
+    type: "channel",
+    options: {
+      id: "text_channel_select",
+      placeholder: "💬 Select a text channel",
+      channelTypes: [ChannelType.GuildText, ChannelType.GuildAnnouncement],
+    },
+  },
+}
+```
+
+#### 📌 Menu with Default Values (User/Role/Channel):
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "user",
+    options: {
+      id: "user_select_default",
+      placeholder: "👤 Select users",
+      min: 1,
+      max: 3,
+      defaultValues: [
+        { id: "123456789012345678", type: "user" },
+        { id: "987654321098765432", type: "user" },
+      ],
+    },
+  },
+}
+```
+
+</details>
+
+---
+
+<details>
+<summary>📦 Section Component Examples</summary>
+
+
+#### 📌 Section with Thumbnail (Product):
+
+```js
+{
+  type: "section",
+  content: "🛒 **iPhone 15 Pro**\n💰 Price: $999\n⭐ Rating: 4.8/5\n📦 In Stock: Yes",
+  accessory: {
+    type: "thumbnail",
+    url: "https://example.com/iphone.png",
+    description: "iPhone 15 Pro Image",
+  },
+}
+```
+
+#### 📌 Section with Button :
+
+```js
+{
+  type: "section",
+  content: "🎁 **Daily Reward**\nClick to claim your daily reward!\n💎 **+100 Coins**",
+  accessory: {
+    type: "button",
+    id: "claim_daily",
+    style: 3, 
+    label: "Claim",
+    emoji: "🎁",
+  },
+}
+```
+
+
+
+
+</details>
+
+---
+
+
+### 📖 Component Types Explanation
+
+#### 🔹 Text
+
+- `type` → `"text"`
+- `content` → The text content to display (supports Markdown)
+
+#### 🔹 Separator
+
+- `type` → `"separator"`
+- `divider` → Show a dividing line (true/false)
+- `spacing` → Spacing size (1: Small, 2: Large)
+
+#### 🔹 Media Gallery
+
+- `type` → `"media"`
+- `links` → Array of image URLs or objects with:
+  - `url` → Image URL
+  - `description` → Alt text for the image
+  - `spoiler` → Hide behind spoiler (true/false)
+
+#### 🔹 File
+
+- `type` → `"file"`
+- `url` → File URL or attachment reference
+- `spoiler` → Hide behind spoiler (true/false)
+
+#### 🔹 Button
+
+- `type` → `"button"`
+- `components` → Array of button objects:
+  - `id` → customId (required for non-link buttons)
+  - `style` → 1: Primary, 2: Secondary, 3: Success, 4: Danger, 5: Link
+  - `label` → Button text
+  - `emoji` → Button emoji
+  - `disabled` → Disable button (true/false)
+  - `url` → URL for link buttons (style: 5)
+
+#### 🔹 Menu
+
+- `type` → `"menu"`
+- `components` → Object containing:
+  - `type` → `"string" | "user" | "role" | "channel"`
+  - `options` → Menu configuration:
+    - `id` → customId
+    - `placeholder` → Placeholder text
+    - `min` / `max` → Min/Max selectable values
+    - `data` → Options array (for string select)
+    - `label` → Key in data for label
+    - `value` → Key in data for value
+    - `emoji` → Key in data for emoji
+    - `description` → Key in data for description
+    - `channelTypes` → Channel types filter (for channel menu)
+    - `defaultValues` → Pre-selected values
+
+#### 🔹 Section
+
+- `type` → `"section"`
+- `content` → Text content for the section
+- `accessory` → Side component:
+  - **Button Accessory:**
+    - `type` → `"button"`
+    - `id` → customId
+    - `style` → Button style
+    - `label` → Button text
+    - `emoji` → Button emoji
+    - `url` → URL (for link buttons)
+  - **Thumbnail Accessory:**
+    - `type` → `"thumbnail"`
+    - `url` → Image URL
+    - `description` → Image description
+
+---
+
+### 🔹 Mode Differences
+
+| Feature          | `"array"` Mode          | `"container"` Mode        |
+| ---------------- | ----------------------- | ------------------------- |
+| Return Type      | Array of components     | Single ContainerBuilder   |
+| Usage            | Standard messages       | Components V2 messages    |
+| Sections Support | ✅                      | ✅                        |
+| Grouping         | Individual components   | All grouped in container  |
+| Flags Required   | ❌                      | ✅ (flags: 32768)         |
+
+---
+
+### 🔹 Notes
+
+- Use `"container"` mode for Discord's **Components V2** (newer UI)
+- Use `"array"` mode for standard component arrays
+- Sections can have either a **button** or **thumbnail** as accessory, not both
+- Media galleries support multiple images in a single component
+- All components are fully customizable 🎨
+
+</details>
+
+---
+
 <details>
 <summary>Wait ⏰</summary>
 
@@ -412,148 +1462,811 @@ console.log(
 ```js
 const { Wait } = require("djs-builder");
 
-const response = await Wait({
-  context: message, // Message or Interaction object
-  userId: message.author.id, // Optional: filter by user
-  type: "both", // "message" | "interaction" | "both"
-  time: 30000, // Time in ms
-  message_Wait: message, // Required if waiting for buttons/selects
-});
+const response = await Wait({
+  context: message, // Message or Interaction object
+  userId: message.author.id, // Optional: filter by user
+  type: "both", // "message" | "interaction" | "both"
+  time: 30000, // Time in ms
+  message_Wait: message, // Required if waiting for buttons/selects
+});
+
+if (!response) return console.log("⏱️ Timeout!");
+console.log("✅ Collected:", response);
+```
+
+---
+
+### 🔹 Options
+
+- `context` → The message or interaction context
+- `userId` → Only collect from this user (optional)
+- `type` → `"message" | "interaction" | "both"`
+- `time` → Timeout in milliseconds
+- `message_Wait` → Message containing buttons/select menus (for interaction/both type)
+
+---
+
+### 🔹 Notes
+
+- Supports **automatic cleanup** of collectors after completion
+- Can return **Message**, **Interaction**, or **ModalSubmitInteraction**
+
+</details>
+
+---
+
+<details>
+<summary>GetUser 👤</summary>
+
+**👤 GetUser – Fetch a GuildMember easily from a message ✨**
+
+`GetUser` helps to detect a **target member** in multiple ways:
+
+1. Mention (`@User`)
+2. User ID (`123456789012345678`)
+3. Reply to another message
+
+---
+
+### 📌 Example Usage:
+
+```js
+const { GetUser } = require("djs-builder");
+
+const data = await GetUser(message);
+
+if (!data) return message.reply("❌ Could not find the user.");
+
+const member = data.user; // GuildMember object
+const args = data.args; // Remaining arguments
+const reason = args.join(" ") || "No reason provided";
+
+await member.ban({ reason });
+message.reply(`🚫 ${member.user.tag} was banned for: ${reason}`);
+```
+
+---
+
+### 🔹 Returns
+
+```js
+{
+  user: <GuildMember>,  // Targeted member
+  args: [ "arg1", "arg2" ] // Remaining message arguments
+}
+```
+
+---
+
+### 🔹 Detection Methods
+
+- **Mention:** `!ban @Ahmed Spamming`
+- **User ID:** `!ban 123456789012345678 Spamming`
+- **Reply:** `Reply to user's message with !ban`
+
+---
+
+### 🔹 Notes
+
+- Automatically handles missing users
+- Returns `null` if user not found
+- Works in any text channel of the guild
+
+</details>
+
+---
+
+<details>
+<summary>Logging System 🛡️</summary>
+
+## 🛡️ Logging System – Track Everything in Your Server
+
+The **Logging System** is a powerful feature that keeps track of almost everything happening inside your Discord server 🔍.  
+From **messages** 📝 to **channels** 📂, **roles** 🎭, **invites** 🔗, and even **voice state changes** 🎙️ – nothing goes unnoticed!
+
+> **Note 1**: Using `database: true` requires a **MongoDB** connection. | **Note 2**: You can import the **Log** model for direct database access 💾.
+
+---
+
+### 📦 Module Exports
+
+```js
+const { log, Log } = require("djs-builder");
+```
+
+- `log(client, options)` → Start the logging system with your configuration 🚀.
+- `Log` → The Mongoose model for direct database access and custom modifications 💾.
+
+---
+
+### ✨ Features
+
+- 📝 **Messages** – Deleted & edited messages are logged with details.
+- 📂 **Channels** – Creation, deletion, and updates are tracked.
+- 🎭 **Roles** – Created, deleted, and updated roles, including member role changes.
+- 🎙️ **Voice State** – Joins, leaves, and moves between channels.
+- 🔗 **Invites** – Created invites & usage tracking.
+- 😀 **Emojis & Stickers** – Added, removed, or updated.
+- 👤 **Members** – Join, leave, kick, ban, and unban events.
+- 🚨 **Audit Log Integration** – Fetches the executor (who did what).
+- 🎨 **Beautiful Embeds** – Every log is shown in a clean, styled embed with timestamps.
+- 🗄️ **Caching System** – Fast performance with built-in data caching.
+
+---
+
+### 📊 Database Schema
+
+The logging system uses the following data structure:
+
+```js
+{
+  guildId: String,      // 🏠 Server ID (required)
+  channelId: String,    // 📢 Default log channel ID
+  channels: Object,     // 📂 Custom channels per event type (optional)
+  colors: Object,       // 🎨 Custom colors per event type (optional)
+  disable: Array,       // 🚫 Array of disabled event types (optional)
+}
+```
+
+---
+
+<details>
+<summary>📋 Supported Event Types</summary>
+
+### 📋 Supported Event Types
+
+| Event Type          | Description               |
+| ------------------- | ------------------------- |
+| `messageDelete`     | Message deleted 📝        |
+| `messageUpdate`     | Message edited ✏️         |
+| `channelCreate`     | Channel created 📁        |
+| `channelDelete`     | Channel deleted 🗑️        |
+| `channelUpdate`     | Channel updated ⚙️        |
+| `guildMemberAdd`    | Member joined 🎉          |
+| `guildMemberRemove` | Member left/kicked 🚪     |
+| `guildBanAdd`       | Member banned 🔨          |
+| `guildBanRemove`    | Member unbanned 🤗        |
+| `roleCreate`        | Role created 🏅           |
+| `roleDelete`        | Role deleted ❌           |
+| `roleUpdate`        | Role updated 🔄           |
+| `guildMemberUpdate` | Member roles changed 👤   |
+| `voiceStateUpdate`  | Voice channel activity 🎤 |
+| `inviteCreate`      | Invite created 🔗         |
+| `emojiCreate`       | Emoji added 😀            |
+| `emojiDelete`       | Emoji removed 🚫          |
+| `emojiUpdate`       | Emoji updated 🔄          |
+| `stickerCreate`     | Sticker added ✨          |
+| `stickerDelete`     | Sticker removed 🗑️        |
+| `stickerUpdate`     | Sticker updated 🌀        |
+
+</details>
+
+---
+
+<details>
+<summary>⚡ Method Using Database (Recommended) 🗄️</summary>
+
+### 🗄️ Using MongoDB Database
+
+This method stores log configuration in MongoDB, allowing dynamic management via commands.
+
+**⚡ Setup in `clientReady` Event:**
+
+```js
+const { log } = require("djs-builder");
+
+module.exports = {
+  name: "clientReady",
+  async run(client) {
+    // Start logging with database mode
+    await log(client, {
+      database: true, // 🗄️ Uses MongoDB to store/fetch config
+    });
+
+    console.log("✅ Logging system started with database mode!");
+  },
+};
+```
+
+---
+
+### 💡 How It Works
+
+- ✅ The system automatically fetches log configuration for each guild from MongoDB.
+- 🛠️ You can manage settings via slash commands (see management command below).
+- 🎨 Supports per-guild customization for channels, colors, and disabled events.
+- 📖 **Important**: If you use database mode, see the [Log Management Command](#-slash-command-for-log-management-) below to edit data.
+
+</details>
+
+---
+
+<details>
+<summary>⚡ Method Using Custom Data Array 📋</summary>
+
+### 📋 Using Custom Data Array
+
+This method uses a predefined array of configurations – perfect for simple setups or testing.
+
+**⚡ Setup in `clientReady` Event:**
+
+```js
+const { log } = require("djs-builder");
+
+module.exports = {
+  name: "clientReady",
+  async run(client) {
+    // Define your log configurations
+    const logData = [
+      {
+        guildId: "123456789012345678", // 🏠 Server ID
+        channelId: "987654321098765432", // 📢 Default log channel
+        channels: {
+          // 📂 Custom channels (optional)
+          messageDelete: "111111111111111111",
+          voiceStateUpdate: "222222222222222222",
+        },
+        colors: {
+          // 🎨 Custom colors (optional)
+          messageDelete: "DarkRed",
+          channelCreate: "DarkGreen",
+        },
+        disable: ["inviteCreate"], // 🚫 Disabled events (optional)
+      },
+      // Add more guild configurations...
+      {
+        guildId: "999888777666555444",
+        channelId: "444555666777888999",
+      },
+    ];
+
+    // Start logging with custom data
+    await log(client, {
+      database: false, // 📋 Uses custom array
+      Data: logData, // 📊 Your configurations
+    });
 
-if (!response) return console.log("⏱️ Timeout!");
-console.log("✅ Collected:", response);
+    console.log("✅ Logging system started with custom data!");
+  },
+};
 ```
 
 ---
 
-### 🔹 Options
+### 🎨 Supported Colors
 
-- `context` → The message or interaction context
-- `userId` → Only collect from this user (optional)
-- `type` → `"message" | "interaction" | "both"`
-- `time` → Timeout in milliseconds
-- `message_Wait` → Message containing buttons/select menus (for interaction/both type)
+`Default`, `White`, `Aqua`, `Green`, `Blue`, `Yellow`, `Purple`, `LuminousVividPink`, `Fuchsia`, `Gold`, `Orange`, `Red`, `Grey`, `Navy`, `DarkAqua`, `DarkGreen`, `DarkBlue`, `DarkPurple`, `DarkVividPink`, `DarkGold`, `DarkOrange`, `DarkRed`, `DarkGrey`, `DarkerGrey`, `LightGrey`, `DarkNavy`, `Blurple`, `Greyple`, `DarkButNotBlack`, `NotQuiteBlack`, `Random`, or any **Hex Color** like `#FF5733`.
 
 ---
 
-### 🔹 Notes
+### 🌐 Multi-Guild Support
 
-- Supports **automatic cleanup** of collectors after completion
-- Can return **Message**, **Interaction**, or **ModalSubmitInteraction**
+> 💡 **Tip:** You can add configurations for multiple guilds in the same array. Each guild can have its own unique settings for channels, colors, and disabled events!
 
 </details>
 
 ---
 
 <details>
-<summary>GetUser 👤</summary>
+<summary>🔧 Direct Database Access with Log Model 💾</summary>
 
-**👤 GetUser – Fetch a GuildMember easily from a message ✨**
+### 💾 Using the Log Model Directly
 
-`GetUser` helps to detect a **target member** in multiple ways:
+You can import the `Log` Mongoose model to create, update, or delete log configurations programmatically.
 
-1. Mention (`@User`)
-2. User ID (`123456789012345678`)
-3. Reply to another message
+**📥 Import the Model:**
 
----
+```js
+const { Log } = require("djs-builder");
+```
 
-### 📌 Example Usage:
+**➕ Create New Configuration:**
 
 ```js
-const { GetUser } = require("djs-builder");
+const { Log } = require("djs-builder");
+
+// Create a new log configuration for a guild
+const newConfig = await Log.create({
+  guildId: "123456789012345678",
+  channelId: "987654321098765432",
+  channels: {
+    messageDelete: "111111111111111111",
+  },
+  colors: {
+    messageDelete: "Red",
+  },
+  disable: [],
+});
 
-const data = await GetUser(message);
+console.log("✅ Log configuration created!", newConfig);
+```
 
-if (!data) return message.reply("❌ Could not find the user.");
+**✏️ Update Existing Configuration:**
 
-const member = data.user; // GuildMember object
-const args = data.args; // Remaining arguments
-const reason = args.join(" ") || "No reason provided";
+```js
+const { Log } = require("djs-builder");
 
-await member.ban({ reason });
-message.reply(`🚫 ${member.user.tag} was banned for: ${reason}`);
+// Update log channel
+await Log.findOneAndUpdate(
+  { guildId: "123456789012345678" },
+  { channelId: "NEW_CHANNEL_ID" },
+  { upsert: true } // Create if doesn't exist
+);
+
+// Add event to disable list
+await Log.findOneAndUpdate(
+  { guildId: "123456789012345678" },
+  { $push: { disable: "voiceStateUpdate" } }
+);
+
+// Remove event from disable list
+await Log.findOneAndUpdate(
+  { guildId: "123456789012345678" },
+  { $pull: { disable: "voiceStateUpdate" } }
+);
+
+// Update specific channel for an event
+await Log.findOneAndUpdate(
+  { guildId: "123456789012345678" },
+  { $set: { "channels.messageDelete": "NEW_CHANNEL_ID" } }
+);
+
+// Update specific color for an event
+await Log.findOneAndUpdate(
+  { guildId: "123456789012345678" },
+  { $set: { "colors.messageDelete": "DarkRed" } }
+);
 ```
 
----
+**🗑️ Delete Configuration:**
 
-### 🔹 Returns
+```js
+const { Log } = require("djs-builder");
+
+await Log.findOneAndDelete({ guildId: "123456789012345678" });
+console.log("🗑️ Log configuration deleted!");
+```
+
+**📊 Fetch Configuration:**
 
 ```js
-{
-  user: <GuildMember>,  // Targeted member
-  args: [ "arg1", "arg2" ] // Remaining message arguments
+const { Log } = require("djs-builder");
+
+const config = await Log.findOne({ guildId: "123456789012345678" });
+if (config) {
+  console.log("📢 Log Channel:", config.channelId);
+  console.log("📂 Custom Channels:", config.channels);
+  console.log("🎨 Custom Colors:", config.colors);
+  console.log("🚫 Disabled Events:", config.disable);
 }
 ```
 
+</details>
+
 ---
 
-### 🔹 Detection Methods
+<details>
+<summary>🌐 Dashboard Integration – Manage Logs from Web Panel 🖥️</summary>
 
-- **Mention:** `!ban @Ahmed Spamming`
-- **User ID:** `!ban 123456789012345678 Spamming`
-- **Reply:** `Reply to user's message with !ban`
+### 🖥️ Web Dashboard for Log Management
 
----
+When you use **database mode** (`database: true`), you can manage the logging system directly from the **djs-builder Dashboard**! 🎛️
 
-### 🔹 Notes
+---
 
-- Automatically handles missing users
-- Returns `null` if user not found
-- Works in any text channel of the guild
+#### ✨ Dashboard Features for Logs
 
-</details>
+| Feature                | Description                                  |
+| ---------------------- | -------------------------------------------- |
+| 📢 **Default Channel** | Set the main channel for all logs            |
+| 📂 **Custom Channels** | Assign specific channels for each event type |
+| 🎨 **Custom Colors**   | Choose embed colors for each event type      |
+| 🔄 **Toggle Events**   | Enable/Disable specific event types          |
+| 📊 **Statistics**      | View enabled/disabled events count           |
+| 🗑️ **Reset**           | Clear all log settings with one click        |
 
 ---
 
-<details>
-  <summary>Logging System 🛡️</summary>
+#### 🚀 How to Access
 
-The **Logging System** is a powerful feature that keeps track of almost everything happening inside your Discord server 🔍.  
-From **messages** 📝 to **channels** 📂, **roles** 🎭, **invites** 🔗, and even **voice state changes** 🎙️ – nothing goes unnoticed!
+1. Navigate to your dashboard (e.g., `http://localhost:3000`)
+2. Log in with Discord OAuth2
+3. Select a server
+4. Click on **"سجلات المراقبة"** (Logs) in the sidebar
 
 ---
 
-### ✨ Features
+#### ⚠️ Important Notes
 
-- 📝 **Messages** – Deleted & edited messages are logged with details.
-- 📂 **Channels** – Creation, deletion, and updates are tracked.
-- 🎭 **Roles** – Created, deleted, and updated roles, including member role changes.
-- 🎙️ **Voice State** – Joins, leaves, and moves between channels.
-- 🔗 **Invites** – Created invites & usage tracking.
-- 😀 **Emojis & Stickers** – Added, removed, or updated.
-- 🚨 **Audit Log Integration** – Fetches the executor (who did what).
-- 🎨 **Beautiful Embeds** – Every log is shown in a clean, styled embed with timestamps.
+**When `database: true`:**
+
+- ✅ Full editing capabilities from dashboard
+- ✅ Changes are saved automatically to MongoDB
+- ✅ Real-time updates
+
+**When `database: false` (Custom Data Array):**
+
+- ⚠️ Dashboard shows **read-only** mode
+- ⚠️ A warning banner appears at the top
+- ⚠️ You must edit settings in your code
+
+</details>
 
 ---
 
-### ⚙️ Setup Example
+<details>
+<summary>🎮 Slash Command for Log Management 🛠️</summary>
+
+### 🛠️ Complete Log Management Slash Command
+
+This command allows server administrators to manage the logging system via Discord.
 
-Using the `log` function is very simple ⚡.  
-Just place this code inside an event (like `clientReady`) to start logging:
+> ⚠️ **Important**: This command requires `database: true` mode to work properly.
 
 ```js
-const { log } = require("djs-builder");
+const { Log, getLogConfigData } = require("djs-builder");
+const {
+  SlashCommandBuilder,
+  PermissionFlagsBits,
+  EmbedBuilder,
+  ChannelType,
+} = require("discord.js");
+
+// All supported event types (21 events)
+const EVENT_TYPES = [
+  { name: "Message Delete", value: "messageDelete" },
+  { name: "Message Update", value: "messageUpdate" },
+  { name: "Channel Create", value: "channelCreate" },
+  { name: "Channel Delete", value: "channelDelete" },
+  { name: "Channel Update", value: "channelUpdate" },
+  { name: "Member Join", value: "guildMemberAdd" },
+  { name: "Member Leave", value: "guildMemberRemove" },
+  { name: "Member Ban", value: "guildBanAdd" },
+  { name: "Member Unban", value: "guildBanRemove" },
+  { name: "Role Create", value: "roleCreate" },
+  { name: "Role Delete", value: "roleDelete" },
+  { name: "Role Update", value: "roleUpdate" },
+  { name: "Member Role Update", value: "guildMemberUpdate" },
+  { name: "Voice State", value: "voiceStateUpdate" },
+  { name: "Invite Create", value: "inviteCreate" },
+  { name: "Emoji Create", value: "emojiCreate" },
+  { name: "Emoji Delete", value: "emojiDelete" },
+  { name: "Emoji Update", value: "emojiUpdate" },
+  { name: "Sticker Create", value: "stickerCreate" },
+  { name: "Sticker Delete", value: "stickerDelete" },
+  { name: "Sticker Update", value: "stickerUpdate" },
+];
+
+// Helper function to clear cache after updates
+function clearLogCache(guildId) {
+  const logData = getLogConfigData();
+  if (logData.clearCache) logData.clearCache(guildId);
+}
 
 module.exports = {
-  name: "clientReady",
-  async run(client) {
-    await log(
-      client,
-      "GUILD_ID", // 🏠 Guild ID (server)
-      "CHANNEL_ID" // 📢 Channel ID for logs
-    );
+  data: new SlashCommandBuilder()
+    .setName("logs")
+    .setDescription("🛡️ Manage the server logging system")
+    .setDefaultMemberPermissions(PermissionFlagsBits.Administrator)
+    .addSubcommand((sub) =>
+      sub
+        .setName("setup")
+        .setDescription("📢 Set up the default log channel")
+        .addChannelOption((opt) =>
+          opt
+            .setName("channel")
+            .setDescription("The channel to send logs to")
+            .addChannelTypes(ChannelType.GuildText)
+            .setRequired(true)
+        )
+    )
+    .addSubcommand((sub) =>
+      sub
+        .setName("channel")
+        .setDescription("📂 Set a specific channel for an event type")
+        .addStringOption((opt) =>
+          opt
+            .setName("event")
+            .setDescription("The event type")
+            .setRequired(true)
+            .addChoices(...EVENT_TYPES)
+        )
+        .addChannelOption((opt) =>
+          opt
+            .setName("channel")
+            .setDescription("The channel for this event")
+            .addChannelTypes(ChannelType.GuildText)
+            .setRequired(true)
+        )
+    )
+    .addSubcommand((sub) =>
+      sub
+        .setName("color")
+        .setDescription("🎨 Set a custom color for an event type")
+        .addStringOption((opt) =>
+          opt
+            .setName("event")
+            .setDescription("The event type")
+            .setRequired(true)
+            .addChoices(...EVENT_TYPES)
+        )
+        .addStringOption((opt) =>
+          opt
+            .setName("color")
+            .setDescription("Color name or hex code (e.g., Red, #FF5733)")
+            .setRequired(true)
+        )
+    )
+    .addSubcommand((sub) =>
+      sub
+        .setName("toggle")
+        .setDescription("🔄 Enable or disable an event type")
+        .addStringOption((opt) =>
+          opt
+            .setName("event")
+            .setDescription("The event type")
+            .setRequired(true)
+            .addChoices(...EVENT_TYPES)
+        )
+        .addStringOption((opt) =>
+          opt
+            .setName("action")
+            .setDescription("Enable or disable")
+            .setRequired(true)
+            .addChoices(
+              { name: "Enable", value: "enable" },
+              { name: "Disable", value: "disable" }
+            )
+        )
+    )
+    .addSubcommand((sub) =>
+      sub.setName("view").setDescription("📊 View current log configuration")
+    )
+    .addSubcommand((sub) =>
+      sub
+        .setName("reset")
+        .setDescription("🗑️ Reset all log settings for this server")
+    ),
+
+  async run(client, interaction) {
+    await interaction.deferReply({ ephemeral: true });
+
+    const subcommand = interaction.options.getSubcommand();
+    const guildId = interaction.guild.id;
+
+    // ═══════════════════════════════════════════════════════
+    // 📢 SETUP - Set default log channel
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "setup") {
+      const channel = interaction.options.getChannel("channel");
+
+      await Log.findOneAndUpdate(
+        { guildId },
+        { guildId, channelId: channel.id },
+        { upsert: true, new: true }
+      );
+
+      clearLogCache(guildId); // Clear cache to apply changes immediately
+
+      const embed = new EmbedBuilder()
+        .setTitle("✅ Logging System Setup")
+        .setDescription(`Logs will now be sent to ${channel}`)
+        .setColor("Green")
+        .setTimestamp();
+
+      return interaction.editReply({ embeds: [embed] });
+    }
+
+    // ═══════════════════════════════════════════════════════
+    // 📂 CHANNEL - Set specific channel for event
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "channel") {
+      const event = interaction.options.getString("event");
+      const channel = interaction.options.getChannel("channel");
+
+      await Log.findOneAndUpdate(
+        { guildId },
+        { $set: { [`channels.${event}`]: channel.id } },
+        { upsert: true }
+      );
+
+      clearLogCache(guildId);
+
+      const eventName =
+        EVENT_TYPES.find((e) => e.value === event)?.name || event;
+      const embed = new EmbedBuilder()
+        .setTitle("📂 Event Channel Updated")
+        .setDescription(`**${eventName}** logs will now be sent to ${channel}`)
+        .setColor("Blue")
+        .setTimestamp();
+
+      return interaction.editReply({ embeds: [embed] });
+    }
+
+    // ═══════════════════════════════════════════════════════
+    // 🎨 COLOR - Set custom color for event
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "color") {
+      const event = interaction.options.getString("event");
+      const color = interaction.options.getString("color");
+
+      await Log.findOneAndUpdate(
+        { guildId },
+        { $set: { [`colors.${event}`]: color } },
+        { upsert: true }
+      );
+
+      clearLogCache(guildId);
+
+      const eventName =
+        EVENT_TYPES.find((e) => e.value === event)?.name || event;
+      
+      // Try to use the color, fallback to Blue if invalid
+      let embedColor;
+      try {
+        embedColor = color;
+      } catch {
+        embedColor = "Blue";
+      }
+
+      const embed = new EmbedBuilder()
+        .setTitle("🎨 Event Color Updated")
+        .setDescription(
+          `**${eventName}** embeds will now use color: \`${color}\``
+        )
+        .setColor(embedColor)
+        .setTimestamp();
+
+      return interaction.editReply({ embeds: [embed] });
+    }
+
+    // ═══════════════════════════════════════════════════════
+    // 🔄 TOGGLE - Enable/Disable event
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "toggle") {
+      const event = interaction.options.getString("event");
+      const action = interaction.options.getString("action");
+
+      if (action === "disable") {
+        await Log.findOneAndUpdate(
+          { guildId },
+          { $addToSet: { disable: event } },
+          { upsert: true }
+        );
+      } else {
+        await Log.findOneAndUpdate(
+          { guildId },
+          { $pull: { disable: event } },
+          { upsert: true }
+        );
+      }
+
+      clearLogCache(guildId);
+
+      const eventName =
+        EVENT_TYPES.find((e) => e.value === event)?.name || event;
+      const embed = new EmbedBuilder()
+        .setTitle(
+          action === "disable" ? "🚫 Event Disabled" : "✅ Event Enabled"
+        )
+        .setDescription(`**${eventName}** logging has been ${action}d`)
+        .setColor(action === "disable" ? "Red" : "Green")
+        .setTimestamp();
+
+      return interaction.editReply({ embeds: [embed] });
+    }
+
+    // ═══════════════════════════════════════════════════════
+    // 📊 VIEW - Show current configuration
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "view") {
+      const config = await Log.findOne({ guildId });
+
+      if (!config) {
+        return interaction.editReply({
+          content:
+            "❌ No logging configuration found for this server. Use `/logs setup` first!",
+        });
+      }
+
+      const channelsList = config.channels
+        ? Object.entries(config.channels)
+            .map(([k, v]) => {
+              const eventName = EVENT_TYPES.find((e) => e.value === k)?.name || k;
+              return `• **${eventName}**: <#${v}>`;
+            })
+            .join("\n") || "None"
+        : "None";
+
+      const colorsList = config.colors
+        ? Object.entries(config.colors)
+            .map(([k, v]) => {
+              const eventName = EVENT_TYPES.find((e) => e.value === k)?.name || k;
+              return `• **${eventName}**: \`${v}\``;
+            })
+            .join("\n") || "None"
+        : "None";
+
+      const disabledList =
+        config.disable?.length > 0
+          ? config.disable.map((e) => {
+              const eventName = EVENT_TYPES.find((ev) => ev.value === e)?.name || e;
+              return `• ${eventName}`;
+            }).join("\n")
+          : "None";
+
+      const enabledCount = EVENT_TYPES.length - (config.disable?.length || 0);
+
+      const embed = new EmbedBuilder()
+        .setTitle("📊 Log Configuration")
+        .setDescription(`**${enabledCount}/${EVENT_TYPES.length}** events are enabled`)
+        .setColor("Blue")
+        .addFields(
+          {
+            name: "📢 Default Channel",
+            value: config.channelId ? `<#${config.channelId}>` : "Not set",
+            inline: true,
+          },
+          {
+            name: "📂 Custom Channels",
+            value: channelsList.slice(0, 1024) || "None",
+            inline: false,
+          },
+          {
+            name: "🎨 Custom Colors",
+            value: colorsList.slice(0, 1024) || "None",
+            inline: false,
+          },
+          {
+            name: "🚫 Disabled Events",
+            value: disabledList.slice(0, 1024) || "None",
+            inline: false,
+          }
+        )
+        .setFooter({ text: `Guild ID: ${guildId}` })
+        .setTimestamp();
+
+      return interaction.editReply({ embeds: [embed] });
+    }
+
+    // ═══════════════════════════════════════════════════════
+    // 🗑️ RESET - Delete all configuration
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "reset") {
+      await Log.findOneAndDelete({ guildId });
+      
+      clearLogCache(guildId);
+
+      const embed = new EmbedBuilder()
+        .setTitle("🗑️ Configuration Reset")
+        .setDescription(
+          "All logging settings have been deleted for this server."
+        )
+        .setColor("Red")
+        .setTimestamp();
+
+      return interaction.editReply({ embeds: [embed] });
+    }
   },
 };
 ```
 
+</details>
+
 ---
 
-### 💡 How It Works
+### 💡 Tips & Notes
 
-- ✅ Pass your **Client**, **Guild ID**, and **Log Channel ID**.
-- 🔔 Instantly starts tracking events and sending them to the log channel.
-- 🧰 No extra setup required – plug and play!
+- 🔄 **Caching**: The system caches guild configurations for better performance.
+- 🔐 **Permissions**: Make sure your bot has `View Audit Log` permission for full functionality.
+- 📢 **Invite Tracking**: Uses `discord-inviter` package for accurate invite tracking.
+- 🎨 **Default Colors**: Each event type has sensible default colors if not customized.
+- 🚫 **Disabled Events**: Events in the `disable` array will be completely ignored.
+- 📂 **Channel Fallback**: If no specific channel is set for an event, it uses `channelId`.
+- 💾 **Database Mode**: Recommended for multi-server bots with dynamic configuration needs.
+- 🌐 **Dashboard Integration**: When using database mode, you can manage logs via the web dashboard!
+
+---
 
 </details>
 
@@ -809,55 +2522,54 @@ const { Gstart } = require("djs-builder");
 const { EmbedBuilder } = require("discord.js");
 
 module.exports = {
-  name: "gstart",
-  description: "Starts a new highly-customized giveaway.",
-  run: async (client, message, args) => {
-    // ⏰ Giveaway ends in 48 hours
-    const twoDays = Date.now() + (48 * 60 * 60 * 1000);
-    const channelId = 'YOUR_GIVEAWAY_CHANNEL_ID'; // 📢 Target Channel
-
-    await Gstart({
-      context: message,
-      endTime: twoDays,
-      winers: 5, // 5 lucky winners! 🏆
-      channelId: channelId,
+  name: "gstart",
+  description: "Starts a new highly-customized giveaway.",
+  run: async (client, message, args) => {
+    // ⏰ Giveaway ends in 48 hours
+    const twoDays = Date.now() + 48 * 60 * 60 * 1000;
+    const channelId = "YOUR_GIVEAWAY_CHANNEL_ID"; // 📢 Target Channel
 
-      // 🎨 Customization for the STARTING EMBED
-      embed: {
+    await Gstart({
+      context: message,
+      endTime: twoDays,
+      winers: 5, // 5 lucky winners! 🏆
+      channelId: channelId,
 
-            custom: new EmbedBuilder().setTitle("Raw Embed"),// 💡 You can use 'custom' to pass a raw Discord.js EmbedBuilder JSON
-            title: "🎉 **HUGE SERVER BOOST GIVEAWAY!**",
-            description: "Click the button below to enter for a chance to win a free server boost!",
-            color: "Blue", // Any valid Discord color
-            image: "https://yourimage.com/banner.png", // image URL
-            thumbnail: message.guild.iconURL(),
-      },
+      // 🎨 Customization for the STARTING EMBED
+      embed: {
+        custom: new EmbedBuilder().setTitle("Raw Embed"), // 💡 You can use 'custom' to pass a raw Discord.js EmbedBuilder JSON
+        title: "🎉 **HUGE SERVER BOOST GIVEAWAY!**",
+        description:
+          "Click the button below to enter for a chance to win a free server boost!",
+        color: "Blue", // Any valid Discord color
+        image: "https://yourimage.com/banner.png", // image URL
+        thumbnail: message.guild.iconURL(),
+      },
 
       // 🛑 Customization for the ENDED EMBED
-      endEmbed: {
-            custom: new EmbedBuilder().setTitle("Raw Embed"),// 💡 You can use 'custom' to pass a raw Discord.js EmbedBuilder JSON
-            title: "🛑 Giveaway Has Concluded!",
-            description: "Congratulations to the winners! Check the message below.",
-            color: "Green",
-            // Eimage and Ethumbnail can also be set here
-      },
+      endEmbed: {
+        custom: new EmbedBuilder().setTitle("Raw Embed"), // 💡 You can use 'custom' to pass a raw Discord.js EmbedBuilder JSON
+        title: "🛑 Giveaway Has Concluded!",
+        description: "Congratulations to the winners! Check the message below.",
+        color: "Green", // Eimage and Ethumbnail can also be set here
+      },
 
       // 🖱️ Button Entry Method
-      reaction: {
-        type: "button", // Use 'reaction' for an emoji reaction
-        emoji: "✅", // The emoji displayed on the button
-        label: "Enter Giveaway!", // The text label
-        style: 3, // Button style: Primary(1), Secondary(2), Success(3), Danger(4)
-        id: "djs-builder-giveaway", // Custom ID for the button
-      },
+      reaction: {
+        type: "button", // Use 'reaction' for an emoji reaction
+        emoji: "✅", // The emoji displayed on the button
+        label: "Enter Giveaway!", // The text label
+        style: 3, // Button style: Primary(1), Secondary(2), Success(3), Danger(4)
+        id: "djs-builder-giveaway", // Custom ID for the button
+      },
 
       // 🔒 Requirements (Optional)
       requirements: {
         requiredRoles: ["123456789012345678"], // 🛡️ User MUST have this role to join (Button Only)
       },
-    });
-    message.reply("🎉 Giveaway started successfully!");
-  },
+    });
+    message.reply("🎉 Giveaway started successfully!");
+  },
 };
 ```
 
@@ -1103,14 +2815,14 @@ module.exports = {
       const result = await GaddUser(
         interaction.message.id,
         interaction.user.id,
-        interaction.guild 
+        interaction.guild
       );
 
       if (result?.error) {
         // Handles both "User Already Joined" and "Missing Roles" errors
         if (result.error === "❌ User Already Joined") {
-           // ... (Leave button logic)
-           const row = await CreateRow([
+          // ... (Leave button logic)
+          const row = await CreateRow([
             [
               {
                 label: "Leave Giveaway",
@@ -1120,16 +2832,17 @@ module.exports = {
             ],
           ]);
           return interaction.reply({
-            content: "⚠️ You have **already joined** this giveaway! You can **leave** by clicking the button below.",
+            content:
+              "⚠️ You have **already joined** this giveaway! You can **leave** by clicking the button below.",
             components: row,
-            flags: 64, 
+            flags: 64,
           });
         }
-        
+
         // Show error (e.g. Missing Role)
         return interaction.reply({
-            content: result.error,
-            flags: 64
+          content: result.error,
+          flags: 64,
         });
       }
 
@@ -1139,7 +2852,6 @@ module.exports = {
       });
     }
 
-
     // 2. Handle Leave Button Click (Dynamically Generated ID)
     if (
       interaction.customId &&
@@ -1534,7 +3246,7 @@ module.exports = {
         channelId: channel.id,
         winers: winnerCount,
         endTime: endTimeMs,
-        prize : prize,
+        prize: prize,
         embed: {
           title: `🎉 ${prize} Giveaway!`,
           image: image,
@@ -1810,7 +3522,6 @@ module.exports = {
 
 ---
 
-
 <details>
 <summary>Blacklist System 🚫</summary>
 
@@ -1882,10 +3593,12 @@ console.log("Role unblacklisted! 🔓");
 Returns an array of blacklisted items for a guild. You can optionally filter by type (`user`, `role`, `channel`).
 
 **Parameters:**
+
 - `guildId` (String): The ID of the guild.
 - `type` (String, optional): The type to filter by (`user`, `role`, `channel`).
 
 **Example:**
+
 ```js
 // Get all blacklisted items
 const allBlacklisted = await getBlacklist("GUILD_ID");
@@ -1910,35 +3623,80 @@ Output:
 You can create a slash command to manage the blacklist easily.
 
 ```js
-const { addToBlacklist, removeFromBlacklist, isBlacklisted, getBlacklist } = require("djs-builder");
-const { SlashCommandBuilder, PermissionFlagsBits, EmbedBuilder } = require("discord.js");
+const {
+  addToBlacklist,
+  removeFromBlacklist,
+  isBlacklisted,
+  getBlacklist,
+} = require("djs-builder");
+const {
+  SlashCommandBuilder,
+  PermissionFlagsBits,
+  EmbedBuilder,
+} = require("discord.js");
 
 module.exports = {
   data: new SlashCommandBuilder()
     .setName("blacklist")
     .setDescription("Manage the blacklist")
     .setDefaultMemberPermissions(PermissionFlagsBits.Administrator)
-    .addSubcommand(sub =>
-      sub.setName("add").setDescription("Add to blacklist")
-        .addUserOption(opt => opt.setName("user").setDescription("User to blacklist"))
-        .addRoleOption(opt => opt.setName("role").setDescription("Role to blacklist"))
-        .addChannelOption(opt => opt.setName("channel").setDescription("Channel to blacklist"))
+    .addSubcommand((sub) =>
+      sub
+        .setName("add")
+        .setDescription("Add to blacklist")
+        .addUserOption((opt) =>
+          opt.setName("user").setDescription("User to blacklist")
+        )
+        .addRoleOption((opt) =>
+          opt.setName("role").setDescription("Role to blacklist")
+        )
+        .addChannelOption((opt) =>
+          opt.setName("channel").setDescription("Channel to blacklist")
+        )
     )
-    .addSubcommand(sub =>
-      sub.setName("remove").setDescription("Remove from blacklist")
-        .addUserOption(opt => opt.setName("user").setDescription("User to remove"))
-        .addRoleOption(opt => opt.setName("role").setDescription("Role to remove"))
-        .addChannelOption(opt => opt.setName("channel").setDescription("Channel to remove"))
+    .addSubcommand((sub) =>
+      sub
+        .setName("remove")
+        .setDescription("Remove from blacklist")
+        .addUserOption((opt) =>
+          opt.setName("user").setDescription("User to remove")
+        )
+        .addRoleOption((opt) =>
+          opt.setName("role").setDescription("Role to remove")
+        )
+        .addChannelOption((opt) =>
+          opt.setName("channel").setDescription("Channel to remove")
+        )
     )
-    .addSubcommand(sub =>
-      sub.setName("check").setDescription("Check if a target is blacklisted")
-        .addUserOption(opt => opt.setName("user").setDescription("User to check"))
-        .addRoleOption(opt => opt.setName("role").setDescription("Role to check"))
-        .addChannelOption(opt => opt.setName("channel").setDescription("Channel to check"))
+    .addSubcommand((sub) =>
+      sub
+        .setName("check")
+        .setDescription("Check if a target is blacklisted")
+        .addUserOption((opt) =>
+          opt.setName("user").setDescription("User to check")
+        )
+        .addRoleOption((opt) =>
+          opt.setName("role").setDescription("Role to check")
+        )
+        .addChannelOption((opt) =>
+          opt.setName("channel").setDescription("Channel to check")
+        )
     )
-    .addSubcommand(sub =>
-      sub.setName("list").setDescription("List all blacklisted items")
-        .addStringOption(opt => opt.setName("type").setDescription("Filter by type").addChoices({ name: "User", value: "user" }, { name: "Role", value: "role" }, { name: "Channel", value: "channel" } , { name: "All", value: "all" }))
+    .addSubcommand((sub) =>
+      sub
+        .setName("list")
+        .setDescription("List all blacklisted items")
+        .addStringOption((opt) =>
+          opt
+            .setName("type")
+            .setDescription("Filter by type")
+            .addChoices(
+              { name: "User", value: "user" },
+              { name: "Role", value: "role" },
+              { name: "Channel", value: "channel" },
+              { name: "All", value: "all" }
+            )
+        )
     ),
   async run(interaction) {
     const sub = interaction.options.getSubcommand();
@@ -1948,54 +3706,95 @@ module.exports = {
     const guildId = interaction.guild.id;
 
     if (sub === "list") {
-        const type = interaction.options.getString("type");
-        if (type !== "all") {
+      const type = interaction.options.getString("type");
+      if (type !== "all") {
         const list = await getBlacklist(guildId, type);
 
-        if (!list.length) return interaction.reply({ content: "✅ No blacklisted items found.", flags : 64 });
+        if (!list.length)
+          return interaction.reply({
+            content: "✅ No blacklisted items found.",
+            flags: 64,
+          });
 
         const embed = new EmbedBuilder()
-            .setTitle("🚫 Blacklist")
-            .setColor("Red")
-            .setDescription(list.map(item => `• **${item.type.toUpperCase()}**: <${item.type === 'channel' ? '#' : item.type === 'role' ? '@&' : '@'}${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4000));
-
-        return interaction.reply({ embeds: [embed], flags : 64 });
-        } else {
+          .setTitle("🚫 Blacklist")
+          .setColor("Red")
+          .setDescription(
+            list
+              .map(
+                (item) =>
+                  `• **${item.type.toUpperCase()}**: <${
+                    item.type === "channel"
+                      ? "#"
+                      : item.type === "role"
+                      ? "@&"
+                      : "@"
+                  }${item.id}> (\`${item.id}\`)`
+              )
+              .join("\n")
+              .slice(0, 4000)
+          );
+
+        return interaction.reply({ embeds: [embed], flags: 64 });
+      } else {
         const list = await getBlacklist(guildId);
-        if (!list.length) return interaction.reply({ content: "✅ No blacklisted items found.", flags : 64 });
+        if (!list.length)
+          return interaction.reply({
+            content: "✅ No blacklisted items found.",
+            flags: 64,
+          });
 
         const embeds = [];
-        const roles = list.filter(i => i.type === "role");
-        const users = list.filter(i => i.type === "user");
-        const channels = list.filter(i => i.type === "channel");
+        const roles = list.filter((i) => i.type === "role");
+        const users = list.filter((i) => i.type === "user");
+        const channels = list.filter((i) => i.type === "channel");
 
         if (users.length) {
-            const userEmbed = new EmbedBuilder()
+          const userEmbed = new EmbedBuilder()
             .setTitle("🚫 Blacklisted Users")
             .setColor("Red")
-            .setDescription(users.map(item => `• <@${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4000));
-            embeds.push(userEmbed);
+            .setDescription(
+              users
+                .map((item) => `• <@${item.id}> (\`${item.id}\`)`)
+                .join("\n")
+                .slice(0, 4000)
+            );
+          embeds.push(userEmbed);
         }
-        if( roles.length) {
-            const roleEmbed = new EmbedBuilder()
+        if (roles.length) {
+          const roleEmbed = new EmbedBuilder()
             .setTitle("🚫 Blacklisted Roles")
             .setColor("Red")
-            .setDescription(roles.map(item => `• <@&${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4000));
-            embeds.push(roleEmbed);
+            .setDescription(
+              roles
+                .map((item) => `• <@&${item.id}> (\`${item.id}\`)`)
+                .join("\n")
+                .slice(0, 4000)
+            );
+          embeds.push(roleEmbed);
         }
-        if( channels.length) {
-            const channelEmbed = new EmbedBuilder()
+        if (channels.length) {
+          const channelEmbed = new EmbedBuilder()
             .setTitle("🚫 Blacklisted Channels")
             .setColor("Red")
-            .setDescription(channels.map(item => `• <#${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4000));
-            embeds.push(channelEmbed);
+            .setDescription(
+              channels
+                .map((item) => `• <#${item.id}> (\`${item.id}\`)`)
+                .join("\n")
+                .slice(0, 4000)
+            );
+          embeds.push(channelEmbed);
         }
-        return interaction.reply({ embeds, flags : 64 });
+        return interaction.reply({ embeds, flags: 64 });
+      }
     }
-  }
-  
+
     if (!user && !role && !channel) {
-      return interaction.reply({ content: "⚠️ You must provide at least one option (User, Role, or Channel).", flags : 64 });
+      return interaction.reply({
+        content:
+          "⚠️ You must provide at least one option (User, Role, or Channel).",
+        flags: 64,
+      });
     }
     const target = user || role || channel;
     const type = user ? "user" : role ? "role" : "channel";
@@ -2003,18 +3802,25 @@ module.exports = {
 
     if (sub === "add") {
       const success = await addToBlacklist(guildId, type, id);
-      if (success) interaction.reply(`✅ Added **${type}** ${target} to blacklist.`);
-      else interaction.reply(`⚠️ **${type}** ${target} is already blacklisted.`);
+      if (success)
+        interaction.reply(`✅ Added **${type}** ${target} to blacklist.`);
+      else
+        interaction.reply(`⚠️ **${type}** ${target} is already blacklisted.`);
     } else if (sub === "remove") {
       const success = await removeFromBlacklist(guildId, type, id);
-      if (success) interaction.reply(`✅ Removed **${type}** ${target} from blacklist.`);
+      if (success)
+        interaction.reply(`✅ Removed **${type}** ${target} from blacklist.`);
       else interaction.reply(`⚠️ **${type}** ${target} is not blacklisted.`);
     } else if (sub === "check") {
       const isBlocked = await isBlacklisted(guildId, type, id);
-      if (isBlocked) interaction.reply(`🚫 **${type}** ${target} is currently **blacklisted**.`);
-      else interaction.reply(`✅ **${type}** ${target} is **not** blacklisted.`);
+      if (isBlocked)
+        interaction.reply(
+          `🚫 **${type}** ${target} is currently **blacklisted**.`
+        );
+      else
+        interaction.reply(`✅ **${type}** ${target} is **not** blacklisted.`);
     }
-  }
+  },
 };
 ```
 
@@ -2160,6 +3966,7 @@ The **Dashboard System** is a modern, lightweight web-based control panel for yo
 - 📜 **Commands Viewer** – Browse all slash and prefix commands.
 - 🏆 **Level System Management** – View leaderboards, manage user XP and levels.
 - 🎉 **Giveaway Control** – Pause, resume, end, reroll, or delete giveaways.
+- 🦾 **Logging System Control** – Manage log channels, colors, and event toggles.
 - 🚫 **Blacklist Management** – Add/remove users, roles, or channels from blacklist.
 - 🎨 **Modern UI** – Beautiful, responsive design with dark mode support.
 
@@ -2191,11 +3998,10 @@ const starterOptions = {
 
   // 🌐 Dashboard Configuration
   dashboard: {
-    clientID: "YOUR_DISCORD_CLIENT_ID",        // 🔑 Discord Application Client ID
     clientSecret: "YOUR_DISCORD_CLIENT_SECRET", // 🔐 Discord Application Client Secret
-    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL
-    sessionSecret: "your-super-secret-key",    // 🔒 Session encryption secret
-    port: 3000,                                 // 🌍 Dashboard port (default: 3000)
+    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL (OPTINAL)
+    sessionSecret: "your-super-secret-key", // 🔒 Session encryption secret
+    port: 3000, // 🌍 Dashboard port (OPTINAL / default: 3000)
   },
 
   // ... other options (Status, database, anticrash, etc.)
@@ -2229,11 +4035,10 @@ client.once("ready", () => {
 
   // 🌐 Start the Dashboard
   dashboard(client, {
-    clientID: "YOUR_DISCORD_CLIENT_ID",        // 🔑 Discord Application Client ID
     clientSecret: "YOUR_DISCORD_CLIENT_SECRET", // 🔐 Discord Application Client Secret
-    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL
-    sessionSecret: "your-super-secret-key",    // 🔒 Session encryption secret
-    port: 3000,                                 // 🌍 Dashboard port (default: 3000)
+    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL (OPTINAL)
+    sessionSecret: "your-super-secret-key", // 🔒 Session encryption secret
+    port: 3000, // 🌍 Dashboard port (OPTINAL / default: 3000)
   });
 });
 ```
@@ -2249,15 +4054,16 @@ client.once("ready", () => {
 
 ### 📌 Dashboard Routes
 
-| Route | Description |
-|-------|-------------|
-| `/` | 🏠 Homepage with bot stats |
-| `/login` | 🔐 Login page |
-| `/dashboard` | 📊 Server selection |
-| `/dashboard/:guildId` | 🏠 Server overview |
-| `/dashboard/:guildId/commands` | 📜 Commands list |
-| `/dashboard/:guildId/levels` | 🏆 Level leaderboard |
-| `/dashboard/:guildId/giveaways` | 🎉 Giveaway management |
+| Route                           | Description                  |
+| ------------------------------- | ---------------------------- |
+| `/`                             | 🏠 Homepage with bot stats   |
+| `/login`                        | 🔐 Login page                |
+| `/dashboard`                    | 📊 Server selection          |
+| `/dashboard/:guildId`           | 🏠 Server overview           |
+| `/dashboard/:guildId/commands`  | 📜 Commands list             |
+| `/dashboard/:guildId/levels`    | 🏆 Level leaderboard         |
+| `/dashboard/:guildId/giveaways` | 🎉 Giveaway management       |
+| `/dashboard/:guildId/logs`      | 🛡️ Logging system management |
 
 ---
 
@@ -2290,7 +4096,13 @@ POST /api/:guildId/giveaway/end
 POST /api/:guildId/giveaway/reroll
 POST /api/:guildId/giveaway/delete
 
-// 🚫 Blacklist management
+// �️ Logging system management
+POST /api/:guildId/logs/channel    // Set default log channel
+POST /api/:guildId/logs/toggle     // Enable/disable event type
+POST /api/:guildId/logs/event      // Update event settings (channel, color)
+POST /api/:guildId/logs/reset      // Reset all log settings
+
+// �🚫 Blacklist management
 POST /api/guild/:guildId/blacklist    // Add to blacklist
 DELETE /api/guild/:guildId/blacklist  // Remove from blacklist
 ```
@@ -2304,13 +4116,12 @@ DELETE /api/guild/:guildId/blacklist  // Remove from blacklist
 
 ### 🔧 Configuration Options
 
-| Option | Type | Required | Description |
-|--------|------|----------|-------------|
-| `clientID` | `string` | ✅ | 🔑 Your Discord Application Client ID |
-| `clientSecret` | `string` | ✅ | 🔐 Your Discord Application Client Secret |
-| `callbackURL` | `string` | ✅ | 🔗 OAuth2 redirect URL (must match Discord settings) |
-| `sessionSecret` | `string` | ✅ | 🔒 Secret key for session encryption |
-| `port` | `number` | ❌ | 🌍 Port to run the dashboard (default: 3000) |
+| Option          | Type     | Required | Description                                          |
+| --------------- | -------- | -------- | ---------------------------------------------------- |
+| `clientSecret`  | `string` | ✅       | 🔐 Your Discord Application Client Secret            |
+| `callbackURL`   | `string` | ✅       | 🔗 OAuth2 redirect URL (must match Discord settings) |
+| `sessionSecret` | `string` | ✅       | 🔒 Secret key for session encryption                 |
+| `port`          | `number` | ❌       | 🌍 Port to run the dashboard (default: 3000)         |
 
 ---
 
@@ -2318,16 +4129,17 @@ DELETE /api/guild/:guildId/blacklist  // Remove from blacklist
 
 The dashboard uses **EJS** templates located in the `views` folder:
 
-| File | Description |
-|------|-------------|
-| `index.ejs` | 🏠 Homepage |
-| `login.ejs` | 🔐 Login page |
-| `dashboard.ejs` | 📊 Server selection |
-| `guild.ejs` | 🏠 Server overview |
-| `commands.ejs` | 📜 Commands list |
-| `levels.ejs` | 🏆 Level management |
-| `giveaways.ejs` | 🎉 Giveaway management |
-| `404.ejs` | ❌ Not found page |
+| File            | Description                  |
+| --------------- | ---------------------------- |
+| `index.ejs`     | 🏠 Homepage                  |
+| `login.ejs`     | 🔐 Login page                |
+| `dashboard.ejs` | 📊 Server selection          |
+| `guild.ejs`     | 🏠 Server overview           |
+| `commands.ejs`  | 📜 Commands list             |
+| `levels.ejs`    | 🏆 Level management          |
+| `giveaways.ejs` | 🎉 Giveaway management       |
+| `logs.ejs`      | 🛡️ Logging system management |
+| `404.ejs`       | ❌ Not found page            |
 
 </details>