Don't hesitate to open issues and PRs if you want to help.
Explore the components | Online JupyterLab demo
The UI Toolkit is a component library for building web interfaces in Jupyter ecosystem (JupyterHub, Jupyter Widgets, JupyterLab,...).
Features of the library include:
This repository contains three packages:
@jupyter/web-components
:
The main package defining the web components.@jupyter/react-components
:
Wrapped the web components to use them with React.jupyter-ui-demo
:
Unpublished JupyterLab extension to demonstrate the integration of the toolkit.Those features are brought through the Fast Design. And it is inspired by the WebView toolkit for Visual Studio Code as example for creating a customized toolkit.
The UI Toolkit is currently in a proof of concept. Track progress towards 1.0 here. Styles and API are not guarantee between minor versions prior to v1.0.0.
To install the web-components
library, use either npm
or yarn
as follows:
npm install --save @jupyter/web-components
yarn add @jupyter/web-components
If you need the React components of the toolkit, you need to install
@jupyter/react-components
.
A pre-bundled script that contains all APIs needed to use Jupyter UI Toolkit is available on CDN. You can use this script by adding type="module"
to the script element and then importing from the CDN.
<!doctype html>
<html lang="en">
<head>
<script
type="module"
src="https://unpkg.com/@jupyter/web-components/dist/toolkit.min.js"
></script>
</head>
<!-- ... -->
</html>
The above CDN location points to the latest release of @jupyter/web-components
. It is advised that when you deploy your site or app, you import the specific version you have developed and tested with.
See the example folder for more hints about theming.
Further documentation can be found in the following places:
See the contributing documentation.