From fe2a362f3d7efba0f65ea969d99f0b9d96463cd3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ren=C3=A9=20Zander?=
 <96420681+renezander030@users.noreply.github.com>
Date: Fri, 18 Sep 2026 12:58:26 +0200
Subject: [PATCH] docs: add a showcase issue form and link it from both
 Built-with sections

The form asks for a public link, one sentence, an optional Chinese sentence and optional media, and a required checkbox where the submitter confirms they maintain the project and approve the wording, which is the approval the Built-with cards need.
---
 .github/ISSUE_TEMPLATE/showcase.yml | 45 +++++++++++++++++++++++++++++
 README.md                           |  2 ++
 README.zh-CN.md                     |  2 ++
 3 files changed, 49 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/showcase.yml

diff --git a/.github/ISSUE_TEMPLATE/showcase.yml b/.github/ISSUE_TEMPLATE/showcase.yml
new file mode 100644
index 0000000..add416a
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/showcase.yml
@@ -0,0 +1,45 @@
+name: "Built with capcut-cli / 使用 capcut-cli 构建"
+description: "Add your public project to the README showcase. / 把你的公开项目加入 README 展示。"
+title: "[Showcase] "
+labels: ["showcase"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Cards in **Built with capcut-cli** are text only and use the sentence you approve below. Inclusion does not imply endorsement or affiliation.
+        **使用 capcut-cli 构建** 中的卡片只包含文字，并使用你在下方确认的描述。收录不代表背书或关联。
+  - type: input
+    id: link
+    attributes:
+      label: "Public project link / 公开项目链接"
+      placeholder: "https://github.com/owner/repo"
+    validations:
+      required: true
+  - type: textarea
+    id: sentence
+    attributes:
+      label: "One sentence about what it does / 一句话说明"
+      description: "Published as written. / 将按原文发布。"
+      placeholder: "exports an agent-edited timeline into an editable CapCut / JianYing draft for review."
+    validations:
+      required: true
+  - type: textarea
+    id: sentence_zh
+    attributes:
+      label: "Chinese sentence for README.zh-CN (optional) / 用于 README.zh-CN 的中文描述（可选）"
+    validations:
+      required: false
+  - type: textarea
+    id: media
+    attributes:
+      label: "Screenshot or demo (optional) / 截图或演示（可选）"
+      description: "Only media you have the right to publish. / 仅限你有权发布的素材。"
+    validations:
+      required: false
+  - type: checkboxes
+    id: approval
+    attributes:
+      label: "Approval / 确认"
+      options:
+        - label: "I maintain this project and approve the wording above for the capcut-cli README. / 我是该项目的维护者，同意在 capcut-cli README 中使用以上描述。"
+          required: true
diff --git a/README.md b/README.md
index 9ea67e3..16ec238 100644
--- a/README.md
+++ b/README.md
@@ -111,6 +111,8 @@ The host reads a draft and passes its JSON as tool input. The component itself h
 
 - [OpenChatCut](https://github.com/0xsline/OpenChatCut) — exports an agent-edited timeline, local media, audio, and captions into a real CapCut / JianYing draft for review and rendering.
 
+Built something with capcut-cli? [Open a showcase issue](https://github.com/renezander030/capcut-cli/issues/new?template=showcase.yml) with a public link, one sentence about what it does, and an optional screenshot or demo.
+
 Project descriptions are approved by their maintainers. Inclusion does not imply endorsement or affiliation.
 
 
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 27f3b1e..fbd9c24 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -88,6 +88,8 @@ Claude Code 也可以把它作为插件加载：
 
 - [OpenChatCut](https://github.com/0xsline/OpenChatCut) — 将 Agent 编辑后的时间线、本地视频、音频和字幕导出为可在 CapCut / 剪映中继续审阅和渲染的真实草稿。
 
+使用 capcut-cli 构建了公开项目？请[提交 showcase issue](https://github.com/renezander030/capcut-cli/issues/new?template=showcase.yml)，附上公开链接、一句话说明，以及可选的截图或演示。
+
 项目描述须经其维护者确认。收录不代表背书或关联。