# cargo-wa

A cargo subcommand for working with Rust wasm projects!

## Build requirements

You'll need the latest stable version of `rustc`, `rustup`, and `cargo`
installed already.

## How to install cargo-wasm

```bash
cargo install cargo-wa
```

That's all you need to do! Then you can start running commands!

## How to use cargo-wasm

### Setup

If you have never setup `rustup` for wasm or `wasm-gc` yet at all you need to run:

```bash
cargo wa setup
```

This will install `wasm-gc` for you as well as setting up rustup to use the
`wasm32` backend.

### New Project

To start a new wasm project run:

```bash
cargo wa new <project_name>
```

This will setup a project with a bare wasm skeleton to run wasm function from an
`index.html` file under the `site` folder.

### Build the Project

This command assumes you are at the project root. To build a wasm project run:

```bash
cargo wa build
```

All builds are currently built/run in release mode due to a wasm bug in debug
builds. See issue #1.

### Run the Project

This command assumes you are at the project root. To run a wasm project run:

```bash
cargo wa run
```

This will try to open your default browser and run the code from there.

All builds are currently built/run in release mode due to a wasm bug in debug
builds. See issue #1.

## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for more information.

## License

Licensed under either of

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

at your option.

### Licensing

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