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

# Hello World

> Axum is a web application framework that focuses on ergonomics and modularity.

This section revolves around simple Axum examples you can get quickly started with by following these 3 steps:

1. Initialize a new Axum project by running the `shuttle init --template axum` command
2. Copy pasting the contents of the example you want to deploy -- make sure to check the tabs of the snippet(s) to ensure you are copying the right code/file
3. Running the `shuttle deploy` command

> [!TIP]
>
> If you are looking for step-by-step guides, check out our
> [Tutorials](https://docs.shuttle.dev/templates/tutorials) section.

You can clone the example below by running the following (you'll need `shuttle` CLI installed):

```bash theme={null}
shuttle init --template axum
```

```rust src/main.rs theme={null}
use axum::{routing::get, Router};

async fn hello_world() -> &'static str {
    "Hello, world!"
}

#[shuttle_runtime::main]
async fn main() -> shuttle_axum::ShuttleAxum {
    let router = Router::new().route("/", get(hello_world));

    Ok(router.into())
}
```

```toml Cargo.toml theme={null}
[package]
name = "hello-world"
version = "0.1.0"
edition = "2021"

[dependencies]
axum = "0.8"
shuttle-axum = "0.57.0"
shuttle-runtime = "0.57.0"
tokio = "1.28.2"
```

***

<Snippet file="other-frameworks.mdx" />

<Snippet file="check-examples.mdx" />


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