UI redesign

.github/actions/flutter-prepare/action.yml

@@ -0,0 +1,27 @@
+name: Flutter Prepare
+description: Set up Flutter from .flutter_version and fetch dependencies.
+
+inputs:
+  app-dir:
+    description: Path to the Flutter application directory.
+    required: true
+
+runs:
+  using: composite
+  steps:
+    - name: Read Flutter version
+      id: flutter_version
+      shell: bash
+      run: echo "version=$(cat ${{ inputs.app-dir }}/.flutter_version)" >> "$GITHUB_OUTPUT"
+
+    - name: Set up Flutter
+      uses: subosito/flutter-action@v2
+      with:
+        channel: stable
+        flutter-version: ${{ steps.flutter_version.outputs.version }}
+        cache: true
+
+    - name: Install dependencies
+      shell: bash
+      working-directory: ${{ inputs.app-dir }}
+      run: flutter pub get

.github/workflows/pr_build_all_platforms.yml

@@ -0,0 +1,216 @@
+name: Build PR Artifacts
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - ready_for_review
+
+permissions:
+  contents: read
+  pull-requests: write
+
+concurrency:
+  group: pr-build-artifacts-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+env:
+  APP_DIR: open_wearable
+
+jobs:
+  build_android:
+    name: Build Android
+    runs-on: ubuntu-latest
+    outputs:
+      artifact_id: ${{ steps.upload_android.outputs.artifact-id }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set up Java
+        uses: actions/setup-java@v5
+        with:
+          distribution: zulu
+          java-version: "17"
+          cache: gradle
+
+      - name: Set up Flutter project
+        uses: ./.github/actions/flutter-prepare
+        with:
+          app-dir: ${{ env.APP_DIR }}
+
+      - name: Build Android APK
+        working-directory: ${{ env.APP_DIR }}
+        run: flutter build apk --release
+
+      - name: Upload Android APK
+        id: upload_android
+        uses: actions/upload-artifact@v6
+        with:
+          name: android-apk
+          path: open_wearable/build/app/outputs/flutter-apk/app-release.apk
+          if-no-files-found: error
+
+  build_linux:
+    name: Build Linux
+    runs-on: ubuntu-latest
+    outputs:
+      artifact_id: ${{ steps.upload_linux.outputs.artifact-id }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Install Linux build dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            clang \
+            cmake \
+            libgstreamer1.0-dev \
+            libgstreamer-plugins-base1.0-dev \
+            gstreamer1.0-plugins-base \
+            libgtk-3-dev \
+            ninja-build \
+            pkg-config
+
+      - name: Set up Flutter project
+        uses: ./.github/actions/flutter-prepare
+        with:
+          app-dir: ${{ env.APP_DIR }}
+
+      - name: Build Linux bundle
+        working-directory: ${{ env.APP_DIR }}
+        run: flutter build linux --release
+
+      - name: Upload Linux bundle
+        id: upload_linux
+        uses: actions/upload-artifact@v6
+        with:
+          name: linux-bundle
+          path: open_wearable/build/linux/x64/release/bundle
+          if-no-files-found: error
+
+  build_windows:
+    name: Build Windows
+    runs-on: windows-latest
+    outputs:
+      artifact_id: ${{ steps.upload_windows.outputs.artifact-id }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set up Flutter project
+        uses: ./.github/actions/flutter-prepare
+        with:
+          app-dir: ${{ env.APP_DIR }}
+
+      - name: Build Windows runner
+        working-directory: ${{ env.APP_DIR }}
+        run: flutter build windows --release
+
+      - name: Upload Windows runner
+        id: upload_windows
+        uses: actions/upload-artifact@v6
+        with:
+          name: windows-runner
+          path: open_wearable/build/windows/x64/runner/Release
+          if-no-files-found: error
+
+  build_web:
+    name: Build Web
+    runs-on: ubuntu-latest
+    outputs:
+      artifact_id: ${{ steps.upload_web.outputs.artifact-id }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Set up Flutter project
+        uses: ./.github/actions/flutter-prepare
+        with:
+          app-dir: ${{ env.APP_DIR }}
+
+      - name: Build Web bundle
+        working-directory: ${{ env.APP_DIR }}
+        run: flutter build web --release
+
+      - name: Upload Web bundle
+        id: upload_web
+        uses: actions/upload-artifact@v6
+        with:
+          name: web-bundle
+          path: open_wearable/build/web
+          if-no-files-found: error
+
+  comment_artifact_links:
+    name: Comment Artifact Links
+    runs-on: ubuntu-latest
+    needs:
+      - build_android
+      - build_linux
+      - build_windows
+      - build_web
+    if: always()
+
+    steps:
+      - name: Post or update PR comment with artifact links
+        uses: actions/github-script@v8
+        env:
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          ANDROID_ARTIFACT_ID: ${{ needs.build_android.outputs.artifact_id }}
+          LINUX_ARTIFACT_ID: ${{ needs.build_linux.outputs.artifact_id }}
+          WINDOWS_ARTIFACT_ID: ${{ needs.build_windows.outputs.artifact_id }}
+          WEB_ARTIFACT_ID: ${{ needs.build_web.outputs.artifact_id }}
+        with:
+          script: |
+            const marker = '<!-- pr-build-artifacts -->';
+            const prNumber = context.payload.pull_request.number;
+            const runUrl = process.env.RUN_URL;
+            const repoUrl = `${context.serverUrl}/${context.repo.owner}/${context.repo.repo}`;
+            const linkFor = (id) => id
+              ? `${repoUrl}/actions/runs/${context.runId}/artifacts/${id}`
+              : runUrl;
+
+            const body = `${marker}
+            ### PR Build Artifacts
+            - Android APK: [Download Android build](${linkFor(process.env.ANDROID_ARTIFACT_ID)})
+            - Linux Bundle: [Download Linux build](${linkFor(process.env.LINUX_ARTIFACT_ID)})
+            - Windows Runner: [Download Windows build](${linkFor(process.env.WINDOWS_ARTIFACT_ID)})
+            - Web Bundle: [Download Web build](${linkFor(process.env.WEB_ARTIFACT_ID)})
+
+            Full workflow run: ${runUrl}`;
+
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: prNumber,
+            });
+
+            const previous = comments.find(
+              (comment) =>
+                comment.user.type === 'Bot' &&
+                comment.body &&
+                comment.body.includes(marker)
+            );
+
+            if (previous) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: previous.id,
+                body,
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: prNumber,
+                body,
+              });
+            }

open_wearable/README.md

@@ -1,16 +1,28 @@
-# open_wearable
+# OpenWearable App Module
 
-A new Flutter project.
+Flutter application module for the OpenEarable app.
 
-## Getting Started
+## Documentation
 
-This project is a starting point for a Flutter application.
+High-level architecture and state-management docs live in [`docs/`](./docs/README.md).
 
-A few resources to get you started if this is your first Flutter project:
+- [App Setup and Architecture](./docs/app-setup.md)
+- [State and Providers](./docs/state-and-providers.md)
 
-- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
-- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)
+## Development Quick Start
 
-For help getting started with Flutter development, view the
-[online documentation](https://docs.flutter.dev/), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+1. Install Flutter (stable channel).
+2. From this folder (`open_wearable/`), fetch dependencies:
+   ```bash
+   flutter pub get
+   ```
+3. Run on a connected device/emulator:
+   ```bash
+   flutter run
+   ```
+
+## Notes
+
+- Core app bootstrap is in `lib/main.dart`.
+- Route definitions are in `lib/router.dart`.
+- High-level feature state is primarily under `lib/view_models/`.

open_wearable/android/app/src/main/AndroidManifest.xml

@@ -1,6 +1,6 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
     <application android:label="OpenWearable" android:name="${applicationName}" android:icon="@mipmap/ic_launcher" android:enableOnBackInvokedCallback="true">
-        <activity android:name=".MainActivity" android:exported="true" android:launchMode="singleTop" android:taskAffinity="" android:theme="@style/LaunchTheme" android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode" android:hardwareAccelerated="true" android:windowSoftInputMode="adjustResize">
+        <activity android:name=".MainActivity" android:exported="true" android:launchMode="singleTop" android:taskAffinity="" android:theme="@style/LaunchTheme" android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode" android:hardwareAccelerated="true" android:windowSoftInputMode="adjustResize" android:screenOrientation="portrait">
             <!-- Specifies an Android theme to apply to this Activity as soon as
                  the Android process has started. This theme is visible to the user
                  while the Flutter UI initializes. After that, this theme continues

open_wearable/android/app/src/main/kotlin/com/example/open_wearable/MainActivity.kt

@@ -1,5 +1,36 @@
 package edu.kit.teco.openWearable
 
+import android.content.Intent
+import android.provider.Settings
 import io.flutter.embedding.android.FlutterActivity
+import io.flutter.embedding.engine.FlutterEngine
+import io.flutter.plugin.common.MethodChannel
 
-class MainActivity: FlutterActivity()
+class MainActivity : FlutterActivity() {
+  companion object {
+    private const val SYSTEM_SETTINGS_CHANNEL = "edu.kit.teco.open_wearable/system_settings"
+  }
+
+  override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
+    super.configureFlutterEngine(flutterEngine)
+
+    MethodChannel(
+      flutterEngine.dartExecutor.binaryMessenger,
+      SYSTEM_SETTINGS_CHANNEL,
+    ).setMethodCallHandler { call, result ->
+      if (call.method == "openBluetoothSettings") {
+        try {
+          val intent = Intent(Settings.ACTION_BLUETOOTH_SETTINGS).apply {
+            addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+          }
+          startActivity(intent)
+          result.success(true)
+        } catch (_: Exception) {
+          result.success(false)
+        }
+      } else {
+        result.notImplemented()
+      }
+    }
+  }
+}

open_wearable/docs/README.md

@@ -0,0 +1,21 @@
+# OpenWearable App Documentation
+
+This folder contains high-level documentation for the Flutter app in `open_wearable/`.
+
+## Documents
+
+- [App Setup and Architecture](./app-setup.md)
+  - Startup flow, dependency initialization, routing, UI shell, and lifecycle handling.
+- [State and Providers](./state-and-providers.md)
+  - How top-level providers are wired, how per-device providers are created, and how data flows from wearables to UI.
+- [Page Documentation](./pages/README.md)
+  - Detailed page-by-page contracts: needs, behavior, and outputs.
+
+## Suggested Reading Order
+
+1. [App Setup and Architecture](./app-setup.md)
+2. [State and Providers](./state-and-providers.md)
+
+## Scope
+
+These docs are intentionally focused on app-level behavior and state handling. They are not API references for `open_earable_flutter`.