Enterprise-grade World of Tanks clan monitoring and intelligence platform
Track clan movements • Analyze player statistics • Get instant alerts
|
|
- 🎭 Tactical Military Theme - Immersive WoT-inspired design with hexagonal patterns
- ⚡ Smooth Animations - Framer Motion & GSAP for fluid interactions
- 📱 Fully Responsive - Perfect experience on all devices
- 🌙 Dark Mode Optimized - Easy on the eyes for extended use
- 🔄 Real-Time Updates - Live data without page refresh
Next.js 15.5 • React 19 • TypeScript 5 • Tailwind CSS 4
Framer Motion • GSAP • Lucide Icons • Radix UI
Cloudflare Workers • Cloudflare D1 (SQLite) • OpenNext
Better Auth • Wrangler 4.43 • Edge Runtime
Wargaming API • Tomato.gg • Discord Webhooks
| Table | Purpose |
|---|---|
user |
User accounts and authentication |
session |
Active user sessions |
monitored_clans |
Clan monitoring config (multi-user) |
snapshots |
Historical clan rosters |
changes |
Player movement tracking |
monitoring_config |
Global notification settings |
- Node.js 18+ and npm
- Cloudflare account (free tier works)
- Wargaming API key (Get one free)
# Clone repository
git clone https://github.com/ionutcnu/watcher.git
cd watcher
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your API keys# Create D1 database
npx wrangler d1 create wot-watcher-db
# Update wrangler.toml with your database_id
# Initialize database (run migrations manually)
# SQL files are in your local directory only# Start dev server
npm run dev
# Build for production
npm run build:worker
# Deploy to Cloudflare
npm run deploy
# Watch logs
npx wrangler tail- Navigate to Monitoring → Click "Bulk Import"
- Upload Excel/CSV or paste clan tags
- Import - Clans added in same order as Excel
- Enable/Disable - Toggle monitoring per clan
Click "Run Manual Check" → Automatic batch processing
├── Processes 20 clans per batch
├── Shows real-time progress
├── Displays results in Excel order
└── On-demand stats loading
- Home Dashboard - Recent movements across all clans
- Filter by Date - Custom date range selection
- Last Scanned - View only most recent scan results
- Export Data - Download as CSV/Excel
Admin Dashboard → Manage Users
├── View all registered users
├── Activate/deactivate accounts
├── Monitor system activity
└── Configure global settings
graph LR
A[Browser] -->|HTTPS| B[Cloudflare Edge]
B -->|API Routes| C[Next.js Server]
C -->|Query| D[D1 Database]
C -->|Fetch| E[Wargaming API]
C -->|Stats| F[Tomato.gg]
C -->|Notify| G[Discord]
style A fill:#4A9EFF
style B fill:#F38020
style C fill:#000000
style D fill:#FFA500
| Endpoint | Method | Purpose |
|---|---|---|
/api/auth/[...all] |
ALL | Authentication (Better Auth) |
/api/admin/users |
GET/POST | User management |
/api/admin/settings |
GET/POST | System configuration |
/api/monitored-clans |
GET/POST | Clan CRUD operations |
/api/bulk-import |
POST | Batch clan import |
/api/monitoring/manual-check |
POST | Manual scan (batched) |
/api/clan-newsfeed |
GET | Clan events (bypass proxy) |
/api/player-stats |
POST | Tomato.gg statistics |
/api/changes |
GET | Player movement history |
/api/discord-notify |
POST | Send webhook notifications |
# Wargaming API
WARGAMING_APPLICATION_ID=your_api_key
WARGAMING_REALM=eu
WARGAMING_API_BASE_URL=https://api.worldoftanks.eu
# Better Auth
BETTER_AUTH_SECRET=your_secret_key_here
BETTER_AUTH_URL=https://clanspy.win
# App Config
NEXT_PUBLIC_APP_NAME="WoT Clan Watcher"
NEXT_PUBLIC_APP_URL=https://clanspy.winname = "wot-clan-watcher"
compatibility_date = "2025-01-16"
compatibility_flags = ["nodejs_compat"]
[[d1_databases]]
binding = "DB"
database_name = "wot-watcher-db"
database_id = "your-database-id"
[vars]
WARGAMING_REALM = "eu"
WARGAMING_API_BASE_URL = "https://api.worldoftanks.eu"
NEXT_PUBLIC_APP_NAME = "WoT Clan Watcher"
NEXT_PUBLIC_APP_URL = "https://clanspy.win"| Metric | Value |
|---|---|
| Response Time | < 50ms (edge computing) |
| Global CDN | 300+ data centers |
| Database | SQLite at the edge |
| Bundle Size | < 7.5 MB optimized |
| Batch Size | 20 clans per request |
| Max Clans | Unlimited (automatic batching) |
- Multi-user authentication system
- Client-side automatic batching
- Display order preservation
- 60-day statistics integration
- Admin panel for user management
- Bulk operations (enable/disable/remove)
- Advanced filtering and search
- Customizable dashboards
- Email notifications
- API rate limiting
- Player comparison tools
We welcome contributions! Here's how:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow TypeScript best practices
- Use Tailwind CSS for styling
- Write descriptive commit messages
- Test on Cloudflare Workers before PR
- Update README for new features
This project is licensed under the MIT License - see LICENSE for details.
Built with:
- Wargaming.net - World of Tanks API
- Tomato.gg - Advanced player statistics
- Cloudflare - Edge computing & D1 database
- OpenNext - Next.js on Cloudflare Workers
- Better Auth - Secure authentication
Special thanks to the World of Tanks community for feedback and support!
🌐 Live Application: clanspy.win
📚 API Documentation: Wargaming API • Tomato.gg API
💬 Support: Open an Issue
