Working With Projects

A Project is the central organizational unit in Hex. It includes the Logic View, App View, and Environment Views.

Projects Home

The default landing page for users in Hex is the Projects page. You can quickly find projects you created, as well as those shared with you and your Organization.

Each section of the Projects page can be filtered by the Category and Status of projects, which are defined by Organization administrators.

You can also see a variety of metadata about each project, including your level of access, the project creator, the time of last edit, and publication status.

Creating a New Project

There are two options for creating new projects in Hex:

Creating a Project from Scratch

Hit the "New Project" button on the Projects page to generate an empty Project.

Uploading Existing Jupyter Notebooks

You can upload any existing .ipynb (Jupyter Notebook) file into Hex. Because this file format typically stores the outputs from the last time it was executed, they will often appear instantly in Hex without needing to re-run.

While we support upload of any .ipynb file, you may run into package-related issues while moving your work from environment to environment. See Package Management for more details on configuring your environment in Hex.

Project Options

The dropdown in the upper-left offers several options for a project:

Renaming Projects

You can rename a project from the drop-down menu.

Duplicating Projects

Any user with a Viewer profile or higher can view all of the logic and configuration, and duplicate projects. The new, copied projects do not inherit any permissions from the original.

.ipynb Export

Take your logic to any other Jupyter Notebook-compatible application.

Project Labels

A project can be tagged with one Status and multiple Categories. These can be used to filter the main Projects page to more easily organize large numbers of projects. Labels are not visible to external App or Viewer type users.

Organization administrators can edit and add new labels from the Administration Panel.