Admin UI: Initialize flutter setup

.ci/runAdminUiChecks.sh → .ci/aui/runChecks.sh

@@ -1,3 +1,4 @@
+#!/bin/bash
 set -e
 set -x
 

.ci/aui/runFlutterChecks.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+set -e
+set -x
+
+cd AdminUi
+dart pub global activate melos
+melos bootstrap
+melos analyze
+melos format

.github/workflows/test.yml

@@ -15,7 +15,18 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Run Checks
-        run: ./.ci/runAdminUiChecks.sh
+        run: ./.ci/aui/runChecks.sh
+
+  run-adminUi-flutter-checks:
+    runs-on: ubuntu-latest
+    name: Run Admin UI Flutter Checks
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Flutter
+        uses: subosito/[email protected]
+      - name: Run checks
+        run: ./.ci/aui/runFlutterChecks.sh
 
   check-formatting:
     runs-on: ubuntu-latest

.gitignore

@@ -366,3 +366,6 @@ dist
 # feature.cs files are generated by the build process and should not be committed to source control
 **/*.feature.cs
 **/SpecFlow/
+
+# flutter
+!AdminUi/packages/*

.vscode/extensions.json

@@ -1,3 +1,3 @@
 {
-    "recommendations": ["ms-azuretools.vscode-docker", "ms-dotnettools.csdevkit"]
+    "recommendations": ["ms-azuretools.vscode-docker", "Dart-Code.flutter", "Dart-Code.dart-code"]
 }

.vscode/launch.json

@@ -2,15 +2,11 @@
     "version": "0.2.0",
     "configurations": [
         {
-            "name": "Attach to Consumer API (Docker)",
-            "type": "docker",
-            "request": "attach",
-            "platform": "netCore",
-            "sourceFileMap": {
-                "/app": "${workspaceFolder}"
-            },
-            "containerName": "consumerApi",
-            "processName": "ConsumerApi"
+            "name": "Launch current dart file",
+            "request": "launch",
+            "type": "dart",
+            "toolArgs": ["--dart-define-from-file=${workspaceFolder}/AdminUI/config.json"],
+            "templateFor": ""
         }
     ]
 }

.vscode/settings.json

@@ -29,5 +29,10 @@
     "editor.codeActionsOnSave": {
         "source.organizeImports": "explicit"
     },
-    "files.eol": "\n"
+    "files.eol": "\n",
+    "dart.lineLength": 150,
+    "[dart]": {
+        "editor.defaultFormatter": "Dart-Code.dart-code",
+        "editor.rulers": [150]
+    }
 }

AdminUi/.gitignore

@@ -0,0 +1,9 @@
+pubspec_overrides.yaml
+.dart_tool
+build
+.flutter-plugins
+.flutter-plugins-dependencies
+.DS_Store
+
+# config.json for connecting to the admin api
+config.json

AdminUi/README.md

@@ -0,0 +1,35 @@
+# Admin UI
+
+## Development Guide
+
+### Prerequisites
+
+-   [Flutter](https://flutter.dev/docs/get-started/install) (we are using the `stable` channel)
+-   [melos](https://melos.invertase.dev/getting-started)
+
+    TLDR: `dart pub global activate melos`
+
+    Make sure to [add the system cache bin directory to your path](https://dart.dev/tools/pub/cmd/pub-global#running-a-script-from-your-path) (`$HOME/.pub-cache/bin` for mac and linux and `%LOCALAPPDATA%\Pub\Cache\bin` for most Windows versions).
+
+### Getting Started
+
+Run `melos bootstrap` to [install and link dependencies](https://melos.invertase.dev/commands/bootstrap) in all packages and apps.
+
+### Melos scripts
+
+For an overview of all available melos scripts, run `melos run` or `melos run --help`.
+
+### Configuration
+
+Create a file `AdminUI/config.json` with the following content:
+
+```json
+{
+    "BASE_URL": "...",
+    "API_KEY": "..."
+}
+```
+
+This configuration is automatically used when using the VSCode tooling (run / debug buttons).
+
+For building and running the app from the command line, you can use the `--dart-define-from-file=<path-to-file>` flag.

AdminUi/analysis_options.yaml

@@ -0,0 +1,9 @@
+include: package:very_good_analysis/analysis_options.yaml
+
+linter:
+  rules:
+    lines_longer_than_80_chars: false
+    sort_constructors_first: false
+    public_member_api_docs: false
+    always_use_package_imports: false
+    avoid_setters_without_getters: false

AdminUi/apps/admin_ui/.gitignore

@@ -0,0 +1,43 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+**/ios/Flutter/.last_build_id
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.pub-cache/
+.pub/
+/build/
+
+# Symbolication related
+app.*.symbols
+
+# Obfuscation related
+app.*.map.json
+
+# Android Studio will place build artifacts here
+/android/app/debug
+/android/app/profile
+/android/app/release

AdminUi/apps/admin_ui/.metadata

@@ -0,0 +1,36 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "abb292a07e20d696c4568099f918f6c5f330e6b0"
+  channel: "stable"
+
+project_type: app
+
+# Tracks metadata for the flutter migrate command
+migration:
+  platforms:
+    - platform: root
+      create_revision: abb292a07e20d696c4568099f918f6c5f330e6b0
+      base_revision: abb292a07e20d696c4568099f918f6c5f330e6b0
+    - platform: macos
+      create_revision: abb292a07e20d696c4568099f918f6c5f330e6b0
+      base_revision: abb292a07e20d696c4568099f918f6c5f330e6b0
+    - platform: web
+      create_revision: abb292a07e20d696c4568099f918f6c5f330e6b0
+      base_revision: abb292a07e20d696c4568099f918f6c5f330e6b0
+    - platform: windows
+      create_revision: abb292a07e20d696c4568099f918f6c5f330e6b0
+      base_revision: abb292a07e20d696c4568099f918f6c5f330e6b0
+
+  # User provided section
+
+  # List of Local paths (relative to this file) that should be
+  # ignored by the migrate tool.
+  #
+  # Files that are not part of the templates will be ignored by default.
+  unmanaged_files:
+    - 'lib/main.dart'
+    - 'ios/Runner.xcodeproj/project.pbxproj'

AdminUi/apps/admin_ui/README.md

@@ -0,0 +1,3 @@
+# admin_ui
+
+The Enmeshed Backbone Admin UI.

AdminUi/apps/admin_ui/analysis_options.yaml

@@ -0,0 +1 @@
+include: ../../analysis_options.yaml