⚠️ creme is in an experimental state. Use with caution!
Creme is a simple, opinionated build-time static asset tool for server-side Rust websites, complete with compile-time checks and a fast dev server for quick iteration.
- 🔥 Fast Dev-Mode Server
- 📁 Static File Handling
- 🔎 Cache Busting
- ⚡ CSS Bundling With LightningCSS
Create a public and assets folder in your project's manifest.
Public files are copied over without any modifications, asset files
are hashed, minified, and optimized.
An example project may look like this:
my_website/
├── Cargo.toml
├── src/
│ ├── main.rs
│ └── ...
├── public/
│ ├── robots.txt
│ └── favicon.ico
└── assets/
└── css/
├── style.css
└── modules/
├── _mod1.css
└── _mod2.css
Configure Creme in your build.rs script, using the included builder.
Creme lets you either embed assets into the binary for quick and easy deployment, or to a directory of your choice for deploying to a CDN.
use creme_bundler::{Creme, CremeResult};
fn main() -> CremeResult<()> {
// Recommended to include. Creme will setup the rest.
println!("cargo:rerun-if-changed=build.rs");
Creme::new()
.out_dir("dist")? // Outputs assets to the `dist` directory, for CDN deployment.
// .embedded()? // Or prepare assets to be embedded into the binary and served directly.
.recommended()? // Reads from `public` and `assets` folder.
.bundle()
}In your Rust code, reference an asset's URL:
use creme::asset;
asset!("css/style.css");
// Becomes "/assets/style-[hash].css" in release mode
// Or "/assets/css/style.css" in dev mode.Or directly in your template engine of choice:
use creme::asset;
html! {
head {
title { "Hello Creme + Maud!" }
link rel="stylesheet" href=(asset!("css/style.css"));
}
...
img src=(asset!("img/cat.jpeg"));
}Optionally, use the built-in tower creme::service!() macro. This handles
creating and setting up the dev server service.
For example, with Axum:
let app = Router::new()
.route("/", get(index_handler))
.fallback_service(
creme::service!()
.fallback(not_found_handler.into_service())
);For more, see here for examples
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent