Mara logo

Component Library

A shared, versioned set of reusable interface components that designers and engineers build from instead of recreating elements per screen.

Deliverables & Artifacts

A component library is the implemented half of a design system: actual buttons, inputs, tables and modals that exist in code and in the design file, with the same names and the same states in both. Its value is not visual consistency — that is a side effect — but the elimination of decisions. A component that already handles loading, error, empty and disabled states is a decision nobody has to make twice.

Libraries decay when the design file and the codebase drift, which happens within a couple of releases unless one of them is treated as the source of truth. The usual failure is a beautiful Figma library nobody in engineering uses because the props do not match. Naming parity and shared design tokens matter more than component count.

In practice

A clinic ERP shipped three different table components across scheduling, billing and records, each with its own sort and empty state. Before: a new module meant a new table. After consolidating to one table component with documented props, a new module reused it in a day. The catch — the merge forced two teams to agree on pagination behaviour they had happily disagreed about for a year.

Learn more

You may ask

Frequently Asked Questions

Is a component library the same as a design system?

No. The library is the components; the system also includes tokens, usage rules, accessibility standards, contribution process and documentation. A library without those is a folder of components that slowly diverges.

How many components should we start with?

Start with the ones already duplicated across screens — typically buttons, inputs, selects, one table and one modal. Building components speculatively is how libraries end up with forty entries and eight in use.

Related terms

All terms

Let's talk about your product.

Happy to look at what you're building and say where design would move the needle.

Contact Us