cargo-webassembly

This cargo extension is for developing front end applications in WebAssembly. Use it's subcommands to generate Rust projects ready to develop WebAssembly immediately, and use the tool to run a local dev server to see it while you work.

This project is currently beta, but totally functional! Next steps include:

• cleaning up the code to use less unwrap
• use a better open url library (the current one has some weird behavior).
• support project file watching and recompiling

First make sure you install Rust and have the wasm32 toolchain installed:

rustup target add wasm32-unknown-unknown

Install with the following command:

cargo install cargo-webassembly

Create a new project

cargo webassembly new my_project

This will initialize a Rust WebAssembly project completely setup to run in the browser.

Run your project

Go into your projects root directory (e.g. cd my_project)

cargo webassembly run

This will compile and start a server by default on port 8080, you can change the port with the -p option.

This server is setup for single-page apps where all non-static file routes redirect to the root index.html.

Building your project

cargo webassembly build

This command will just compile your WebAssembly and place everything you need for your web app in the dist folder.

Next steps

Check out more ways to interact with the browser using the web package!

Here's some cool examples:

• snake

License

This project is licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in cargo-webassembly by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.