Zeus - Powerful, Open-Source License Management System

---

Important

This project is new and may have bugs or glitches. If you encounter any issues, please open an issue on GitHub. We appreciate your feedback!
This project has taken inspiration for features from pre-existing license management panels such as Phantom by Buzz.dev and Sun Licenses.

Table of Contents

• Core Philosophy
• Technology Stack
• Features
  • Management & Control
  • Automation & Integration
  • User Experience
• Smart Features
• Database Architecture
• Getting Started
• Deployment
• Extending the Panel
• Environment Variables

Core Philosophy

Zeus was built with three core principles in mind:

1. Simplicity & Speed: Get up and running in minutes. The entire system is designed to be incredibly lightweight, with no external database dependencies.
2. Developer-First Modularity: The codebase is clean, well-organized, and built to be extended.
3. Powerful, Not Complicated: We provide a rich feature set inspired by leading license management solutions, but without the bloat or complexity.

Technology Stack

• Framework: Next.js (App Router)
• Styling: Tailwind CSS
• UI Components: shadcn/ui
• Language: TypeScript
• Authentication: Secure, session-based authentication using HTTP-only cookies.
• Database: JSON file-based system (no external dependencies).
• Discord Integration: Discord.js

Features

Management & Control

• Product, License, and Customer management
• Voucher system for promotions
• Blacklist and validation tracking tools

Automation & Integration

• BuiltByBit automation and webhooks
• Secure validation and admin REST APIs

User Experience

• Real-time dashboard updates
• Client-facing management panel
• Discord bot with admin and user commands

Smart Features

• Geographic validation tracking
• Dynamic command management
• Configurable Admin API
• Customizable Validation API
• Toggleable client panel
• Modular data layer and performance optimizations

Database Architecture

Uses a JSON file-based data system for zero configuration, portability, and speed.
Ideal for small-to-medium applications and easily extendable to SQL ,Firestore, Supabase and etc.

Getting Started

git clone https://github.com/unt1tler/Zeus.git
cd Zeus
npm install
npm run dev

Visit http://localhost:9002 to access your panel.

Deployment

npm run build
npm start

Runs the Next.js server and Discord bot in production.

Extending the Panel

• Add new routes in src/app/api/
• Add new bot commands in src/bot/commands/
• Replace database logic in src/lib/data.ts

Environment Variables

Variable	Description	Required
LOGIN_EMAIL	Admin login email	✅
LOGIN_PASSWORD	Admin login password	✅
SESSION_SECRET	Secret key for session cookies	✅
DISCORD_BOT_TOKEN	Discord bot token	✅

Panel Screenshots~

Discord Bot~

Contribution

• Have a great idea? open a Pull Request at Pull