From 94c68a46a416f4970597604ace97305564a20f8d Mon Sep 17 00:00:00 2001
From: funman300 <funman300@gmail.com>
Date: Thu, 14 May 2026 19:12:59 -0700
Subject: [PATCH] docs: add Android install section with Obtainium instructions

---
 README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/README.md b/README.md
index 3da8ff1..f08bb4a 100644
--- a/README.md
+++ b/README.md
@@ -31,6 +31,26 @@ optional self-hosted sync so your stats follow you across machines.
 - **Color-blind mode** — blue tint on red-suit cards alongside the suit
   glyph
 
+## Android Install
+
+### Obtainium (recommended — automatic updates)
+
+1. Install [Obtainium](https://github.com/ImranR98/Obtainium/releases) on your device
+2. Tap **Add App** and enter:
+   ```
+   https://git.aleshym.co/funman300/Rusty_Solitare
+   ```
+3. Tap **Add** — Obtainium will detect the Gitea source automatically
+4. Tap **Install** to download the current release, and **Update** whenever a new version drops
+
+Obtainium polls for new releases and notifies you when an update is available.
+
+### Direct APK
+
+Download the latest `solitaire-quest.apk` from the
+[Releases](https://git.aleshym.co/funman300/Rusty_Solitare/releases) page,
+enable **Install from unknown sources** in your device settings, and open the file.
+
 ## Building
 
 **Prerequisites**