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

# Postgres Todo App

> This article walks you through how you can easily set up a simple to-do app using Rocket and SQLx with PostgresQL.

## Description

This example shows how to make a simple TODO app using Rocket and a shared Shuttle Postgres DB.

The following routes are provided:

* GET `/todo/<id>` - Get a to-do item by ID.
* POST `/todo` - Create a to-do item. Takes "note" as a JSON body parameter.

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

```bash theme={null}
shuttle init --from shuttle-hq/shuttle-examples --subfolder rocket/postgres
```

## Code

<CodeGroup>
  ```rust src/main.rs theme={null}
  #[macro_use]
  extern crate rocket;

  use rocket::response::status::BadRequest;
  use rocket::serde::json::Json;
  use rocket::State;
  use serde::{Deserialize, Serialize};
  use shuttle_runtime::CustomError;
  use sqlx::{Executor, FromRow, PgPool};

  #[get("/<id>")]
  async fn retrieve(id: i32, state: &State<MyState>) -> Result<Json<Todo>, BadRequest<String>> {
      let todo = sqlx::query_as("SELECT * FROM todos WHERE id = $1")
          .bind(id)
          .fetch_one(&state.pool)
          .await
          .map_err(|e| BadRequest(e.to_string()))?;

      Ok(Json(todo))
  }

  #[post("/", data = "<data>")]
  async fn add(
      data: Json<TodoNew>,
      state: &State<MyState>,
  ) -> Result<Json<Todo>, BadRequest<String>> {
      let todo = sqlx::query_as("INSERT INTO todos(note) VALUES ($1) RETURNING id, note")
          .bind(&data.note)
          .fetch_one(&state.pool)
          .await
          .map_err(|e| BadRequest(e.to_string()))?;

      Ok(Json(todo))
  }

  struct MyState {
      pool: PgPool,
  }

  #[shuttle_runtime::main]
  async fn rocket(#[shuttle_shared_db::Postgres] pool: PgPool) -> shuttle_rocket::ShuttleRocket {
      pool.execute(include_str!("../schema.sql"))
          .await
          .map_err(CustomError::new)?;

      let state = MyState { pool };
      let rocket = rocket::build()
          .mount("/todo", routes![retrieve, add])
          .manage(state);

      Ok(rocket.into())
  }

  #[derive(Deserialize)]
  struct TodoNew {
      pub note: String,
  }

  #[derive(Serialize, FromRow)]
  struct Todo {
      pub id: i32,
      pub note: String,
  }
  ```

  ```sql schema.sql theme={null}
  DROP TABLE IF EXISTS todos;

  CREATE TABLE todos (
    id serial PRIMARY KEY,
    note TEXT NOT NULL
  );
  ```

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

  [dependencies]
  rocket = { version = "0.5.0", features = ["json"] }
  serde = "1.0.148"
  shuttle-rocket = "0.57.0"
  shuttle-runtime = "0.57.0"
  shuttle-shared-db = { version = "0.57.0", features = ["postgres", "sqlx"] }
  sqlx = "0.8.2"
  tokio = "1.26.0"
  ```
</CodeGroup>

## Usage

Once you've cloned the example, try launching it locally using `shuttle run`. Once you've verified that it runs successfully, try using cURL in a new terminal to send a POST request:

```bash theme={null}
curl -X POST -d '{"note":"Hello world!"}' -H 'Content-Type: application/json' \
 http://localhost:8000/todo
```

Assuming the request was successful, you'll get back a JSON response with the ID and Note of the record you just created. If you try the following cURL command, you should be able to then retrieve the message you stored:

```bash theme={null}
curl http://localhost:8000/todo/<id>
```

Interested in extending this example? Here's as couple of ideas:

* Add update and delete routes
* Add static files to show your records

***

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

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