Skip to content

feat(brand): apply "Cortex" design system across web, desktop, and repo#29

Merged
HBarefoot merged 1 commit into
mainfrom
feat/cortex-design-system
Jun 7, 2026
Merged

feat(brand): apply "Cortex" design system across web, desktop, and repo#29
HBarefoot merged 1 commit into
mainfrom
feat/cortex-design-system

Conversation

@HBarefoot

Copy link
Copy Markdown
Owner

Applies the finalized Engram "Cortex" design system and the "Bloom" dodecahedron logo across every surface — web dashboard, macOS desktop app, and repo brand — replacing the ad-hoc sky-blue / Inter styling. Source of truth was the design-system artifact Henry produced.

Highlights

Brand assets (assets/brand/)

  • Canonical SVG sources: engram-mark.svg (flat accent) + engram-icon.svg (gradient squircle tile).
  • scripts/generate-brand.js renders the macOS icon set, .icns, tray icons, favicons, and the 180px README logo from those SVGs (@resvg/resvg-js + sips/iconutil). Re-run after editing the SVGs.
  • Fonts self-hosted (Space Grotesk, IBM Plex Sans/Mono) under each app's public/fonts/ — preserves the zero-network/offline guarantee and removes the Google Fonts <link>s the desktop app shipped.

Web dashboard (dashboard/)

  • New sidebar + top brand-bar shell (replaces the top-tab nav).
  • design-system.css tokens + component classes; Tailwind mapped to the CSS vars; single dark theme.
  • Category colors centralized in utils/categories.js; recharts themed dark.

Desktop (desktop/)

  • Cortex tokens in globals.css (dark-only); Tailwind gray→neutrals and blue/indigo/sky/cyan→accent/trace remap so existing utility classes render on-brand.
  • New Dock + menu-bar icons; chart colors deduped in lib/categories.ts.
  • Fixes tauri.conf.json version drift 1.4.6 → 1.5.3.

Docs: adds DESIGN_SYSTEM.md; documents the brand workflow in CONTRIBUTING.md; cross-references CLAUDE.md.

Notes

  • Trace direction intentionally not shipped (tokens left :root-only so a future toggle is pure CSS).
  • No backend/API/MCP/schema changes — presentation only. Category values unchanged; only their colors are centralized.

Verification

  • dashboard + desktop build
  • npm run lint — 0 errors
  • npm run test:run — 226/226 pass
  • ✅ No external font/CDN references in either app
  • ✅ Dashboard shell render confirmed live (browser)
  • ⚠️ Desktop verified by build only — recommend a tauri dev pass to eyeball the Dock/tray icons and in-window theme.

🤖 Generated with Claude Code

@HBarefoot

Copy link
Copy Markdown
Owner Author

recheck

Implements the finalized Engram design system (Cortex direction) and the
"Bloom" dodecahedron logo across every surface, replacing the ad-hoc
sky-blue/Inter styling.

Brand assets
- Canonical SVG sources in assets/brand/ (engram-mark flat, engram-icon
  gradient tile); scripts/generate-brand.js renders the macOS icon set,
  .icns, tray icons, favicons, and README logo via @resvg/resvg-js.
- Self-host all fonts (Space Grotesk, IBM Plex Sans/Mono) under
  public/fonts/ — preserves the zero-network/offline guarantee; removes
  the Google Fonts links the desktop app shipped.

Web dashboard
- New sidebar + top brand-bar shell (replaces top-tab nav).
- design-system.css tokens + component classes; Tailwind mapped to the
  CSS vars; single dark theme.
- Category colors centralized in utils/categories.js; recharts themed.

Desktop
- Cortex tokens in globals.css (dark-only); Tailwind gray->neutrals and
  blue/indigo/sky/cyan->accent/trace remap so existing classes are on-brand.
- New Dock + menu-bar icons; categories deduped in lib/categories.ts.
- Fix tauri.conf.json version drift 1.4.6 -> 1.5.3.

Docs: add DESIGN_SYSTEM.md; document the brand workflow in CONTRIBUTING;
cross-reference CLAUDE.md.

Verified: dashboard + desktop build, lint 0 errors, 226 tests pass, no
external font/CDN references.
@HBarefoot HBarefoot force-pushed the feat/cortex-design-system branch from 609159a to 0feb45f Compare June 7, 2026 18:40
@HBarefoot

Copy link
Copy Markdown
Owner Author

recheck

@HBarefoot HBarefoot merged commit 6e671a1 into main Jun 7, 2026
5 of 6 checks passed
@github-actions github-actions Bot locked and limited conversation to collaborators Jun 7, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant