@digibib/deichman-ui

Deichman-ui

Style-guide and component library for the Oslo public libraries

• Documentation
• Changelog

Built with

• React
• PostCSS CSS processing
• Backpack.css CSS foundation for applications
• Rollup JavaScript module bundler
• Storybook UI Development Environment

Developing

Local development is done via React-storybook. Clone the repo and run:

  npm i
  npm start

New components

Before adding a new Component, make sure this is a generic utility-component. If it's not, add it to the project where it will be used. I.E, an "Accordion" is generic, a "LibraryDetailsCard" is probably not.

New component checklist:

	Requirement	Description
✅	The component is semantic	Use HTML5 markup, the correct font hierarchy etc.
✅	The component is documented	Ensure the component has a Component.md file, a story and proptype definitions.
✅	The component is accessible	Usable with a keyboard, correct :focus-styles, correct aria-roles.
✅	The component is tested	Cross-browser testing.

Publishing

Make sure to update the changelog if there's any breaking changes.

To publish a new version of the library to npm:

  npm version {major/minor/patch}
  git push --tags
  git push origin master
  npm publish

To publish/update the docs:

  npm run deploy-storybook

CDN Cache

jsDelivr will cache the @latest tag for 24 hours, if you're using the latest version and wish to purge the cache, visit https://purge.jsdelivr.net/npm/@digibib/deichman-ui@latest/dist/index.css