À propos du projet

Helsinki Design System, ou HDS, est un système de design open-source créé par la Ville d'Helsinki. Il regroupe des outils pour le développement et le design, accompagnés de directives et de ressources permettant de créer des services numériques conviviaux et accessibles pour la ville. Ce qu'il fournit : - L'accessibilité intégrée. Les composants sont conçus dès le départ pour être aussi accessibles que possible et passent un audit d'accessibilité tiers avant leur publication. - React et CSS. Les composants sont disponibles à la fois en tant qu'implémentations React et en tant que styles CSS, permettant aux équipes de choisir ce qui convient le mieux à leur projet. - Composants personnalisables. Les composants sont construits pour être adaptés, permettant aux projets d'exprimer la marque Helsinki. - Design et implementation synchronisés. Les designers travaillent avec une collection de bibliothèques Sketch qui restent synchronisées avec l'implémentation. Packages : HDS est divisé en trois packages publiés sur npm. hds-core fournit les couleurs de marque la Ville d'Helsinki, la typographie et les styles de base sous forme de styles CSS et de variables. hds-react fournit les composants HDS implémentés en React. hds-design-tokens contient la base du système, incluant les couleurs de base et la typographie, sous forme de jetons de design. Le site du projet à l'adresse hds.hel.fi héberge la documentation, une liste des composants disponibles et des instances Storybook pour les packages React et core. Des guides de mise en route distincts existent pour les développeurs et les designers. Développement et contribution : le monorepo utilise Lerna pour exécuter des scripts entre les packages, gérer la versionnage et les publications, et les workspaces pnpm pour la gestion des dépendances, ce qui permet aux différents packages de se référencer mutuellement via des liens symboliques lors du développement local. Un guide de développement couvre la configuration d'un environnement local. Les contributions sont les bienvenues sous forme d'issues, de demandes de tirage (pull requests) et de propositions de conceptions de composants ; le projet documente également une page de support indiquant comment prendre contact. Le dépôt est publié sous licence MIT.