Skip to main content
solution

Worked Answer: Enterprise Design System

Prompt​

Design a frontend architecture for an enterprise design system used by multiple product teams, brands, and accessibility-sensitive workflows.

Clarify​

Ask:

  • How many apps and teams consume it?
  • Is multi-brand or white-label required?
  • Which components are highest-risk?
  • What accessibility standard and verification process apply?
  • How are breaking changes shipped?
  • What migration support exists?

Architecture overview​

Package strategy​

PackageOwns
tokenssemantic design decisions and theme mappings
primitivesbehavior, keyboard, ARIA, state machines
componentsstyled accessible components
recipesrecommended compositions for common workflows
product wrappersdomain-specific data and naming

API principles​

  • component APIs expose product intent, not CSS internals
  • accessibility behavior is enforced through API and tests
  • async/loading/error/disabled/invalid states are first-class
  • product-specific behavior lives in wrappers
  • breaking changes include migration path

Governance​

ConcernControl
adoptionscorecard by app/team
contributiontriage process and API review
accessibilitycomponent contracts and manual checks
versioningsemver, migration guides, codemods where possible
exceptionsowner, reason, expiry, replacement path

Failure modes​

FailurePrevention
teams fork componentsmissing pattern triage and recipes
tokens become raw brand aliasessemantic taxonomy review
dialog focus regressesprimitive keyboard/focus fixtures
migration stallscodemods, office hours, deprecation window
GenUI produces invalid combinationsregistry-safe schemas

Strong close​

I would launch the platform around a few high-leverage primitives, not a huge visual catalog. Success is measured by adoption, reduced forks, fewer accessibility regressions, faster migrations, and product teams choosing the design system because it makes correct work easier.