Static Files

​

Description

This example has one route at / where the homepage is served and shows you how you can serve HTML or other types of files with Actix Web.

Note that static assets are declared in the Shuttle.toml file.

You can clone the example below by running the following (you’ll need cargo-shuttle installed):

cargo shuttle init --from shuttle-hq/shuttle-examples \
 --subfolder actix-web/static-files

​

Code

use actix_files::NamedFile;
use actix_web::{get, web::ServiceConfig, Responder};
use shuttle_actix_web::ShuttleActixWeb;

#[get("/")]
async fn index() -> impl Responder {
    NamedFile::open_async("assets/index.html").await
}

#[shuttle_runtime::main]
async fn actix_web() -> ShuttleActixWeb<impl FnOnce(&mut ServiceConfig) + Send + Clone + 'static> {
    let config = move |cfg: &mut ServiceConfig| {
        cfg.service(index);
    };

    Ok(config.into())
}

​

Usage

After you clone the example, launch it locally by using cargo shuttle run then visit the home route at http://localhost:8000 - you should see a homepage that shows our included HTML file.

You can extend this example by adding more routes that serve other files.