3/9

Design system documentation

City of Montréal

Documented the City of Montréal's design system with clear UX guidance, increasing adoption by internal teams and external suppliers.

Challenge

The City of Montréal runs dozens of digital services built by internal departments and external suppliers. Its design system was underused and needed clearer guidance.

My contribution

I structured and wrote practical documentation on UX best practices, components and accessibility, with examples, step-by-step guides and clear dos and don'ts, linking design guidance to the Figma library and the Angular components.

Results

Internal teams and suppliers adopted the design system, its Figma library and Angular components more consistently.

Samples of the design system documentation

Design system available online at zeroheight

Buttons: primary and secondary, with their states
Text field: states and anatomy of a form element
Text field: placeholders, required fields and error messages
Info tiles: vertical and horizontal