From 2aa9133f9d3334e8f77bd596c67727a2698e8bed Mon Sep 17 00:00:00 2001
From: Michael Aaron Murphy <michael@mmurphy.dev>
Date: Wed, 13 May 2026 16:14:34 +0200
Subject: [PATCH] docs(readme): add Made for COSMIC Flatpak section

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

diff --git a/README.md b/README.md
index 23da97b..698316d 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,24 @@ While libcosmic is written entirely in Rust, some of its dependencies may requir
 sudo apt install cargo cmake just libexpat1-dev libfontconfig-dev libfreetype-dev libxkbcommon-dev pkgconf
 ```
 
+## Made-for-COSMIC Flatpak IDs
+
+To identify a project as a COSMIC Application, add `<id>com.system76.CosmicApplication</id>` to the provides section of the project's metainfo.
+
+```xml
+<provides>
+  <id>com.system76.CosmicApplication</id>
+</provides>
+```
+
+For COSMIC Applets, use `com.system76.CosmicApplet`.
+
+```xml
+<provides>
+  <id>com.system76.CosmicApplet</id>
+</provides>
+```
+
 ## Examples
 
 Some examples are included in the [examples](./examples) directory to to kickstart your