Update readme about how to get started

[eboody]

I'd love to give this a whirl but the example isn't compiling for me :/

[boris-schwarz]

Got it running by doing following

1. Add following dependencies to cargo.toml

[dependencies]
axum = "0.8.8"
chrono = "0.4.42"
derived-cms = {version="0.6.1", features=["sqlite", "json"]}
ormlite = {version="0.23.3", features=["sqlite"]}
serde = "1.0.228"
sqlx = {version="0.8.6", features=["runtime-tokio", "tls-rustls-ring-webpki"]}
tokio = "1.49.0"
ts-rs = "10.1.0"
uuid = {version="1.19.0", features=["v4"]}

2. Add following code to main.rs

#[derive(Debug, Clone, Serialize)]
struct MyError;

impl fmt::Display for MyError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "An error occured")
    }
}
impl std::error::Error for MyError {}
impl From<MyError> for AppError {
    fn from(_: MyError) -> Self {
        AppError::new("Error".to_owned(), "An error occured".to_owned())
    }
}
impl From<ormlite::Error> for MyError {
    fn from(_: ormlite::Error) -> Self {
        MyError
    }
}

impl From<sqlx::Error> for MyError {
    fn from(_: sqlx::Error) -> Self {
        MyError
    }
}

3. Create /.tmp/db.sqlite

The code will compile, but firing a GET request to http://127.0.0.1:3000/api/v1/posts returns a 400 Bad Request and firing a POST request to http://127.0.0.1:3000/api/v1/posts with following body returns a 400 Bad Request too:

{
  "title": "foo",
  "date": "2026-01-07T10:30:00Z",
  "body": ["text"],
  "draft": false
}

For now, I will not look into it any further, but maybe that helps you.

Cheers, Boris

[eboody]

@boris-schwarz I appreciate it! Looks like you've been working on a headless CMS yourself. How has that been going for you?

[nitn3lav]

Hi, sorry for my late reply, I just added an example here, does this help you?

[boris-schwarz]

@nitn3lav Also sorry for my late reply, the example works, thanks a lot! 👍 main.css seems to be missing, but that's only visual.

@eboody Indeed, I've got a background in web development, so naturally my first hobby project while learning rust had to be a CMS. Went in over my head and am periodically abandoning it again :´-)