From ea97dee282a88253291b42c30769e6deea1d0b64 Mon Sep 17 00:00:00 2001
From: Sebastian Palencsar <hello@linuxcommand.dev>
Date: Sat, 30 May 2026 22:59:14 +0200
Subject: [PATCH] Add Flatpak repository installation instructions to README

---
 CHANGELOG.md |  5 +++++
 README.md    | 14 +++++++++++++-
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6ebf6be..23ab44e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Added
+- Flatpak build manifest and deployment guides for hosting an independent repository.
+
 ## [1.0.3] - 2026-05-30
 
 ### Added
diff --git a/README.md b/README.md
index 57c0149..785eade 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,7 @@ Screenshots: KDE Plasma on Linux.
 
 ## Quick Start
 
-Two sensible paths right now:
+Three sensible paths right now:
 
 ### Option A: Arch Linux (AUR)
 
@@ -52,6 +52,18 @@ Then launch:
 ~/.local/bin/bearwave
 ```
 
+### Option C: Flatpak (Universal / Immutable OS)
+
+If you are running an immutable Linux distribution (like Fedora Silverblue, SteamOS) or simply prefer sandboxed applications, you can install BearWave directly from our independent repository:
+
+```bash
+# Add the BearWave repository
+flatpak remote-add --user --no-gpg-verify bearwave-repo https://flatpak.bearwave.app/bearwave.flatpakrepo
+
+# Install the application
+flatpak install bearwave-repo de.nerdbear.bearwave
+```
+
 ## What BearWave Is
 
 BearWave focuses on: