🛠️ GuildBuilder - Discord Channel Generator Bot

An AI-powered, full-stack application that transforms simple text descriptions into fully provisioned Discord server architectures. Users can invite the bot, design custom layouts through a natural language chat interface, view an instant live layout preview, and deploy categories, channels, and permissions in one click.

---

🚀 Key Features

• Instant Bot Invite: Single-click OAuth2 integration to add the bot with precise required permissions.
• AI Server Architect: Driven by LLM technology to translate natural descriptions into structured server blueprints.
• Live Discord Sidebar Preview: Interactive, dark-mode Tailwind UI that mirrors the real Discord channel list.
• One-Click Automated Deployment: Multi-threaded, rate-limit safe execution using discord.js v14 to spawn nodes instantly.
• Smart Permission Isolation: Automatic lockdown settings for categories tagged as private (e.g., Staff/Mentors).

---

📐 System Architecture

[ User Dashboard ] 💡 ------> [ Gemini LLM API ] ------> [ AI Text + JSON Blueprint ]

        |                                                           |
 (OAuth2 Invite)                                              (Click Deploy)

        |                                                           |
        v                                                           v
[ Captures Guild ID ] 🔑 ---> [ Express API Backend ] <-------------+
                                    |
                        (Executes sequential loops)
                                    v
                         [ Live Discord Server ] 🚀

---

📋 Prerequisites

Before setting up the project, make sure you have:

• Node.js v18.0.0 or higher installed.
• A Discord Developer Account with a registered application.
• Privileged Gateway Intents (Server Members, Message Content) turned ON in the Discord Developer Portal under the Bot tab.

---

⚙️ Environment Configuration

💻 Backend Setup (.env at project root)

Create a .env file in your root folder and add the following keys:

PORT=4000
DISCORD_TOKEN=your_discord_bot_token
DISCORD_CLIENT_ID=your_discord_application_client_id
DISCORD_CLIENT_SECRET=your_discord_application_client_secret
DISCORD_REDIRECT_URI=http://localhost:3000/dashboard
GEMINI_API_KEY=your_gemini_api_key_here

🎨 Frontend Setup (.env.local inside frontend folder)

Create a .env.local file inside your frontend directory:

NEXT_PUBLIC_API_URL=http://localhost:4000
NEXT_PUBLIC_DISCORD_CLIENT_ID=your_discord_application_client_id
NEXT_PUBLIC_DISCORD_REDIRECT_URI=http://localhost:3000/dashboard

---

🛠️ Installation & Local Running

1. Clone the Repository:

   git clone https://github.com
   cd discord-channel-generator-bot

2. Install Dependencies:

   npm install

3. Launch the Application in Development Mode:

   npm run dev

• Your Frontend UI will run at: http://localhost:3000
• Your Backend API Server will run at: http://localhost:4000

---

🔗 OAuth2 Permissions Flow

The system generates a secure Discord authorization link automatically using your environment variables. The link safely requests the following essential scopes:

• bot (To create server structures)
• applications.commands (To support modern slash configurations)
• Manage Channels permission (Mandatory)
• Manage Roles permission (Required for private section overwrites)

---

🛠️ Troubleshooting

• Channels not creating? Ensure the bot's role is dragged to the very top of your server's role hierarchy list in Discord Settings.
• OAuth2 Redirect loop? Double check that http://localhost:3000/dashboard is explicitly added as an authorized redirect URI in your Discord Developer Panel.