evitaLab

evitaLab is the official web-based GUI client for evitaDB e-commerce database. Visit demo.evitadb.io for the live demo.

       

evitaLab aims to provide a user-friendly client for evitaDB database to easily browse and modify data stored in the database.

You can try out evitaLab with evitaDB demo dataset at demo.evitadb.io.

Features

evitaLab allows you to:

• inspect schemas
• browse entities in interactive table
• execute GraphQL queries
• execute evitaQL queries
• visualise extra results
• share tabs between developers
• manage connections to multiple evitaDB instances
• manage server (status, tasks, JFR recordings)
• manage catalogs and collections

evitaLab is still in active development and new features are being added fairly frequently.

Running locally

To run evitaLab locally, you can use either of the following ways. In the future, we plan to provide pre-built binaries for all major desktop platforms, but currently the docker image is the closest thing we have.

Embedded in local evitaDB instance

The easiest and quickest way to run evitaLab locally is to enable it inside your configuration of evitaDB. By default, evitaDB will automatically expose its own local evitaLab instance on the localhost:5555/lab address. For more configuration, see evitaDB documentation.

Docker

The easiest and quickest way to run evitaLab locally without running evitaDB is to use Docker. You can use the following command to install evitaLab locally:

docker run --name evitalab -ti -p 5566:3000 ghcr.io/lukashornych/evitalab:latest

Next time you want to run the evitaLab, simply start use:

docker start evitalab

This will expose an evitaLab instance on localhost:5566/lab address.

From dist

If you want to run evitaLab manually, you can download the latest release from releases page and use any static web server to serve the files from dist directory. For example, you can use nginx

From source

If you want to run a development version of the evitaLab, you can clone this repository.

Before you start, make sure you have Node.js in version specified in .nvmrc and Yarn package manager installed.

# running using npm
npm install
npm run dev

# running using yarn
yarn install
yarn dev

This will start a development server on localhost:3000/lab address.

Development

If you would like to contribute to evitaLab source code or just simply play with it locally, you just need to clone the project, install the Node.js in version specified in .nvmrc and Yarn (as that's what we use for development) and run the following commands to run the evitaLab locally:

# running using yarn
yarn install
yarn dev

You can find more indepth info about internal structure and guidelines of evitaLab in developer documentation.

Licence

Apache License 2.0

Contribution

Any contributions are welcome and appreciated. If you would like to contribute to evitaLab, feel free to open an issue and submit a pull request.