Welcome to SeasonalBots — a collection of seasonal Discord bots and services designed to bring interactive events, games, countdowns, and festive experiences to Discord communities throughout the year.

SeasonalBots is owned and operated by NodeByte LTD.

Each SeasonalBot is designed around a specific time of year, with its own identity, features, events, and community experiences.

SeasonalBots is more than just a collection of Discord bots. Our central platform brings our services together under one ecosystem.

The SeasonalBots platform includes:

• 🔗 Linked Services — Connect your HalloweenBot, ChristmasBot, and future SeasonalBots accounts.
• 🖥️ Central Dashboard — Manage your connected services and servers from one place.
• 💎 SeasonalBots Premium — Manage Premium subscriptions and assign Premium benefits to supported servers.
• 🎫 Support Platform — Create and manage support tickets directly through SeasonalBots.
• 📊 Status Platform — Monitor the availability and health of SeasonalBots services.
• 📚 Documentation — Guides and resources for using our bots and services.
• 📰 Blog & Changelog — Keep up with new features, improvements, and announcements.
• 🧪 Beta Programme — Help test upcoming SeasonalBots features before public release.

SeasonalBots Premium provides additional features and customisation across supported SeasonalBots services.

Premium subscriptions are managed centrally through SeasonalBots, allowing eligible Premium entitlements to be assigned to supported Discord servers and synchronised with services such as HalloweenBot.

Premium features may include:

• Custom embeds and branding
• Advanced countdown configuration
• Webhook support
• Additional custom commands
• Welcome and farewell customisation
• Advanced moderation features
• Analytics
• Beta feature access
• Priority support

Available features may vary depending on the bot, Premium plan, and service.

Our services use a modern stack designed for scalability, reliability, and maintainability.

• 🧠 Runtime: Node.js
• 🤖 Discord: Discord.js
• 🗄️ Database: PostgreSQL
• 🔷 ORM: Prisma
• ⚡ APIs: Fastify & Next.js API Routes
• 🖥️ Web Applications: Next.js & React
• 🎨 Styling: Tailwind CSS
• 🔐 Authentication: Discord OAuth
• 💳 Payments: Stripe
• 🐳 Deployment: Docker

Individual repositories may use different technologies depending on their requirements.

The SeasonalBots organisation contains repositories for our bots, websites, APIs, dashboards, documentation, and supporting infrastructure.

SeasonalBots/
├── HalloweenBot/            # 🎃 HalloweenBot Discord bot
├── HalloweenBot-API/        # 🎃 HalloweenBot API
├── Halloween-Dashboard/     # 🎃 HalloweenBot dashboard
├── ChristmasBot/            # 🎄 ChristmasBot Discord bot
├── EasterBot/               # 🐣 EasterBot projects
├── SeasonalBots-Website/    # 🌐 Main SeasonalBots platform
├── Status/                  # 📊 Service status platform
└── Documentation/           # 📚 Documentation and guides

Repository names and structure may change as the SeasonalBots platform continues to grow.

New features may be released through our development and beta environments before reaching production.

Our beta programme allows selected community members to:

• Test upcoming bot features
• Try new dashboard functionality
• Participate in seasonal event testing
• Report bugs and unexpected behaviour
• Provide feedback before public releases

Beta features may be experimental and can change before their final release.

If you discover a security vulnerability affecting SeasonalBots or one of our services, please report it privately through our official support channels.

Please do not publicly disclose security vulnerabilities through GitHub Issues.

Some SeasonalBots repositories may be private or maintained exclusively by the SeasonalBots development team.

For repositories that accept community contributions, please review the repository's contributing guidelines before submitting an issue or pull request.

Licensing may vary between repositories.

Please refer to the LICENSE file within each repository for information about permitted use, modification, and distribution.

Unless explicitly stated otherwise, the SeasonalBots name, branding, logos, and associated assets remain the property of NodeByte LTD.

Our goal is simple: make Discord communities more fun throughout the year.

From spooky Halloween events 🎃 to festive Christmas celebrations 🎄 and Easter adventures 🐣, SeasonalBots provides communities with interactive seasonal experiences built specifically for Discord.

© 2020–Present SeasonalBots. SeasonalBots is owned and operated by NodeByte LTD.