From cce58cb407f3316d5b357d78bf950a8a0171daac Mon Sep 17 00:00:00 2001
From: Abhishek Uniyal <56363630+uniyalabhishek@users.noreply.github.com>
Date: Wed, 20 May 2026 23:05:39 +0530
Subject: [PATCH] docs/rofl: Document manifest artifact overrides

---
 docs/rofl/features/manifest.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/docs/rofl/features/manifest.md b/docs/rofl/features/manifest.md
index a720fd54171..e4aa71ded66 100644
--- a/docs/rofl/features/manifest.md
+++ b/docs/rofl/features/manifest.md
@@ -81,6 +81,21 @@ values currently supported:
 
 The `size` argument defines the amount of storage to provision in megabytes.
 
+## Artifacts (`artifacts`) {#artifacts}
+
+Configures locations of artifacts used during the ROFL build process.
+Unspecified fields use the default artifacts provided by the CLI.
+
+Supported fields are `builder`, `firmware`, `kernel`, `stage2`,
+`container.runtime` and `container.compose`. For containerized apps,
+`container.compose` points to the Compose file included in the ROFL bundle.
+
+```yaml
+artifacts:
+  container:
+    compose: compose.yaml
+```
+
 ## Deployments (`deployments`) {#deployments}
 
 This section contains ROFL deployments on specific networks.
@@ -89,6 +104,21 @@ This section contains ROFL deployments on specific networks.
 
 User-defined deployment name.
 
+#### `artifacts`
+
+Optional deployment-specific artifact location overrides. Deployment artifacts
+are merged field by field on top of global `artifacts`.
+
+```yaml
+deployments:
+  testnet:
+    network: testnet
+    paratime: sapphire
+    artifacts:
+      container:
+        compose: compose.testnet.yaml
+```
+
 #### `policy`
 
 Contains the policy under which the app will be allowed to spin up: