Open Source Software

Herman

Automated Style Guides

Herman is an automated pattern-library generator, built on top of SassDoc, and designed to integrate with OddBird’s Sass Accoutrement libraries for quick theme configuration, color palettes, font specimens, icon libraries, and documentation of UI patterns in both CSS and HTML.

‘npm package’ 'build-status'

Pattern libraries and style guides help keep the code and design of your site consistent, while facilitating communication between designers and developers. But documentation can be difficult to maintain, especially if it lives too far from the code – and there’s nothing worse than an out-of-date pattern library. Herman is here to help make documentation simple, keeping it inline with the source code of the project, and updating pattern libraries on-the-fly.

npm install sassdoc
npm install sassdoc-theme-herman
Read The Docs

Accoutrement Modules

OddBird’s Accoutrement toolkits are designed around the idea that code should be meaningful to both humans and machines – opening the door for automation, while improving readability. These tools integrate with Herman, our automated pattern-library generator.

Init

Lightweight browser normalization. This is the only Accoutrement library with direct CSS output when imported.

Color

Manage your color palettes in one place, and access them from anywhere with optional accessibility guidance from the WCAG.

Type

Manage your webfonts, import them all with a single command, and access font-stacks on-the-fly, with utilities for generated content and accessibility.

Scale

Manage a system of consistent sizes to use across your project for typography, spacing, layout, and more. Generate sizes based on modular-scale ratios, and access sizes in any unit you need.

Layout

Layout utilities including named media-queries, shorthand positioning, fluid aspect-ratios, box-sizing, and float-clearing.

Start the conversation…

Interested in a chat with Miriam to find out more? Ask us anything; we’re happy to answer your questions, big or small. If your business is a good fit, we’ll offer a free in-depth project assessment!

Schedule a call with Miriam