The ultimate Clash of Clans companion app for tracking stats, managing clans, and analyzing performance. Built with Flutter for a beautiful, fast mobile experience.
- Comprehensive player profile tracking
- Trophy progression and league rankings
- Achievement monitoring and progress
- Legend League daily tracking with detailed analytics
- Real-time clan member monitoring
- Donation tracking and clan health metrics
- Join/leave event tracking
- Clan capital raid analytics
- Detailed war performance tracking
- Attack strategy analysis and win rates
- War history and statistical trends
- Clan War League (CWL) performance metrics
- Daily trophy gain/loss tracking
- End-of-season statistics
- Performance charts and trends
- Attack and defense analytics
- Multi-language support (20+ languages)
- Dark/light theme support
- Account verification with API tokens
- Android home screen widgets
- Offline data caching
- Flutter 3.0 or higher
- Dart 3.0 or higher
- Android Studio / Xcode for device deployment
-
Clone the repository
git clone https://github.com/ClashKingInc/clashkingapp.git cd clashkingapp -
Install dependencies
flutter pub get
-
Run the app
flutter run
flutter pub get- Install dependenciesflutter run- Run the app in development modeflutter test- Run testsflutter build apk- Build Android APKflutter build ios- Build iOS app
ClashKing is a comprehensive platform with multiple tools:
- 📱 Mobile App (this repository) - Beautiful, fast access to your stats
- 🤖 Discord Bot - Clan management and server integration
- 🔗 Free API - Open-source data access for developers
All tools work together seamlessly, sharing data to provide the ultimate Clash of Clans experience.
lib/
├── core/ # Core app functionality and utilities
├── features/ # Feature-based modules
│ ├── auth/ # Authentication and user management
│ ├── clan/ # Clan-related features
│ ├── player/ # Player statistics and profiles
│ ├── war_cwl/ # War and CWL analytics
│ └── settings/ # App settings and preferences
├── common/ # Shared widgets and utilities
└── l10n/ # Internationalization files
- Flutter - Cross-platform mobile framework
- Provider - State management
- HTTP - API communication
- Cached Network Image - Image caching and optimization
- Shared Preferences - Local data persistence
The app supports 20+ languages with community-driven translations:
- English (reference language)
- French (developer-maintained)
- Spanish, German, Italian, Portuguese, and more
Help us translate the app! We use Crowdin for community translations:
- Visit our Crowdin project
- Join our Discord community for translator support
We welcome contributions from the community! This is a side project developed alongside our full-time jobs, driven by our passion for Clash of Clans.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow Flutter best practices
- Maintain existing code style and patterns
- Add translations for new strings
- Test on both Android and iOS
- Ensure no secrets or API keys are committed
- Bug Reports: GitHub Issues
- Feature Requests: Use our in-app feature voting system
- General Support: Discord Community
- Email: devs@clashk.ing
ClashKing is funded entirely through user donations and Supercell Creator code usage:
- Use Creator Code: Enter "ClashKing" in any Supercell game shop
- Patreon: Support us on Patreon
- Discord: Join our community
- Share: Tell your clan mates about ClashKing!
This project is open source. See the source code for implementation details.
Important: This project is not affiliated with Supercell. Clash of Clans is a trademark of Supercell Oy. This app follows the Supercell Fan Content Policy.
- API Repository: ClashKing API
- Discord Bot: Invite to your server
- Website: clashk.ing
- Discord Community: discord.gg/clashking
Made with ❤️ by the ClashKing team and community contributors.
