From 50de1605e1559f6430cd31e28ed2c7c4d32be501 Mon Sep 17 00:00:00 2001
From: Barakudum <68517540+Barakudum@users.noreply.github.com>
Date: Fri, 28 Aug 2026 11:29:51 +0200
Subject: [PATCH] feat(icons): add `playing-card`, `playing-cards`, and
 `playing-cards-fan` (#4258)

* Added icons `playing-card`, `playing-cards`, `playing-cards-2`

* updated playing card icons according to @karsa-mistmere

* updated playing card icons according to @karsa-mistmere

* added `playing-cards-fan` icon from @karsa-mistmere

* fix(metadata): add missing use-cases for playing card icons

* Update playing-card.json

* Update playing-cards-fan.json

* Update playing-cards.json

* Update playing-cards.svg

* Update playing-cards-fan.svg

* Update playing-card.svg

---------

Co-authored-by: Eric Fennis <eric.fennis@gmail.com>
Co-authored-by: Karsa <contact@karsa.org>
---
 icons/playing-card.json      | 41 ++++++++++++++++++++++++++++++++
 icons/playing-card.svg       | 14 +++++++++++
 icons/playing-cards-fan.json | 45 ++++++++++++++++++++++++++++++++++++
 icons/playing-cards-fan.svg  | 15 ++++++++++++
 icons/playing-cards.json     | 43 ++++++++++++++++++++++++++++++++++
 icons/playing-cards.svg      | 15 ++++++++++++
 6 files changed, 173 insertions(+)
 create mode 100644 icons/playing-card.json
 create mode 100644 icons/playing-card.svg
 create mode 100644 icons/playing-cards-fan.json
 create mode 100644 icons/playing-cards-fan.svg
 create mode 100644 icons/playing-cards.json
 create mode 100644 icons/playing-cards.svg

diff --git a/icons/playing-card.json b/icons/playing-card.json
new file mode 100644
index 000000000..eb2da95c7
--- /dev/null
+++ b/icons/playing-card.json
@@ -0,0 +1,41 @@
+{
+  "$schema": "../icon.schema.json",
+  "contributors": [
+    "Barakudum",
+    "jamiemlaw",
+    "karsa-mistmere"
+  ],
+  "use-cases": [
+    "Representing a single card in tabletop games",
+    "Showing flashcards in learning interfaces",
+    "Marking prompts in icebreaker activities",
+    "Indicating chance-based actions or random selection"
+  ],
+  "tags": [
+    "deck",
+    "draw",
+    "deal",
+    "shuffle",
+    "chance",
+    "random",
+    "selection",
+    "tabletop",
+    "flashcard",
+    "study",
+    "learning",
+    "prompt",
+    "icebreaker",
+    "conversation",
+    "collectible",
+    "trading",
+    "poker",
+    "casino",
+    "game",
+    "gambling",
+    "suit"
+  ],
+  "categories": [
+    "gaming",
+    "development"
+  ]
+}
diff --git a/icons/playing-card.svg b/icons/playing-card.svg
new file mode 100644
index 000000000..308f97fa5
--- /dev/null
+++ b/icons/playing-card.svg
@@ -0,0 +1,14 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M12.832 8.445a1 1 0 00-1.589-.098l-2.075 3.098a1 1 0 000 1.11l2 3a1 1 0 001.664 0l2-3a1 1 0 000-1.11z" />
+  <rect x="5" y="2" width="14" height="20" rx="2" />
+</svg>
diff --git a/icons/playing-cards-fan.json b/icons/playing-cards-fan.json
new file mode 100644
index 000000000..379a29ae8
--- /dev/null
+++ b/icons/playing-cards-fan.json
@@ -0,0 +1,45 @@
+{
+  "$schema": "../icon.schema.json",
+  "contributors": [
+    "Barakudum",
+    "karsa-mistmere"
+  ],
+  "use-cases": [
+    "Representing a player's hand in card games",
+    "Showing planning poker estimates in agile tools",
+    "Displaying icebreaker prompts in conversation apps",
+    "Marking spread or revealed collectible cards"
+  ],
+  "tags": [
+    "deck",
+    "fan",
+    "spread",
+    "hand",
+    "deal",
+    "dealt",
+    "draw",
+    "shuffle",
+    "tabletop",
+    "planning poker",
+    "scrum",
+    "agile",
+    "estimation",
+    "estimate",
+    "prompt",
+    "icebreaker",
+    "conversation",
+    "collectible",
+    "collection",
+    "trading",
+    "poker",
+    "casino",
+    "game",
+    "gambling",
+    "suit"
+  ],
+  "categories": [
+    "gaming",
+    "development",
+    "social"
+  ]
+}
diff --git a/icons/playing-cards-fan.svg b/icons/playing-cards-fan.svg
new file mode 100644
index 000000000..00d35897b
--- /dev/null
+++ b/icons/playing-cards-fan.svg
@@ -0,0 +1,15 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M12.65 7.65a2 2 0 012.629-1.046l5.51 2.374a2 2 0 011.046 2.628l-3.957 9.184a2 2 0 01-2.628 1.046l-5.51-2.374a2 2 0 01-1.046-2.628z" />
+  <path d="M18 7.777V4a2 2 0 00-2-2h-6a2 2 0 00-2 2v10a2 2 0 001.137 1.805" />
+  <path d="m8 4.389-4.364.809a2 2 0 00-1.602 2.33l1.822 9.833a2 2 0 002.331 1.602l2.542-.47" />
+</svg>
diff --git a/icons/playing-cards.json b/icons/playing-cards.json
new file mode 100644
index 000000000..62b4bcc08
--- /dev/null
+++ b/icons/playing-cards.json
@@ -0,0 +1,43 @@
+{
+  "$schema": "../icon.schema.json",
+  "contributors": [
+    "Barakudum",
+    "jamiemlaw",
+    "karsa-mistmere"
+  ],
+  "use-cases": [
+    "Representing decks in tabletop games",
+    "Showing planning poker cards in agile tools",
+    "Organizing flashcard sets in learning apps",
+    "Marking collectible card collections in inventories"
+  ],
+  "tags": [
+    "deck",
+    "stack",
+    "shuffle",
+    "deal",
+    "draw",
+    "hand",
+    "tabletop",
+    "planning poker",
+    "scrum",
+    "agile",
+    "estimation",
+    "estimate",
+    "flashcards",
+    "study",
+    "learning",
+    "collectible",
+    "collection",
+    "trading",
+    "poker",
+    "casino",
+    "game",
+    "gambling",
+    "suit"
+  ],
+  "categories": [
+    "gaming",
+    "development"
+  ]
+}
diff --git a/icons/playing-cards.svg b/icons/playing-cards.svg
new file mode 100644
index 000000000..020979ecd
--- /dev/null
+++ b/icons/playing-cards.svg
@@ -0,0 +1,15 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M14.832 8.445a1 1 0 00-1.589-.098l-2.075 3.098a1 1 0 000 1.11l2 3a1 1 0 001.664 0l2-3a1 1 0 000-1.11z" />
+  <path d="m7.18 20.827-5-11a2 2 0 01.993-2.647L7 5.44" />
+  <rect x="7" y="2" width="14" height="20" rx="2" />
+</svg>