Seedlinker Android App

Seedlinker Android App is a mobile companion for the Seedlinker IoT ecosystem. It enables real-time device monitoring, management, and configuration through a clean, intuitive Flutter interface.

Features

• Secure Authentication: Robust user login and registration system with session persistence.
• Real-Time Monitoring: Live data visualization from devices using WebSockets integration.
• Device Management: Easy tools to add, configure, and view details of connected Seedlinker devices.
• Smart Dashboard: A centralized home view for a quick overview of your ecosystem status.
• Multi-language Support: Fully localized interface adapted for different regions.
• Modern UI/UX: Smooth animations, custom typography (Aileron), and intuitive navigation.

Technologies Used

• Flutter: Cross-platform framework for building natively compiled applications.
• Dart: Programming language used for Flutter development.
• Riverpod: State management solution for efficient and scalable app architecture.
• WebSockets: For real-time communication with the Seedlinker backend.
• Dio : HTTP client for API interactions.
• Easy Localizations: For multi-language support.
• GoRouter: For declarative routing and navigation.
• Shared Preferences: For persistent local storage.

Note: Please check 📄pubspec.yaml for the full list of dependencies.

Getting Started

Prerequisites

• Flutter SDK 3.7.x or higher
• Android Studio or VS Code with Flutter extension
• Android device or emulator
• Seedlinker Server running and accessible

Installation

1. Clone the repository:

   git clone https://github.com/igidio/seedlinker_androidapp.git
   cd seedlinker_androidapp

2. Install dependencies:

   flutter pub get

3. Configure .env from .env.template with the server address:

   cp .env.template .env
   # Edit .env with your values

4. Run the app in development:

   flutter run

Project Structure

• 📁lib/
  • 📄main.dart: App entry point, initializes app, routes and global state.
  • 📄routes.dart: App navigation routes.
  • 📄common.dart: Barrel file
  • 📁core/
    • 📁models/: Data models for users, devices, sensors and actuators.
    • 📁providers/: State management using Riverpod.
    • 📁services/: Communication with the Seedlinker server.
    • 📁storages/: Local persistence for tokens and settings.
    • 📁theme/: App colors and styles.
    • 📁layouts/: Screen layouts like dashboard and device details.
    • 📁widgets/: Reusable UI components.
    • 📁utils/: Utility helpers such as date formatting.
• 📁features/: Feature-specific logic and screens.

License

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