From 159c8c175c01d4225a6984265c0cfb4e533a18d9 Mon Sep 17 00:00:00 2001
From: Hokila Jan <1647434+Hokila@users.noreply.github.com>
Date: Mon, 31 Aug 2026 16:53:22 +0800
Subject: [PATCH 1/2] Document how to add In-App Purchase capability

---
 Docs/FAQ.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/Docs/FAQ.md b/Docs/FAQ.md
index 9d1096816..6036659b3 100644
--- a/Docs/FAQ.md
+++ b/Docs/FAQ.md
@@ -3,6 +3,7 @@
 - [Can I use CocoaPods](#can-i-use-cocoapods)
 - [Can I use Crashlytics](#can-i-use-crashlytics)
 - [How do I setup code signing](#how-do-i-setup-code-signing)
+- [How do I add an Xcode capability](#how-do-i-add-an-xcode-capability)
 
 ## Can I still check in my project
 Absolutely. You will get the most out of XcodeGen by adding your project to your `.gitignore`, as this way you avoid merge conflicts. But you can also check it in as a halfway step.
@@ -41,3 +42,18 @@ This script will be added after `[CP] Embed Pods Frameworks.`
 ## How do I setup code signing
 
 At the moment there are no special options for code signing in XcodeGen, and this must be configured via regular build settings. For code signing to work, you need to tell Xcode which development team to use. This requires setting the `DEVELOPMENT_TEAM` and possibly `CODE_SIGN_STYLE` build settings. See [Configuring build settings](Usage.md#configuring-build-settings) for how to do that
+
+## How do I add an Xcode capability
+
+XcodeGen does not provide a general-purpose abstraction for Xcode capabilities. To determine what a capability requires, temporarily remove the generated project from source control, enable the capability in Xcode, and inspect the resulting project and entitlements changes.
+
+For example, enabling In-App Purchase adds the StoreKit framework. You can express that dependency in your spec as follows:
+
+```yaml
+targets:
+  MyApp:
+    dependencies:
+      - framework: StoreKit.framework
+```
+
+See [Dependencies](ProjectSpec.md#dependency) for the other dependency forms supported by XcodeGen. This example is specific to In-App Purchase; other capabilities may require different project settings, entitlements, or Xcode project attributes.

From 13567b0156e5102b9ddb38ab147ea8b84963aecd Mon Sep 17 00:00:00 2001
From: Hokila Jan <1647434+Hokila@users.noreply.github.com>
Date: Mon, 31 Aug 2026 16:53:45 +0800
Subject: [PATCH 2/2] Add changelog entry for capability documentation

---
 CHANGELOG.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f48867138..83a8fcf0d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Change Log
 
+## Unreleased
+
+### Documentation
+- Document how to add the In-App Purchase capability #1644 @Hokila
+
 ## 2.46.0
 
 ### Added