@opensearch-staging/oui
TypeScript icon, indicating that this package has built-in type declarations

1.0.0 • Public • Published

OpenSearch UI Framework

The OpenSearch UI Framework is a collection of React UI components for quickly building user interfaces at OpenSearch Project. Not using React? No problem! You can still use the CSS behind each component.

You should check out our living style guide, which contains many examples of components in the OUI framework aesthetic, and how to use them in your products. We also have a FAQ that covers common usage questions.

Installation

To install the OpenSearch UI Framework into an existing project, use the yarn CLI (npm is not supported).

yarn add @opensearch-project/oui

Note that OUI has several peerDependencies requirements that will also need to be installed if starting with a blank project. You can read more about other ways to consume OUI.

yarn add @opensearch-project/oui @elastic/datemath moment prop-types

Running Locally

Node

We depend upon the version of node defined in .nvmrc.

You will probably want to install a node version manager. nvm is recommended.

To install and use the correct node version with nvm:

nvm install

Documentation

You can run the documentation locally at http://localhost:8030/ by running the following.

yarn
yarn start

If another process is already listening on port 8030, the next free port will be used. Alternatively, you can specify a port:

yarn start --port 9000

Goals

The primary goal of this library is to provide reusable UI components that can be used throughout Elastic's web products. As React components, they remove CSS from the process of building UIs. As a single source of truth, the framework allows our designers to make changes to our aesthetic directly in the code. And unit test coverage for the UI components allows us to deliver a stable "API for user interfaces".

Wiki

Consumption

Maintenance / Contributing

CONTRIBUTING.md

License

Apache Licensed. Read the FAQ for details.

Readme

Keywords

none

Package Sidebar

Install

npm i @opensearch-staging/oui

Weekly Downloads

5

Version

1.0.0

License

Apache-2.0

Unpacked Size

86.3 MB

Total Files

6855

Last publish

Collaborators

  • mattsb42-aws
  • abhng
  • peterzhuamazon
  • amzn-oss
  • cehenkle