ROADMAP.md

XrayMOD Roadmap

Phase 1: Core Panel + Proxy Engine ✅

• Cloudflare Worker architecture with D1 storage
• React frontend with shadcn/ui + Tailwind CSS v4
• Authentication system (password + session cookies)
• Admin panel: Dashboard, Nodes, Users, Protocols, Settings
• User panel: Dashboard, Marketplace, Referral, Payment, Profile
• Proxy engine: VLESS, Trojan, Shadowsocks over WebSocket
• Subscription link generation (base64, Clash, sing-box)
• Traffic tracking per user
• Modular protocol system (JSON schema + templates)
• Dark theme with emerald accent

Phase 2: Deployment Wizard ✅

• Wizard installer Worker script
• One-click deployment via Cloudflare API token
• Automatic D1 database creation
• Worker script upload and configuration
• Bilingual wizard UI (English + Persian)
• Setup script for Git repository fixes

Phase 3: Advanced Proxy Features

• ECH (Encrypted Client Hello) support
• TLS fragment / SNI fragment
• Proxy chaining (SOCKS5, HTTP, HTTPS forward)
• gRPC transport support
• XHTTP transport support
• WebSocket Early Data (0-RTT)
• Multi-path / port-spread configuration
• Disguise system — Error 1101 bypass + secret admin/login paths
• Automatic clean IP scanning + Iranian ISP detection

Phase 4: External Server Bridge

• Telegram Bot integration (user notifications, management commands)
• Backend mode — VPS registration + auto-install script
• TON Wallet integration (payments, withdrawals)
• Bridge API between Worker and external server
• Real-time notifications via WebSocket

Phase 5: WARP Integration

• WARP account registration
• WARP+ license support
• WARP endpoint switcher
• Amnezia WARP mode
• WARP Noise protocol

Phase 6: Advanced Features

• Per-ISP clean IP optimization
• DNS encryption (DoH, DoT)
• Routing rules (GeoIP, GeoSite)
• AdBlock / PornBlock / Malware blocking
• IPv6 support
• NAT64 transition support

Phase 7: Multi-Language & UX

• Bilingual documentation (English + فارسی)
• RTL layout for Persian UI
• Guided setup wizard (/install)
• Backup & Restore (export/import settings)
• Daily traffic charts with upload/download split
• Log viewer
• JSON config editor

Phase 8: Fleet Management

• Central management API
• Multi-instance fleet stats
• Broadcast messages to all instances
• Instance heartbeat monitoring
• Kill switch (global pause/resume)
• Self-healing domain pool

Phase 9: Client Support

• Clash/Mihomo direct link
• sing-box direct link
• V2RayNG / Nekobox optimized links
• Quantumult X support
• Loon / Surge support
• QR code generation for all formats

---

Adding New Features

To add a new feature to XrayMOD:

1. Protocol Features

Add new protocol support in worker/proxy/:

• Create a new handler file (e.g., grpc.ts)
• Implement the protocol parsing and handling
• Register the protocol in worker/schema.ts

2. API Endpoints

Add new API routes in worker/api/:

• Create a new handler file
• Add route matching in worker/router.ts
• Update the types in worker/types.ts

3. UI Features

Add new UI components in src/:

• Create new components using shadcn/ui
• Add new tabs/views in src/App.tsx
• Update the navigation in the sidebar

4. Deployment Features

Extend the wizard in wizard/:

• Modify wizard/index.ts for new deployment options
• Update the wizard UI for new settings

5. Documentation

Update documentation:

• README.md — Installation and usage guides
• ROADMAP.md — This file
• PROTOCOLS.md — Protocol documentation

---

Version History

v1.9.12 (Current)

• Compulsory SECURE PATH + silent 404
• Admin Dashboard (update, CF email, domains, remote sync, kill switch)
• Disguise ON by default · D-tagged custom domains
• Schema v4 migration

v1.0.0

• Initial open-source release
• Core proxy engine (VLESS, Trojan, Shadowsocks)
• Admin and user panels
• Wizard installer
• Bilingual documentation

Planned

• ECH / fragment polish, WARP stack, fleet domain pool