` |
-
----
+## โ๏ธ Configuration
-## ๐ Admin Features
+### Required Environment
-### ๐ Statistics Dashboard
-```
-๐ BOT STATISTICS
-
-๐ฅ Users & Domains:
-โข Registered Users: 150
-โข Active Domains: 45
-โข Total Subdomains: 1,234
+- **Node.js 20+** - [Download here](https://nodejs.org/)
+- **Telegram Bot Token** - Get from [@BotFather](https://t.me/BotFather)
+- **Cloudflare Account** - [Sign up here](https://cloudflare.com/)
-โก System Status:
-โข Uptime: 7d 12h 30m
-โข Memory Usage: 45.2 MB
-โข Node.js Version: v20.10.0
+### Environment Variables
-๐ค Bot Info:
-โข Bot Username: @YourWildcardBot
-โข Last Updated: 2024-01-15 14:30:25
-```
+```env
+# ๐ค Bot Configuration
+BOT_TOKEN=your_bot_token_here
+ADMIN_IDS=123456789
-### ๐ข Broadcast System
-Send messages to all registered users:
-```
-/broadcast ๐จ Scheduled maintenance in 1 hour. All services will be temporarily unavailable.
-```
+# ๐ข Optional: Notifications
+TELEGRAM_GROUP_ID=-1001234567890
-### ๐ค User Management
-Get detailed user information:
-```
-/userinfo 123456789
-
-๐ค USER INFORMATION
-๐ User ID: 123456789
-๐ฑ Telegram: @username (John Doe)
-๐ง Cloudflare Email: user@example.com
-๐ Custom Domains: 5
-๐
Registration: 2024-01-10 09:15:32
+# ๐ง Optional: Settings
+MAX_CUSTOM_DOMAINS=5
+NODE_ENV=production
```
---
-## ๐ง Advanced Configuration
-
-### Custom Domain Setup
-Add your own domains to the bot:
-
-```javascript
-// config/default.js
-DEFAULT_DOMAINS: [
- 'your-domain.com',
- 'another-domain.net',
- 'example.org'
-]
-```
+## ๐ Documentation
-### Notification Customization
-Configure Telegram notifications:
+
-```javascript
-NOTIFICATIONS: {
- TELEGRAM: {
- enabled: true,
- groupId: process.env.TELEGRAM_GROUP_ID,
- // Custom message templates
- templates: {
- welcome: '๐ New user registered: {username}',
- domainSetup: '๐ Wildcard setup: {domain} by {user}'
- }
- }
-}
-```
+| ๐ **Guide** | ๐ง **Setup** | ๐ **Help** | ๐ **Start** |
+|:---:|:---:|:---:|:---:|
+| [Commands](wiki/Commands.md) | [Configuration](wiki/Configuration.md) | [Troubleshooting](wiki/Troubleshooting.md) | [Quick Start](wiki/Quick-Start.md) |
-### Rate Limiting Configuration
-Prevent abuse with custom rate limits:
+[๐ **Complete Wiki**](wiki/Home.md)
-```javascript
-RATE_LIMITS: {
- SETUP_WILDCARD: {
- PER_USER: 5, // Max 5 setups per user
- COOLDOWN: 3600 // 1 hour cooldown
- },
- ANALYTICS: {
- PER_USER: 10, // Max 10 requests per hour
- COOLDOWN: 300 // 5 minutes between requests
- }
-}
-```
+
---
-## ๐ Deployment
-
-### Production Deployment with PM2
-```bash
-# Install PM2 globally
-npm install -g pm2
+## ๐ Support the Project
-# Start bot with PM2
-pm2 start index.js --name "wildcard-bot"
+
-# Enable auto-restart on server reboot
-pm2 startup
-pm2 save
+### ๐ฐ Donate via QRIS (Indonesia)
-# Monitor logs
-pm2 logs wildcard-bot
+
-# Restart bot
-pm2 restart wildcard-bot
-```
+**Your donation helps us maintain and improve this project!**
-### Environment Setup for Production
-```bash
-# Set production environment
-export NODE_ENV=production
+### ๐ Other Ways to Support
-# Increase memory limit if needed
-node --max-old-space-size=2048 index.js
-```
+[](https://github.com/AutoFTbot/Wildcard-Bot)
+[](https://github.com/AutoFTbot/Wildcard-Bot/fork)
+[](https://github.com/AutoFTbot/Wildcard-Bot/issues)
-### Nginx Reverse Proxy (Optional)
-If you plan to add webhooks:
-
-```nginx
-server {
- listen 80;
- server_name your-bot-domain.com;
-
- location /webhook {
- proxy_pass http://localhost:3000;
- proxy_http_version 1.1;
- proxy_set_header Upgrade $http_upgrade;
- proxy_set_header Connection 'upgrade';
- proxy_set_header Host $host;
- proxy_cache_bypass $http_upgrade;
- }
-}
-```
+
---
-## ๐ ๏ธ Development
-
-### Project Structure
-```
-auto-wildcard-bot/
-โโโ ๐ bin/
-โ โโโ wildcard-bot.js # CLI entry point
-โโโ ๐ config/
-โ โโโ constants.js # Application constants
-โ โโโ default.js # Default configuration
-โโโ ๐ handlers/
-โ โโโ adminHandlers.js # Admin command handlers
-โ โโโ cloudflareHandlers.js # Cloudflare operations
-โ โโโ configHandlers.js # Configuration management
-โ โโโ domainHandlers.js # Domain operations
-โ โโโ generalHandlers.js # General bot commands
-โโโ ๐ lib/
-โ โโโ WildcardBot.js # Main bot class
-โโโ ๐ services/
-โ โโโ CloudflareManager.js # Cloudflare API wrapper
-โ โโโ NotificationService.js # Notification system
-โโโ ๐ utils/
-โ โโโ fileUtils.js # File operations
-โ โโโ systemUtils.js # System utilities
-โ โโโ validation.js # Input validation
-โโโ ๐ data/ # Bot data storage
-โโโ index.js # Application entry point
-โโโ package.json # Dependencies
-โโโ README.md # Documentation
-```
+## ๐ Project Stats
-### Running in Development Mode
-```bash
-# Clone repository
-git clone https://github.com/AutoFTbot/Wildcard-Bot.git
-cd Wildcard-Bot
+
-# Install dependencies
-npm install
+
+
+
-# Copy environment file
-cp .env.example .env
+
+
+
-# Edit configuration
-nano .env
+
-# Start in development mode
-npm run dev
-```
+---
-### Code Style and Linting
-```bash
-# Run linter
-npm run lint
+## ๐ Support & Community
-# Fix linting issues
-npm run lint:fix
+
-# Format code
-npm run format
+[](https://t.me/AutoFtFile)
+[](https://github.com/AutoFTbot/Wildcard-Bot/issues)
+[](https://t.me/AutoFtBot69)
-# Run all checks
-npm run check
-```
+
-### Testing
-```bash
-# Test configuration
-npm run test:config
+---
-# Test notifications
-npm run test:notifications
+## ๐ License
-# Test Cloudflare connection
-npm run test:cloudflare
-```
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
-## โ FAQ
+## ๐ Web Dashboard (Coming Soon)
-### **Q: How do I get a Telegram Bot Token?**
-A: Message [@BotFather](https://t.me/BotFather) on Telegram, use `/newbot` command, and follow the instructions.
+
-### **Q: Where do I find my Cloudflare Global API Key?**
-A: Go to [Cloudflare Dashboard](https://dash.cloudflare.com) โ My Profile โ API Tokens โ Global API Key โ View
+### ๐จ Modern Web Interface
-### **Q: How do I get my Telegram ID?**
-A: Message [@userinfobot](https://t.me/userinfobot) on Telegram to get your user ID.
+**Manage your wildcard domains from anywhere with our upcoming web dashboard!**
-### **Q: Can I use custom domains?**
-A: Yes! Add your domains to the `DEFAULT_DOMAINS` array in `config/default.js`.
+
-### **Q: Is there a limit on users or domains?**
-A: You can configure limits in `config/default.js`. Default is 5 domains per user.
+
-### **Q: How do I update the bot?**
-A: Run `npm update -g auto-wildcard-bot` for global installations.
+### ๐ Planned Features
----
-
-## ๐ Troubleshooting
+
-### Common Issues
+| ๐ **Analytics** | ๐๏ธ **Control Panel** | ๐ฅ **User Management** | ๐ **Notifications** |
+|:---:|:---:|:---:|:---:|
+| Real-time domain stats | Drag & drop interface | Role-based access | Live activity feed |
+| Traffic monitoring | Bulk operations | Team collaboration | Custom alerts |
+| Performance insights | Quick actions | Permission controls | Email & Telegram |
-#### ๐ด Bot not responding
-```bash
-# Check if bot is running
-ps aux | grep node
+
-# Check logs
-pm2 logs wildcard-bot
+### ๐ ๏ธ Tech Stack
-# Restart bot
-pm2 restart wildcard-bot
+```javascript
+// Modern web technologies planned
+{
+ "frontend": ["React", "Next.js", "TailwindCSS", "Chart.js"],
+ "backend": ["Node.js", "Express", "Socket.io", "JWT"],
+ "database": ["MongoDB", "Redis"],
+ "deployment": ["Docker", "Nginx", "PM2"]
+}
```
-#### ๐ด "Bot token invalid" error
-- Verify your bot token in `.env` file
-- Make sure token format is correct: `1234567890:ABCdefGHIjklMNOpqrsTUVwxyz`
-- Check if bot was deleted in @BotFather
+### ๐ฏ Web Features Roadmap
-#### ๐ด Cloudflare API errors
-- Verify Global API Key and email in user configuration
-- Check if domain is added to Cloudflare account
-- Ensure API key has necessary permissions
+- [ ] ๐จ **Q2 2024**: Modern dashboard UI/UX
+- [ ] ๐ **Q2 2024**: Real-time analytics & charts
+- [ ] ๐ฅ **Q3 2024**: Multi-user management portal
+- [ ] ๐ **Q3 2024**: Advanced security & 2FA
+- [ ] ๐ฑ **Q4 2024**: Mobile-responsive design
+- [ ] ๐ **Q4 2024**: Multi-language support
+- [ ] ๐ **2025**: REST API & webhooks
+- [ ] โก **2025**: GraphQL integration
-#### ๐ด Notifications not working
-- Verify `TELEGRAM_GROUP_ID` in environment variables
-- Make sure bot is added to the notification group
-- Check if bot has permission to send messages
+### ๐ก Sneak Peek
-#### ๐ด Domain setup fails
-- Ensure domain is registered in Cloudflare
-- Check DNS propagation status
-- Verify Cloudflare account permissions
+
-### Debug Mode
-Enable detailed logging:
-```bash
-export LOG_LEVEL=debug
-npm start
+**๐๏ธ Dashboard Overview**
+```
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ AutoFT Web Dashboard ๐ ๐ โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
+โ ๐ Analytics ๐ Domains ๐ฅ Users โ๏ธ โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
+โ โ
+โ ๐ฏ Quick Actions โ
+โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโ โ
+โ โ Add Domain โ โ Setup Wild โ โ View Logs โ โ
+โ โ + โ โ *. โ โ ๐ โ โ
+โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโ โ
+โ โ
+โ ๐ Domain Statistics โ
+โ โโ example.com โโโโโโโโโโโโโโโโโโ 89% โโโ โ
+โ โโ demo.net โโโโโโโโโโโโโโโโโโโโ 76% โโโ โ
+โ โโ test.org โโโโโโโโโโโโโโโโโโโโ 45% โโโ โ
+โ โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
-### Getting Help
-1. Check our [Wiki](https://github.com/AutoFTbot/Wildcard-Bot/wiki)
-2. Search [existing issues](https://github.com/AutoFTbot/Wildcard-Bot/issues)
-3. Join our [Telegram group](https://t.me/AutoFtBot69)
-4. Create a [new issue](https://github.com/AutoFTbot/Wildcard-Bot/issues/new)
-
----
+
-## ๐ค Contributing
+### ๐ช Interactive Demo
-We welcome contributions! Here's how you can help:
+Want early access to the web dashboard? Join our beta program!
-### ๐ Bug Reports
-- Use the [issue template](https://github.com/AutoFTbot/Wildcard-Bot/issues/new?template=bug_report.md)
-- Include detailed reproduction steps
-- Provide relevant logs and screenshots
+
-### โจ Feature Requests
-- Check [existing requests](https://github.com/AutoFTbot/Wildcard-Bot/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
-- Use the [feature template](https://github.com/AutoFTbot/Wildcard-Bot/issues/new?template=feature_request.md)
-- Explain the use case and benefits
+[](https://t.me/AutoFtFile)
+[](https://demo.autoft-bot.com)
-### ๐ป Code Contributions
-1. Fork the repository
-2. Create a feature branch: `git checkout -b feature/amazing-feature`
-3. Make your changes and test thoroughly
-4. Follow our coding standards (run `npm run lint`)
-5. Commit with clear messages: `git commit -m 'Add amazing feature'`
-6. Push to your branch: `git push origin feature/amazing-feature`
-7. Open a Pull Request
+**๐ข Get notified when web dashboard launches!**
-### ๐ Documentation
-- Improve existing documentation
-- Add examples and use cases
-- Translate to other languages
-- Create video tutorials
+
---
-## ๐ Roadmap
+## ๐จโ๐ป For Developers
-### ๐ Upcoming Features
-- [ ] **Web Dashboard** - Browser-based management interface
-- [ ] **Docker Support** - Containerized deployment
-- [ ] **Multi-language** - Support for multiple languages
-- [ ] **Advanced Analytics** - Detailed usage statistics
-- [ ] **Custom Commands** - User-defined bot commands
-- [ ] **Backup System** - Automated data backups
-- [ ] **Plugin System** - Extensible architecture
+
-### ๐ฏ Long-term Goals
-- [ ] **Cloud Hosting** - Managed hosting service
-- [ ] **Mobile App** - Native mobile application
-- [ ] **Enterprise Features** - Advanced business features
-- [ ] **API Gateway** - RESTful API interface
+**Join our development team and help build the future of domain management!**
----
+
-## ๐ Statistics
+### ๐ Development Stack
-
+```bash
+# Current Bot Architecture
+โโโ ๐ค Telegram Bot (Node.js + Telegraf)
+โโโ โ๏ธ Cloudflare API Integration
+โโโ ๐ Real-time Analytics
+โโโ ๐ง PM2 Process Management
-
-
-
-
+# Upcoming Web Stack
+โโโ โ๏ธ Frontend (React + Next.js + TailwindCSS)
+โโโ ๐๏ธ Backend (Node.js + Express + Socket.io)
+โโโ ๐พ Database (MongoDB + Redis)
+โโโ ๐ณ DevOps (Docker + Nginx + GitHub Actions)
+```
-
+### ๐ ๏ธ Contributing Areas
----
+
-## ๐ License
+| ๐จ **Frontend** | ๐ง **Backend** | ๐ฑ **Mobile** | ๐งช **Testing** |
+|:---:|:---:|:---:|:---:|
+| React/Next.js | Node.js/Express | React Native | Jest/Cypress |
+| UI/UX Design | API Development | iOS/Android | Performance |
+| Dashboard | Database Design | PWA | Security |
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
-```
-MIT License
+### ๐ฏ Open Opportunities
-Copyright (c) 2024 AutoFTbot Team
+- ๐จ **UI/UX Designer** - Design the web dashboard interface
+- โ๏ธ **React Developer** - Build responsive frontend components
+- ๐ง **Backend Developer** - API & database architecture
+- ๐ฑ **Mobile Developer** - React Native mobile app
+- ๐งช **QA Engineer** - Testing & automation
+- ๐ **Technical Writer** - Documentation & tutorials
+- ๐ **Translator** - Multi-language support
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+### ๐ก Quick Start Development
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-```
+```bash
+# Clone the repository
+git clone https://github.com/AutoFTbot/Wildcard-Bot.git
+cd Wildcard-Bot
----
+# Install dependencies
+npm install
-## ๐ Acknowledgments
+# Set up development environment
+cp .env.example .env.dev
+nano .env.dev
-- **Telegraf.js** - Telegram Bot API framework
-- **Cloudflare** - DNS and CDN services
-- **Node.js Community** - Runtime environment
-- **Contributors** - Everyone who helped improve this project
+# Start development mode
+npm run dev
----
+# Run tests
+npm test
-## ๐ Support & Community
+# Build for production
+npm run build
+```
-
+### ๐ Contributor Benefits
-### ๐ฌ Get Help
+- ๐ **Recognition** in project credits
+- ๐ **Portfolio** enhancement with real-world project
+- ๐ค **Networking** with global developer community
+- ๐ **Learning** modern web technologies
+- ๐ฐ **Revenue sharing** for premium features (planned)
-[](https://t.me/AutoFtBot69)
-[](https://github.com/AutoFTbot/Wildcard-Bot/issues)
+
-### ๐ Stay Updated
+[](https://github.com/AutoFTbot/Wildcard-Bot/blob/main/CONTRIBUTING.md)
+[](https://discord.gg/autoft-dev)
-[](https://github.com/AutoFTbot/Wildcard-Bot)
-[](https://github.com/AutoFTbot/Wildcard-Bot)
-[](https://github.com/AutoFTbot/Wildcard-Bot)
+
---
-**โญ If this project helped you, please give it a star!**
+
+
+**๐ If this project helped you, please consider giving it a star!**
-**Made with โค๏ธ by the AutoFTbot Team**
+**Made with โค๏ธ by the AutoFTbot Team**
+**Developer: [@AutoFtBot69](https://t.me/AutoFtBot69)**
-[๐ Get Started Now](https://www.npmjs.com/package/auto-wildcard-bot) โข [๐ Read the Docs](https://github.com/AutoFTbot/Wildcard-Bot/wiki) โข [๐ฌ Join Community](https://t.me/AutoFtBot69)
+[๐ **Get Started Now**](https://www.npmjs.com/package/autoft-bot-wildcard) โข [๐ข **Updates Channel**](https://t.me/AutoFtFile) โข [๐ฐ **Donate**](https://raw.githubusercontent.com/AutoFTbot/AutoFTbot/refs/heads/main/assets/QRIS.jpg)