Skip to content

[docs] Canonical design system package v1.1 + design assets home - #445

Open
explosivebit wants to merge 1 commit into
devfrom
docs/design-system-package
Open

explosivebit wants to merge 1 commit into
devfrom
docs/design-system-package

Conversation

@explosivebit

Copy link
Copy Markdown
Contributor

What

Adds design/ as the single home for all ForgePlan design assets, anchored by the unified design system package v1.1:

  • design/forgeplan-design-system/ — canonical docs (RU/EN, incl. §8 merge rules + consumer migration mappings), tokens.css (base + stepped neutrals), tokens.graph.css (graph/map module ported from forgeplan-web, rebased on the canonical palette), tokens.json 1.1.0, self-contained components.html, A4 cheatsheets, brand assets
  • design/visual-guides/ — 11 approved methodology sheets
  • design/command-map/ — command map (portrait + 16:9)
  • AGENTS.md — design-system pointer section (agents consult it for any UI/branding work), repo map + see-also updates

Why

One canonical, portable design system consumable by any surface (website, forgeplan-web, Pencil, guides, slides) and by external tools (e.g. Claude Design) straight from the repo. The v1.1 merge absorbed the best of forgeplan-web (neutral ramps, graph tokens) while rejecting its divergences (legacy accent #FF5A1F, shadows, off-canon fonts) — all recorded with per-consumer migration tables.

Notes

  • PNGs force-added past the root *.png ignore rule — they are package content, not screenshots.
  • The Pencil source (forgeplan-site.pen) ships separately later — it currently mixes in personal CV frames pending a file split.
  • Docs-only branch: no code paths touched.

🤖 Generated with Claude Code

…s home

Establish design/ as the single home for all ForgePlan design assets:

- forgeplan-design-system/: the unified v1.1 package - canonical docs
  (RU/EN incl. merge rules and consumer migration mappings), tokens.css
  (base + stepped neutrals ported from forgeplan-web), tokens.graph.css
  (graph/map module: relation edges, canvas strokes, composed-map zones,
  dot-grid), tokens.json 1.1.0 machine contract, self-contained
  components.html reference, A4 cheatsheets, brand-assets (logos,
  favicons, icons)
- visual-guides/: 11 approved methodology sheets (design-system
  foundation, quick start, 9 thematic 16:9)
- command-map/: command map by scenario (portrait + 16:9)
- source-materials/ + MANIFEST.md + README.md

AGENTS.md: add the design-system section (single source of truth
pointer, key invariants, reuse rule), design/ in the repo map, see-also
link. PNGs force-added past the root *.png ignore rule - they are
package content here, not screenshots.

The Pencil source (forgeplan-site.pen) ships separately later: it
currently mixes in personal CV frames pending a file split.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant