Skip to content

chore: add design-sync setup for the Aragon App Design System (claude.ai/design)#1243

Open
evanaronson wants to merge 2 commits into
mainfrom
chore/design-sync
Open

chore: add design-sync setup for the Aragon App Design System (claude.ai/design)#1243
evanaronson wants to merge 2 commits into
mainfrom
chore/design-sync

Conversation

@evanaronson

Copy link
Copy Markdown
Contributor

Description

Adds the durable inputs for syncing this repo's design system to the Aragon App Design System project on claude.ai/design, so any teammate (or CI) can re-sync with one command after a kit or app change.

What's included (tooling only — no app runtime changes)

  • .design-sync/config.json — converter config: project pin, component source map, card-mode overrides
  • .design-sync/app-entry.ts + process-shim.ts — curated bundle entry for the app's shared components (wizards, page scaffolding, forms, presentational); exclusion reasons documented inline
  • .design-sync/build-css.mjs + tailwind-entry.css — compiles the design-system CSS from source, mirroring layoutRoot.css (the kit's shipped build.css is corrupted by its minifier — see NOTES)
  • .design-sync/previews/ — 103 authored, screenshot-verified component previews (112 components synced total)
  • .design-sync/conventions.md — standing instructions inlined into the design agent's prompt (token vocabulary, provider stack, wizard/page patterns)
  • .design-sync/NOTES.md — operational playbook: wiring decisions, upstream bug reports for the gov-ui-kit team, re-sync risks
  • .gitignore — excludes the machine-state/scratch dirs (.ds-sync/, ds-bundle/, caches)
  • Changeset (patch, @aragon/app)

Upstream findings worth routing to the gov-ui-kit team

  1. Published build.css (v2.8.1) has minifier-merged selector lists giving children of ~60 md:*/~140 2xl:* utilities spurious borders — invisible to consumers that compile from source, broken for anyone using the precompiled file.
  2. InputNumber/InputNumberMax pass suffix/prefix unescaped into their imask pattern (suffix="days" renders d_ys).

Design project: https://claude.ai/design/p/2f22a679-7abb-4283-9f39-e28a63dba83b

🤖 Generated with Claude Code

….ai/design)

Converter config, CSS-from-source pipeline, app-component bundle entry,
103 verified component previews, conventions header, and re-sync notes
for the Claude Design project. Tooling only — no app runtime changes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@evanaronson
evanaronson requested a review from a team as a code owner July 18, 2026 10:44
@github-actions

github-actions Bot commented Jul 18, 2026

Copy link
Copy Markdown

🚀 Preview Deployment: View Here

Updated the design-sync setup to facilitate future re-syncs, including configuration for the converter and CSS pipeline.

Signed-off-by: Evan Aronson <93671071+evanaronson@users.noreply.github.com>
@github-actions

github-actions Bot commented Jul 18, 2026

Copy link
Copy Markdown

E2E results (preview)

Smoke

Base URL https://app-next-o3tys37ya-aragon-app.vercel.app
Suite smoke
Playwright result ❌ failed
Summary 80 passed, 1 failed, 1 skipped
HTML report View report
GitHub job ✅ completed

View run #4577

@evanaronson

Copy link
Copy Markdown
Contributor Author

@aragon/app-team-frontend take a look here: https://support.claude.com/en/articles/14604416-get-started-with-claude-design

There are also some UI kit bugs found along the way that design-sync stores in a NOTES.md file.

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