Socket
Socket
Sign inDemoInstall

@blockchain-com/components

Package Overview
Dependencies
110
Maintainers
5
Versions
65
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    @blockchain-com/components

Blockchain.com components library


Version published
Weekly downloads
24
decreased by-72.73%
Maintainers
5
Install size
15.2 MB
Created
Weekly downloads
 

Readme

Source

Coverage Status Flow Coverage CircleCI

js-standard-style Code Style: prettier Conventional Commits

Description

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.

Installation

Just a quick npm i @blockchain-com/components and you are good to go!

Tips

Icons usage

1. FontAwesome icons (free version)

Use <Fas... />

  • Fas is the type ("Fab", "Far" and "Fas" are avaible)

    • Fab matches the brand iconset
    • Fas matches the solid iconset
    • Far matches the regular iconset
  • ... is the FontAwesome icon name formatted as PascalCase.

The full icon list is available here

Examples:

<FasCheckCircle />
<FarCheckCircle />
<FabFacebook />

cryptos

2. Crypto icons

Use <Crypto.../>

The list of crypto icons is available here

Examples:

<CryptoBtc />
<CryptoXlm />

cryptos

3. Custom (bc) icons

Use <Bc... />

The list of custom icons is available here

Examples:

<BcBlocks />
<BcTransactions />

cryptos

Development

Tooling

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:

  1. git clone git@github.com:blockchain/components.git
  2. cd path-to/components
  3. npm link
  4. cd path-to/my-app
  5. npm link @blockchain-com/components

:zap: you need to run npm link @blockchain-com/components everytime you run npm i or yarn...

Storybook

  1. Ensure Node version >= 8.0 is installed
  2. Install packages: npm i
  3. Start application in dev mode: npm run start
  4. The library will now be accessible at localhost:6006

Architecture

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

Code Quality

1. Linting

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

2. Unit Tests

Testing is done using Jest and Enzyme.

Following commands is available:

  • npm test
    • Run the unit tests

3. Git Hooks

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.

FAQs

Last updated on 21 Feb 2019

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc