## From the Hub Dashboard

1

Navigate to your organization or personal account

- Click on your organization or personal account in the left sidebar
- Go to the **Graphs** section

2

Click "Create Graph"

- Enter a unique name for your graph (this becomes the slug)
- The name must follow slug format (lowercase, hyphens allowed)
- Click **Create Graph**

Graph names must be unique within your organization or personal account. They serve as both display names and URL slugs.

### What Gets Created

When you create a new graph, Hub automatically sets up:

- **Main Branch**: The primary collaborative workspace with real-time editing
- **Empty Schema**: Ready for GraphQL type creation and organization
- **Real-time Collaboration**: Multiple users can edit simultaneously
- **Collaborator Access**: Automatic permissions based on your organization settings

## Importing Existing Schemas

Hub provides multiple ways to import existing GraphQL schemas into your new graph. When you first open a new graph, you’ll be presented with three options:

## From Registry

Import schemas directly from Cosmo or Apollo GraphOS

## Upload Files

Upload .graphql or .graphqls files from your computer

## Start from Scratch

Begin with an empty schema and build types manually

### Upload Schema Files

Import GraphQL schema files directly from your file system:

1

Select "Upload Files"

2

Drag and drop

or browse for `.graphql` or `.graphqls` files

3

Configure schema names

- Hub automatically generates names from file names
- Edit names to match your schema organization
- Names must be valid slugs

4

Import

Hub processes files and sets up your GraphQL schemas

### Start from Scratch

Begin with an empty schema and build it incrementally:

1

Select "Start from Scratch"

2

Use the creation tools

- **Create Types/Fields**: Add GraphQL types and fields
- **Create Schemas**: Organize your GraphQL types
- **Define Relationships**: Connect types and establish data relationships

## Starter Templates

For new users, Hub automatically creates a starter template called **“hr-platform”** that demonstrates:

- **Multiple Schemas**: `users`, `hr`, `payroll` domain schemas
- **GraphQL Patterns**: Type relationships, field organization, schema structure
- **Real Schema Examples**: Complete HR domain with Users, Departments, Salary, Benefits

The starter template serves as a learning resource and can be safely deleted once you’re familiar with Hub’s GraphQL schema design concepts.
