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,213 @@
+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 \
+            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/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`.