📦✨ wasm-pack

Your favorite rust -> wasm workflow tool!

This tool seeks to be a one-stop shop for building and working with rust- generated WebAssembly that you would like to interop with JavaScript, in the browser or with Node.js. wasm-pack helps you build and publish rust-generated WebAssembly to the npm registry to be used alongside any other javascript package in workflows that you already use, such as a bundler like webpack or greenkeeper.

This project is a part of the rust-wasm group. You can find more info by visiting that repo!

demo

🔮 Prerequisities

🎙️ Commands

init: Generate an npm wasm pkg from a rustwasm crate
pack: Create a tarball of your rustwasm pkg
publish: Publish your rustwasm pkg to a registry

📝 Logging

We generate a wasm-pack.log file if wasm-pack errors on you, and you can customize the log verbosity using the verbosity flag.

Verbosity	Result
-v	All Info, Warn, and Errors are logged
-vv	All Debug, Info, Warn, and Errors are logged
-vvv	All Trace, Debug, Info, Warn, and Errors are logged

👯 Contributing

Read our guide on getting up and running for developing wasm-pack, and check out our contribution policy.

⚡ Quickstart Guide

Write a crate in Rust.
Add wasm-bindgen to your Cargo.toml:

[lib]
crate-type = ["cdylib"]

[dependencies]
wasm-bindgen = "0.2"

Add this to the top of your src/lib.rs:

#![feature(use_extern_macros)]

extern crate wasm_bindgen;

use wasm_bindgen::prelude::*;

Annotate your public functions with #[wasm_bindgen], for example:

#[wasm_bindgen]
extern {
    pub fn alert(s: &str);
}

#[wasm_bindgen]
pub fn greet(name: &str) {
    alert(&format!("Hello, {}!", name));
}