From e2d7638ce127330aabb3cc4516102f373915c1ef Mon Sep 17 00:00:00 2001
From: Binarybaron <binarybaron@protonmail.com>
Date: Fri, 27 Jun 2025 22:10:33 +0200
Subject: [PATCH] feat(docs): flatpak

---
 dev_scripts/publish_flatpak.sh                |  2 ++
 .../getting_started/install_instructions.mdx  | 25 ++++++++++++++++++-
 flatpak/index.html                            |  5 ++--
 3 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/dev_scripts/publish_flatpak.sh b/dev_scripts/publish_flatpak.sh
index baeff625..95d144fe 100644
--- a/dev_scripts/publish_flatpak.sh
+++ b/dev_scripts/publish_flatpak.sh
@@ -1,3 +1,5 @@
+#!/bin/bash
+
 # UnstoppableSwap Flatpak Build and Deploy Script
 # Usage: ./flatpak-build.sh [--push] [--branch BRANCH] [--no-gpg]
 # Example: ./flatpak-build.sh --push --branch gh-pages
diff --git a/docs/pages/getting_started/install_instructions.mdx b/docs/pages/getting_started/install_instructions.mdx
index 5826590d..d3560b40 100644
--- a/docs/pages/getting_started/install_instructions.mdx
+++ b/docs/pages/getting_started/install_instructions.mdx
@@ -9,7 +9,7 @@ Unless you know what you're doing, you probably want to use the precompiled bina
 
 Precompiled binaries of the _GUI_ are available for most platforms. Simply download the appropriate binary for your system and follow the instructions.
 
-<Tabs items={['Windows', 'macOS (Silicon)', 'macOS (Intel)', 'Linux (x86_64)', 'Linux (arm64)']}>
+<Tabs items={['Windows', 'macOS (Silicon)', 'macOS (Intel)', 'Linux (x86_64)', 'Linux (arm64)', 'Flatpak']}>
   <Tabs.Tab>
     1. Download the latest release from GitHub [here](https://github.com/UnstoppableSwap/core/releases/download/1.0.0-rc.4/UnstoppableSwap_1.0.0-rc.4_x64-setup.exe)
     2. Open the downloaded `.exe` installer
@@ -40,6 +40,29 @@ Precompiled binaries of the _GUI_ are available for most platforms. Simply downl
   <Tabs.Tab>
     Due to limitations with our CI pipeline, we currently can't provide precompiled binaries for arm64 linux systems.
   </Tabs.Tab>
+  <Tabs.Tab>
+    For Linux systems with Flatpak support, you can install UnstoppableSwap directly from our Flatpak repository:
+
+    ```bash filename="install.sh"
+    # Add the UnstoppableSwap repository
+    flatpak remote-add --user unstoppableswap https://unstoppableswap.github.io/core/unstoppableswap.flatpakrepo
+
+    # Install the application
+    flatpak install unstoppableswap net.unstoppableswap.gui
+
+    # Run the application
+    flatpak run net.unstoppableswap.gui
+    ```
+
+    **Requirements:**
+    - Flatpak 1.0 or newer
+    - x86_64 architecture
+
+    **Updates:**
+    ```bash
+    flatpak update net.unstoppableswap.gui
+    ```
+  </Tabs.Tab>
 </Tabs>
 
 ## Building from source
diff --git a/flatpak/index.html b/flatpak/index.html
index efd9768b..d3f06b58 100644
--- a/flatpak/index.html
+++ b/flatpak/index.html
@@ -77,9 +77,10 @@
         <pre><code># Add the repository
 flatpak remote-add --if-not-exists unstoppableswap https://flatpak.unstoppableswap.net/unstoppableswap.flatpakrepo
 
-# Install the application
+# Install
 flatpak install unstoppableswap net.unstoppableswap.gui
-# Run it
+
+# Run
 flatpak run net.unstoppableswap.gui
 </code></pre>
         <h2>Run it</h2>