# react-cimpress-fulfillers-components

[![npm version](https://badge.fury.io/js/react-cimpress-fulfillers-components.svg)](https://badge.fury.io/js/react-cimpress-fulfillers-components)

react-cimpress-fulfillers-components is a library of React components facilitating the consumption of Fulfiller Identity and Fulfillment Location services in your UI. A variety of selection components allows for robust and customizable UIs working with fulfillers or fulfillment locations conforming to the Cimpress style guide.

## Getting Started

Install `react-cimpress-fulfillers-components` with your package manager of choice:
```
npm install --save react-cimpress-fulfillers-components
```

(**New!**) The simplest way to get started is to visit the library's [demo page](https://trdlnk.cimpress.io/demo-fulfillers-components) at our [home page](https://trdlnk.cimpress.io). There you'll find example applications of the components with ready-to-paste code snippets.

## Components

#### FulfillerSelect

`FulfillerSelect` is a heavily customized fulfiller selection dropdown based on [react-virtualized-select](https://github.com/bvaughn/react-virtualized-select). Apart from allowing the user to select a fulfiller, the component also maintains a list of recently selected fulfillers for quick access on other pages. The component also automatically selects the most recently accessed fulfiller on subsequent page visits.

#### FulfillerMultiSelect

`FulfillerMultiSelect`, is a variant of `FulfillerSelect`, but with multi select. This components maintains it's own list of recently selected fulfillers.

#### FulfillmentLocationField
#### FulfillmentLocationListItem
#### FulfillmentLocationList
#### FulfillmentLocationTitle

## Contributing

Have you benefited from the library? Have you found or fixed a bug? Would you like to see a new feature implemented? We are eager to collaborate with you on GitHub.

## Versioning

We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/your/project/tags). 

## Authors

* **Ivan Stanishev** <[istanishev@cimpress.com](mailto:istanishev@cimpress.com)>
* **Trdelnik Squad** <[TrdelnikSquad@cimpress.com](mailto:TrdelnikSquad@cimpress.com)>

See also the list of [contributors](https://github.com/Cimpress/react-cimpress-fulfillers-components/contributors) who participated in this project.

## License

This project is licensed under the Apache 2.0 license - see the [LICENSE](LICENSE) file for details.