> ## Documentation Index
> Fetch the complete documentation index at: https://hub-docs.wundergraph.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Your First Graph

> WunderGraph Hub allows you to create GraphQL schemas from scratch or by importing existing schemas from various sources

### From the Hub Dashboard

<img src="https://mintcdn.com/wundergraphhub/-jQI1JMT_pnsyeFl/images/create-graph.png?fit=max&auto=format&n=-jQI1JMT_pnsyeFl&q=85&s=b18a48f143bab3a70924ef73593fc749" alt="Create a graph from Hub Dashboard" width="2880" height="1674" data-path="images/create-graph.png" />

<Steps>
  <Step title="Navigate to your organization or personal account">
    * Click on your organization or personal account in the left sidebar
    * Go to the **Graphs** section
  </Step>

  <Step title="Click &#x22;Create Graph&#x22;">
    * Enter a unique name for your graph (this becomes the slug)
    * The name must follow slug format (lowercase, hyphens allowed)
    * Click **Create Graph**
  </Step>
</Steps>

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

### 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:

<img src="https://mintcdn.com/wundergraphhub/-jQI1JMT_pnsyeFl/images/import-options.png?fit=max&auto=format&n=-jQI1JMT_pnsyeFl&q=85&s=9b476a279d3da31f8bbf62a64e3458ed" alt="Import schema options" width="2880" height="1674" data-path="images/import-options.png" />

<CardGroup cols={3}>
  <Card title="From Registry" icon="cloud">
    Import schemas directly from Cosmo or Apollo GraphOS
  </Card>

  <Card title="Upload Files" icon="upload">
    Upload .graphql or .graphqls files from your computer
  </Card>

  <Card title="Start from Scratch" icon="sparkles">
    Begin with an empty schema and build types manually
  </Card>
</CardGroup>

### Upload Schema Files

Import GraphQL schema files directly from your file system:

<Steps>
  <Step title="Select &#x22;Upload Files&#x22;" />

  <Step title="Drag and drop">
    or browse for `.graphql` or `.graphqls` files
  </Step>

  <Step title="Configure schema names">
    * Hub automatically generates names from file names
    * Edit names to match your schema organization
    * Names must be valid slugs
  </Step>

  <Step title="Import">
    Hub processes files and sets up your GraphQL schemas
  </Step>
</Steps>

### Start from Scratch

Begin with an empty schema and build it incrementally:

<Steps>
  <Step title="Select &#x22;Start from Scratch&#x22;" />

  <Step title="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
  </Step>
</Steps>

## 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

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