Transform your digital habits. Reclaim your focus. Achieve digital wellness.
BlockMind is a comprehensive digital wellness application built with Flutter and powered by Firebase, designed to help users manage screen time, improve productivity, and maintain healthy digital habits. With intelligent app blocking, advanced analytics, and AI-powered assistance, BlockMind empowers users to take control of their digital lives.
Empowering individuals to build meaningful relationships with technology through mindful usage and digital wellness.
|
|
|
|
|
Welcome Screen |
 Registration Options |
 Login Screen |
 Email Verification |
 Manual Registration |
 Manual Login |
 Password Recovery |
 Welcome Guide |
 Features Overview |
 Setup Guide |
 Get Started |
🔑 Key Authentication Highlights:
- 🔐 Secure Authentication - Multiple login methods including social media
- ✉️ Email Verification - Enhanced security with email confirmation
- 🎓 Interactive Onboarding - Step-by-step introduction to features
- 🚀 Quick Setup - Get started in under 2 minutes
|
Main Dashboard |
 Quick Block Feature |
 Active Sessions |
 Timer Interface |
 App Selection |
 Create Block Session |
 Start Block Confirmation |
 Reset Options |
⚡ Key Home Features:
- 🚫 Quick Block - Start blocking sessions in seconds
- 📊 Real-time Monitoring - Live tracking of active sessions
- 🎯 Smart Selection - Choose apps by category or individually
- 🕐 Flexible Timing - Custom durations from 15 minutes to hours
 All Schedules |
 Create New Schedule |
 Schedule Details |
 Calendar Overview |
 Delete Confirmation |
📅 Schedule Management Features:
- 📋 Flexible Scheduling - Daily, weekly, or custom patterns
- 🎨 Visual Calendar - See your blocking schedule at a glance
- ⚙️ Easy Management - Create, edit, and delete schedules effortlessly
- 🔄 Smart Recurrence - Set up complex recurring patterns
 All Activities |
 Today's Activities |
 Getting Started |
|
Daily Analysis |
 Daily Breakdown |
 Weekly Analysis |
 Monthly Analysis |
📈 Analytics Features:
- 📊 Comprehensive Reports - Multi-timeframe analysis
- 📈 Trend Analysis - Understand your progress over time
- 🎯 Goal Tracking - Monitor achievement of wellness goals
- 📋 Detailed Insights - Hour-by-hour breakdown and patterns
|
AI Chatbot Interface |
 Intelligent Conversations |
🤖 AI Assistant Features:
- 🧠 Smart Assistant - AI-powered recommendations and support
- 💬 Natural Conversation - Intuitive chat interface
- 🎯 Personalized Advice - Custom recommendations based on your usage
- 🌟 24/7 Availability - Always there when you need guidance
|
Main Profile |
 Settings Menu |
 Account Settings |
 Account Details |
 Notifications |
 Theme Settings |
 Language Options |
 Time Management |
 Backup & Restore |
 Privacy Settings |
 Help & FAQ |
 About BlockMind |
👤 Profile Features:
- 🏆 Achievement System - Gamified progress tracking
- ⚙️ Deep Customization - Tailor the app to your preferences
- 🔒 Privacy First - Complete control over your data
- 🌍 Multi-language Support - Available in multiple languages
| Category | Technologies |
|---|---|
| Frontend | Flutter, Dart |
| Backend | Firebase (Auth, Firestore, Cloud Functions) |
| Local Storage | SharedPreferences, Hive |
| Authentication | Firebase Auth, OAuth 2.0 |
| Analytics | Custom Analytics Engine |
| State Management | Provider / Bloc |
| Notifications | Firebase Cloud Messaging |
- Flutter SDK (3.0+)
- Dart SDK (2.17+)
- Android Studio / VS Code
- Firebase Account
# Clone the repository
git clone https://github.com/blockmind/blockmind.git
# Navigate to project directory
cd blockmind
# Install dependencies
flutter pub get
# Run the app
flutter run-
Firebase Setup
# Install Firebase CLI npm install -g firebase-tools # Login to Firebase firebase login # Initialize Firebase in your project firebase init
-
Add Firebase Configuration Files
- Download
google-services.jsonfor Android and place inandroid/app/ - Download
GoogleService-Info.plistfor iOS and place inios/Runner/
- Download
-
Environment Setup
# pubspec.yaml dependencies dependencies: flutter: sdk: flutter firebase_core: ^2.15.0 firebase_auth: ^4.7.2 cloud_firestore: ^4.8.4 shared_preferences: ^2.2.0 hive: ^2.2.3
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Presentation │ │ Business │ │ Data │
│ Layer │◄──►│ Logic │◄──►│ Layer │
│ │ │ Layer │ │ │
│ • Flutter UI │ │ • Provider/Bloc │ │ • Firebase │
│ • Widgets │ │ • Services │ │ • Local Storage │
│ • Screens │ │ • Repositories │ │ • Hive/SharedP │
└─────────────────┘ └─────────────────┘ └─────────────────┘
lib/
├── core/
│ ├── constants/
│ ├── utils/
│ └── services/
├── features/
│ ├── auth/
│ │ ├── data/
│ │ ├── domain/
│ │ └── presentation/
│ ├── home/
│ ├── schedule/
│ ├── analytics/
│ ├── profile/
│ └── chatbot/
├── shared/
│ ├── widgets/
│ ├── models/
│ └── providers/
└── main.dart
class AppBlockingService {
static Future<void> startBlockSession({
required List<String> blockedApps,
required Duration duration,
required BlockType type,
}) async {
// Implementation for starting app blocking
}
static Future<void> stopBlockSession(String sessionId) async {
// Implementation for stopping app blocking
}
static Stream<List<BlockSession>> getActiveBlocks() {
// Stream of active blocking sessions
}
}class AnalyticsService {
static Future<UsageReport> generateReport(TimeFrame timeframe) async {
// Generate usage analytics report
}
static Future<double> calculateProductivityScore() async {
// Calculate user productivity score
}
static Future<void> trackAppUsage(String appId, Duration duration) async {
// Track app usage for analytics
}
}class AIAssistantService {
static Future<List<Recommendation>> getRecommendations(
UserProfile profile
) async {
// Get personalized recommendations
}
static Future<String> getChatResponse(String message) async {
// Process chat messages and return AI response
}
}| Aspect | Implementation |
|---|---|
| Data Encryption | End-to-end encryption for all sensitive data |
| Local Processing | Analytics processed locally when possible |
| Minimal Collection | Only collect data essential for functionality |
| User Control | Complete control over data sharing preferences |
| GDPR Compliant | Full compliance with privacy regulations |
| Firebase Security | Advanced security rules and authentication |
- 🔒 Secure Authentication - Firebase Auth with multi-factor support
- 🛡️ Data Protection - Firestore security rules and encryption
- 🔄 Regular Updates - Continuous security improvements
- 📋 Privacy Controls - Granular privacy settings
- 🎯 Minimal Permissions - Only request necessary device permissions
We welcome contributions from the community! Here's how you can get involved:
|
|
|
- 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
- Code Style: Follow Dart/Flutter style guide
- Testing: Write unit and widget tests
- Documentation: Update documentation for new features
- Performance: Ensure no performance regressions
- 📧 Email: [email protected]
- 💬 Live Chat: Available in-app 24/7
- 📚 Documentation: docs.blockmind.app
- 🎥 Video Tutorials: YouTube Channel
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2024 MAD Developers Solutions - NSBM Green University
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:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Developed with ❤️ by MAD Developers Solutions
NSBM Green University
- Flutter Team - For the amazing cross-platform framework
- Firebase Team - For the comprehensive backend services
- Open Source Community - For the incredible libraries and tools
- NSBM Green University - For supporting our development journey
- Beta Testers - For helping us improve the app
Start your journey to better digital habits today with BlockMind!
⭐ Star this repository if you found it helpful! ⭐