web-bundler
| Crates.io | web-bundler |
| lib.rs | web-bundler |
| version | 0.2.0 |
| source | src |
| created_at | 2021-01-05 16:13:00.148994 |
| updated_at | 2023-10-12 07:11:28.493977 |
| description | Manages the building of WebAssembly single page app frontends from a build.rs script so that they can easily be embedded into Rust API projects |
| homepage | |
| repository | https://codeberg.org/worthe-it/web-bundler |
| max_upload_size | |
| id | 332246 |
| size | 30,496 |
Justin Wernick (JWorthe)
documentation
README
Web Bundler
Manages the building of WebAssembly single page app frontends from a build.rs script so that they can easily be embedded into Rust API projects.
Internally, the bundler uses wasm-pack to do the actual webassembly compilation.
Prerequisites
From a clean Rustup-based Rust installation, there are no additional steps. Web Bundler will download and install any dependencies it needs.
For Rust installations that are not done with Rustup, you will need to
add the wasm32-unknown-unknown compilation target manually (see the
wasm-pack docs
for details on how to do this).
Running the Demo Example
There is an example usage in the example directory. To
run the example, open a terminal in the example directory and run
cargo run. Then, open a web browser and navigate to
http://localhost:3030/. You should see a Seed web application.
Usage
Web-bundler expects you to have two projects: a frontend project using a single page app framework (like Seed), and a backend project using a web server framework (like warp). These projects should be in a common workspace.
Changes to your frontend project
-
Update your index.html to allow templating in Javascript and CSS.
Specifically, you need to add
{{ stylesheet | safe }}to the<head>section, and{{ javascript | safe }}to the end of the<body>. Optionally, if you want to set the base url, add<base href="{{ base_url }}">to the<head>as well.See the example frontend index.html.
-
Create a root stylesheet for your app called
./css/style.scss.This stylesheet will be compiled to CSS, and embedded directly into your index.html file.
See the example frontend style.scss.
-
Put all of your static assets in the
staticdirectoryAll files in the static directory will be copied directly to a static folder in the output directory.
See the example frontend static directory.
Changes to your API project
-
Update your Cargo.toml to depend on your frontend project and web-bundler
We depend on the frontend project in Cargo.toml so that Cargo knows to rerun build.rs whenever the frontend project changes.
See the example backend Cargo.toml.
-
Add a build.rs script that calls web-bundler for your frontend
See the example backend build.rs.
-
Use Rust Embed to embed your built frontend into your API binary
See the example backend main.rs. Our example uses the warp web server. Rust Embed also has examples for other web servers in their repo.
target and web-target directories
When web-bundler compiles the frontend, it overrides the default
target directory to be web-target instead of target. This is done
because, if the backend and frontend are in the same workspace, Cargo
will already be locking target while running the build.rs
script.
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option.Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.