🤸 moveUP Mobile Fitness App

Mobile client for the moveUP fitness platform.

---

📚 Table of Contents

• 🚀 Highlights
• 📦 Tech Stack
• 🏗️ Architecture
• 📂 Project Structure
• 🛠️ Getting Started
• 🧪 Testing
• 📖 Documentation
• 🐋 Docker Build
• 📝 Changelog

---

🚀 Highlights

• 🏛️ Clean Architecture (Data → Domain → Presentation)
• 💉 Dependency Injection (GetIt + Provider)
• ⚠️ Error Handling (Result pattern + Failure hierarchy)
• 📝 Logging with AppLogger abstraction and Mixin for Bloc/Cubit
• 🧭 Navigation with GoRouter
• 🌐 Connectivity Tracking with connectivity_plus
• 📦 Modular Structure for scalable feature development

---

📦 Tech Stack

Category	Technology
Framework	Flutter 3.41.0+
State Management	flutter_bloc
Dependency Injection	get_it, provider
Navigation	go_router
Connectivity Tracking	connectivity_plus
HTTP Client	dio + retrofit
Code Generation	freezed, json_serializable, build_runner
Logging	logger
Testing	mockito, bloc_test, flutter_test
UI Components	flutter_svg, cached_network_image

---

🏗️ Architecture

This app follows Clean Architecture principles:

┌─────────────────────────────────────────┐
│           Presentation Layer            │
│      (Pages, Widgets, BLoC/Cubit)       │
└───────────────────┬─────────────────────┘
                    │
                    │ uses
┌───────────────────▼─────────────────────┐
│             Domain Layer                │
│   (Entities, UseCases, Repositories*)   │  * interfaces only
└───────────────────▲─────────────────────┘
                    │
                    │ implements
┌───────────────────┴─────────────────────┐
│              Data Layer                 │
│  (DTOs, DataSources, Repositories Impl) │
└─────────────────────────────────────────┘

---

📂 Project Structure

lib/
├── core/                  # Shared infrastructure
│   ├── di/                # Dependency injection
│   ├── failures/          # Error handling (Failure)
│   ├── result/            # Result-pattern
│   ├── router/            # Navigation (GoRouter)
│   ├── services/          # Services (Network, etc.)
│   └── utils/             # Utilities (Logger, Analytics)
├── features/              # Feature modules (Clean Architecture)
│   └── [feature_name]/
│       ├── data/          # DTOs, DataSources, Repository Impl
│       ├── domain/        # Entities, UseCases, Repository Interfaces
│       └── presentation/  # Pages, Widgets, BLoC/Cubit
├── uikit/                 # Shared UI components
└── main.dart              # App entry point

---

🛠️ Getting Started

Prerequisites

• Flutter SDK: >=3.41.0
• Dart SDK: >=3.11.0

Setup

1. Install dependencies:

   flutter pub get

2. Run code generation:

   flutter pub run build_runner build --delete-conflicting-outputs

3. Run the app:

   flutter run

---

🧪 Testing

Run tests:

# Unit tests
flutter test

# Widget tests
flutter test test/features/*/presentation/

# Coverage (requires lcov)
flutter test --coverage
genhtml coverage/lcov.info -o coverage/html

---

📖 Documentation

Generate API docs from Dart doc-comments:

dart doc --output doc/api

Serve docs locally:

dart pub global activate dhttpd
dart pub global run dhttpd --path doc/api

Then open:

http://localhost:8080

---

🐋 Docker Build

Build Android APK using Docker:

docker build \                                                  
  --build-arg BUILD_DATE=$(date -u +'%Y-%m-%dT%H:%M:%SZ') \
  --build-arg VCS_REF=$(git rev-parse --short HEAD) \
  --progress=plain \
  --no-cache \
  -t moveUP-app-android:latest .

Extract APK files:

docker create --name temp-flutter moveUP-app-android:latest
docker cp temp-flutter:/artifacts/. ./apk-output/
docker rm temp-flutter

---

📝 Changelog

All notable changes to this project are documented in CHANGELOG.md.