From 25c49190ff919747a74e2e58f15c4e6978f65717 Mon Sep 17 00:00:00 2001
From: Ethan Carter Edwards <ethan@ethancedwards.com>
Date: Sun, 20 Sep 2026 17:12:42 -0400
Subject: [PATCH] doc: add meta.mainDarwinApp

Signed-off-by: Ethan Carter Edwards <ethan@ethancedwards.com>
---
 doc/redirects.json         | 3 +++
 doc/stdenv/meta.chapter.md | 4 ++++
 2 files changed, 7 insertions(+)

diff --git a/doc/redirects.json b/doc/redirects.json
index c247c05dcd9b..34033dd7cf5a 100644
--- a/doc/redirects.json
+++ b/doc/redirects.json
@@ -1711,6 +1711,9 @@
   "var-meta-mainProgram": [
     "index.html#var-meta-mainProgram"
   ],
+  "var-meta-mainDarwinApp": [
+    "index.html#var-meta-mainDarwinApp"
+  ],
   "var-meta-priority": [
     "index.html#var-meta-priority"
   ],
diff --git a/doc/stdenv/meta.chapter.md b/doc/stdenv/meta.chapter.md
index 3c662d40dcf3..09f621356f11 100644
--- a/doc/stdenv/meta.chapter.md
+++ b/doc/stdenv/meta.chapter.md
@@ -105,6 +105,10 @@ A list of the teams of this Nix expression. Teams are defined in [`nixpkgs/maint
 
 The name of the main binary for the package. This affects the binary `nix run` executes. Example: `"rg"`
 
+### `mainDarwinApp` {#var-meta-mainDarwinApp}
+
+The name of the main Darwin/macOS Application for the package. It must end in `.app`. Example: `"VSCodium.app"`
+
 ### `priority` {#var-meta-priority}
 
 The *priority* of the package, used by `nix-env` to resolve file name conflicts between packages. See the [manual page for `nix-env`](https://nixos.org/manual/nix/stable/command-ref/nix-env) for details. Example: `"10"` (a low-priority package).