Watching your server grow, one stat at a time
Features • Quick Start • Development
LangStats is a Discord bot that tracks your server's growth and sends weekly reports. Simple, private, and useful.
Built for language exchange communities, but works for any Discord server.
| Feature | Description |
|---|---|
| Daily Stats | Records member count and language role stats every day |
| Weekly Report | Automatically posts growth reports every Monday (no manual work) |
/setup |
Set the channel for weekly reports |
/preview |
Preview the current report before it's posted |
Example output (numbers are sample data)
📊 Weekly Growth Report - Language Exchange Hub
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
👥 Members: 482 (+12)
📈 Growth: +2.5%
🏷️ Language Roles:
English Learners: 156 (+5)
Japanese Learners: 89 (+3)
Spanish Learners: 45 (+1)
💡 Insight: Learner roles grew faster than native roles this week.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
Add the bot to your server
-
Set the report channel
Use
/setupto choose where weekly reports will be posted. -
Wait for your first report
Your first report will be posted automatically next Monday.
- Runtime: Node.js 20
- Bot Framework: discord.js
- Database: Turso (SQLite)
- ORM: Drizzle ORM
- Scheduler: GitHub Actions
# Install dependencies
pnpm install
# Copy environment variables
cp .env.example .env
# Edit .env with your credentials
# - DISCORD_TOKEN
# - DISCORD_CLIENT_ID
# - TURSO_DATABASE_URL
# - TURSO_AUTH_TOKEN
# Run database migrations
pnpm db:push
# Start the bot
pnpm dev| Script | Description |
|---|---|
pnpm dev |
Start the bot in development mode |
pnpm build |
Build for production |
pnpm start |
Start the production bot |
pnpm job:daily |
Run daily stats collection |
pnpm job:weekly |
Run weekly report job |
pnpm db:push |
Push schema changes to database |
In production, the bot runs on Railway and scheduled jobs (daily stats, weekly reports) run via GitHub Actions.
- Design System - UI/UX design guidelines for Phase 2
- Project Plan - Roadmap and development milestones
- Requirements - Detailed requirements and specifications
MIT