Documentation

Standardized developer documentation template for Dexel. Designed with high-contrast typography, hairline cards, and responsive components.

Quickstart →

Get up and running with automated setup and initial configuration.
Configuration →

Comprehensive reference for environment variables, flags, and runtime settings.

Overview #

Welcome to the standardized documentation portal. This layout adheres strictly to the Vercel Geist Monochrome Design System, using stark black-and-white contrast, 1px hairlines, and Geist Sans & Mono typography.

Quick Note
To add Dexel directly to your Discord server with application command scopes, use the verified OAuth2 invite link below or click the top-right button.

Quickstart #

Follow these instructions to initialize and run the service locally or integrate it into your existing workspace.

1. Add to Discord

Use the OAuth2 authorization URL with required permissions:

OAuth2 Authorization URL 
https://discord.com/oauth2/authorize?client_id=1467468160456101968&permissions=1100585352278&integration_type=0&scope=bot+applications.commands

2. Clone and Setup

Clone the codebase and install dependencies using your preferred package manager: 

# Clone repository and install dependencies
git clone https://github.com/theadityasinghal/dexel.git
cd dexel
pip install -r requirements.txt

Configuration #

Configure runtime behavior via environment variables or a local .env configuration file.

Variable Type Default Description
DISCORD_TOKEN string required Secret bot authorization token generated from Discord Developer Portal.
ENVIRONMENT "dev" | "prod" "prod" Execution context for logging verbosity and error reporting.
PORT number 3000 Local HTTP server port for status healthchecks and webhook listening.
DEBUG_MODE boolean false Enable granular console debugging logs and payload traces.
Security Note
Never commit your .env file or secret credentials to public git repositories. Always utilize secret managers for production deployments.

Architecture & Design #

The architecture follows a modular event-driven structure with isolated execution handlers:

architecture.json 
{
  "system": "Dexel",
  "runtime": "Python 3.11+",
  "framework": "discord.py",
  "storage": "PostgreSQL / Supabase"
}

Troubleshooting & Support #

Common issues and resolution steps when deploying or testing:

Missing Application Command Permissions?
Ensure you have invited the bot using the URL including scope=bot+applications.commands so that slash commands register across your guild.
Was this documentation page helpful?