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

# Quick Start

> Get started with your first Shuttle project and deploy it to the cloud 🚀

> [!NOTE]
>
> This guide assumes you have installed the Shuttle CLI. If you haven't, please visit the [installation guide](https://docs.shuttle.dev/getting-started/installation.md) first.

## Login to Your Account

First, you'll need to authenticate with Shuttle. The login command will open your browser to the [Shuttle Console](https://console.shuttle.dev/) where you can authenticate:

```sh theme={null}
shuttle login
```

> [!NOTE]
>
> You can use your Google account, GitHub account or email to authenticate with Shuttle.

## Create Your First Project

The `init` command helps you create a new Shuttle project. You can choose from:

* A simple Hello World template
* One of our [example projects](https://docs.shuttle.dev/examples)
* A [pre-built template](https://docs.shuttle.dev/templates)

For your first project, we recommend starting with the Hello World template:

```sh theme={null}
shuttle init
```

## Run Your Project Locally

Before deploying, you can run your project locally to test it:

```sh theme={null}
shuttle run
```

## Deploy Your Project

When you're ready to deploy your project to the cloud:

```sh theme={null}
shuttle deploy
```

This will:

1. Upload your code to Shuttle's platform and build it into a Docker image
2. Deploy it to our infrastructure and assign a public HTTPS URL

> [!NOTE]
>
> The first deployment might take a few minutes as it builds your project and sets up the infrastructure.

## Next Steps

> [card] [Examples](https://docs.shuttle.dev/examples)
>
> Explore more example projects

> [card] [Resources](https://docs.shuttle.dev/resources/resources.md)
>
> Learn about available resources

> [card] [Templates](https://docs.shuttle.dev/templates)
>
> Start from a pre-built template


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.