Skip to content

Getting Started

This page covers how to sign in to Mosaic and how to find your way around once you are in. If you are new to Mosaic, start here, then read the Overview for the concepts behind projects and collections.

Signing In

Mosaic is a web application — there is nothing to install. To get started, open your browser and navigate to:

https://mosaic.frameshift.io/

If you have an institutional deployment of Mosaic you will want to use that specific URL. For example: https://mosaic.examplehospital.org/

Sign in with your credentials, or create an account if you do not already have one. If you have forgotten your password, use the Forgot Password? link on the sign-in screen to reset it.

Tip: Access to individual projects and collections is granted per user. If you sign in but cannot find a case or cohort you expect to see, you may not yet have been added to it — contact a project Admin, who can grant you access from the project's member settings (see Project Members).

Mosaic is organized into projects and collections. A project holds the data for a single case (for example, an individual or a family), while a collection is a group of projects that you work with together as a cohort. These concepts are introduced in the Overview and described in full in Projects and Collections.

The Home Page

After signing in, you are taken to a table of the projects and collections you have access to.

In this table, collections are shown in green and carry a badge on the right indicating how many projects they contain; projects are shown without that badge. To open a project or collection, click its name. Use the Search bar to find an item by name — for example, searching for MXL returns the projects whose names contain MXL. The filter control next to the search bar lets you choose whether to show projects, collections, or both.

The + Create button at the top of the table is used to create a new project or collection; this is described in Creating Projects and Collections.

Inside a Project or Collection

Once you open a project or collection, the left menu is your primary means of navigation. It provides access to the Dashboard (the home page), Samples, Project Attributes, Ontologies (including HPO terms), Variants, Conversations, Documents, Analytics, and Analyses, with administrative pages grouped under Settings & More. Each of these areas has its own section in this documentation.

The top menu bar provides cross-project navigation that is always available: Projects to return to the home table, Tasks to see outstanding items across the cases you are subscribed to (see Tasks), Conversations to open the cross-project conversation inbox (see Communication), Help, and Account.

Tip: A breadcrumb trail at the top of each page (for example, 1,000G Extended Demo / Projects) shows where you are and lets you step back up to a parent collection in one click.