From f537d1133b5aa4650a98a2646d3e6eefa2bb0e88 Mon Sep 17 00:00:00 2001
From: "Joshua (D) Drake" <136637981+ChronicallyJD@users.noreply.github.com>
Date: Mon, 6 Jul 2026 06:09:47 -0600
Subject: [PATCH] Add PL/php logo assets and use them in the docs

Track the light/dark logos and square icon under doc/assets/, and wire the
logo into the README header (theme-aware <picture>) and the language
reference.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md                   |  2 ++
 README.md                      |  5 ++++-
 doc/assets/plphp-icon.svg      | 14 ++++++++++++++
 doc/assets/plphp-logo-dark.svg | 19 +++++++++++++++++++
 doc/assets/plphp-logo.svg      | 18 ++++++++++++++++++
 doc/plphp.md                   |  7 +++++++
 6 files changed, 64 insertions(+), 1 deletion(-)
 create mode 100644 doc/assets/plphp-icon.svg
 create mode 100644 doc/assets/plphp-logo-dark.svg
 create mode 100644 doc/assets/plphp-logo.svg

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9ab4552..b31b825 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -20,6 +20,8 @@ and the project aims to follow [Semantic Versioning](https://semver.org/).
 
 ### Added
 
+- **Project logo and brand assets.** Light/dark PL/php logos and a square icon
+  under `doc/assets/`, wired into the README and language reference.
 - **Error CONTEXT lines.** Messages raised while PL/php code runs carry a
   `CONTEXT: PL/php function "name"` line (or the anonymous-block/compilation
   variants), like every other procedural language.
diff --git a/README.md b/README.md
index 603e02d..2357c20 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,9 @@
 <div align="center">
 
-# PL/php
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="doc/assets/plphp-logo-dark.svg">
+  <img src="doc/assets/plphp-logo.svg" alt="PL/php — Procedural Language for PostgreSQL" width="460">
+</picture>
 
 **Write PostgreSQL functions, triggers, and procedures in PHP.**
 
diff --git a/doc/assets/plphp-icon.svg b/doc/assets/plphp-icon.svg
new file mode 100644
index 0000000..b711b0f
--- /dev/null
+++ b/doc/assets/plphp-icon.svg
@@ -0,0 +1,14 @@
+<svg viewBox="55 175 490 375" xmlns="http://www.w3.org/2000/svg">
+  <path d="M 128 300 C 92 322, 86 362, 103 398" stroke="#2B5578" stroke-width="11" fill="none" stroke-linecap="round"/>
+  <rect x="175" y="402" width="50" height="114" rx="22" fill="#2B5578"/>
+  <rect x="250" y="402" width="50" height="114" rx="22" fill="#2B5578"/>
+  <rect x="325" y="402" width="50" height="114" rx="22" fill="#3A6E9A"/>
+  <rect x="384" y="382" width="50" height="134" rx="22" fill="#3A6E9A"/>
+  <ellipse cx="290" cy="330" rx="165" ry="120" fill="#336791"/>
+  <circle cx="445" cy="270" r="95" fill="#777BB4"/>
+  <path d="M 430 205 C 398 195, 372 220, 373 258 C 374 292, 400 315, 435 312 C 448 311, 455 302, 450 291 C 438 265, 438 235, 450 214 C 456 204, 444 200, 430 205 Z" fill="#2B5578"/>
+  <path d="M 485 320 C 505 360, 500 400, 475 430 C 455 452, 430 458, 415 445 C 430 440, 445 425, 450 405 C 457 375, 450 345, 430 320 C 445 305, 470 305, 485 320 Z" fill="#777BB4"/>
+  <circle cx="475" cy="248" r="12" fill="#FAF9F6"/>
+  <circle cx="478" cy="248" r="6" fill="#23272F"/>
+  <path d="M 505 335 C 517 345, 517 360, 505 368" stroke="#FAF9F6" stroke-width="8" fill="none" stroke-linecap="round"/>
+</svg>
diff --git a/doc/assets/plphp-logo-dark.svg b/doc/assets/plphp-logo-dark.svg
new file mode 100644
index 0000000..24de73f
--- /dev/null
+++ b/doc/assets/plphp-logo-dark.svg
@@ -0,0 +1,19 @@
+<svg viewBox="0 0 1160 300" xmlns="http://www.w3.org/2000/svg">
+  <rect width="1160" height="300" fill="#1B2430"/>
+  <g transform="translate(-21.6,-66.6) scale(0.6)">
+  <path d="M 128 300 C 92 322, 86 362, 103 398" stroke="#5A8FBF" stroke-width="11" fill="none" stroke-linecap="round"/>
+  <rect x="175" y="402" width="50" height="114" rx="22" fill="#5A8FBF"/>
+  <rect x="250" y="402" width="50" height="114" rx="22" fill="#5A8FBF"/>
+  <rect x="325" y="402" width="50" height="114" rx="22" fill="#7FB0DA"/>
+  <rect x="384" y="382" width="50" height="134" rx="22" fill="#7FB0DA"/>
+  <ellipse cx="290" cy="330" rx="165" ry="120" fill="#6FA6D6"/>
+  <circle cx="445" cy="270" r="95" fill="#9B9FD4"/>
+  <path d="M 430 205 C 398 195, 372 220, 373 258 C 374 292, 400 315, 435 312 C 448 311, 455 302, 450 291 C 438 265, 438 235, 450 214 C 456 204, 444 200, 430 205 Z" fill="#5A8FBF"/>
+  <path d="M 485 320 C 505 360, 500 400, 475 430 C 455 452, 430 458, 415 445 C 430 440, 445 425, 450 405 C 457 375, 450 345, 430 320 C 445 305, 470 305, 485 320 Z" fill="#9B9FD4"/>
+  <circle cx="475" cy="248" r="12" fill="#1B2430"/>
+  <circle cx="478" cy="248" r="6" fill="#FAF9F6"/>
+  <path d="M 505 335 C 517 345, 517 360, 505 368" stroke="#1B2430" stroke-width="8" fill="none" stroke-linecap="round"/>
+  </g>
+  <text x="334" y="165" font-family="Consolas, 'DejaVu Sans Mono', 'Courier New', monospace" font-weight="700" font-size="112"><tspan fill="#7FB0DA">PL</tspan><tspan fill="#E8E8ED">/</tspan><tspan fill="#B3B6E6">php</tspan></text>
+  <text x="337" y="209" font-family="Arial, sans-serif" font-size="24" letter-spacing="1" fill="#9CA3AF">PROCEDURAL LANGUAGE FOR POSTGRESQL</text>
+</svg>
diff --git a/doc/assets/plphp-logo.svg b/doc/assets/plphp-logo.svg
new file mode 100644
index 0000000..860c968
--- /dev/null
+++ b/doc/assets/plphp-logo.svg
@@ -0,0 +1,18 @@
+<svg viewBox="0 0 1160 300" xmlns="http://www.w3.org/2000/svg">
+  <g transform="translate(-21.6,-66.6) scale(0.6)">
+  <path d="M 128 300 C 92 322, 86 362, 103 398" stroke="#2B5578" stroke-width="11" fill="none" stroke-linecap="round"/>
+  <rect x="175" y="402" width="50" height="114" rx="22" fill="#2B5578"/>
+  <rect x="250" y="402" width="50" height="114" rx="22" fill="#2B5578"/>
+  <rect x="325" y="402" width="50" height="114" rx="22" fill="#3A6E9A"/>
+  <rect x="384" y="382" width="50" height="134" rx="22" fill="#3A6E9A"/>
+  <ellipse cx="290" cy="330" rx="165" ry="120" fill="#336791"/>
+  <circle cx="445" cy="270" r="95" fill="#777BB4"/>
+  <path d="M 430 205 C 398 195, 372 220, 373 258 C 374 292, 400 315, 435 312 C 448 311, 455 302, 450 291 C 438 265, 438 235, 450 214 C 456 204, 444 200, 430 205 Z" fill="#2B5578"/>
+  <path d="M 485 320 C 505 360, 500 400, 475 430 C 455 452, 430 458, 415 445 C 430 440, 445 425, 450 405 C 457 375, 450 345, 430 320 C 445 305, 470 305, 485 320 Z" fill="#777BB4"/>
+  <circle cx="475" cy="248" r="12" fill="#FAF9F6"/>
+  <circle cx="478" cy="248" r="6" fill="#23272F"/>
+  <path d="M 505 335 C 517 345, 517 360, 505 368" stroke="#FAF9F6" stroke-width="8" fill="none" stroke-linecap="round"/>
+  </g>
+  <text x="334" y="165" font-family="Consolas, 'DejaVu Sans Mono', 'Courier New', monospace" font-weight="700" font-size="112"><tspan fill="#336791">PL</tspan><tspan fill="#23272F">/</tspan><tspan fill="#777BB4">php</tspan></text>
+  <text x="337" y="209" font-family="Arial, sans-serif" font-size="24" letter-spacing="1" fill="#6B7280">PROCEDURAL LANGUAGE FOR POSTGRESQL</text>
+</svg>
diff --git a/doc/plphp.md b/doc/plphp.md
index cedac4c..923dc58 100644
--- a/doc/plphp.md
+++ b/doc/plphp.md
@@ -1,3 +1,10 @@
+<div align="center">
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="assets/plphp-logo-dark.svg">
+  <img src="assets/plphp-logo.svg" alt="PL/php" width="360">
+</picture>
+</div>
+
 # PL/php Language Reference
 
 PL/php lets you write PostgreSQL functions and triggers in PHP. This document