Creative & DesignContent Creator

Design system overview: a page people can read without a tool

A design system is the shared set of rules, components and examples that keep product screens consistent across a team. For a shareable page, the job is to explain the principles, the core components and when to use each one, so that a new designer or stakeholder can understand the system without opening the design files. Keep the working source in your design and code tools, and let the page be the readable summary of it.

Format notes

Describe the system in the order people use it

Start with principles, not components

Two or three principles tell a reader why the components look the way they do. Put them first, so each component rule reads as a consequence of a principle rather than an arbitrary instruction.

Write each component as a short rule set

For every core component, state when to use it, when not to, the states it has and its content limits. Name where the full component file lives in your design tool or repository, so readers know where to check.

Explain tokens in words, with exact values

Name the color roles, the type scale and the spacing steps, each with its value and its purpose. Content Creator is not a design tool and does not generate or sync tokens, so copy values from the source file carefully and date the copy.

Put accessibility rules beside the component

Add the contrast rule, the minimum target size and the focus behavior that each component follows. A reader should not have to hunt for these in a separate document.

Weak and strong wording

Turn a consistency goal into a rule someone can check in review

Weak: Buttons should look consistent.

Strong: One primary button per section of a screen. Use the secondary style for cancel actions. Never place two primary buttons side by side.

Consistent describes a result. A count and a pairing rule can be checked in a design review.

Weak: Use the right colors for errors.

Strong: Error text uses the error role color on the surface color and must pass the contrast rule. Never use red as the only signal; add an icon and a message.

The strong version names the role, the check and the second signal, which is what an accessibility review looks for.

Weak: The date picker is flexible.

Strong: The [component name] accepts typed input and a selection from a list, and both must produce the same value. Do not use it for [use case].

Flexible tells a builder nothing about what the component must do in each path.

Weak: Ask design before changing a component.

Strong: Propose changes to a shared component in the review channel named in the contribution guide, with the screens it affects. Changes to a token need sign-off from [role].

A named channel and an approver turn a rule into a process people can follow.

Quality checklist

Check the overview against the live source

  • The page opens with two or three principles and names where the full rules live.
  • Each core component has a use rule, a do-not-use rule and its list of states.
  • Color, type and spacing values are copied exactly from the source file and dated.
  • Each color role used for text names the contrast rule it must meet.
  • No component is described as available in product unless it has shipped and been checked.
  • The owners and the change process are named, with a place to propose a change.
  • A reader who has never opened the design file can explain one component's rule back in their own words.
Share the finished page

Match the audience to the link

Team link

Share the page with product, design and engineering through a team link. Ask engineers and designers to compare it with the live source before anyone uses it as guidance.

Public link

Use a public link for partners, contractors or an outside design review. Remove internal approval routes and component names that are not released yet.

Copy link

Copy the link into onboarding notes for new designers and engineers. Confirm the link points to the current approved version before you send it.

Mistakes to avoid

Four ways an overview drifts from the system

Calling the page the source of truth

The page summarizes the system. The design file and the code repository hold the components. When the page and those files disagree, the page is the document that is wrong.

Describing components nobody has built

A component listed as if it exists will be requested and then missed. Mark planned components as planned, with the review date.

Color roles without values

A role called primary means little to an engineer without its value and its use. Give each role its value, its purpose and the places it appears.

Leaving out the states

Hover, focus, disabled and error states are where many inconsistencies appear. Describe each state for every core component, even when the state is simple.

Frequently asked questions

Can this page pull in my Figma design system?

No. Content Creator does not connect to Figma or to a code repository. Copy the values and rules you need into the page, and name where the source files live so readers know where to check.

Is there a design system template I can download?

This page does not provide a template file. Use the outline above to write your own overview: principles, core components, token values, accessibility rules and the change process. A template with your real components is more useful than a generic one.

What do design system examples look like?

Public design systems from established product teams show how an overview can be organized. Study their structure, then write your own rules, values and component names. Do not copy another team's component specifications or brand assets.

How long should a design system overview be?

Long enough for a new designer to explain the core components and their rules, and short enough to read in one sitting. If it runs longer, move component detail into the design file and keep a summary on the page.

Browse by category

More visuals in Creative & Design

How to build it

  1. Follow the eight-step wizard: type, assets and description, images, branding, contact and call to action, Atty Suggestions, blueprint, and generate. Atty generates one HTML page in the background. Review it, then publish and share the page link or download the HTML file.

Attain OS BETA