Skip to content

Commit 310fb59

Browse files
committed
Add technical diagram design system with Blueprint Authority palette
- Created comprehensive design documentation (docs/plans/2025-10-30-diagram-design-system.md) - Added diagram CSS variables to global.css @theme block (Blueprint Authority palette) - Updated CLAUDE.md with diagram guidelines reference and Mermaid classDef standards - Defined semantic node types: atomic (amber), derived (blue), system (emerald) - WCAG AA compliant (4.5:1 minimum, most achieve AAA 7:1+) - Hybrid implementation approach: Mermaid for standard flows, custom SVG for hero diagrams
1 parent fb8f68e commit 310fb59

File tree

3 files changed

+716
-0
lines changed

3 files changed

+716
-0
lines changed

CLAUDE.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -382,6 +382,32 @@ if (!prefersReducedMotion()) {
382382

383383
Tailwind 4: Theme variables are global. Use responsive utility variants (`text-xl md:text-2xl`, `p-4 md:p-6`) in markup, not custom `@media` around tokens.
384384

385+
### Technical Diagrams
386+
387+
**Design System**: See `docs/plans/2025-10-30-diagram-design-system.md` for complete specifications
388+
**CSS Variables**: Added to `src/styles/global.css` @theme block (lines 102-165)
389+
390+
**Quick Reference**:
391+
- **Palette**: Blueprint Authority (limestone cream canvas, Egyptian gold/blue accents)
392+
- **Node Types**: Atomic (amber), Derived (blue), System (emerald), Default (cream)
393+
- **Typography**: Inter 14px titles, 12px labels, 11px annotations
394+
- **Accessibility**: WCAG AA minimum (4.5:1 text), AAA for node backgrounds (7:1+)
395+
- **Implementation**: Hybrid approach - Mermaid for standard flows, custom SVG for hero diagrams
396+
397+
**Mermaid classDef Standards** (copy-paste into diagrams):
398+
```mermaid
399+
classDef atomic fill:#FEF3C7,stroke:#F59E0B,stroke-width:2px,color:#78350F
400+
classDef derived fill:#DBEAFE,stroke:#0EA5E9,stroke-width:2px,color:#0C4A6E
401+
classDef system fill:#D1FAE5,stroke:#10B981,stroke-width:2px,color:#065F46
402+
```
403+
404+
**Accessibility Requirements**:
405+
- [ ] Wrap diagrams in `<figure>` with `<figcaption>` description
406+
- [ ] Add `<details>` with text alternative for relationships
407+
- [ ] Test with screen reader (VoiceOver, NVDA)
408+
- [ ] Verify all text meets 4.5:1 contrast minimum
409+
- [ ] Respect `prefers-reduced-motion` (disable animations)
410+
385411
---
386412

387413
## Done = Week 2: Shareable + animation + responsive | Month 1: Case study + bio/resume

0 commit comments

Comments
 (0)