Create and Manage Desktop Projects

The Projects home page is your portal to

  • Create new Desktop projects and manage existing projects.

  • Review details of your Kineviz account, link to information, send feedback to Kineviz, and access user communities.

20 01 04 KD ManageProjects

Open a Project

Projects are displayed in either a tile or list view organized in the following sections:

  • Recent Projects, the projects you recently opened.

  • My Projects, projects you’ve created, and a Create tile or button.

  • Create From Sandbox, pre-configured projects you can review and copy.

To introduce you to basic graph workflows, at least one Sandbox Start Here project is already included. These Kineviz tutorials use GraphXR’s Grove extension, an Observable-based javascript notebook.

Open the Start Here tutorial

  • Click the Start Here project tile or list. When the project opens, you can:

    • Click the Grove icon to open the in-app tutorial notebook. It guides you through a basic workflow where you import a CSV table, transform it to a labeled property graph, explore connections in the data, and save graph views. It also provides examples of using the Kineviz API to work with the demo data.

    • Click the Chat icon to launch GraphXR Agent, a pre-configured AI Agent you can use to import, transform, and analyze your data in no-code chat.

    Using GraphXR Agent in Kineviz Desktop requires an Online connection to the managed Kineviz Cloud.

Create and Open a New Project

To create a new project:

  1. In the Projects home page, click Create

  2. In the Create New Project dialog:

    1. Enter a Project Name of your choice.

    2. Optionally, select the Database Type and enter the requested details for the specific database.

      KoreDB is the default, which automatically sets the specifications for the internal data store. Most other database options require a Hostname (or IP), BOLT port - a default is shown for most options, Username, Password, and Database Name. You may also need to verify that your external database is running before trying to connect to it.

  3. Click Confirm to create the project and open it.

Import an Exported Project

You can export a project from Kineviz Desktop (or GraphXR) by clicking the Settings icon on a project tile or list item and choosing Export project.

The exported file includes the project name and a .gxrproject extension, for example: Tutorial.gxrproject. It can then be imported into any Desktop or GraphXR instance.

To import a saved project:

  1. On the Projects home page, click Import Project.

    20 01 03 KD ImportProject
  2. Navigate to a saved project, and click Open (or simply drag and drop the file on the dialog).

    The project is added to the Projects page, and you can choose to open it immediately.

Manage Existing Projects

A tile or list item includes information and tools to review and configure a project:

  • Project name

  • Database badge showing the database type connected to the project (if any), e.g. NEO4J, SPAN (Spanner Graph), PUPPY (Puppygraph), KoreDB (for the internal project database), etc.

  • Sandbox badge on pre-configured sandbox projects.

  • Settings Menu to edit the project.

  • An optional brief description of the project.

  • The date the project was Created, and the date it was last Opened.

Search for a Project

To find a specific project, you can:

  • Use the Search bar at the top of the page to find one or more projects by name.

  • Use the dropdown menu in the My Projects section to sort projects by

    • Project name

    • Database type

    • Date created

    • Date last opened

Edit, Clone, or Delete a Project

In the Settings menu for a Project select:

  • Edit project name, template, and/ or database type.

  • Clone to create a copy of the project.

  • Export Project to export the project to your local system as a .gxrproject file.

  • Protect from deletion / Allow deletion project options. When protected from deletion, a lock icon appears next to the project name.=.

  • Delete Project to delete the project, its saved views and internal graph database (but not data in an external connected graph database).

Manage Your User Account

Go to the user menu at the top of the Projects page to edit your desktop account settings or log out.

Update Account Details

  • Select Settings to review your Kineviz Desktop configuration and Cloud settings, including the Current plan and cloud token usage. Under Cloud settings, you can click Manage account to change subscription, billing, and account details on the Kineviz Cloud.

  • Select Logout to log out of Kineviz Desktop.

Select UI Language

Use the language selector at the top right of the Projects page to switch between default English, Chinese, or Spanish user interfaces.

20 01 05 KD LanguageMenu

Access Documentation

Click links at the bottom of the browser window to open user guides available on the Kineviz Help Center.

  • Help opens Kineviz Desktop user documentation.

  • The version number at the bottom of the browser window opens release notes for the current Kineviz Desktop version.

User Feedback and Community

Click links at the bottom of the browser window for:

  • A Feedback form to submit questions or comments for Kineviz response.

  • A Discord invitation to join the Kineviz Discord community.