ConnectFlow - BLE Device Manager

Flutter BLE app with clean architecture, BLoC pattern, real-time data streaming, and OTA firmware updates

A professional-grade Flutter application for managing Bluetooth Low Energy (BLE) devices with real-time sensor monitoring, over-the-air firmware updates, and comprehensive device control capabilities.

✨ Features

🔍 Device Management

Smart Scanning: Automatic BLE device discovery with RSSI indication
Secure Pairing: Robust device connection with timeout handling
Connection Management: Real-time connection status monitoring

📊 Real-time Data Streaming

Live Sensor Data: Temperature, humidity, pressure, and battery monitoring
Data Visualization: Real-time charts and historical data tracking
Configurable Buffering: Adjustable data history with memory management

🔄 OTA Firmware Updates

Wireless Updates: Over-the-air firmware deployment
Progress Tracking: Real-time update progress with status indicators
Error Handling: Robust error recovery and retry mechanisms

🏗️ Architecture & Design

Clean Architecture: Separation of concerns with layered design
SOLID Principles: Maintainable and extensible codebase
BLoC Pattern: Reactive state management with event-driven architecture
Dependency Injection: Modular design with GetIt

🏛️ Architecture Overview

├── 📱 Presentation Layer
│   ├── BLoC (State Management)
│   ├── Pages (UI Screens)
│   └── Widgets (Reusable Components)
│
├── 🧠 Domain Layer
│   ├── Entities (Business Models)
│   ├── Use Cases (Business Logic)
│   └── Repository Interfaces
│
└── 💾 Data Layer
    ├── Data Sources (BLE Implementation)
    ├── Models (Data Transfer Objects)
    └── Repository Implementation

🎯 SOLID Principles Implementation

Single Responsibility: Each class has one clear purpose
Open/Closed: Easy to extend without modifying existing code
Liskov Substitution: Interfaces are properly abstracted
Interface Segregation: Small, focused interfaces
Dependency Inversion: High-level modules independent of low-level details

🚀 Getting Started

Prerequisites

Flutter 3.0 or higher
Android SDK 21+ or iOS 12+
Physical device (BLE not supported on simulators)

Installation

Clone the repository

git clone https://github.com/sohailmahmud/ConnectFlow.git
cd connectflow

Install dependencies
```
flutter pub get
```

Generate code (if using build_runner)

flutter packages pub run build_runner build

Run the app
```
flutter run
```

📱 Platform Setup

Android Configuration

Add these permissions to android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

iOS Configuration

Add to ios/Runner/Info.plist:

<key>NSBluetoothAlwaysUsageDescription</key>
<string>This app needs Bluetooth access to connect to BLE devices</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>This app needs Bluetooth access to connect to BLE devices</string>

📦 Dependencies

Core Dependencies

dependencies:
  flutter_blue_plus: ^1.14.3      # Modern BLE library
  flutter_bloc: ^8.1.3            # State management
  equatable: ^2.0.5               # Value equality
  injectable: ^2.3.2              # Dependency injection annotations
  get_it: ^7.6.4                  # Service locator
  permission_handler: ^11.0.1     # Runtime permissions
  rxdart: ^0.27.7                 # Reactive extensions
  dartz: ^0.10.1                  # Functional programming

dev_dependencies:
  build_runner: ^2.4.7            # Code generation
  freezed: ^2.4.6                 # Immutable classes
  injectable_generator: ^2.4.1    # DI code generation
  json_serializable: ^6.7.1       # JSON serialization

🎮 Usage

Basic Workflow

Scan for Devices

context.read<BleBloc>().add(StartScanningEvent());

Connect to Device

context.read<BleBloc>().add(ConnectToDeviceEvent(deviceId));

Start Data Streaming

context.read<BleBloc>().add(StartDataStreamEvent(deviceId));

Firmware Update

context.read<BleBloc>().add(
  StartFirmwareUpdateEvent(deviceId, firmwareData)
);

State Management Example

BlocBuilder<BleBloc, BleState>(
  builder: (context, state) {
    if (state is BleDataStreaming) {
      return DataVisualizationWidget(
        device: state.device,
        dataHistory: state.dataHistory,
      );
    }
    return CircularProgressIndicator();
  },
)

🧪 Testing

Running Tests

# Domain layer tests
flutter test test/domain/

# Data layer tests  
flutter test test/data/

# Presentation layer tests
flutter test test/presentation/

# All unit tests
flutter test

# Integration tests
flutter test integration_test/

# With coverage
flutter test --coverage

Test Structure

test/
├── core/
│   └── errors/failures_test.dart
├── domain/
│   ├── entities/
│   ├── usecases/
├── data/
│   ├── models/
│   └── repositories/
├── presentation/
│   ├── bloc/
│   └── widgets/
├── mocks/
├── test_helpers/
└── integration_test/

🔧 Configuration

BLE Service UUIDs

Update these constants in ble_datasource.dart:

static const String serviceUuid = "12345678-1234-1234-1234-123456789abc";
static const String dataCharacteristicUuid = "87654321-4321-4321-4321-cba987654321";
static const String otaCharacteristicUuid = "11111111-2222-3333-4444-555555555555";

Data Parsing

Customize sensor data parsing in _parseFloat() method based on your device's data format.

📊 Performance

Memory Management: Automatic cleanup of streams and subscriptions
Battery Optimization: Efficient BLE scanning with timeouts
Data Buffering: Configurable history size to prevent memory leaks
Connection Pooling: Proper device connection lifecycle management

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Follow the existing code style and architecture patterns
Write tests for new functionality
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 Effective Dart guidelines
Use meaningful variable and function names
Add documentation for public APIs
Maintain separation of concerns

🐛 Troubleshooting

Common Issues

BLE Not Working on Emulator

BLE requires physical device - emulators don't support Bluetooth hardware

Permission Denied Errors

Ensure all required permissions are added to platform-specific files
Check that location services are enabled (required for BLE scanning)

Connection Timeouts

Verify device is in pairing mode
Check signal strength (RSSI)
Ensure device is not connected to another app

OTA Update Failures

Verify firmware file format
Check MTU size limitations
Ensure stable connection during update

� CI/CD & DevOps

This project includes comprehensive GitHub Actions workflows for automated testing, building, and deployment:

🔄 Continuous Integration (`.github/workflows/ci.yml`)

Automated Testing: Runs on every push and pull request
Multi-platform Support: Tests on Ubuntu, macOS, and Windows
Comprehensive Coverage: Unit, widget, and integration tests
Code Quality: Static analysis, formatting checks, and security scanning
Coverage Reporting: Automatic test coverage analysis

🛠️ Maintenance Workflow (`.github/workflows/maintenance.yml`)

Weekly Dependency Updates: Automated dependency management
Security Audits: Regular vulnerability scanning
Automated PRs: Creates pull requests for updates

📦 Release Workflow (`.github/workflows/release.yml`)

Production Builds: Automated APK and App Bundle generation
GitHub Releases: Automatic release creation with changelogs
Artifact Management: Binary distribution and versioning
Multi-format Support: Both stable and pre-release versions

Workflow Badges

Add these badges to track your CI/CD status:

[![CI](https://github.com/yourusername/connectflow/workflows/CI/badge.svg)](https://github.com/yourusername/connectflow/actions/workflows/ci.yml)
[![Maintenance](https://github.com/yourusername/connectflow/workflows/Maintenance/badge.svg)](https://github.com/yourusername/connectflow/actions/workflows/maintenance.yml)
[![Release](https://github.com/yourusername/connectflow/workflows/Release/badge.svg)](https://github.com/yourusername/connectflow/actions/workflows/release.yml)

�📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Flutter Blue Plus - Excellent BLE library
BLoC Library - Reactive state management
GetIt - Dependency injection
Clean Architecture principles by Robert C. Martin

📞 Support

📧 Email: sohailmahmud@yahoo.com
🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions

Made with ❤️ using Flutter

Name		Name	Last commit message	Last commit date
Latest commit History 22 Commits
.github/workflows		.github/workflows
.vscode		.vscode
android		android
integration_test		integration_test
ios		ios
lib		lib
test		test
.fvmrc		.fvmrc
.gitignore		.gitignore
.metadata		.metadata
CHANGELOG.md		CHANGELOG.md
README.md		README.md
analysis_options.yaml		analysis_options.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

sohailmahmud/connectflow

Folders and files

Latest commit

History

Repository files navigation