mirror of
https://github.com/yewstack/yew.git
synced 2025-12-08 21:26:25 +00:00
b246e0d5ed
* tree-wide: update links to https://rustwasm.github.io/wasm-bindgen https://rustwasm.github.io/wasm-bindgen -> https://wasm-bindgen.github.io/wasm-bindgen https://rustwasm.github.io/docs/wasm-pack -> https://drager.github.io/wasm-pack/book/ https://rustwasm.github.io/wasm-pack -> https://github.com/drager/wasm-pack
45 lines
3.4 KiB
Plaintext
45 lines
3.4 KiB
Plaintext
---
|
|
title: 'Wasm Build Tools'
|
|
description: 'Information about build tools'
|
|
---
|
|
|
|
## **Wasm Build Tools**
|
|
|
|
Extra tooling is needed to facilitate the interop between WebAssembly and JavaScript. Additionally,
|
|
depending on the tool you choose, they can help make deployment and packaging much less of a
|
|
headache by generating all of the JavaScript code necessary to load and run your app's `.wasm`
|
|
binary in a browser.
|
|
|
|
### [**`trunk`**](https://github.com/thedodd/trunk/)
|
|
|
|
A tool practically made for building Yew apps.
|
|
It can build any `wasm-bindgen` based app and its design is inspired by rollup.js.
|
|
With Trunk you don't need to have Node.js installed or touch any JavaScript code for that matter.
|
|
It can bundle assets for your app and even ships with a Sass compiler.
|
|
|
|
All of our examples are built with Trunk.
|
|
|
|
[Getting started with `trunk`](../getting-started/project-setup/using-trunk.mdx)
|
|
|
|
### [**`wasm-pack`**](https://drager.github.io/wasm-pack/book/)
|
|
|
|
A CLI tool developed by the Rust / Wasm Working Group for packaging up WebAssembly. Best used
|
|
together with the [`wasm-pack-plugin`](https://github.com/wasm-tool/wasm-pack-plugin) for Webpack.
|
|
The primary purpose of `wasm-pack` is building Wasm libraries for use in JavaScript.
|
|
Because of this, it can only build libraries and doesn't provide useful tools like a development server or automatic rebuilds.
|
|
|
|
[Get started with `wasm-pack`](../getting-started/project-setup/using-wasm-pack.mdx)
|
|
|
|
### Comparison
|
|
|
|
| | `trunk` | `wasm-pack` |
|
|
| ----------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
|
|
| Project Status | Actively maintained | Actively maintained by the [Rust / Wasm Working Group](https://rustwasm.github.io) |
|
|
| Dev Experience | Just works! Batteries included, no external dependencies needed. | Bare-bones. You'll need to write some scripts to streamline the experience or use the webpack plugin. |
|
|
| Local Server | Supported | Only with webpack plugin |
|
|
| Auto rebuild on local changes | Supported | Only with webpack plugin |
|
|
| Asset handling | Supported | Only with webpack plugin |
|
|
| Headless Browser Testing | [In Progress](https://github.com/thedodd/trunk/issues/20) | [Supported](https://github.com/drager/wasm-pack/book/commands/test.html) |
|
|
| Supported Targets | <ul><li><code>wasm32-unknown-unknown</code></li></ul> | <ul><li><code>wasm32-unknown-unknown</code></li></ul> |
|
|
| Example Usage | [Sample app](./../getting-started/build-a-sample-app.mdx) | [Starter template](https://github.com/yewstack/yew-wasm-pack-minimal) |
|