Helsinki Design System (HDS)

Helsinki Design System (HDS)

Background

The City of Helsinki offers thousands of digital and non-digital services for different purposes. The common goal is to meet the needs of the users.

For example, citizens of Helsinki need to:

Apply to daycare
Visit site
Find events in Helsinki
See events
Rent a berth for a boat
Berth search
Become a Culture Kid
Learn more
Visit the official site
Visit hel.fi
Buy a resident parking permit
See how

The Helsinki Design System was created to unify the user experience

May 26, 2020
HDS Alpha
Setting up the processes after a proof of concept.
October 29, 2020
HDS Beta
Providing a foundation of the library components.
May 3, 2021
HDS 1.0.0
Official support, continuous development, a city-wide acknowledged tool.
June 27, 2022
HDS 2.0.0
Design update for the entire component library.
Coming soon
HDS 3.0.0
New navigation components and a navigation pattern.

Goals

The Helsinki Design System helps teams work and communicate more efficiently and supports the City of Helsinki in fulfilling its vision in the digital world.

HDS is part of the city strategy

HDS is a tool for building the digital presence and brand of the City of Helsinki. HDS supports creating equal and functional city services.

Digitalisation is a key enabler of city services and the new city strategy. The city strategy emphasises creating accessible services for all citizens, regardless of the time and place. HDS provides building blocks for such services and enables projects to solve actual user problems instead of rebuilding essential elements. HDS has accessibility baked in so that the end user projects using the ready components are one step closer to accessible services.

The brand of Helsinki is present in the physical and digital worlds. One Helsinki is the guideline for visual identity in digital services. The goal is for digital services and websites to be recognised as the City of Helsinki services at first glance, emphasising consistent user experience and trust towards city services. HDS is a cornerstone for building this consistent user experience and bringing the brand to the digital world.

HDS team vision consists of five cornerstones

Unity
We promote a consistent and whole city experience and maintain the digital appearance of the city.
Equality
Together, we create a city that is accessible and worthy for every city dweller.
Impact
We make the city more attractive and a point of pride. We enable evolution by inspiring and supporting.
Joy
We enjoy building a better city for everyone and wish to share the delight with every user.
Wellbeing
We support the wellbeing of city employees by providing proper tools for digital development.

How we work?

The Helsinki Design System team is a collaboration of professionals from different consultancies and City of Helsinki employees.

Multi-disciplinary collaboration

The City of Helsinki didn't buy a ready design system but instead gathered the best professionals in the same team. This way, the City of Helsinki owns and maintains the design system. When team members change, the processes but also the existing design system must be well documented so that it's possible to transfer the knowledge.

HDS is developed as an open-source project so that anyone can benefit from it. The source code is available onGitHubfree of charge, and even the designs are shared for those interested. Building an open-source design system has many valuable points:

  • Open-source is one way to share the benefits to larger community
  • Open-source projects enables collaboration with other cities and companies as well, allowing contributions from the community
  • Open-source creates transparency

A fundamental principle is to pay attention to accessibility from the first drafts to the final component. Accessibility specialists audit every component before we release it.

Accessibility is ensured throughout the process

A flowchart illustrating the accessibility processA flowchart illustrating the accessibility process

HDS ensures accessibility in every stage of component development. HDS components always meet at least the WCAG 2.1 AA level and often reach the AAA level. HDS components and patterns are tested with the newest NVDA on Windows and VoiceOver on Mac and iOS.

Collaboration and support are built-in into the processes. The City of Helsinki has a dedicated slack channel to handle discussions and requests from the projects across the city organization.

Results

The Helsinki Design System gains more users from the City of Helsinki teams and the impact on the city's digital user experience is constantly increasing.

Some of our key metrics

HDS component usage is increasing
React component instances in the City of Helsinki's projects at nine times
HDS design kit is in heavy use
Fifteen most used Sketch symbol categories as of January 2023
HDS documentation is viewed more
Unique visitors on hds.hel.fi from June 2020 to December 2022

Basic info

Below you can find details about HDS in an accessible HDS Table component. This page also uses other accessible HDS components.

Table 1: Key information on HDS
NameHelsinki Design System (HDS)
LinkLink to Helsinki Design System (HDS)
ClientCity of Helsinki
Consultancies since v1.0.0 Gofore, HiQ, Kodan, Nitor, SiteImprove, Solita, Suomen Ohjelmistokehitys OSK, Unicus
Competition categoryBest Design System
Technologies usedReact, html+css (core)
Design tools usedSketch, Abstract