<p align="center">
<img src="./logo/graphitepdf-logo-oss.svg" alt="GraphitePDF logo" width="520" />
</p>
<p align="center">
<strong>A modern brand system for GraphitePDF — a Rust-native PDF rendering engine focused on precision, performance, and visual clarity.</strong>
</p>
<p align="center">
<img alt="GraphitePDF" src="https://img.shields.io/badge/graphitepdf-brand_system-1E1E1C?style=for-the-badge&labelColor=060604&color=D4581A" />
<img alt="Design Language" src="https://img.shields.io/badge/design-industrial_%7C_precise_%7C_modern-C4C4C0?style=for-the-badge&labelColor=2E2E2C&color=3A3A38" />
<img alt="Typography" src="https://img.shields.io/badge/type-Space_Grotesk-F58040?style=for-the-badge&labelColor=2E2E2C&color=7C2806" />
</p>
---
## Overview
GraphitePDF is designed to feel like a serious systems tool:
- precise without feeling sterile
- modern without visual excess
- expressive while remaining documentation-first
- unmistakably Rust-native in tone and craftsmanship
The visual language combines deep graphite neutrals, focused rust-orange accents, and geometric composition built for technical products and developer tooling.
---
## Color System
<p>
<img alt="Graphite 950" src="https://img.shields.io/badge/Graphite_950-060604?style=for-the-badge&labelColor=060604&color=060604" />
<img alt="Graphite 900" src="https://img.shields.io/badge/Graphite_900-1E1E1C?style=for-the-badge&labelColor=1E1E1C&color=1E1E1C" />
<img alt="Graphite 850" src="https://img.shields.io/badge/Graphite_850-2E2E2C?style=for-the-badge&labelColor=2E2E2C&color=2E2E2C" />
<img alt="Mist 300" src="https://img.shields.io/badge/Mist_300-C4C4C0?style=for-the-badge&labelColor=C4C4C0&color=C4C4C0" />
</p>
<p>
<img alt="Rust Glow 400" src="https://img.shields.io/badge/Rust_Glow_400-F58040?style=for-the-badge&labelColor=F58040&color=F58040" />
<img alt="Rust Ember 500" src="https://img.shields.io/badge/Rust_Ember_500-D4581A?style=for-the-badge&labelColor=D4581A&color=D4581A" />
<img alt="Rust Ember 600" src="https://img.shields.io/badge/Rust_Ember_600-C84C14?style=for-the-badge&labelColor=C84C14&color=C84C14" />
<img alt="Rust Oxide 700" src="https://img.shields.io/badge/Rust_Oxide_700-7C2806?style=for-the-badge&labelColor=7C2806&color=7C2806" />
</p>
---
## Repository Structure
| Brand guidelines | `design-palette.md`, `visual-identity.md` | Defines composition, tone, spacing, and visual usage principles |
| Design tokens | `tokens.json`, `tokens.yaml`, `colors.css` | Shared color and typography primitives across tooling |
| Logo system | `logo/graphitepdf-logo-oss.svg`, `mark/graphitepdf-mark.svg` | Primary wordmark and compact brand mark |
| Product assets | `icon/graphitepdf-favicon.svg`, `icon/graphitepdf-app-icon.svg` | Optimized assets for browsers, apps, and small surfaces |
---
## Recommended Usage
| README headers and documentation landing pages | `logo/graphitepdf-logo-oss.svg` |
| Avatars, favicons, compact placements | `mark/graphitepdf-mark.svg` |
| UI styling and implementation | `colors.css`, `tokens.json`, `tokens.yaml` |
| Marketing surfaces and future websites | Full token system and visual identity guides |
---
## Design Principles
GraphitePDF visuals should consistently communicate:
- reliability
- technical precision
- systems-level craftsmanship
- modern open-source quality
Preferred direction:
- let graphite neutrals dominate layouts
- use rust-orange intentionally as a focal accent
- prioritize spacing, structure, and strong contrast
- keep visuals geometric, minimal, and documentation-oriented
---
## Quick Start
```text
Primary logo: brand/logo/graphitepdf-logo-oss.svg
Standalone mark: brand/mark/graphitepdf-mark.svg
Palette tokens: brand/tokens.json
CSS variables: brand/colors.css
Usage guidelines: brand/visual-identity.md