discord-giveaway-bot

📑 Table of Contents

• 📍 Overview
• 📦 Features
• 📂 Structure
• 💻 Installation
• 🏗️ Usage
• 🌐 Hosting
• 📄 License
• 👏 Authors

📍 Overview

This repository contains a Discord giveaway bot project designed to simplify giveaway management on Discord servers. It provides a comprehensive solution with features like automated giveaway creation, entry management, winner selection, and announcement capabilities. The project is built using a robust and scalable tech stack, including React, Node.js, PostgreSQL, and custom AI models.

📦 Features

📂 Structure

├── src
│   ├── commands
│   │   ├── create.js
│   │   ├── enter.js
│   │   ├── end.js
│   │   ├── winners.js
│   │   ├── help.js
│   │   └── dashboard.js
│   ├── events
│   │   ├── ready.js
│   │   ├── message.js
│   │   └── interactionCreate.js
│   ├── services
│   │   ├── giveawayService.js
│   │   ├── databaseService.js
│   │   ├── discordService.js
│   │   └── notificationService.js
│   ├── models
│   │   ├── Giveaway.js
│   │   ├── User.js
│   │   └── Prize.js
│   ├── utils
│   │   ├── commandHandler.js
│   │   ├── logger.js
│   │   ├── errorHandler.js
│   │   └── randomWinnerSelector.js
│   ├── config
│   │   ├── env.config.js
│   │   └── database.config.js
│   ├── routes
│   │   ├── api.js
│   │   └── authRoutes.js
│   ├── middleware
│   │   ├── authentication.js
│   │   ├── authorization.js
│   │   └── logging.js
│   └── prisma
│       └── schema.prisma
├── public
│   ├── index.html
│   ├── favicon.ico
│   ├── robots.txt
│   └── manifest.json
├── next.config.js
├── tsconfig.json
└── README.md

💻 Installation

🔧 Prerequisites

• Node.js (v18+)
• npm
• Docker

🚀 Setup Instructions

1. Clone the repository:
   • git clone https://github.com/spectra-ai-codegen/discord-giveaway-bot.git
2. Navigate to the project directory:
   • cd discord-giveaway-bot
3. Install dependencies:
   • npm install

🏗️ Usage

🏃‍♂️ Running the Project

1. Start the development server:
   • npm start
2. Open your browser and navigate to http://localhost:3000.

⚙️ Configuration

Adjust configuration settings in config.js or .env.

📚 Examples

• 📝 Example 1: Creating a new giveaway

  • /create command with arguments for prize, duration, entry requirements, and number of winners.

• 📝 Example 2: Entering a giveaway

  • /enter command with the giveaway ID.

• 📝 Example 3: Ending a giveaway

  • /end command with the giveaway ID (only for admins).

• 📝 Example 4: Viewing winners

  • /winners command with the giveaway ID.

• 📝 Example 5: Accessing the admin dashboard

  • /dashboard command (redirects to the web interface).

  🌐 Hosting

  🚀 Deployment Instructions

  Heroku Deployment

  1. Install the Heroku CLI:
     • npm install -g heroku
  2. Login to Heroku:
     • heroku login
  3. Create a new Heroku app:
     • heroku create
  4. Deploy the code:
     • git push heroku main

  Environment Variables

  • DISCORD_BOT_TOKEN: Your Discord bot token.
  • DATABASE_URL: Your PostgreSQL database connection string.
  • NEXTAUTH_SECRET: Your NextAuth.js secret key.

  📜 API Documentation

  🔍 Endpoints

  • POST /api/giveaways: Creates a new giveaway.
  • GET /api/giveaways/🆔 Retrieves a specific giveaway.
  • PUT /api/giveaways/🆔 Updates a giveaway.
  • DELETE /api/giveaways/🆔 Deletes a giveaway.
  • POST /api/giveaways/:id/enter: Enters a giveaway.
  • POST /api/giveaways/:id/end: Ends a giveaway.

  🔒 Authentication

  Use JWT tokens for authentication to access the API.

  📝 Examples

  • curl -X POST -H "Content-Type: application/json" -d '{"prize": "Discord Nitro", "duration": 86400, "entryRequirements": [], "numberOfWinners": 1}' http://localhost:3000/api/giveaways

  📜 License

  This project is licensed under the GNU AGPLv3.

  👥 Authors

  • Author Name - Spectra.codes
  • Creator Name - DRIX10