@mapbox/mr-ui

Pronounced 'mis-tər yü-'ī. Mapbox React UI components.

UI components for Mapbox projects. See docs at https://mapbox.github.io/mr-ui/.

This project is for internal Mapbox usage. The code is open source and we appreciate bug reports; but we will only consider feature requests and pull requests from Mapbox developers.

Installation

npm install @mapbox/mr-ui

On Mapbox projects, pair these components with version 1.1.0+ of Mapbox's custom Assembly build. (This is not in peerDependencies because you might use <link> and <script> tags instead of the npm package.)

The public Assembly build should work fine, with maybe one or two hiccups.

Usage

Import individual components! All components are exposed at @mapbox/mr-ui/{component-name}. For example:

import Modal from '@mapbox/mr-ui/modal';
import Tooltip from '@mapbox/mr-ui/tooltip';

Only the component itself and whatever it depends on will be drawn into your bundle.

Utility functions

There are a few utility functions you can import from @mapbox/mr-ui/utils/{name}.

See the utils documentation.

Development

Here are some commands you'll probably want to use:

# Start the test-cases app.
npm start

# Start the documentation site.
npm run start-docs

# Start Jest's CLI in watch mode.
npx jest --watchAll

# Lint and test everything.
npm test

Publishing

The build command creates a pkg/ directory that contains the code we want to publish, organized the way we want it. So pkg/ is the directory that we publish. pkg/package.json is a clone of package.json but with private: true removed.

Increment version numbers in package.json and package.lock.json, and ensure the changelog has an entry for the latest version. Then, create a new Git tag.
Build the pkg/ directory: npm run build.
cd into the pkg/ directory and mbx npm publish from there.
cd back to root and run npm run deploy-docs to update the docs at https://mapbox.github.io/mr-ui/

Current Tags

1.0.0-beta.0 ... beta (6 years ago)
0.9.2-dev.12 ... dev (5 years ago)
1.1.0-patch.1 ... latest (4 years ago)

45 Versions

1.1.0-patch.1 ... 4 years ago
2.0.0-beta.2 ... 4 years ago
2.0.0-beta.1 ... 4 years ago
1.1.0 ... 5 years ago
1.0.0 ... 5 years ago
1.0.0-beta.2 ... 5 years ago
1.0.0-beta.1 ... 5 years ago
0.12.0 ... 5 years ago
0.11.0 ... 5 years ago
0.10.0 ... 5 years ago
0.9.2-dev.12 ... 5 years ago
0.9.2-dev.11 ... 5 years ago
0.9.2-dev.10 ... 5 years ago
0.9.2-dev.9 ... 5 years ago
0.9.2-dev.8 ... 5 years ago
0.9.2-dev.7 ... 5 years ago
0.9.2-dev.6 ... 5 years ago
0.9.2-dev.5 ... 5 years ago
0.9.2-dev.4 ... 5 years ago
0.9.2-dev.3 ... 5 years ago
0.9.2-dev.2 ... 5 years ago
0.9.2-dev.1 ... 5 years ago
0.9.2-dev.0 ... 5 years ago
1.0.0-beta.0 ... 6 years ago
0.9.1 ... 6 years ago
0.9.0 ... 6 years ago
0.8.0 ... 6 years ago
0.7.4 ... 6 years ago
0.7.3 ... 6 years ago
0.7.2 ... 7 years ago
0.7.1 ... 7 years ago
0.7.0 ... 7 years ago
0.6.1 ... 7 years ago
0.6.0 ... 7 years ago
0.5.0 ... 7 years ago
0.4.3 ... 7 years ago
0.4.2 ... 7 years ago
0.4.1 ... 7 years ago
0.4.0 ... 7 years ago
0.3.2 ... 7 years ago
0.3.1 ... 8 years ago
0.3.0 ... 8 years ago
0.2.1 ... 8 years ago
0.2.0 ... 8 years ago
0.1.0 ... 8 years ago