Democoin

Welcome to Democoin – your friendly gateway to the exciting world of cryptocurrency!

This is an open-source Flutter demo project that brings real-time crypto data right to your fingertips. Whether you're a crypto enthusiast, a Flutter developer looking to learn, or just curious about how crypto apps work, you're in the right place! 🚀

✨ What's Inside?

Democoin is a beautifully crafted mobile app that lets you:

• 📊 Track cryptocurrencies
• 📈 View basic chart
• 🎨 Enjoy a modern UI
• 🌓 Switch themes

🏗️ Architecture

This project is built following Clean Architecture principles, making it:

• Easy to understand and maintain
• Scalable and testable
• A great learning resource for Flutter developers

The codebase is organized into clear layers:

• Presentation: Beautiful UI with BLoC state management
• Domain: Business logic and use cases
• Data: Repository pattern with local and remote data sources

🔌 API & Data

Democoin uses the CoinGecko API (free tier) to fetch real-time cryptocurrency data.

⚠️ Friendly Reminder: The free API has rate limits, so please be gentle with your requests! If you spam too many requests, you might encounter a 429 status code (too many requests). Let's keep it cool and respectful! 😊

🎯 Getting Started

1. Clone the repository

   git clone https://github.com/arg0nath/democoin.git
   cd democoin

2. Install dependencies

   flutter pub get

3. Run the app

   flutter run

🪙 Adding More Coins

By default, we track a limited number of cryptocurrencies to respect the API rate limits. But if you want to explore more coins, you can easily add them!

Just head over to lib/core/common/constants/app_const.dart and add your favorite coins to the availableCryptoCoinIds list:

static const List<String> availableCryptoCoinIds = [
  'bitcoin',
  'ethereum',  // Add more here!
  'cardano',
  // ... your favorites
];

Note: Remember to be mindful of API rate limits when adding more coins!

🛠️ Tech Stack

• Flutter - Beautiful native apps from a single codebase
• Dart - The language that powers Flutter
• BLoC/Cubit - Predictable state management
• Go Router - Declarative routing
• Dio - Powerful HTTP client
• GetIt - Dependency injection
• SharedPreferences - Local data persistence

🤝 Contributing

This is an open-source project, and contributions are always welcome! Whether it's:

• 🐛 Bug fixes
• ✨ New features
• 📝 Documentation improvements
• 🎨 UI/UX enhancements

Feel free to open an issue or submit a pull request. Let's make Democoin even better together!

📱 Screenshots

Coming soon! The app is so pretty, we're still taking the perfect screenshots. 📸

📄 License

This project is open source and available under the MIT License.

💬 Questions or Feedback?

Have questions? Found a bug? Want to chat about crypto or Flutter? Feel free to open an issue or reach out!

---

Made with ❤️ and Flutter

Happy coding! 🎉