From ca0737eefbb2174b56afbd96e44f1ec2f34aee2b Mon Sep 17 00:00:00 2001
From: ThatGuySam <sam@sam.lc>
Date: Sat, 14 Jun 2025 14:33:47 -0500
Subject: [PATCH] add: app request flow doc

---
 docs/app-flow.md | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 docs/app-flow.md

diff --git a/docs/app-flow.md b/docs/app-flow.md
new file mode 100644
index 0000000..b0933e3
--- /dev/null
+++ b/docs/app-flow.md
@@ -0,0 +1,43 @@
+# App Request Flow
+
+Flow for new app requests and updates to existing apps
+
+<!-- 
+Mermaid Diagram Notes:
+- All node labels MUST be wrapped in quotes ("text") when containing:
+  * Special characters like parentheses ()
+  * HTML tags like <br/>
+  * Single quotes within text 'text'
+  * Emojis combined with special characters
+- Without quotes, Mermaid throws parsing errors like "Expecting 'SQE'..."
+- Do NOT wrap the entire code block in quotes - breaks markdown rendering
+-->
+
+```mermaid
+flowchart TD
+    A["👤 User: Submits App Request or Issue"] --> B{"🔧 Maintainer: Type of Issue?"}
+    B -- New App Request --> C["⚙️ System: Check for Existing Issue"]
+    C -- Not Found --> D["👤 User: Fill Out Issue Form<br/>(App Name, Status, Category, Links, Screenshot)"]
+    D --> E["⚙️ System: Label as 'New App Request'"]
+    E --> F["🔧 Maintainer: Reviews Submission"]
+    F -- Info Complete --> G["🔧 Maintainer: Label as 'Ready to Add'"]
+    F -- Info Missing --> H["🔧 Maintainer: Request More Info from User"]
+    H --> H2["🔧 Maintainer: Add 'Needs ...' Labels<br/>(e.g. Needs Screenshots, Needs Category)"]
+    H2 --> F
+    G --> I["👥 Contributor: Creates PR"]
+    I --> J["👥 Contributor: App Added to Compatibility List"]
+    J --> K["⚙️ System: Close Issue"]
+
+    B -- App Update --> L["👤 User: Reports Update<br/>(e.g. Native Support Now Available)"]
+    L --> M["👤 User: Provide Evidence<br/>(Links, Screenshots)"]
+    M --> N["🔧 Maintainer: Label as 'App Update'"]
+    N --> F
+
+    B -- Feature/Meta Issue --> O["🔧 Maintainer: Label as 'Feature Request' or 'Bug'"]
+    O --> P["🔧 Maintainer: Discuss, Assign, and Track Progress"]
+    P --> Q["👥 Contributor: Implement and Close"]
+
+    style A stroke:#f9f,stroke-width:2px
+    style J stroke:#bbf,stroke-width:2px
+    style K stroke:#bfb,stroke-width:2px
+```