Brand Ecosystem
The Zenzic Brand Ecosystem defines how Zenzic is represented across open-source communities, CI/CD integrations, and documentation landscapes.
Our Posture
Zenzic is an authoritative, silent, and rigorous entity. Our branding reflects the philosophy of the tool itself:
- Surgical precision: We prefer exact, technical language over vague marketing buzzwords.
- Zero noise: Just like Zenzic returns exit code
0silently when a test passes, our visual and written communication avoids unnecessary clutter. - Deterministic tone: Behavior is stated in precise, verifiable terms.
The Zenzic Lexicon
Consistency is the foundation of quality. When writing about Zenzic across any medium, adhere to the following naming conventions:
- Zenzic: The software suite. Always written with a capital Z.
zenzic: The CLI command. Always written in lowercase and formatted as code.- The credential scanner: Our security scanning engine. Always capitalized.
- Reference Integrity Check: Our primary deterministic validation algorithm.
What we are not: Zenzic is an engine-agnostic quality suite. Never refer to Zenzic as simply a "plugin," a "MkDocs utility," or a "Markdown viewer."
Visual Identity: The Zenzic Artifact
The historical term zenzic refers to the mathematical square of a number (). It is fundamentally tied to root systems and dimensional scaling.
Our iconography directly inherits from this heritage. The visual artifact of Zenzic represents a solid root foundation holding complex mathematical structures in balance. It stands for logic dominating chaos across interconnected systems.
When positioning our logos or visual elements in presentations or documentation:
- Provide adequate whitespace around the artifact. Do not crowd it.
- Maintain sharp, high-contrast boundaries.
- Avoid skewing, rotating, or applying blur effects that disrupt its mathematical geometry.
Official Badges
The two static SVG badges are included in the Brand Kit for offline or enterprise deployments
that cannot reach img.shields.io:
| Badge | Preview | Use |
|---|---|---|
| Audit Badge |  | Binary gate: passing / failing |
| Score |  | Quality metric: 0–100 |
For dynamic Shields.io variants and CI/CD wiring, see the Badges guide.
The Bimodal Palette
Zenzic adapts its visual frequency to the ambient light of the engineer's environment. The Indigo that guides you through a midnight audit must be different from the Indigo that greets you on a bright conference screen. This is not inconsistency — it is ergonomic design.
| Mode | Token | Hex | Contrast Ratio | WCAG Level |
|---|---|---|---|---|
| Light | indigo-700 | #4338ca | 7.9:1 on white | AAA |
| Dark | indigo-300 | #a8b3fb | 9.9:1 on #09090b | AAA |
| Borders (Light) | indigo-200 | #c7d2fe | structural | — |
| Borders (Dark) | indigo-500/20 | #6366f1 at 20% | structural | — |
Usage Specification: The Zenzic Indigo color is a semantic indicator reserved for structural components (e.g., Navbar, Footer, Scanner Output). In Light Mode, it ensures a contrast ratio >4.5:1 for primary text. In Dark Mode, contrast levels are recalibrated for extended readability. The backdrop-blur layer beneath ZenzicOutput panels reduces border intensity to prevent visual fatigue (WCAG 2.1 AA compliance).
Brand System Reference
The interactive Brand System document shows the full Color Palette, logomark variants, social card, typography specimens, and usage laws in a single precision-formatted page:
Download
The complete Zenzic brand asset package (SVG + PNG) is attached to every GitHub release as brand-kit.zip.
Download from the stable GitHub Releases page,
then open the latest release and fetch brand-kit.zip from its Assets section.
Integration Protocols
If you are developing third-party integrations, CI/CD actions, or writing research papers incorporating Zenzic, you are part of our ecosystem.
- GitHub Actions & Badges: Use our official Zenzic badges to demonstrate you are maintaining a 100% Quality Score on your repositories.
- Press & Media Coverage: For inquiries regarding custom art assets, interviews on static analysis architecture, or technical deep-dives, route requests to
[email protected]. - Endorsements: Always ensure that any graphical association accurately implies integration, not exclusive ownership or dependency. Zenzic is and will permanently remain Open Source and universally adaptable.