bump gomuks

This reverts commit 69c392a51f.

.forgejo/workflows/e2e.yml

@@ -0,0 +1,28 @@
+name: "End-to-end tests"
+
+on:
+    push:
+        branches: ["main"]
+    pull_request:
+    workflow_dispatch:
+
+jobs:
+    e2e:
+        runs-on: ["large", "debian-13-x86_64"]
+
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v6
+              with:
+                  submodules: recursive
+
+            - name: Lix GHA Installer Action
+              uses: samueldr/lix-gha-installer-action@v2026-02-22
+              with:
+                  extra_nix_config: experimental-features = nix-command flakes flake-self-attrs
+
+            - name: Generate code
+              run: nix develop --command bash -c "flutter pub get && dart scripts/generate.dart && flutter pub run build_runner build"
+
+            - name: Run end-to-end tests
+              run: nix run .#e2e-headless

.github/workflows/android.yml

@@ -1,39 +1,39 @@
 name: "Build APK"
 
 on:
-  push:
-    branches: ["main"]
-    tags: ["*"]
-  workflow_dispatch:
+    push:
+        branches: ["main"]
+        tags: ["*"]
+    workflow_dispatch:
 
 jobs:
-  build-apk:
-    runs-on: ubuntu-latest
+    build-apk:
+        runs-on: ubuntu-latest
 
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v6
-        with:
-          submodules: recursive
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v6
+              with:
+                  submodules: recursive
 
-      - name: Lix GHA Installer Action
-        uses: samueldr/lix-gha-installer-action@v2026-02-22
-        with:
-          extra_nix_config: experimental-features = nix-command flakes flake-self-attrs
-      
-      - name: Decode keystore
-        run: echo "$KEYSTORE_CONTENT" | base64 --decode > keystore.jks
-        env:
-          KEYSTORE_CONTENT: ${{ secrets.KEYSTORE_CONTENT }}
+            - name: Lix GHA Installer Action
+              uses: samueldr/lix-gha-installer-action@v2026-02-22
+              with:
+                  extra_nix_config: experimental-features = nix-command flakes flake-self-attrs
 
-      - name: Build app
-        run: nix develop --command bash -c "flutter pub get && dart scripts/generate.dart && flutter pub run build_runner build && flutter build apk --release"
-        env:
-          KEYSTORE_PATH: ../../keystore.jks
-          KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }}
+            - name: Decode keystore
+              run: echo "$KEYSTORE_CONTENT" | base64 --decode > keystore.jks
+              env:
+                  KEYSTORE_CONTENT: ${{ secrets.KEYSTORE_CONTENT }}
 
-      - name: Upload installer artifact
-        uses: actions/upload-artifact@v6
-        with:
-          name: APK
-          path: build/app/outputs/flutter-apk/app-release.apk
+            - name: Build app
+              run: nix develop --command bash -c "flutter pub get && dart scripts/generate.dart && flutter pub run build_runner build && flutter build apk --target-platform android-arm64 --split-per-abi --dart-define=GIT_COMMIT=${{ github.sha }}"
+              env:
+                  KEYSTORE_PATH: ../../keystore.jks
+                  KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }}
+
+            - name: Upload installer artifact
+              uses: actions/upload-artifact@v6
+              with:
+                  name: APK
+                  path: build/app/outputs/flutter-apk/app-arm64-v8a-release.apk

.github/workflows/flatpak.yml

@@ -1,37 +1,73 @@
 name: "Build Flatpaks"
 
 on:
-  push:
-    branches: ["main"]
-    tags: ["*"]
-  workflow_dispatch:
+    push:
+        branches: ["main"]
+        tags: ["*"]
+    workflow_dispatch:
 
 jobs:
-  build-flatpak:
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - arch: x86_64
-            runner: ubuntu-latest
-          - arch: aarch64
-            runner: ubuntu-24.04-arm
-    runs-on: ${{ matrix.runner }}
+    build-flatpak:
+        strategy:
+            fail-fast: false
+            matrix:
+                include:
+                    - arch: x86_64
+                      runner: ubuntu-latest
+                    - arch: aarch64
+                      runner: ubuntu-24.04-arm
+        runs-on: ${{ matrix.runner }}
 
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v6
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v6
 
-      - name: Lix GHA Installer Action
-        uses: samueldr/lix-gha-installer-action@v2026-02-22
-        with:
-          extra_nix_config: experimental-features = nix-command flakes flake-self-attrs
+            - name: Lix GHA Installer Action
+              uses: samueldr/lix-gha-installer-action@v2026-02-22
+              with:
+                  extra_nix_config: experimental-features = nix-command flakes flake-self-attrs
 
-      - name: Build app
-        run: nix build .#flatpak
+            - name: Build app
+              run: nix build .#flatpak
 
-      - name: Upload installer artifact
-        uses: actions/upload-artifact@v6
-        with:
-          name: flatpak-${{ matrix.arch }}
-          path: result/nexus.federated.nexus.flatpak
+            - name: Upload installer artifact
+              uses: actions/upload-artifact@v6
+              with:
+                  name: flatpak-${{ matrix.arch }}
+                  path: result/nexus.federated.nexus.flatpak
+
+    publish:
+        needs: build-flatpak
+        if: github.ref == 'refs/heads/main'
+        runs-on: ubuntu-latest
+        permissions:
+            pages: write
+            id-token: write
+        environment:
+            name: github-pages
+            url: ${{ steps.deployment.outputs.page_url }}
+        steps:
+            - name: Install flatpak tooling
+              run: sudo apt-get update && sudo apt-get install -y flatpak ostree
+
+            - name: Download bundles
+              uses: actions/download-artifact@v7
+              with:
+                  pattern: flatpak-*
+                  path: bundles
+
+            - name: Build OSTree repo
+              run: |
+                  ostree init --repo=repo --mode=archive-z2
+                  for bundle in bundles/*/nexus.federated.nexus.flatpak; do
+                    flatpak build-import-bundle repo "$bundle"
+                  done
+                  flatpak build-update-repo --prune repo
+
+            - uses: actions/upload-pages-artifact@v4
+              with:
+                  path: repo
+
+            - name: Deploy to Pages
+              id: deployment
+              uses: actions/deploy-pages@v4

.github/workflows/ios.yml

@@ -0,0 +1,48 @@
+name: "Build iOS App"
+
+on:
+    push:
+        branches: ["main"]
+        tags: ["*"]
+    workflow_dispatch:
+
+jobs:
+    build-app:
+        runs-on: macos-latest
+
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v6
+              with:
+                  submodules: recursive
+
+            - name: Set up Flutter
+              uses: subosito/flutter-action@v2
+              with:
+                  flutter-version: 3.47.4
+
+            - name: Set up Go
+              uses: actions/setup-go@v6
+              with:
+                  go-version-file: gomuks/go.mod
+
+            - name: Build app
+              run: |
+                  flutter pub get
+                  dart scripts/generate.dart
+                  flutter pub run build_runner build
+                  flutter build ios --no-codesign --dart-define=GIT_COMMIT=${{ github.sha }}
+
+            # Unsigned IPA: SideStore/AltStore re-sign this on-device with the
+            # user's own Apple ID at install time, so no certificate is needed here.
+            - name: Package unsigned IPA
+              run: |
+                  mkdir Payload
+                  cp -r build/ios/iphoneos/Runner.app Payload/
+                  zip -r Nexus.ipa Payload
+
+            - name: Upload IPA artifact
+              uses: actions/upload-artifact@v6
+              with:
+                  name: Nexus.ipa
+                  path: Nexus.ipa

.github/workflows/macos.yml

@@ -1,32 +1,47 @@
 name: "Build MacOS App"
 
 on:
-  # TODO: Uncomment this once the MacOS workflow actually works
-  # push:
-  #   branches: ["main"]
-  #   tags: ["*"]
-  workflow_dispatch:
+    push:
+        branches: ["main"]
+        tags: ["*"]
+    workflow_dispatch:
 
 jobs:
-  build-app:
-    runs-on: macos-latest
+    build-app:
+        runs-on: macos-latest
 
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v6
-        with:
-          submodules: recursive
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v6
+              with:
+                  submodules: recursive
 
-      - name: Lix GHA Installer Action
-        uses: samueldr/lix-gha-installer-action@v2026-02-22
-        with:
-          extra_nix_config: experimental-features = nix-command flakes flake-self-attrs
+            - name: Set up Flutter
+              uses: subosito/flutter-action@v2
+              with:
+                  flutter-version: 3.47.4
 
-      - name: Build app
-        run: nix develop --command bash -c "flutter pub get && dart scripts/generate.dart && flutter pub run build_runner build && flutter build macos --release"
+            - name: Set up Go
+              uses: actions/setup-go@v6
+              with:
+                  go-version-file: gomuks/go.mod
 
-      - name: Upload installer artifact
-        uses: actions/upload-artifact@v6
-        with:
-          name: App
-          path: build/macos/Build/Products/Release/Nexus.app
+            - name: Build App
+              run: |
+                  flutter pub get
+                  dart scripts/generate.dart
+                  flutter pub run build_runner build
+                  flutter build macos --dart-define=GIT_COMMIT=${{ github.sha }}
+
+            - name: Create DMG
+              id: create-dmg
+              uses: L-Super/create-dmg-actions@28511e988b13ca34096d439159a66d468b8e724f
+              with:
+                  dmg_name: nexus
+                  src_dir: build/macos/Build/Products/Release/Nexus.app
+
+            - name: Upload DMG
+              uses: actions/upload-artifact@v6
+              with:
+                  name: nexus.dmg
+                  path: ${{ steps.create-dmg.outputs.dmg_path }}

.github/workflows/windows.yml

@@ -1,65 +1,74 @@
 name: "Build EXE"
 
 on:
-  push:
-    branches: ["main"]
-    tags: ["*"]
-  workflow_dispatch:
+    push:
+        branches: ["main"]
+        tags: ["*"]
+    workflow_dispatch:
 
 jobs:
-  build-exe:
-    runs-on: windows-latest
+    build-exe:
+        runs-on: windows-latest
 
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v6
-        with:
-          submodules: recursive
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v6
+              with:
+                  submodules: recursive
 
-      - name: Set up Flutter
-        uses: subosito/flutter-action@v2
-        with:
-          flutter-version: 3.44.4
+            - name: Set up Flutter
+              uses: subosito/flutter-action@v2
+              with:
+                  flutter-version: 3.47.4
 
-      - name: Set up Go
-        uses: actions/setup-go@v6
-        with:
-          go-version-file: gomuks/go.mod
+            - name: Set up Go
+              uses: actions/setup-go@v6
+              with:
+                  go-version-file: gomuks/go.mod
 
-      - name: Setup MSYS2
-        uses: msys2/setup-msys2@v2
-        with:
-          msystem: MINGW64
-          install: >-
-            mingw-w64-x86_64-gcc
+            - name: Setup MSYS2
+              uses: msys2/setup-msys2@v2
+              with:
+                  msystem: CLANG64
+                  install: >-
+                      mingw-w64-x86_64-gcc
 
-      - name: Go build
-        run: |
-          cd gomuks/pkg/ffi
-          go build -tags goolm,sqlite_fts5 -o ../../../libgomuks.dll -buildmode=c-shared
+            - name: Go build
+              run: |
+                  cd gomuks/pkg/ffi
+                  go build -tags goolm,sqlite_fts5 -o ../../../libgomuks.dll -buildmode=c-shared
 
-      - name: Build with Flutter
-        run: |
-          flutter pub get
-          dart scripts/generate.dart
-          flutter pub run build_runner build
-          flutter build windows --release
+            - name: Build with Flutter
+              run: |
+                  flutter pub get
+                  dart scripts/generate.dart
+                  flutter pub run build_runner build
+                  flutter build windows --dart-define=GIT_COMMIT=${{ github.sha }}
 
-      - name: Copy MinGW runtime DLLs
-        shell: msys2 {0}
-        run: |
-          cp /mingw64/bin/libgcc_s_seh-1.dll build/windows/x64/runner/Release/
-          cp /mingw64/bin/libwinpthread-1.dll build/windows/x64/runner/Release/
-          cp /mingw64/bin/libstdc++-6.dll build/windows/x64/runner/Release/
+            - name: Copy MinGW runtime DLLs
+              shell: msys2 {0}
+              run: |
+                  cp /mingw64/bin/libgcc_s_seh-1.dll build/windows/x64/runner/Release/
+                  cp /mingw64/bin/libwinpthread-1.dll build/windows/x64/runner/Release/
+                  cp /mingw64/bin/libstdc++-6.dll build/windows/x64/runner/Release/
 
-      - name: Install Inno Setup
-        run: choco install innosetup -y
+            - name: Copy MSVC runtime DLLs
+              shell: powershell
+              run: |
+                  $release = "build/windows/x64/runner/Release"
 
-      - name: Build Inno Setup installer
-        run: iscc windows/installer.iss
+                  Copy-Item C:\Windows\System32\MSVCP140.dll $release -Force
+                  Copy-Item C:\Windows\System32\VCRUNTIME140.dll $release -Force
+                  Copy-Item C:\Windows\System32\VCRUNTIME140_1.dll $release -Force
 
-      - name: Upload installer artifact
-        uses: actions/upload-artifact@v6
-        with:
-          name: windows-installer
-          path: windows/dist/Nexus-Setup.exe
+            - name: Install Inno Setup
+              run: choco install innosetup -y
+
+            - name: Build Inno Setup installer
+              run: iscc windows/installer.iss
+
+            - name: Upload installer artifact
+              uses: actions/upload-artifact@v6
+              with:
+                  name: windows-installer
+                  path: windows/dist/Nexus-Setup.exe

.gitignore

@@ -41,4 +41,6 @@ key.properties
 password.txt
 
 # Nix
-/result
+/result
+# Widget Preview related
+.widget_preview/

.gitmodules

@@ -1,4 +1,4 @@
 [submodule "gomuks"]
 	path = gomuks
 	url = https://github.com/gomuks/gomuks
-	branch = main
+	branch = quad/nexus

.metadata

@@ -4,7 +4,7 @@
 # This file should be version controlled and should not be manually edited.
 
 version:
-  revision: "nixpkgs000000000000000000000000000000000"
+  revision: "6b182d2c7585eba26d4edce0f97630effd256c33"
   channel: "stable"
 
 project_type: app
@@ -13,11 +13,11 @@ project_type: app
 migration:
   platforms:
     - platform: root
-      create_revision: nixpkgs000000000000000000000000000000000
-      base_revision: nixpkgs000000000000000000000000000000000
-    - platform: macos
-      create_revision: nixpkgs000000000000000000000000000000000
-      base_revision: nixpkgs000000000000000000000000000000000
+      create_revision: 6b182d2c7585eba26d4edce0f97630effd256c33
+      base_revision: 6b182d2c7585eba26d4edce0f97630effd256c33
+    - platform: ios
+      create_revision: 6b182d2c7585eba26d4edce0f97630effd256c33
+      base_revision: 6b182d2c7585eba26d4edce0f97630effd256c33
 
   # User provided section
 

.vscode/launch.json

@@ -0,0 +1,17 @@
+{
+    "configurations": [
+        {
+            "name": "Flutter",
+            "type": "dart",
+            "request": "launch",
+            "program": "lib/main.dart"
+        },
+        {
+            "name": "Flutter (Headless)",
+            "type": "dart",
+            "request": "launch",
+            "program": "lib/main.dart",
+            "env": { "FLUTTER_HEADLESS": "1" }
+        }
+    ]
+}

.vscode/settings.json

@@ -10,7 +10,11 @@
         "msgtype",
         "muks",
         "prefs",
+        "recents",
         "unban",
-        "unredact"
+        "underride",
+        "unifiedpush",
+        "unredact",
+        "webpush"
     ]
 }

DEVELOPMENT.md

@@ -21,28 +21,32 @@ See [Effective Dart: Style](https://dart.dev/effective-dart/style) for general r
 Controllers live in `lib/controllers/` and provide a source that exposes data and logic via Riverpod providers, allowing other parts of the code to watch state changes with ref.watch (`ref.watch(MyController.provider)`), access the current value with ref.read (`ref.read(MyController.provider)`), and run helper methods on those classes using the notifier:
 
 ```dart
-ref.watch(MyController.provider.notifier).helperMethod()
+ref.read(MyController.provider.notifier).helperMethod()
 ```
 
 We use an object oriented style for controllers, where `provider` is a static member on the controller class. E.g.
 
 ```dart
-class MyController extends AsyncNotifier<DataThisControllerExposes> {
-  final SomeInputType input;
-  MyController(this.input);
-
+class MyController(final SomeInputType input)
+    extends AsyncNotifier<DataThisControllerExposes> {
   @override
   Future<DataThisControllerExposes> build() async {
     return input.foo;
   }
 
   static final provider =
-	AsyncNotifierProvider.family<MyController, DataThisControllerExposes, SomeInputType>(
-	  AuthorController.new,
-	);
+      AsyncNotifierProvider.family<MyController, DataThisControllerExposes, SomeInputType>(
+        MyController.new,
+      );
 }
 ```
 
+#### `watch` vs `read`
+
+Only use `ref.watch` in a `build` method, where you want to rebuild when the value changes. Everywhere else, like callbacks, `useEffect`, and methods on a controller, use `ref.read`.
+
+Use `.select` to narrow down what you depend on, e.g. `ref.watch(RoomsController.provider.select((rooms) => rooms[roomId]))`.
+
 Providers which are not controllers, e.g. they expose no data, only methods, should instead live in `lib/helpers/`. For an example, see `lib/helpers/launch_helper.dart`. Other, non-provider helpers, like extensions or helper methods can also go in `lib/helpers/`.
 
 ### Don't use StatefulWidgets ([Flutter Hooks](https://pub.dev/packages/flutter_hooks))
@@ -61,6 +65,36 @@ When possible, use immutable collections instead of the mutable equivalent. For
 
 When possible, we prefer not to create global variables or methods. You can usually replace a global variable with a Riverpod controller, and a global method with an extension method.
 
+I'm also not a big fan of unneeded private methods or variables, but this is contextual.
+
+### Modern Dart syntax
+
+We try to use newer Dart language features where they make code shorter:
+
+- Primary constructors for classes, including widgets, e.g. `class const MemberList(final String roomId, {super.key}) extends HookConsumerWidget`.
+- Dot shorthands wherever the type can be inferred, e.g. `.new(...)`, `padding: .all(8)`, `relationType == .reply`.
+- Patterns and switch expressions over null checks and casts, e.g. `if (event.content case MessageContent(:final body?))` rather than checking `is` then using `!`.
+
+### Prefer `map` over inline `for` loops
+
+When building a list (or set, or map) from another collection, use `.map`, `.expand` and friends rather than a `for` inside the collection literal:
+
+```dart
+// Prefer
+children: rooms.map((room) => RoomTile(room)).toList(),
+
+// Over
+children: [for (final room in rooms) RoomTile(room)],
+```
+
+Regular `for` statements are fine for logic that doesn't just build a collection.
+
+### Async values and errors
+
+When rendering an `AsyncValue`, use the `betterWhen` extension, which shows our standard loading and error widgets, or a switch expression if you need more control (e.g. `AsyncData(:final value) || AsyncLoading(:final value?)` to keep showing old data while reloading).
+
+For futures started from the UI that nothing awaits, like button presses, add `.onError(showError)` so failures are shown to the user instead of being lost.
+
 ## LLM/AI Assisted Contributions
 
 LLM generated code is NOT allowed. All contributions should be written by humans. Using LLMs for interacting with others, e.g. for Comments, PRs, etc, is also not allowed.

README.md

@@ -1,8 +1,5 @@
 # Nexus Client
 
-> [!WARNING]
-> Nexus Client is still in development, and doesn't support everything needed for daily use.
-
 ## Description
 
 A simple and user-friendly Matrix client made with Flutter and a Gomuks backend.
@@ -13,112 +10,63 @@ A simple and user-friendly Matrix client made with Flutter and a Gomuks backend.
 | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------: |
 | ![Screenshot of Nexus Client in dark mode, showing users talking, with a sidebar showing rooms and spaces, and another sidebar showing members](./assets/screenshotDark.png) | ![The same screenshot as above, but in light mode](./assets/screenshotLight.png) |
 
-## Progress
-
-- [ ] Platform Support
-    - [x] Linux
-    - [x] Windows
-    - [x] Android
-    - [ ] MacOS ([#50](https://git.federated.nexus/Nexus/nexus/issues/50))
-    - [ ] iOS
-    - [ ] Web (may not be possible)
-- [x] Login (via OAuth)
-- [x] Rooms / Spaces
-    - [x] Displaying and choosing
-    - [x] Reading, showing unread
-        - [x] Mark as read button on rooms and spaces
-    - [ ] Searching
-    - [ ] Creating (Rooms, Spaces, and DMs)
-    - [x] Joining
-        - [x] Parse vias
-        - [x] Using a text/uri/link
-            - [x] Plain text
-            - [x] `matrix:` Uri
-            - [x] Matrix.to link
-        - [ ] From space
-        - [ ] From directory
-    - [x] Leaving
-    - [x] Subspaces
-- [x] Messages
-    - [x] Encryption
-        - [x] Restoring crypto identity from a recovery passphrase/key
-    - [x] Sending
-        - [x] Plain text
-        - [x] HTML/Markdown
-        - [x] Replies
-            - [x] Choose ping on/off
-        - [x] Per message profiles
-        - [x] Attachments
-        - [ ] Commands with [MSC4391](https://github.com/matrix-org/matrix-spec-proposals/pull/4391)
-        - [x] Mentions
-            - [x] Users
-            - [x] Rooms
-            - [ ] Inline emoji picker (Putting this here since it'll be implemented the same way as mentions)
-        - [ ] Custom emojis/stickers
-        - [ ] GIFs using Gomuks' GIF proxies
-    - [x] Receiving
-        - [x] Plain text
-        - [x] Per message profiles
-        - [x] HTML
-        - [x] URL Previews
-        - [x] Replies
-            - [x] Viewing
-            - [ ] Jump to original message
-                - [x] In loaded timeline
-                - [ ] Out of loaded timeline
-        - [x] Edits
-        - [x] Attachments
-            - [x] Unencrypted
-            - [x] Encrypted
-            - [x] Blurhashing
-            - [ ] Downloading attachments
-            - [x] Opening attachments in their own view
-        - [ ] Polls
-        - [x] Mentions
-            - [x] Users
-                - [x] Clickable
-            - [x] Rooms
-                - [ ] Clickable
-                - [x] Matrix URIs
-                - [x] Matrix.to links
-            - [x] Events
-                - [ ] Render more nicely
-                - [ ] Clickable
-        - [x] Custom emojis/stickers
-        - [x] History loading
-    - [x] Editing
-    - [x] Deleting
-- [x] Reactions
-- [x] Pins
-    - [x] Displaying
-    - [x] Pinning/Unpinning
-- [ ] Threads
-- [x] Profile popouts
-    - [x] Working actions
-- [x] Copy link to:
-    - [x] Room
-    - [x] Space
-    - [x] Message
-- [ ] Reporting
-    - [x] Events
-    - [ ] Rooms
-- [x] Member list
-    - [x] Sort by power level
-    - [ ] Colors based off of power level
-- [ ] Notifications using UnifiedPush ([#35](https://git.federated.nexus/Nexus/nexus/issues/35))
-- [ ] Group calls using [MSC4195](https://github.com/matrix-org/matrix-spec-proposals/pull/4195)
-- [ ] Invites
-- [x] Settings
-
 ## Try it out
 
-If you want to try out Nexus, grab one of the following artifacts from CI:
+If you want to try out Nexus, download the [latest release](https://git.federated.nexus/Nexus/nexus/releases/latest).
+
+### Nightly Builds
+
+For the newest changes, grab one of the following nightly artifacts, built by CI from the latest commit on `main`.
 
 - [Android APK](https://nightly.link/Henry-Hiles/nexus/workflows/android/main/APK.zip)
+- [Unsigned iOS IPA](https://nightly.link/Henry-Hiles/nexus/workflows/ios/main/Nexus.ipa.zip)
+- [Unsigned MacOS DMG](https://nightly.link/Henry-Hiles/nexus/workflows/macos/main/nexus.dmg.zip)
 - [Windows EXE](https://nightly.link/Henry-Hiles/nexus/workflows/windows/main/windows-installer.zip)
-- Flatpak
-    - [AArch64/Arm64](https://nightly.link/Henry-Hiles/nexus/workflows/flatpak/main/flatpak-aarch64.zip)
-    - [x86_64/AMD64](https://nightly.link/Henry-Hiles/nexus/workflows/flatpak/main/flatpak-x86_64.zip)
+
+Or, use one of the below methods:
+
+### Nightly Flatpak Repo
+
+Make sure Flatpak is set up on your system, then run:
+
+```bash
+flatpak install --user https://nexus.federated.nexus/flatpak/nexus.flatpakref
+```
+
+This adds the Nexus remote and installs the app for your user only, so no root access is needed (x86_64 and aarch64 are supported). To install system-wide instead, use `--system` in place of `--user`. Updates arrive through `flatpak update` or your software center.
+
+### NixOS Module
+
+Add Nexus as a flake input, following `nixpkgs` for less fetches:
+
+```nix
+nexus = {
+  url = "git+https://git.federated.nexus/Nexus/nexus";
+  inputs.nixpkgs.follows = "nixpkgs";
+};
+```
+
+This tracks the latest commit on `main`. To stay on a release instead, pin the input to its tag:
+
+```nix
+url = "git+https://git.federated.nexus/Nexus/nexus?ref=refs/tags/v1.0.1";
+```
+
+Then import the module and enable it in your NixOS configuration:
+
+```nix
+{ inputs, ... }:
+{
+  imports = [ inputs.nexus.nixosModules.default ];
+
+  programs.nexus = {
+    enable = true;
+    enableNotifications = true; # optional: push notifications via UnifiedPush
+  };
+}
+```
+
+This installs Nexus system-wide. With `enableNotifications`, it also installs KUnifiedPush and registers its systemd and D-Bus services so notifications work. The `package` option lets you override the package if you need to.
 
 ## Build it yourself
 
@@ -126,8 +74,8 @@ If you want to try out Nexus, grab one of the following artifacts from CI:
 
 #### Linux
 
-- With Nix: Either use direnv and `direnv allow`, or `nix flake develop`
-- Without Nix: Install Flutter, Go, Git, Libclang, Libass, MPV, and Glibc. Do not use any Snap packages, they cause various compilation issues.
+- On NixOS: Either use direnv and `direnv allow`, or `nix develop`
+- On other distros: Install Flutter, Go, Git, Libclang, Libass, MPV, and Glibc. Do not use any Snap packages, they cause various compilation issues.
 
 #### Windows
 
@@ -205,7 +153,7 @@ Development instructions can be found in [DEVELOPMENT.md](./DEVELOPMENT.md).
 
 Join the [Nexus Client Matrix room](https://matrix.to/#/#nexus:federated.nexus) for questions or help with developing or using Nexus Client.
 
-# Credits
+## Credits
 
 Thank you Hylke Bons (https://planetpeanut.studio) for making the amazing icon for Nexus!
 Thank you Tulir Asokan for making [Gomuks](https://github.com/gomuks/gomuks), and helping us integrate it into Nexus!

analysis_options.yaml

@@ -1,12 +1,18 @@
 analyzer:
-  errors:
-    invalid_annotation_target: ignore
-    avoid_print: ignore
-  exclude:
-    - "build/**"
-    - "**/*.g.dart"
-    - "**/*.freezed.dart"
+    errors:
+        invalid_annotation_target: ignore
+        avoid_print: ignore
+    exclude:
+        - "build/**"
+        - "**/*.g.dart"
+        - "**/*.freezed.dart"
+        - android/**
+        - ios/**
+        - web/**
+        - windows/**
+        - macos/**
+        - linux/**
 include: package:flutter_lints/flutter.yaml
 linter:
-  rules:
-    prefer_double_quotes: true
+    rules:
+        prefer_double_quotes: true

android/app/build.gradle

@@ -1,77 +0,0 @@
-plugins {
-    id "com.android.application"
-    id "kotlin-android"
-    // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
-    id "dev.flutter.flutter-gradle-plugin"
-}
-
-def localProperties = new Properties()
-def localPropertiesFile = rootProject.file("local.properties")
-if (localPropertiesFile.exists()) {
-    localPropertiesFile.withReader("UTF-8") { reader ->
-        localProperties.load(reader)
-    }
-}
-
-def flutterVersionCode = localProperties.getProperty("flutter.versionCode")
-if (flutterVersionCode == null) {
-    flutterVersionCode = "1"
-}
-
-def flutterVersionName = localProperties.getProperty("flutter.versionName")
-if (flutterVersionName == null) {
-    flutterVersionName = "1.0"
-}
-
-def keystoreProperties = new Properties()
-def keystorePropertiesFile = rootProject.file('key.properties')
-if (keystorePropertiesFile.exists()) {
-	keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
-}
-
-android {
-    namespace = "nexus.federated.nexus"
-    ndkVersion = flutter.ndkVersion
-    compileSdk = 34
-
-    compileOptions {
-        sourceCompatibility = JavaVersion.VERSION_17
-        targetCompatibility = JavaVersion.VERSION_17
-    }
-
-    kotlinOptions {
-        jvmTarget = "17"
-    }
-
-    defaultConfig {
-        applicationId = "nexus.federated.nexus"
-        minSdk = 29
-        targetSdkVersion flutter.targetSdkVersion
-        versionCode = flutterVersionCode.toInteger()
-        versionName = flutterVersionName
-    }
-
-	signingConfigs {
-		release {
-			keyAlias "key"
-			def storePath = keystoreProperties['path'] ?: System.getenv("KEYSTORE_PATH")
-			storeFile storePath ? file(storePath) : null
-			keyPassword keystoreProperties['password'] ?: System.getenv("KEYSTORE_PASSWORD")
-			storePassword keystoreProperties['password'] ?: System.getenv("KEYSTORE_PASSWORD")
-		}
-    }
-
-    buildTypes {
-        release {
-		   signingConfig signingConfigs.release
-        }
-
-		debug {
-			applicationIdSuffix = ".debug"
-	   	}
-    }
-}
-
-flutter {
-    source = "../.."
-}

android/app/build.gradle.kts

@@ -0,0 +1,84 @@
+import java.util.Properties
+
+plugins {
+    id("com.android.application")
+    id("dev.flutter.flutter-gradle-plugin")
+}
+
+val keystoreProperties = Properties()
+val keystorePropertiesFile = rootProject.file("key.properties")
+
+if (keystorePropertiesFile.exists()) {
+    keystorePropertiesFile.inputStream().use {
+        keystoreProperties.load(it)
+    }
+}
+
+android {
+    namespace = "nexus.federated.nexus"
+    compileSdk = 36
+    ndkVersion = flutter.ndkVersion
+
+    compileOptions {
+		isCoreLibraryDesugaringEnabled = true
+		sourceCompatibility = JavaVersion.VERSION_21
+        targetCompatibility = JavaVersion.VERSION_21
+    }
+
+    defaultConfig {
+        applicationId = "nexus.federated.nexus"
+
+		minSdk = 29
+        targetSdk = flutter.targetSdkVersion
+
+        versionCode = flutter.versionCode
+        versionName = flutter.versionName
+
+		multiDexEnabled = true
+    }
+
+    signingConfigs {
+        create("release") {
+            keyAlias = "key"
+
+            val storePath =
+                keystoreProperties["path"]?.toString()
+                    ?: System.getenv("KEYSTORE_PATH")
+
+            storeFile = storePath?.let { file(it) }
+
+            keyPassword =
+                keystoreProperties["password"]?.toString()
+                    ?: System.getenv("KEYSTORE_PASSWORD")
+
+            storePassword =
+                keystoreProperties["password"]?.toString()
+                    ?: System.getenv("KEYSTORE_PASSWORD")
+        }
+    }
+
+    buildTypes {
+        release {
+            signingConfig = signingConfigs.getByName("release")
+        }
+
+        debug {
+            applicationIdSuffix = ".debug"
+        }
+    }
+}
+
+dependencies {
+    implementation("org.unifiedpush.android:embedded-fcm-distributor:3.1.0")
+    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.4")
+}
+
+kotlin {
+    compilerOptions {
+        jvmTarget = org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_21
+    }
+}
+
+flutter {
+    source = "../.."
+}

android/app/src/main/AndroidManifest.xml

@@ -1,12 +1,16 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
 	<uses-permission android:name="android.permission.INTERNET" />
+	<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+	<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
 	<uses-permission
 		android:name="android.permission.READ_EXTERNAL_STORAGE"
 		android:maxSdkVersion="32" />
     <uses-permission
         android:name="android.permission.WRITE_EXTERNAL_STORAGE"
 		android:maxSdkVersion="29" />
+		<!-- Until https://github.com/flutter/flutter/issues/145290 is fixed, we need enableOnBackInvokedCallback as false -->
     <application
+    	android:enableOnBackInvokedCallback="false"
         android:label="Nexus"
         android:name="${applicationName}"
         android:icon="@mipmap/ic_launcher"
@@ -30,6 +34,13 @@
 
 				<data android:scheme="nexus.federated.nexus" />
 			</intent-filter>
+			<intent-filter>
+				<action android:name="android.intent.action.VIEW" />
+				<category android:name="android.intent.category.DEFAULT" />
+				<category android:name="android.intent.category.BROWSABLE" />
+
+				<data android:scheme="matrix" />
+			</intent-filter>
             <meta-data
               android:name="io.flutter.embedding.android.NormalTheme"
               android:resource="@style/NormalTheme"
@@ -49,6 +60,16 @@
         <meta-data
             android:name="flutterEmbedding"
             android:value="2" />
+        <!-- Needed by pasteboard, for pasting files from the clipboard -->
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.provider"
+            android:exported="false"
+            android:grantUriPermissions="true">
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/provider_paths" />
+        </provider>
     </application>
     <!-- Required to query activities that can process text, see:
          https://developer.android.com/training/package-visibility and

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

@@ -1,5 +0,0 @@
-package nexus.federated.nexus
-
-import io.flutter.embedding.android.FlutterActivity
-
-class MainActivity: FlutterActivity()

android/app/src/main/kotlin/nexus/federated/nexus/MainActivity.kt

@@ -0,0 +1,40 @@
+package nexus.federated.nexus
+
+import android.os.Build
+import android.os.Bundle
+import android.view.View
+import android.view.WindowInsets
+import android.view.WindowInsetsAnimation
+import io.flutter.embedding.android.FlutterActivity
+
+// TODO: Revert this commit once https://github.com/flutter/flutter/issues/191156 is fixed
+class MainActivity: FlutterActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.R) return
+
+        window.decorView.setWindowInsetsAnimationCallback(
+            object : WindowInsetsAnimation.Callback(DISPATCH_MODE_CONTINUE_ON_SUBTREE) {
+                override fun onProgress(
+                    insets: WindowInsets,
+                    runningAnimations: List<WindowInsetsAnimation>,
+                ) = insets
+
+                override fun onEnd(animation: WindowInsetsAnimation) {
+                    if ((animation.typeMask and WindowInsets.Type.ime()) != 0) reapplyInsets()
+                }
+            },
+        )
+    }
+
+    override fun onWindowFocusChanged(hasFocus: Boolean) {
+        super.onWindowFocusChanged(hasFocus)
+        if (hasFocus && Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) reapplyInsets()
+    }
+
+    // Posted so it runs after Flutter has applied any insets it deferred.
+    private fun reapplyInsets() {
+        val view = findViewById<View>(FLUTTER_VIEW_ID) ?: return
+        view.post { view.rootWindowInsets?.let(view::onApplyWindowInsets) }
+    }
+}

android/app/src/main/res/xml/provider_paths.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<paths xmlns:android="http://schemas.android.com/apk/res/android">
+    <external-path
+        name="external_files"
+        path="." />
+</paths>