open-city-design
v1.0.0-alpha.3
Published
Themeable Boostrap 4 SASS library with City of Helsinki theme
Downloads
13
Readme
Browse the Open City Design System
Open City Design System
What is this?
Open City Design System (OCDS) is a design system for cities and their services. Design system provides UI components, user patterns and design resources to support the open development of city services.
The project is in early alpha. The development of the concept has been funded by a EU backed project called 6aika.
Contents
- Documentation - React app, using Reactstrap components for style demos
- Bootstrap 4 sass theme - Available as npm package
How to use?
Open City Design System takes advantage and is built around Bootstrap component library. It can be used as a Bootstrap style theme or expanded pattern library with added modules and pattern.
Go to Open City Design System website and browse the city-specific design systems.
Install
Install or add Bootstrap sass theme to your application
yarn add open-city-design
See the scss files how the import hierarchy works. You might need to create your own scss file with appropriate import paths for your environment.
NOTE: 1.0.0-alpha.3 onwards we import Bootstrap default variables directly instead of 6Aika defaults. Note this if you are doing your own style imports.
How can I contribute?
Open City Design System documentation is built on React.js, a Javascript library for building user interfaces. It requires Node.js 8+ to run.
You can get it running by cloning the repository locally, and running the following commands:
cd open-city-design
yarn install
yarn start
We welcome pull requests on the respective parts of this repository. There's a Slack channel available for discussion.