notebooks/workspaces/frontend/README.md

1.7 KiB

Kubeflow Workspaces Frontend

The Kubeflow Workspaces Frontend is the web user interface used to monitor and manage Kubeflow Workspaces as part of Kubeflow Notebooks 2.0.

⚠️ Warning ⚠️

The Kubeflow Workspaces Frontend is a work in progress and is NOT currently ready for use. We greatly appreciate any contributions.

Dev Setup

Requirements

This project requires the following tools to be installed on your system:

  • NodeJS and NPM
    • Node recommended version -> 20.17.0
    • NPM recommended version -> 10.8.2

Development

  1. Clone the repository:

    git clone https://github.com/kubeflow/notebooks.git
    
  2. Checkout the Notebooks 2.0 development branch:

    git checkout notebooks-v2
    
  3. Navigate to the frontend directory and install the project dependencies.

    cd workspaces/frontend && npm install
    

Build the Project

npm run build

Serve the UI Locally

This is the default setup for running the UI locally. Make sure you build the project using the instructions above prior to running the command below.

npm run start:dev

The command above requires the backend to be active in order to serve data. To run the UI independently, without establishing a connection to the backend, use the following command to start the application with a mocked API:

npm run start:dev:mock

Testing

Run all tests:

npm run test

Linting

Check for linting issues:

npm run test:lint

Automatically fix linting issues:

npm run test:fix