React-based GUI for management and monitoring of Nimbus fleets
Go to file
RadoslavDimchev f1d5697ba2 fix: css import order 2023-12-20 10:47:44 +02:00
.github/workflows ci: add step for checking formatting 2023-09-26 12:23:26 +03:00
.storybook fix: clean preview 2023-09-05 10:31:17 +03:00
.yarn dev: switch to `yarn` v3 2023-08-03 12:53:39 +03:00
public fix: delete connection blue svg 2023-12-18 22:39:03 +02:00
src fix: css import order 2023-12-20 10:47:44 +02:00
.eslintrc.cjs project reinit 2023-08-03 09:20:54 +03:00
.gitignore fix: auto add vercel settings after re-authenticate 2023-11-28 14:59:06 +02:00
.nojekyll fix(ci): add `.nojekyll` file in root 2023-08-21 15:07:08 +03:00
.nvmrc build: add a .nvmrc file 2023-08-03 12:51:10 +03:00
.prettierrc feat: add Tamagui integration 2023-08-04 09:43:07 +03:00
.tool-versions dev: switch to `yarn` v3 2023-08-03 12:53:39 +03:00
.yarnrc.yml dev: switch to `yarn` v3 2023-08-03 12:53:39 +03:00
LICENSE Clean project directory 2023-07-13 14:16:49 +03:00
LICENSE-APACHEv2 Basic README and license files 2023-08-01 10:11:08 +03:00
LICENSE-MIT Basic README and license files 2023-08-01 10:11:08 +03:00
README.md Remove a superfluous heading 2023-11-13 13:03:39 +03:00
animations.ts fix: add proper tamagui config 2023-08-10 09:56:22 +03:00
index.html add link preload fonts 2023-09-11 23:20:57 +03:00
package.json Merge pull request #23 from nimbus-gui/Create-dashboard-grid 2023-11-03 11:31:18 +02:00
tamagui.config.ts cleanup: remove stray commented out line 2023-08-10 10:25:53 +03:00
themes.ts fix: add proper tamagui config 2023-08-10 09:56:22 +03:00
tokens.ts fix: add proper tamagui config 2023-08-10 09:56:22 +03:00
tsconfig.json project reinit 2023-08-03 09:20:54 +03:00
tsconfig.node.json project reinit 2023-08-03 09:20:54 +03:00
vercel.json ci: add `vercel.json` for vercel to rewrite routes 2023-09-07 15:57:28 +03:00
vite.config.ts debug(ci): set base URL in `.storybook/main` 2023-08-21 20:49:21 +03:00
yarn.lock Merge pull request #23 from nimbus-gui/Create-dashboard-grid 2023-11-03 11:31:18 +02:00

README.md

Nimbus GUI

The goal of this project is to develop a management and monitoring GUI for the Nimbus Ethereum client.

Right now, Nimbus is managed as a typical system service. It offers executables that can be launched from the command-line. It produces log output as the primary way to communicate information to the user and it's typically monitored through Prometheus and Grafana. The user can interact with Nimbus through a standardized REST APIs with some Nimbus-specific extensions.

Since the primary purpose of Nimbus is to enable the user to operate Ethereum validators, users typically also consult web-sites such as beaconcha.in, which provide up-to-date information about the network and the obtained rewards of each validator. The beaconcha.in web-site also offers a popular mobile application which can alert the user if their validator(s) are failing to perform their duties (which can happen if the Nimbus service is experiencing any technical issues).

At the moment, all of the above makes Nimbus accessible mostly to users with the sufficient technical skills to setup and integrate multiple software packages, often within a rented server running Linux in a remote data center.

We would like to make Nimbus much more accessible to non-technical users by developing GUI installers and GUI management and monitoring software. We have prepared a rough roadmap for this here:

https://github.com/status-im/nimbus-eth2/issues/3423

Development Plan

The initial version of the management UI will be developed as a web application, communicating with a special service called the Logos Node Management Service.

As part of the Logos movement, Nimbus benefits from close ties to Status, a messanger that offers strong integration with Ethereum and also serves as a mobile wallet and a DApp browser. We can provide a simple interface for solo stakers who would be able to execute their validator deposits directly from the Status app in the future. The Nimbus management UI will be then embedded within the app and it will use the same design system as the app.

The Status UI team is currently developing the next iteration of the Status design system that will be used across its mobile and desktop products. To facilitate the future integration, we will use the same system during the development of the Nimbus GUI from the start.

UX Designs (WIP)

Initial designs for the Nimbus management UI are being developed here:

https://www.figma.com/file/kUO8PyQCo89SyvCn3pFmNS/Nodes-Nimbus---New-Design-System?type=design&node-id=3%3A188588&t=npvkylewM1T5GUHG-1

Please note that all of the graphics are currently placeholders as the final artwords are still being prepared. The layout of the screens is likely to resemble the final design, although the content and the available functionality on the web-pages is still under review.

Live Demos

We have a Storybook up at https://nimbus-gui.github.io/nimbus-gui/ which shows the components of the project. We also have a deployed version of the GUI up at https://nimbus-gui.vercel.app/ which shows the GUI as it currently looks in the main branch of the nimbus-gui/nimbus-gui repository.

How to Contribute

Install all dependencies

Run yarn in the root directory of the project in order to install dependencies.

Run a development server

If you want to run a development server to see what the GUI looks like you can run the following command:

yarn dev

This will start the server on port 5173 and you can open https://localhost:5173 in order to see the page.

Launch Storybook locally

If you want to run the Storybook locally you can simply run yarn storybook in the root of the project. This is useful if you want to contribute a component and be sure that it renders as you expect it to, without testing it out on any given page.