Deno KV GUI Client

This is an open source desktop app client to manage Deno KV Databases.
It enables you to browse your data inside Deno KV Databases in a modern GUI, perform CRUD operations and more!.

It's like using "MongoDB Compass" with MongoDB, "Redis Insight" with Redis, "pgAdmin" with Postgres database, "Beekeeper Studio" with many different databases, etc...

Some Screenshots

Download

Always recommended to download from the latest release

[!NOTE] For Windows and Mac Users:
This application is not code signed yet. When running the app, you may encounter security warnings like "Unknown Publisher" or "'*.app' is damaged and can’t be opened", So please ensure you trust the source code before proceeding with the installation.

To download the Deno KV GUI Client app, go to releases page, pick and download the file that matches your operating system:

Linux

There are two options for Linux users:

.AppImage format (compatible with most Linux distributions)

[!TIP] To easily download the .AppImage file and set up a desktop entry for the app, run:

curl -sS https://abdulrhmangoni.github.io/denokv-gui-client/linux-AppImage-install.sh | sh

If you've already downloaded the .AppImage file from the releases page, you can pass its path to installation script to skip downloading it again and just set up the desktop entry:

curl -sS https://abdulrhmangoni.github.io/denokv-gui-client/linux-AppImage-install.sh path/to/denokv-gui-client-x.x.x-linux-x86_64.AppImage | sh

[!IMPORTANT] If you decided to manually download and run the .AppImage file, you might need to make it executable before running it:

chmod +x path/to/denokv-gui-client-x.x.x-linux-x86_64.AppImage

Make sure to replace 'path/to' and 'x.x.x' with the actual location and version.

.deb format (Debian/Ubuntu installer)

If you picked .deb installer and downloaded it, you can install it like the following:

sudo dpkg -i path/to/denokv-gui-client-x.x.x-linux-x86_64.deb

MacOS

The application is provided as a .dmg installer for both Apple Silicon (arm64) and Intel (x86_64) architectures.
Download the correct version for your Mac from the releases page:

• denokv-gui-client-x.x.x-mac-arm64.dmg for Apple Silicon Macs
• denokv-gui-client-x.x.x-mac-x64.dmg for Intel-based Macs

[!IMPORTANT] When you download and install the app, you'll most likely be prevented from opening it and see a warnings like this:

“denokv-gui-client.app” is damaged and can’t be opened. You should move it to the Bin.

You can bypass this using following command:

xattr -c /path/to/denokv-gui-client.app

Make sure to set the right path

Windows

On Windows, you just need to download the denokv-gui-client-x.x.x-win-x64.exe file from releases page and run it.

Install and run locally

Installation

1. Clone the repo and enter the project's directory

  git clone https://github.com/AbdulrhmanGoni/denokv-gui-client.git && cd denokv-gui-client

2. Install dependencies

  npm install

Development Mode

You first need to run the migration to set up the development database:

  npm run migration up

[!NOTE] A development SQLite database file will be created in the root directory of the project once you run the migration command for the first time. It will be where any data and settings created in development mode are stored.

Then run the app in development mode with:

  npm start

Compiling The App

To compile or build the app for production use:

  npm run compile

This command will create the build artifacts in dist directory

Tests

To run the tests, compile the app first, and then run:

  npm run test

[!NOTE] A testing SQLite database file will be created in the root directory of the project once you run the migration command for the first time.