linux icon image fix

mih_api_hub/main.py

@@ -48,13 +48,15 @@ origins = [
     "http://MIH-API-Hub",
     "http://api.mzansi-innovation-hub.co.za",
     "http://app.mzansi-innovation-hub.co.za",
+    "https://api.mzansi-innovation-hub.co.za",
+    "https://app.mzansi-innovation-hub.co.za",
 ]
 
 init(
     app_info=InputAppInfo(
         app_name="Mzansi Innovation Hub",
         api_domain="http://localhost:8080/",
-        website_domain="http://app.mzansi-innovation-hub.co.za",
+        website_domain="https://app.mzansi-innovation-hub.co.za",
         api_base_path="/auth",
         website_base_path="/auth"
     ),

mih_api_hub/requirements.txt

@@ -9,5 +9,5 @@ watchfiles
 python-multipart
 python-dotenv
 xlrd
-supertokens-python
+supertokens-python==0.24.0
 sniffio

mih_ui/lib/mih_config/mih_env.dart

@@ -26,7 +26,15 @@ abstract class AppEnviroment {
             baseApiUrl = "http://localhost:8080";
             baseFileUrl = "http://localhost:9000";
             baseAiUrl = "http://localhost:11434";
-            bannerAdUnitId = 'ca-app-pub-3940256099942544/2435281174';
+            bannerAdUnitId = 'ca-app-pub-3940256099942544/2435281174'; // IOS ID
+            break;
+          } else if (Platform.isIOS || Platform.isLinux) {
+            //================= Web Dev Urls =================
+            baseAppUrl = "http://localhost:80";
+            baseApiUrl = "http://localhost:8080";
+            baseFileUrl = "http://localhost:9000";
+            baseAiUrl = "http://localhost:11434";
+            bannerAdUnitId = 'ca-app-pub-3940256099942544/2435281174'; // IOS ID
             break;
           } else if (Platform.isAndroid) {
             //================= Android Dev Urls =================
@@ -35,14 +43,6 @@ abstract class AppEnviroment {
             baseFileUrl = "http://10.0.2.2:9000";
             baseAiUrl = "http://10.0.2.2:11434";
             bannerAdUnitId = 'ca-app-pub-3940256099942544/9214589741';
-          } else {
-            //================= Web & iOS Dev Urls =================
-            baseAppUrl = "http://localhost:80";
-            baseApiUrl = "http://localhost:8080";
-            baseFileUrl = "http://localhost:9000";
-            baseAiUrl = "http://localhost:11434";
-            bannerAdUnitId = 'ca-app-pub-3940256099942544/2435281174';
-            break;
           }
         }
       case Enviroment.prod:

mih_ui/lib/mih_config/mih_theme.dart

@@ -98,6 +98,12 @@ class MihTheme {
         return "Android";
       } else if (platform == TargetPlatform.iOS) {
         return "iOS";
+      } else if (platform == TargetPlatform.linux) {
+        return "Linux";
+      } else if (platform == TargetPlatform.macOS) {
+        return "macOS";
+      } else if (platform == TargetPlatform.windows) {
+        return "Windows";
       }
     }
     return "Other";

mih_ui/lib/mih_package_components/Example/package_tools/package_tool_one.dart

@@ -1,5 +1,8 @@
+import 'dart:io';
+
 import 'package:country_code_picker/country_code_picker.dart';
 import 'package:file_picker/file_picker.dart';
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_speed_dial/flutter_speed_dial.dart';
 import 'package:geolocator/geolocator.dart';
@@ -451,7 +454,8 @@ class _PackageToolOneState extends State<PackageToolOne> {
                     ),
                   ],
                 ),
-                MihBannerAd(),
+                if (!kIsWeb && (Platform.isAndroid || Platform.isIOS))
+                  MihBannerAd(),
                 const SizedBox(height: 10),
                 Divider(
                   color: MihColors.getSecondaryColor(

mih_ui/lib/mih_package_components/mih_circle_avatar.dart

@@ -52,13 +52,16 @@ class _MihCircleAvatarState extends State<MihCircleAvatar> {
         context: context,
         builder: (context) {
           return MihPackageWindow(
-            fullscreen: false,
+            fullscreen: true,
             windowTitle: "",
+            scrollbarOn: false,
             onWindowTapClose: () {
               context.pop();
             },
-            windowBody: InteractiveViewer(
+            windowBody: SizedBox.expand(
-              child: Image(image: imagePreview!),
+              child: InteractiveViewer(
+                child: Image(image: imagePreview!),
+              ),
             ),
           );
         });

mih_ui/lib/mih_package_components/mih_dropdwn_field.dart

@@ -103,6 +103,18 @@ class _MihDropdownFieldState extends State<MihDropdownField> {
                     Expanded(
                       child: Theme(
                         data: Theme.of(context).copyWith(
+                          scrollbarTheme: ScrollbarThemeData(
+                            thumbColor: WidgetStatePropertyAll(
+                                MihColors.getPrimaryColor(
+                                    MzansiInnovationHub.of(context)!
+                                            .theme
+                                            .mode ==
+                                        "Dark")),
+                            thickness: const WidgetStatePropertyAll(6),
+                            radius: const Radius.circular(10),
+                            thumbVisibility: const WidgetStatePropertyAll(
+                                true), // Always show when scrolling
+                          ),
                           textSelectionTheme: TextSelectionThemeData(
                             cursorColor: MihColors.getPrimaryColor(
                                 MzansiInnovationHub.of(context)!.theme.mode ==

mih_ui/lib/mih_package_components/mih_package.dart

@@ -1,7 +1,9 @@
+import 'dart:io';
+
+import 'package:flutter/foundation.dart';
 import 'package:flutter/services.dart';
 import 'package:go_router/go_router.dart';
 import 'package:ken_logger/ken_logger.dart';
-import 'package:mzansi_innovation_hub/main.dart';
 import 'package:mzansi_innovation_hub/mih_package_components/mih_scack_bar.dart';
 import 'package:mzansi_innovation_hub/mih_packages/mih_home/components/mih_app_drawer.dart';
 import 'package:mzansi_innovation_hub/mih_package_components/mih_package_tools.dart';
@@ -100,7 +102,7 @@ class _MihPackageState extends State<MihPackage>
     //     _peakAnimation();
     //   });
     // }
-    if (!MzansiInnovationHub.of(context)!.theme.kIsWeb) {
+    if (!kIsWeb && (Platform.isAndroid || Platform.isIOS)) {
       // Trigger the peak animation only AFTER the route transition is complete
       WidgetsBinding.instance.addPostFrameCallback((_) {
         final ModalRoute? currentRoute = ModalRoute.of(context);

mih_ui/lib/mih_package_components/mih_package_tile.dart

@@ -1,3 +1,5 @@
+import 'dart:io';
+
 import 'package:app_settings/app_settings.dart';
 import 'package:flutter/foundation.dart';
 import 'package:local_auth/local_auth.dart';
@@ -155,7 +157,8 @@ class _MihPackageTileState extends State<MihPackageTile> {
   Future<void> authenticateUser() async {
     if (widget.authenticateUser != null &&
         widget.authenticateUser! &&
-        !kIsWeb) {
+        !kIsWeb &&
+        !Platform.isLinux) {
       if (await isUserAuthenticated()) {
         widget.onTap();
       }

mih_ui/lib/mih_package_components/mih_package_window.dart

@@ -15,6 +15,7 @@ class MihPackageWindow extends StatefulWidget {
   final Color? foregroundColor;
   final bool? borderOn;
   final bool fullscreen;
+  final bool? scrollbarOn;
   const MihPackageWindow({
     super.key,
     required this.fullscreen,
@@ -23,6 +24,7 @@ class MihPackageWindow extends StatefulWidget {
     required this.onWindowTapClose,
     required this.windowBody,
     this.borderOn,
+    this.scrollbarOn,
     this.backgroundColor,
     this.foregroundColor,
   });
@@ -177,7 +179,13 @@ class _MihPackageWindowState extends State<MihPackageWindow> {
                     getHeader(),
                     const SizedBox(height: 5),
                     Expanded(
-                        child: SingleChildScrollView(child: widget.windowBody)),
+                      child: widget.scrollbarOn != null || !widget.scrollbarOn!
+                          ? widget.windowBody
+                          : MihSingleChildScroll(
+                              scrollbarOn: true,
+                              child: widget.windowBody,
+                            ),
+                    ),
                   ],
                 )
               : Column(

mih_ui/lib/mih_packages/calculator/package_tools/currency_exchange_rate.dart

@@ -1,3 +1,6 @@
+import 'dart:io';
+
+import 'package:flutter/foundation.dart';
 import 'package:flutter/gestures.dart';
 import 'package:flutter/material.dart';
 import 'package:mzansi_innovation_hub/main.dart';
@@ -157,7 +160,11 @@ class _CurrencyExchangeRateState extends State<CurrencyExchangeRate> {
             ),
             SizedBox(height: 10),
             Consumer(builder: (context, bannerAdDisplay, child) {
-              return MihBannerAd();
+              if (!kIsWeb && (Platform.isAndroid || Platform.isIOS)) {
+                return MihBannerAd();
+              } else {
+                return const SizedBox(height: 0);
+              }
             }),
           ],
         ),

mih_ui/lib/mih_packages/calculator/package_tools/tip_calc.dart

@@ -1,3 +1,6 @@
+import 'dart:io';
+
+import 'package:flutter/foundation.dart';
 import 'package:mzansi_innovation_hub/main.dart';
 import 'package:mzansi_innovation_hub/mih_package_components/mih_banner_ad.dart';
 import 'package:mzansi_innovation_hub/mih_config/mih_colors.dart';
@@ -229,7 +232,11 @@ class _TipCalcState extends State<TipCalc> {
               ),
             SizedBox(height: 10),
             Consumer(builder: (context, bannerAdDisplay, child) {
-              return MihBannerAd();
+              if (!kIsWeb && (Platform.isAndroid || Platform.isIOS)) {
+                return MihBannerAd();
+              } else {
+                return const SizedBox(height: 0);
+              }
             }),
             // if (splitBillController.text == "Yes") const Divider(),
           ],

mih_ui/lib/mih_packages/mine_sweeper/package_tools/mine_sweeper_game.dart

@@ -1,5 +1,7 @@
 import 'dart:async';
+import 'dart:io';
 import 'dart:math';
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_speed_dial/flutter_speed_dial.dart';
 import 'package:font_awesome_flutter/font_awesome_flutter.dart';
@@ -851,7 +853,9 @@ class _MineSweeperGameState extends State<MineSweeperGame> {
                 ],
               ),
             ),
-            _timer != null ? MihBannerAd() : SizedBox(),
+            _timer != null && !kIsWeb && (Platform.isAndroid || Platform.isIOS)
+                ? MihBannerAd()
+                : SizedBox(),
             SizedBox(height: 15),
           ],
         );

mih_ui/lib/mih_packages/mzansi_ai/package_tools/mih_ai_chat.dart

@@ -1,4 +1,5 @@
 import 'dart:convert';
+import 'dart:io';
 
 import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
@@ -112,15 +113,35 @@ class _MihAiChatState extends State<MihAiChat> with WidgetsBindingObserver {
 
   void speakLastMessage(MzansiAiProvider aiProvider) {
     final history = aiProvider.ollamaProvider.history;
-    if (history.isNotEmpty) {
+    if (history.isEmpty) return;
-      final historyList = history.toList();
+
-      for (int i = historyList.length - 1; i >= 0; i--) {
+    final historyList = history.toList();
-        if (historyList[i].origin == MessageOrigin.llm &&
+    String? textToSpeak;
-            historyList[i].text != null &&
+
-            historyList[i].text!.isNotEmpty) {
+    // Find the last LLM message
-          _flutterTts.speak(historyList[i].text!);
+    for (int i = historyList.length - 1; i >= 0; i--) {
-          return;
+      if (historyList[i].origin == MessageOrigin.llm &&
-        }
+          historyList[i].text != null &&
+          historyList[i].text!.isNotEmpty) {
+        textToSpeak = historyList[i].text!;
+        break;
+      }
+    }
+
+    if (textToSpeak != null) {
+      if (!kIsWeb && Platform.isLinux) {
+        // Linux Workaround: Use Speech Dispatcher (standard on most distros)
+        // '-t female1' is optional for voice variety
+        Process.run('spd-say', [textToSpeak]);
+
+        // Since spd-say doesn't have an easy "completion handler" via CLI,
+        // we manually toggle the UI state or just leave it off.
+        aiProvider.setTTSstate(true);
+        Future.delayed(
+            Duration(seconds: 5), () => aiProvider.setTTSstate(false));
+      } else {
+        // Your existing mobile/web logic
+        _flutterTts.speak(textToSpeak);
       }
     }
   }
@@ -183,11 +204,16 @@ class _MihAiChatState extends State<MihAiChat> with WidgetsBindingObserver {
   // }
 
   void stopTTS(MzansiAiProvider aiProvider) {
-    _flutterTts.stop();
+    if (!kIsWeb && Platform.isLinux) {
+      Process.run('spd-say', ['-S']); // The -S flag stops current speech
+    } else {
+      _flutterTts.stop();
+    }
     aiProvider.setTTSstate(false);
   }
 
   Future<void> initTts(MzansiAiProvider aiProvider) async {
+    if (!kIsWeb && Platform.isLinux) return;
     try {
       await _flutterTts.setSpeechRate(!kIsWeb ? 0.55 : 1);
       // await _flutterTts.setLanguage("en-US");
@@ -258,7 +284,9 @@ class _MihAiChatState extends State<MihAiChat> with WidgetsBindingObserver {
 
   @override
   void dispose() {
-    _flutterTts.stop();
+    if (!kIsWeb && !Platform.isLinux) {
+      _flutterTts.stop();
+    }
     WidgetsBinding.instance.removeObserver(this);
     super.dispose();
   }

mih_ui/lib/mih_packages/mzansi_profile/business_profile/package_tools/mih_business_qr_code.dart

@@ -1,3 +1,5 @@
+import 'dart:io';
+
 import 'package:cached_network_image/cached_network_image.dart';
 import 'package:file_picker/file_picker.dart';
 import 'package:file_saver/file_saver.dart';
@@ -82,6 +84,19 @@ class _MihBusinessQrCodeState extends State<MihBusinessQrCode> {
         fileExtension: "png",
         mimeType: MimeType.png,
       );
+    } else if (defaultTargetPlatform == TargetPlatform.linux ||
+        defaultTargetPlatform == TargetPlatform.windows) {
+      // Use File Picker to get a save path on Desktop
+      String? outputFile = await FilePicker.platform.saveFile(
+        dialogTitle: 'Please select where to save your QR Code:',
+        fileName: filename,
+      );
+
+      if (outputFile != null) {
+        final file = File(outputFile);
+        await file.writeAsBytes(imageBytes);
+        KenLogger.success("Saved to $outputFile");
+      }
     } else {
       await FileSaver.instance.saveAs(
         name: filename,
@@ -95,14 +110,14 @@ class _MihBusinessQrCodeState extends State<MihBusinessQrCode> {
   Future<void> downloadQrCode() async {
     if (_isUserSignedIn) {
       await screenshotController.capture().then((image) {
-        KenLogger.success("Image Captured: $image");
+        // KenLogger.success("Image Captured: $image");
         setState(() {
           businessQRImageFile = image;
         });
       }).catchError((onError) {
         KenLogger.error(onError);
       });
-      KenLogger.success("QR Code Image Captured : $businessQRImageFile");
+      // KenLogger.success("QR Code Image Captured : $businessQRImageFile");
       saveImage(businessQRImageFile!);
     } else {
       showSignInRequiredAlert();

mih_ui/lib/mih_packages/mzansi_wallet/builder/build_loyalty_card_list.dart

@@ -1,3 +1,5 @@
+import 'dart:io';
+
 import 'package:flutter/foundation.dart';
 import 'package:flutter_speed_dial/flutter_speed_dial.dart';
 import 'package:go_router/go_router.dart';
@@ -545,7 +547,7 @@ class _BuildLoyaltyCardListState extends State<BuildLoyaltyCardList> {
               ),
             ),
             SizedBox(height: 10),
-            MihBannerAd()
+            if (!kIsWeb && (Platform.isAndroid || Platform.isIOS)) MihBannerAd()
             // MihBannerAd(),
           ],
         ),
@@ -572,7 +574,7 @@ class _BuildLoyaltyCardListState extends State<BuildLoyaltyCardList> {
   }
 
   Future<void> setScreenBrightness(double newBrightness) async {
-    if (!kIsWeb) {
+    if (!kIsWeb && !Platform.isLinux) {
       bool canChange =
           await ScreenBrightness.instance.canChangeSystemBrightness;
 

mih_ui/lib/mih_providers/mih_banner_ad_provider.dart

@@ -1,3 +1,5 @@
+import 'dart:io';
+
 import 'package:flutter/foundation.dart';
 import 'package:google_mobile_ads/google_mobile_ads.dart';
 import 'package:mzansi_innovation_hub/mih_config/mih_env.dart';
@@ -28,35 +30,37 @@ class MihBannerAdProvider extends ChangeNotifier {
   }
 
   void loadBannerAd() {
-    if (bannerAd != null) {
+    if (!kIsWeb && (Platform.isAndroid || Platform.isIOS)) {
-      bannerAd!.dispose();
+      if (bannerAd != null) {
-      bannerAd = null;
+        bannerAd!.dispose();
-      isBannerAdLoaded = false;
+        bannerAd = null;
+        isBannerAdLoaded = false;
+      }
+      bannerAd = BannerAd(
+        adUnitId: adUnitId,
+        request: const AdRequest(),
+        size: AdSize.banner,
+        listener: BannerAdListener(
+          onAdLoaded: (ad) {
+            debugPrint('$ad loaded.');
+            isBannerAdLoaded = true;
+            notifyListeners();
+          },
+          onAdFailedToLoad: (ad, err) {
+            debugPrint('BannerAd failed to load: $err');
+            errorMessage =
+                'Failed to load ad- Message: ${err.message} Code :${err.code}';
+            ad.dispose(); // Dispose the ad to free resources
+            isBannerAdLoaded = false; // ⬅️ Explicitly set to false
+            bannerAd = null; // ⬅️ Explicitly set to null
+            notifyListeners();
+          },
+          onAdOpened: (Ad ad) => debugPrint('$ad opened.'),
+          onAdClosed: (Ad ad) => debugPrint('$ad closed.'),
+          onAdImpression: (Ad ad) => debugPrint('$ad impression.'),
+        ),
+      );
+      bannerAd!.load();
     }
-    bannerAd = BannerAd(
-      adUnitId: adUnitId,
-      request: const AdRequest(),
-      size: AdSize.banner,
-      listener: BannerAdListener(
-        onAdLoaded: (ad) {
-          debugPrint('$ad loaded.');
-          isBannerAdLoaded = true;
-          notifyListeners();
-        },
-        onAdFailedToLoad: (ad, err) {
-          debugPrint('BannerAd failed to load: $err');
-          errorMessage =
-              'Failed to load ad- Message: ${err.message} Code :${err.code}';
-          ad.dispose(); // Dispose the ad to free resources
-          isBannerAdLoaded = false; // ⬅️ Explicitly set to false
-          bannerAd = null; // ⬅️ Explicitly set to null
-          notifyListeners();
-        },
-        onAdOpened: (Ad ad) => debugPrint('$ad opened.'),
-        onAdClosed: (Ad ad) => debugPrint('$ad closed.'),
-        onAdImpression: (Ad ad) => debugPrint('$ad impression.'),
-      ),
-    );
-    bannerAd!.load();
   }
 }

mih_ui/lib/mih_services/mih_alert_services.dart

@@ -1,3 +1,6 @@
+import 'dart:io';
+
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:go_router/go_router.dart';
 import 'package:mzansi_innovation_hub/main.dart';
@@ -134,7 +137,9 @@ class MihAlertServices {
                   ),
                   const SizedBox(height: 15),
                   Text(
-                    "To get the most out of MIH, we need your location. Please go to the site settings of the app and enable location services. Once you do that, we can start showing you relevant information based on your location.",
+                    !kIsWeb && Platform.isLinux
+                        ? "To get the most out of MIH, we need your location. Please go to your System Settings and enable location services. Once you do that, we can start showing you relevant information based on your location."
+                        : "To get the most out of MIH, we need your location. Please go to the site settings of the app and enable location services. Once you do that, we can start showing you relevant information based on your location.",
                     style: TextStyle(
                       color: MihColors.getSecondaryColor(
                           MzansiInnovationHub.of(context)!.theme.mode ==

mih_ui/lib/mih_services/mih_file_services.dart

@@ -1,7 +1,10 @@
 import 'dart:convert';
+import 'dart:io';
 
 import 'package:file_picker/file_picker.dart';
+import 'package:flutter/foundation.dart';
 import 'package:go_router/go_router.dart';
+import 'package:ken_logger/ken_logger.dart';
 import 'package:mzansi_innovation_hub/mih_package_components/mih_loading_circle.dart';
 import 'package:mzansi_innovation_hub/mih_config/mih_env.dart';
 import 'package:flutter/material.dart';
@@ -51,6 +54,15 @@ class MihFileApi {
     } finally {
       // Navigator.of(context).pop(); // Always pop loading dialog
     }
+    KenLogger.success("File URL: $fileUrl");
+    if (AppEnviroment.getEnv() == "Dev" && kIsWeb) {
+      fileUrl = fileUrl.replaceAll("10.0.2.2", "127.0.0.1");
+    } else if (AppEnviroment.getEnv() == "Dev" && Platform.isIOS) {
+      fileUrl = fileUrl.replaceAll("10.0.2.2", "127.0.0.1");
+    } else if (AppEnviroment.getEnv() == "Dev" && Platform.isLinux) {
+      fileUrl = fileUrl.replaceAll("10.0.2.2", "127.0.0.1");
+    }
+    KenLogger.success("File URL: $fileUrl");
     return fileUrl;
   }
 

mih_ui/lib/mih_services/mih_location_services.dart

@@ -1,3 +1,6 @@
+import 'dart:io';
+
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:geolocator/geolocator.dart';
 import 'package:mzansi_innovation_hub/mih_services/mih_alert_services.dart';
@@ -13,6 +16,12 @@ class MIHLocationAPI {
   ///if user has blocked permission (denied or denied forver), user will get error pop up.
   ///if user has granted permission (while in use), function will return Position object.
   Future<Position?> getGPSPosition(BuildContext context) async {
+    bool serviceEnabled = await Geolocator.isLocationServiceEnabled();
+    if (!serviceEnabled && !kIsWeb && Platform.isLinux) {
+      // Direct the user to their System Settings
+      MihAlertServices().locationPermissionAlert(context);
+      return null;
+    }
     print("Before checkPermission"); // Debug
     LocationPermission permission = await Geolocator.checkPermission();
     print("After checkPermission: $permission"); // Debug

mih_ui/linux/CMakeLists.txt

@@ -4,10 +4,10 @@ project(runner LANGUAGES CXX)
 
 # The name of the executable created for the application. Change this to change
 # the on-disk name of your application.
-set(BINARY_NAME "patient_manager")
+set(BINARY_NAME "mzansi_innovation_hub")
 # The unique GTK application identifier for this application. See:
 # https://wiki.gnome.org/HowDoI/ChooseApplicationID
-set(APPLICATION_ID "com.example.patient_manager")
+set(APPLICATION_ID "za.co.mzansiinnovationhub.mih")
 
 # Explicitly opt in to modern CMake behaviors to avoid warnings with recent
 # versions of CMake.

mih_ui/mih_app_flatpak/za.co.mzansiinnovationhub.mih.desktop

@@ -0,0 +1,12 @@
+[Desktop Entry]
+Version=1.0
+Type=Application
+Name=MIH
+GenericName=Mzansi Innovation Hub
+Comment=Mzansi Innovation Hub official application
+Exec=mzansi_innovation_hub
+Icon=za.co.mzansiinnovationhub.mih
+Terminal=false
+Categories=Utility;
+Keywords=MIH;Mzansi;Innovation;Hub;
+StartupWMClass=mzansi_innovation_hub

mih_ui/mih_app_flatpak/za.co.mzansiinnovationhub.mih.metainfo.xml

@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<component type="desktop-application">
+
+  <id>za.co.mzansiinnovationhub.mih</id>
+  
+  <name>MIH</name>
+  <summary>Innovation tools and services for the Mzansi ecosystem</summary>
+
+  <metadata_license>CC0-1.0</metadata_license>
+  <project_license>GPL-3.0</project_license>
+  <developer_name>Mzansi Innovation Hub</developer_name>
+
+  <description>
+    <p>
+      MIH (Mzansi Innovation Hub) is a modern desktop application designed to provide
+      innovation tools and services for users. Built with Flutter, it offers a 
+      high-performance, responsive interface tailored for the Linux desktop.
+    </p>
+    <ul>
+      <li>Access professional innovation resources</li>
+      <li>Streamlined user interface for efficiency</li>
+      <li>Native integration with Linux desktop environments</li>
+    </ul>
+  </description>
+
+  <launchable type="desktop-id">za.co.mzansiinnovationhub.mih.desktop</launchable>
+
+  <screenshots>
+    <screenshot type="default">
+      <caption>The main dashboard of the MIH application.</caption>
+      <image>https://git.mzansi-innovation-hub.co.za/yaso_meth/mih-project/raw/main/screenshots/main.png</image>
+    </screenshot>
+  </screenshots>
+
+  <url type="homepage">https://mzansi-innovation-hub.co.za/</url>
+  <url type="bugtracker">https://git.mzansi-innovation-hub.co.za/yaso_meth/mih-project/issues</url>
+
+  <provides>
+    <binary>mzansi_innovation_hub</binary>
+  </provides>
+
+  <releases>
+    <release version="1.0.0" date="2026-02-26"/>
+  </releases>
+
+  <content_rating type="oars-1.1"/>
+
+  <categories>
+    <category>Utility</category>
+  </categories>
+
+</component>

mih_ui/mih_app_flatpak/za.co.mzansiinnovationhub.mih.yml

@@ -0,0 +1,55 @@
+id: za.co.mzansiinnovationhub.mih
+runtime: org.freedesktop.Platform
+runtime-version: '24.08'
+sdk: org.freedesktop.Sdk
+command: mzansi_innovation_hub
+
+finish-args:
+  - --share=ipc
+  - --share=network        # Added for Internet access
+  - --socket=fallback-x11
+  - --socket=wayland
+  - --device=dri
+  # Removed --filesystem=home for better security; add back only if strictly needed.
+
+modules:
+  - name: mzansi-innovation-hub
+    buildsystem: simple
+    sources:
+      - type: archive
+        url: https://git.mzansi-innovation-hub.co.za/yaso_meth/mih-project/releases/download/linux/mzansi_innovation_hub.tar.gz
+        sha256: b8c383f4d43e2de36b4e6520c9745e3f8e8618bdb9ef6024ad0bf260061137a9
+        # If the tarball contains a top-level folder (like 'bundle'), 
+        # flatpak-builder enters it automatically. 
+        # If it doesn't, we use the commands below to find them.
+
+      - type: file
+        path: za.co.mzansiinnovationhub.mih.desktop
+      - type: file
+        path: za.co.mzansiinnovationhub.mih.metainfo.xml
+      - type: file
+        path: za.co.mzansiinnovationhub.mih.png
+
+    build-commands:
+      # 1. Create the necessary directories
+      - mkdir -p /app/bin /app/share/applications /app/share/icons/hicolor/256x256/apps /app/share/metainfo
+
+      # 2. Move EVERYTHING from your archive into /app/bin/
+      # We use 'find' to move only the app-related files and avoid the metadata files
+      - |
+        find . -mindepth 1 -maxdepth 2 \
+          ! -name "*.desktop" \
+          ! -name "*.xml" \
+          ! -name "*.png" \
+          ! -name "*.yml" \
+          -exec cp -R -t /app/bin/ {} +
+
+      # 3. Ensure the binary is in the right place and executable
+      # If the binary ended up in a subfolder, this moves it to the top of /app/bin
+      - find /app/bin -name "mzansi_innovation_hub" -type f -exec mv {} /app/bin/ \;
+      - chmod +x /app/bin/mzansi_innovation_hub
+
+      # 4. Install Metadata (using the exact local files)
+      - install -Dm644 za.co.mzansiinnovationhub.mih.desktop /app/share/applications/za.co.mzansiinnovationhub.mih.desktop
+      - install -Dm644 za.co.mzansiinnovationhub.mih.png /app/share/icons/hicolor/256x256/apps/za.co.mzansiinnovationhub.mih.png
+      - install -Dm644 za.co.mzansiinnovationhub.mih.metainfo.xml /app/share/metainfo/za.co.mzansiinnovationhub.mih.metainfo.xml

mih_ui/pubspec.lock

@@ -369,6 +369,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "3.1.0"
+  dbus:
+    dependency: transitive
+    description:
+      name: dbus
+      sha256: d0c98dcd4f5169878b6cf8f6e0a52403a9dff371a3e2f019697accbf6f44a270
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.7.12"
   device_info_plus:
     dependency: transitive
     description:
@@ -808,6 +816,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "4.0.0"
+  geoclue:
+    dependency: transitive
+    description:
+      name: geoclue
+      sha256: c2a998c77474fc57aa00c6baa2928e58f4b267649057a1c76738656e9dbd2a7f
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.1.1"
   geolocator:
     dependency: "direct main"
     description:
@@ -832,6 +848,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.3.13"
+  geolocator_linux:
+    dependency: "direct main"
+    description:
+      name: geolocator_linux
+      sha256: d64112a205931926f4363bb6bd48f14cb38e7326833041d170615586cd143797
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.2.4"
   geolocator_platform_interface:
     dependency: transitive
     description:
@@ -904,6 +928,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.3.2"
+  gsettings:
+    dependency: transitive
+    description:
+      name: gsettings
+      sha256: "1b0ce661f5436d2db1e51f3c4295a49849f03d304003a7ba177d01e3a858249c"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.2.8"
   html:
     dependency: transitive
     description:

mih_ui/pubspec.yaml

@@ -1,7 +1,7 @@
 name: mzansi_innovation_hub
 description: ""
 publish_to: 'none' # Remove this line if you wish to publish to pub.dev
-version: 1.2.6+129
+version: 1.2.6+130
 # version: 1.1.1+97 #--- Updated version for upgrader package testing
 
 environment:
@@ -29,6 +29,7 @@ dependencies:
   flutter_native_splash: ^2.4.6
   printing: ^5.13.3
   geolocator: ^14.0.1
+  geolocator_linux: ^0.2.4
   table_calendar: ^3.1.2
   youtube_player_iframe: ^5.2.0
   mobile_scanner: ^7.0.1