Skip to main content

Introduction to projects

A project is the central organizational unit in Hex. It includes the Logic View, App Builder, and Environment views.

Projects home#

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

Each section of the Projects page can be filtered by the category and status of projects, which are defined by workspace Admins.

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:

Create a project from scratch#

Select the New project button on the Projects page to generate an empty project.

Upload 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, the outputs will often appear instantly in the project without needing to be re-run.


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

Project options#

Once you are inside the project, the project name dropdown offers several options for a project:

dropdown with options to rename or duplicate the project, or export the project as .ipynb file.

Rename the project#

You can rename the project.

Duplicate the project#

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

Export as .ipynb#

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

Project organization#

A project can be tagged with one status and multiple categories. You can use these project labels to filter the main Projects page to organize large numbers of projects. Status and category are not visible to external App or Viewer type users.

Workspace administrators can edit and add new statuses and categories from the Administration Panel on the Projects page.