+
# mongodb-operator
+> **Keiailab data operator family** — MongoDB replica sets and sharded clusters on Kubernetes with TLS, metrics, and declarative topology.
+
+
+
+
+
+
+
+
+
+
+## Design assets
+
+| Asset | Path | Usage |
+|---|---|---|
+| Centered service symbol | [`docs/branding/symbol.png`](docs/branding/symbol.png) | GitHub README, Artifact Hub icon/screenshot |
+| Repository wordmark | [`docs/branding/logo.png`](docs/branding/logo.png) | Project pages and docs cards |
+| Social cover | [`docs/branding/cover.png`](docs/branding/cover.png) | Social cards and launch posts |
+| Branding guide | [`docs/branding.md`](docs/branding.md) | Public visual usage rules |
+
A Kubernetes operator for running MongoDB on Kubernetes. It manages the lifecycle
of MongoDB replica sets and sharded clusters through Custom Resources — bootstrapping
the cluster, creating the admin user, wiring up TLS and metrics, and reconciling
the desired topology.
-[](LICENSE)
-[](go.mod)
-[](#supported-mongodb-versions)
-[](#requirements)
-
The operator does not bundle or redistribute MongoDB. It pulls the official
`mongo` community images at runtime and orchestrates them; you remain responsible
for complying with MongoDB's [SSPL](https://www.mongodb.com/licensing/server-side-public-license)
diff --git a/charts/mongodb-operator/Chart.yaml b/charts/mongodb-operator/Chart.yaml
index 699d390a..c6cdf772 100644
--- a/charts/mongodb-operator/Chart.yaml
+++ b/charts/mongodb-operator/Chart.yaml
@@ -27,7 +27,7 @@ maintainers:
email: support@keiailab.com
url: https://keiailab.com
-icon: https://raw.githubusercontent.com/mongodb/mongo/master/docs/leaf.svg
+icon: https://raw.githubusercontent.com/KeiaiLab/mongodb-operator/main/docs/branding/symbol.png
annotations:
artifacthub.io/license: MIT
@@ -62,6 +62,13 @@ annotations:
url: https://github.com/keiailab/mongodb-operator
- name: MongoDB Documentation
url: https://www.mongodb.com/docs/
+ - name: Design Assets
+ url: https://github.com/KeiaiLab/mongodb-operator/blob/main/docs/branding.md
+ artifacthub.io/screenshots: |
+ - title: Keiailab MongoDB Operator centered service symbol
+ url: https://raw.githubusercontent.com/KeiaiLab/mongodb-operator/main/docs/branding/symbol.png
+ - title: Keiailab MongoDB Operator social cover
+ url: https://raw.githubusercontent.com/KeiaiLab/mongodb-operator/main/docs/branding/cover.png
artifacthub.io/crds: |
- kind: MongoDB
version: v1alpha1
diff --git a/charts/mongodb-operator/README.md b/charts/mongodb-operator/README.md
index 49bcbfde..2428cb6e 100644
--- a/charts/mongodb-operator/README.md
+++ b/charts/mongodb-operator/README.md
@@ -1,7 +1,20 @@
# MongoDB Operator Helm Chart
+
+
+
+
A Kubernetes Operator for deploying and managing MongoDB ReplicaSets and Sharded Clusters.
+## Design assets
+
+| Asset | URL | Usage |
+|---|---|---|
+| Centered service symbol | https://raw.githubusercontent.com/KeiaiLab/mongodb-operator/main/docs/branding/symbol.png | Artifact Hub package icon and screenshot |
+| Repository wordmark | https://raw.githubusercontent.com/KeiaiLab/mongodb-operator/main/docs/branding/logo.png | Project pages and docs cards |
+| Social cover | https://raw.githubusercontent.com/KeiaiLab/mongodb-operator/main/docs/branding/cover.png | Social cards and launch posts |
+| Branding guide | https://github.com/KeiaiLab/mongodb-operator/blob/main/docs/branding.md | GitHub visual usage rules |
+
## Features
- **MongoDB ReplicaSet**: Deploy highly available 3+ member replica sets
diff --git a/docs/branding.md b/docs/branding.md
index 63d5f09f..6244d12d 100644
--- a/docs/branding.md
+++ b/docs/branding.md
@@ -28,14 +28,15 @@ This document is the canonical reference for `mongodb-operator` branding decisio
| Asset | URL | Usage |
|---|---|---|
-| Primary logo (current) | `https://github.com/keiailab.png` | README header (all repos), slides |
-| Primary logo (SVG, planned) | `https://keiailab.com/assets/logo.svg` *(not yet published)* | future replacement for GitHub avatar |
-| Mono mark (planned) | `https://keiailab.com/assets/mark.svg` *(not yet published)* | Favicon, social cards |
+| Primary logo (current) | `docs/branding/symbol.png` | README header (all repos), slides |
+| Repository wordmark | `docs/branding/logo.png` | Project pages |
+| Social cover | `docs/branding/cover.png` | Social cards and launch posts |
+| Current favicon | `https://keiailab.com/favicon.ico` | Favicon, social cards |
| Wordmark (planned) | `https://keiailab.com/assets/wordmark.svg` *(not yet published)* | Footer, dark backgrounds |
-**Logo placement**: Top-center of README, width 120px. Always link to https://github.com/keiailab.
+**Logo placement**: Top-center of README, width 96px. Always link to https://keiailab.com.
-**Migration note (2026-05-21)**: until `keiailab.com/assets/*.svg` is published, all repos in the family use the GitHub avatar (`https://github.com/keiailab.png`) as canonical primary logo. The SVG row is reserved for the future migration.
+**Symbol note (2026-06-11)**: the primary symbol keeps the Keiailab rotating-arrow mark and replaces only the removed center sphere with the service icon.
**Clear space**: Minimum padding around logo = 25% of logo width.
@@ -87,7 +88,7 @@ GitHub README 의 shield.io badge 는 위 hex 사용 권장.
```markdown
-
+
# mongodb-operator
@@ -95,7 +96,7 @@ GitHub README 의 shield.io badge 는 위 hex 사용 권장.
> **MIT MongoDB Operator for Kubernetes — ReplicaSet + Sharded Cluster + Backup, vanilla MongoDB 7.0+**
-
+
diff --git a/docs/branding/base-symbol.png b/docs/branding/base-symbol.png
new file mode 100644
index 00000000..6e169101
Binary files /dev/null and b/docs/branding/base-symbol.png differ
diff --git a/docs/branding/cover.png b/docs/branding/cover.png
index 730376d4..5523ed63 100644
Binary files a/docs/branding/cover.png and b/docs/branding/cover.png differ
diff --git a/docs/branding/logo.png b/docs/branding/logo.png
index b5e162c2..c6e7b22b 100644
Binary files a/docs/branding/logo.png and b/docs/branding/logo.png differ
diff --git a/docs/branding/logo.svg b/docs/branding/logo.svg
index 91c7df93..2c453f9e 100644
--- a/docs/branding/logo.svg
+++ b/docs/branding/logo.svg
@@ -1,20 +1,8 @@
-