Sparkgeo Component Library

Storybook documentation: https://sparkgeo.github.io/spk-components/

---

This is an early attempt at creating a collection of useful and reusable React components focussed on geospatial web map applications.

As many fundamental UI components already exist in the vast ecosystem of React UI libraries, the aim for this project is to be a tool which provides larger and more complex components that are common within a geospatial UI. This aim will likely make the library's components more opinonated.

This project is open to contributions from anyone who is intrested. If you would like to participate any discussions please join the slack channel #spk-ui-component-library

Note: This project still very much a WIP and will be subject to breaking changes in the near future.

Features

???

Running Storybook locally

Install all dependencies using:

npm install

Run storybook using the following command:

npm run storybook

This should automatically open a browser tab to the storybook server running on localhost port 6000 by default.

Building the library

Run npm run build to build the library into the dist folder.

Using components locally

If you want to use the components in a local react project locally, while testing, you can use npm link.

• Build the library using the command above.
• Run npm link to link the library.
• In the directory of your react project run npm link spk-components
• You should now be able to import the components e.g. import { GradientLegend, SimpleSlider } from 'spk-components'; in your project.
• If you want npm to watch for changes to spk-components and automatically rebuild run npm run watch instead of npm run build

Removing the link

To remove the linked package:

• In your react project where you have been using the package run npm unlink spk-components
• In spk-components run npm unlink

Contribution & Development

See CONTRIBUTING.md

License

See LICENSE

Authors

Created by Sparkgeo

See contributors for a listing of individual contributors.

Changes

See CHANGES.md.