📁 1. /docs/README.md
`
The GitDigital Emoji Library is the visual language of the GitDigital ecosystem.
It defines the emojis used for repositories, teams, roles, badges, workflows, and contributor‑economy systems.
This library acts as the source of truth for:
- Emoji taxonomy
- Repo prefix mapping
- Contributor badges
- Governance roles
- Protocol categories
- Design system rules
- Machine‑readable registry for bots
Every GitDigital organization, repo, and product should reference this library to ensure consistency, clarity, and contributor‑friendly UX.
Why Emojis?
Emojis provide:
- Instant cognitive recognition
- A universal visual language
- A friendly, modern contributor experience
- A consistent identity across 300+ repositories
- A foundation for gamification and contributor rewards
emoji-library/ │ ├── taxonomy/ ├── sets/ ├── mappings/ ├── design-system/ ├── badges/ ├── docs/ └── registry.json
Each folder contains a specific part of the emoji operating system.
- Choose emojis from the taxonomy or sets.
- Apply mappings to repos, teams, or workflows.
- Follow design-system rules for consistency.
- Use badges for contributor recognition.
- Reference registry.json for automation and bots.
All new emoji proposals must include:
- Category
- Purpose
- Justification
- Example usage
- Suggested mappings
Submit proposals via emoji-proposal.md template (coming soon).
Open-source, permissive, and contributor-friendly. `
`
The GitDigital Emoji System is more than decoration — it is a functional design language.
It exists to:
- Reduce cognitive load
- Improve contributor onboarding
- Make repo scanning effortless
- Reinforce GitDigital’s identity
- Support gamification and recognition
- Provide a universal visual vocabulary
Emojis act as micro‑logos.
They make the ecosystem feel alive, intuitive, and welcoming.
This philosophy guides every decision in this library. `
`
This guide explains how to integrate the emoji system into GitDigital repos, teams, bots, and workflows.
Prefix repos with emojis based on their category:
- 🧱 Infrastructure → 🧱-infra-*
- 🤖 Automation → 🤖-bot-*
- 🔐 Security → 🔐-sec-*
- 📚 Documentation → 📚-docs-*
- 🧪 Experimental → 🧪-exp-*
Teams should use emojis that reflect their domain:
- 🛡 Governance Team
- 🧙 Protocol Architects
- 🛠 Builder Team
- 🤖 Automation Team
Use emojis to mark sections:
- 📘 Overview
- 🧩 Components
- ⚙️ Setup
- 🧪 Testing
- 🛡 Security Notes
Bots consume registry.json to:
- Validate repo naming
- Enforce emoji usage
- Generate badges
- Apply contributor XP
- Tag PRs with emoji categories
Emojis should appear in:
- Repo titles
- Issue templates
- PR templates
- Wiki navigation
- Contributor profiles
`
`
This document defines how emojis are used in naming across the GitDigital ecosystem.
Format: --
- 🧱-infra-core
- 🤖-bot-sync-engine
- 🔐-sec-audit-runner
- 📚-docs-style-guide
- 🧪-exp-prototype-01
Format:
- 🛡 Governance Team
- 🧙 Protocol Architects
- 🛠 Builder Squad
- 🤖 Automation Crew
Format:
- 🧙 Expert Architect
- 🦾 Automation Master
- 🛠 Builder Tier 2
- 🧭 Navigator Maintainer
Format:
- 🔁 Sync Repos
- ⚡ Fast Merge
- 🛡 Security Scan `
`
This file defines the core emoji categories used across the GitDigital ecosystem.
🧱 Infrastructure
⚙️ Systems
🛠 Tools
🧩 Modules
📦 Packages
🤖 Automation
🔁 Sync
⚡ Fast Actions
🧠 Smart Logic
🔐 Security
🛡 Governance
📜 Compliance
🧾 Audits
🧬 Core Protocol
🔗 On‑chain
🌐 API
📡 Gateway
🛰 Network
📚 Docs
📝 Notes
📖 Guides
🧠 Knowledge
🥇 Gold
🥈 Silver
🥉 Bronze
🧙 Expert
🛠 Builder
🧭 Navigator
🐣 New Contributor
🦾 Automation Master
🧪 Lab
🚧 WIP
🔥 Hot
`
`
Defines emojis for protocol layers.
- 🧬 Core Protocol
- 🔗 On‑chain Logic
- 🌐 API Layer
- 📡 Gateway Layer
- 🛰 Network Layer
- 🧩 Modules
- 🛠 Extensions
`
`
- 🛡 Governance Team
- 🧙 Protocol Architects
- 🛠 Builder Team
- 🤖 Automation Team
- 📚 Documentation Team
- 🧪 Research & Lab Team
`
`
- 🧭 Navigator (Maintainer)
- 🛠 Builder
- 🧙 Architect
- 🛡 Guardian (Security)
- 🦾 Automation Specialist
- 🐣 New Contributor
`
`
XP Tiers
🐣 Beginner
🛠 Builder
🧙 Expert
🦾 Automation Master
🧠 Architect
🔥 Streak
⚡ Fast Merge
🛡 Governance Guardian
🧩 Modular Master
📚 Documentation Hero
`
`
- 🛠 Builder Lane
- 🧙 Expert Lane
- 🧭 Maintainer Lane
- 🦾 Automation Lane
- 📚 Documentation Lane
- 🧪 Research Lane
`
`
- 🧱 Infrastructure
- 🤖 Automation
- 🔐 Security
- 📚 Documentation
- 🧪 Experimental
- 🧩 Modules
- 🛠 Tools
`
`
- Emojis must be consistent with taxonomy.
- New emojis require proposal + approval.
- Repo prefixes must match category.
- Badges must use approved emoji sets.
- Bots enforce naming and usage.
`
`
This is the primary emoji set used across GitDigital.
🧱 🤖 🔐 📚 🧪 🛠 🧙 🧭 🦾 🧬 🔗 🌐 📡 🛰
`
`
Used for optional or specialized contexts.
🔥
`
`
Used for events, holidays, and special releases.
🎉 🎁 🎃 🎄 ✨
`
`
Used for prototypes, labs, and early-stage ideas.
🧪 🚧 🔥
`
`
🧱 → infra-*
🤖 → bot-*
🔐 → sec-*
📚 → docs-*
🧪 → exp-*
🛠 → tools-*
🧩 → module-*
`
`
GitDigital Products → 🧱
GitDigital Solana → 🔗
OpenGrantStack → 🎯
Compliance Registry → 🔐
Automation Suite → 🤖
`
`
Proof-of-Contribution Protocol → 🧬
Compliance Registry → 🔐
RepoSync AI → 🤖
AutoDocs Generator → 📚
Governance Validator → 🛡
`
`
🔁 Repo Sync
⚡ Fast Merge
🛡 Security Scan
📚 Docs Build
🧪 Test Suite
`
`
🤖 Automation
🔁 Sync
⚡ Speed
🧠 Smart Logic
🛡 Safety Checks
`
`
- Use emojis consistently.
- Use only approved emojis.
- Place emojis at the start of names.
- Avoid mixing categories.
- Keep meanings stable over time.
`
`
- Use emojis as prefixes
- Use emojis to clarify meaning
- Use emojis in docs and workflows
- Use random emojis
- Change meanings without approval
- Overload names with multiple emojis
`
`
- Always pair emojis with text
- Avoid relying on emoji alone
- Ensure screen readers can interpret names
`
`
Recommended UI color pairings for emoji categories.
🧱 Infrastructure → Gray / Blue
🤖 Automation → Purple / Neon
🔐 Security → Red / Black
📚 Docs → Blue / White
🧪 Experimental → Yellow / Orange
`
`
Use clean, readable fonts with emojis.
Recommended:
- Inter
- Roboto
- SF Pro
- Open Sans
`
`
- 🐣 New Contributor
- 🛠 Builder
- 🧙 Expert
- 🧭 Maintainer
- 🦾 Automation Master
`
`
Tier 1 → 🐣
Tier 2 → 🛠
Tier 3 → 🧙
Tier 4 → 🦾
Tier 5 → 🧠
`
`
🔥 Streak
⚡ Fast Merge
🛡 Governance Guardian
🧩 Modular Master
📚 Documentation Hero
`
`
🛡 Security Guardian
🧭 Navigator
🧙 Protocol Architect
`
{ "categories": { "infrastructure": "🧱", "automation": "🤖", "security": "🔐", "docs": "📚", "experimental": "🧪" }, "badges": { "builder": "🛠", "expert": "🧙", "automation_master": "🦾" }, "repo_prefixes": { "infra": "🧱", "bot": "🤖", "sec": "🔐", "docs": "📚", "exp": "🧪" } }