Design with Milpa · Unit 3 of 3

From local candidate to public pattern

Academy is a laboratory: it can invent an ac-* composition. Design decides whether it survives as mui-* when there is a real case, it shows up at least twice, it supports a contract, it passes gates and it's consumed without hacks.

Intermediate35 min

By the end, you'll be able to

Apply the promotion rule
Gather evidence before generalizing

Understand

See

See the artifacts precedent

The cluster started as a local composition and today is consumed from @milpa/design@0.9.0.

Open artifact

Do

Run the practice in your checkout and keep the output as evidence.

Read how to contribute

Verify

Show that you can apply the unit. Progress only advances once you pass the assessment.

Criteria assessed

Require two real uses or strong evidence before promoting.
Describe the candidate through anatomy, states, a11y and motion.

Graded assessment

Solve the 3 scenarios. This unit requires 3 of 3 correct answers.

0 attempts

Question 1 of 3ac-knowledge-map looks good and works in a single lesson, but there is no other use yet and no strong evidence of repetition. What should happen?

Promote it to mui-* right away; the visual polish demonstrates generality.Keep it as an ac-* candidate, observe the real case and gather evidence before generalizing.Move it into foundations to avoid deciding whether it's a pattern or a composition.

Question 2 of 3A composition appears on three screens and has a contract, but can't be operated with the keyboard and its animation ignores prefers-reduced-motion. Is it ready for promotion?

Yes; repetition and a contract replace the accessibility gates.Yes, if it's published as experimental without running npm test.No; it must meet the quality floor and pass keyboard, focus, a11y, motion and the remaining gates before it enters.

Question 3 of 3A candidate has two real uses, a contract and green gates, but each consumer must copy a private file and apply internal selectors because the package doesn't export it. What is missing?

Nothing; consumption hacks are acceptable as long as they are documented.Clean consumption from a published version: export the piece and confirm it works without patches or access to private internals.A fourth screen; the package can only export patterns that have four uses.

Grading validates answers in this browser; it doesn't certify identity.

Primary sources

Design

Content verified: 2026-07-10

By the end, you'll be able to

1Understand

2See

3Do

4Verify

Primary sources

Understand

See

Do

Verify