Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@bufferapp/analyze-billing-banner

Package Overview
Dependencies
Maintainers
28
Versions
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@bufferapp/analyze-billing-banner

Billing banner for accounts on trial without credit card details

  • 0.99.1
  • latest
  • npm
  • Socket score

Version published
Maintainers
28
Created
Source

@bufferapp/analyze-billing-banner

The billing banner for notifying trial users without credit card details to add them.

  • Quick Start
  • Package Anatomy

Quick Start

Start Storybook

If you're interested in working on or observing how things look, starting with React Storybook is a great way to get going. It's setup to automatically reload as the code changes to make it easy to do rapid iteration on components.

npm start

After that copy and paste the host and port that is displayed on the console into a browser.

Developing Multiple Packages In Parallel

If you're running this for multiple packages at the same time, it's helpful to pass in the port number.

npm start -- --port 8003

Run Tests

Tests are run using Jest and UIs are tested and locked down using Jest Snapshots and React Storybook.

Standard Tests

Runs linter, then unit and snapshot tests. These tests are run using CI and are currently running on TravisCI:

https://travis-ci.com/bufferapp/buffer-publish

npm test
Watch Mode

When writing unit tests for things like middleware and the main index file, it's useful to only run the test that change so you can rapidly iterate. Jest watch mode allows you do do this with a single command:

npm run test-watch

Package Anatomy

A UI package should include all concerns related to a given feature.

billing-banner/ # root
+-- .storybook/ # React Storybook Configuration
    `-- addons.js # storybook action panel configuration
    `-- config.js # storybook main configuration
    `-- preview-head.html # configure <head> in storybook preview
    `-- webpack.config.js # webpack configuration for storybook
+-- components/ # presentational components
    +-- BillingBanner # component that is only used in the package
        `-- index.jsx # implementation of the component
        `-- story.jsx # description of all the possible configurations of the component
+-- mocks/ # mock users and account information
    `-- billing.js
`-- .babelrc # babel transpiler
`-- index.js # main package file, should export the container and level resources
`-- index.test.js # main package file tests
`-- package.json # npm package
`-- README.md # you are here

index.js

This is the main package file, it's default export should be the container.

Imagine another package is trying to use the package you're building. The package API should look like this:

import BillingBanner from '@bufferapp/analyze-billing-banner';

components/

Presentational components (pure ui) are implemented with the following structure:

+-- components/
    +-- BillingBanner
        `-- index.jsx
        `-- story.jsx
components/BillingBanner/index.jsx

This should export a functional and stateless component. There are some special cases where handling things like focus, hover and active states that need to be tracked.

If you need focus and or hover take a look at PseudoClassComponent to wrap the component you're building:

https://github.com/bufferapp/buffer-components/blob/master/PseudoClassComponent/index.jsx

Here's an example of how to wrap a Button:

https://github.com/bufferapp/buffer-components/blob/master/Button/index.jsx

components/BillingBanner/story.jsx

This should set the context (properties) for every configuration of the component in index.jsx. The story is used for both React Storybook as well as Jest Snapshots.

FAQs

Package last updated on 11 Jul 2019

Did you know?

Socket

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
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc