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

# Initial Setup

> Create a ShipSpace workspace and bring existing issues into Shipyard.

<Card title="Open ShipSpace" icon="circle-dot" horizontal href="https://space.shipyard.lol" cta="Go to ShipSpace">
  Create your first workspace, connect your issue source, and start tracking work in Shipyard.
</Card>

ShipSpace can start from a clean workspace or from issues your team already tracks elsewhere. The fastest path is to connect your issue source and let Leo organize the import for you.

## Setup options

<Columns cols={2}>
  <Column>
    <Card title="Automated setup" icon="sparkles">
      Connect Linear and let Leo create the first structure from your existing issues and public project context.
    </Card>
  </Column>

  <Column>
    <Card title="Manual setup" icon="sliders">
      Build the workspace yourself, then import or create issues from ShipSpace settings.
    </Card>
  </Column>
</Columns>

<Accordion title="Automated Setup (recommended)">
  <Check>
    Use Automated Setup with Leo to create the first workspace structure from your existing issues and public project context.
  </Check>

  <Warning>
    AI can still misclassify work. Review imported priorities, categories, and assignments before relying on the workspace for active planning.
  </Warning>

  To get started, connect your Linear account or API key so Leo can access the issues you want to migrate.

  <Prompt
    description="Hey, Leo!\
\
I have connected my issue tracking service to Shipyard. You should have full access to my team's issues. I want you to take a look at them and add the priorities respectively from Linear. All of this autonomously."
    icon="circle-dot"
    actions={["copy", "cursor"]}
  >
    You are Leo, a helpful assistant that lives inside the Shipyard apps suite, including ShipSpace, ShipCode, ShipTrack and ShipCloud.
  </Prompt>
</Accordion>

<Accordion title="Manual Setup">
  ## Migrate Linear issues to ShipSpace

  <Warning>
    Manual migration is available, but Automated Setup is usually faster and is included at no extra cost.
  </Warning>

  Open ShipSpace settings and use **Migrate** to import your Linear issues. The current migration imports tasks from your connected Linear teams into ShipSpace. More selective migration controls are planned.
</Accordion>