The library Components is based on React and styled-components. It contains basic components, "atoms", and more complex "molecules" that are used on the Blockchain.com ecosystem.
Just a quick npm i @blockchain-com/components and you are good to go!
Use <Fas... />
-
Fasis the type ("Fab", "Far" and "Fas" are avaible)Fabmatches the brand iconsetFasmatches the solid iconsetFarmatches the regular iconset
-
...is the FontAwesome icon name formatted as PascalCase.
The full icon list is available here
Examples:
<FasCheckCircle />
<FarCheckCircle />
<FabFacebook />
Use <Crypto.../>
...is the icon name formatted as PascalCase.
The list of crypto icons is available here
Examples:
<CryptoBtc />
<CryptoXlm />
Use <Bc... />
...is the icon name formatted as PascalCase.
The list of custom icons is available here
Examples:
<BcBlocks />
<BcTransactions />
Both yarn and npm are supported.
The commands are given using npm however you can use the yarn equivalent and it will Just Work™
If you want to change the library and reflect your changes on your consumer app without having to push to the repo and release, just:
git clone git@github.com:blockchain/components.gitcd path-to/componentsnpm linkcd path-to/my-appnpm link @blockchain-com/components
⚡ you need to run npm link @blockchain-com/components everytime you run npm i or yarn...
- Ensure Node version >= 8.0 is installed
- Install packages:
npm i - Start application in dev mode:
npm run start - The library will now be accessible at localhost:6006
This library follows the Atomic Design principles.
An additional attention has be taken to ensure that all components are available and fully functional accross major web browsers*, as well as responsive on any screen sizes.
Browsers with > 1% usage:
- IE 11
- Safari 11+
- Chrome / Edge / Firefox latest 2 major versions
The coding style rules are defined by Prettier and enforced by Eslint
The good practices™ that we follow are defined by the Javascript Standard Style
Following commands are available:
npm run lint:js- Lints JS code
npm run lint:css- Lints styled components
Testing is done using Jest and Enzyme.
Following commands is available:
npm test- Run the unit tests
We use Husky to automatically deploy git hooks
On every git commit and git push we run the unit tests and the linting tasks.
The commit messages are also validated and must follow the Conventional Commits spec.