antibaconmachine / axiom Goto Github PK

A consumable library of Brandwatch UI & UX patterns.

yarn add bw-axiom

• Materials (colors, sizing) to create custom components while following patterns.
• Components to encapsulate templates, styles and behaviour.
• Composites for larger reusable multi component solutions.
• Utilities to apply UX patterns (like date and number formatting).
• Light and Dark themes at a global level.

• Using create-react-app? See the setup guide here
• Have a custom set up? All you need is to set up postcsss, see the setup guide here

The React components provide an abstraction of the templates and CSS, which greatly reduces any needed maintenance when CSS classes or the HTML structure to a component changes. They also encapsulate the behaviour of more interactive components, so components that do require Javascript will not work and will require you to plumb it all together.

The compiled CSS file is stored on the Brandwatch Google Cloud Platform CDN or target individual CSS files from the node_module.

http://axiom.bwcom.io/axiom-{THEME}.{VERSION}.min.css

Template and CSS changes are not classed as breaking changes and are not specified in the release notes

git clone [email protected]:BrandwatchLtd/axiom.git
cd axiom
yarn install
yarn start

Npm/yarn link won't work out of the box as the main directory specified in package.json is lib. To populate this directory with your local changes, run yarn build:local. You can then run npm link as normal, and then npm link bw-axiom from your application directory.