aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorgabrielgio <gabriel.giovanini@pm.me>2022-03-25 17:37:45 +0100
committergabrielgio <gabriel.giovanini@pm.me>2022-03-25 17:37:45 +0100
commit0bef00b83e965aa350df1cd6a16c6ac39c388d93 (patch)
tree8c94855e87b50884de2ed68d969202d907a1bf0a /README.md
parentdf46e401bd3dac1162cace8e9259ddaba02d5332 (diff)
downloadgenpass-0bef00b83e965aa350df1cd6a16c6ac39c388d93.tar.gz
genpass-0bef00b83e965aa350df1cd6a16c6ac39c388d93.tar.bz2
genpass-0bef00b83e965aa350df1cd6a16c6ac39c388d93.zip
feat: Add initial draft for rust wasm
It adds the initial tooling for build and publishing a static site with wasm. The generate code is barebones, that is just a PoC for tooling, later I'll add proper code logic and test for it.
Diffstat (limited to 'README.md')
-rw-r--r--README.md69
1 files changed, 69 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1e4617a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,69 @@
+<div align="center">
+
+ <h1><code>wasm-pack-template</code></h1>
+
+ <strong>A template for kick starting a Rust and WebAssembly project using <a href="https://github.com/rustwasm/wasm-pack">wasm-pack</a>.</strong>
+
+ <p>
+ <a href="https://travis-ci.org/rustwasm/wasm-pack-template"><img src="https://img.shields.io/travis/rustwasm/wasm-pack-template.svg?style=flat-square" alt="Build Status" /></a>
+ </p>
+
+ <h3>
+ <a href="https://rustwasm.github.io/docs/wasm-pack/tutorials/npm-browser-packages/index.html">Tutorial</a>
+ <span> | </span>
+ <a href="https://discordapp.com/channels/442252698964721669/443151097398296587">Chat</a>
+ </h3>
+
+ <sub>Built with 🦀🕸 by <a href="https://rustwasm.github.io/">The Rust and WebAssembly Working Group</a></sub>
+</div>
+
+## About
+
+[**📚 Read this template tutorial! 📚**][template-docs]
+
+This template is designed for compiling Rust libraries into WebAssembly and
+publishing the resulting package to NPM.
+
+Be sure to check out [other `wasm-pack` tutorials online][tutorials] for other
+templates and usages of `wasm-pack`.
+
+[tutorials]: https://rustwasm.github.io/docs/wasm-pack/tutorials/index.html
+[template-docs]: https://rustwasm.github.io/docs/wasm-pack/tutorials/npm-browser-packages/index.html
+
+## 🚴 Usage
+
+### 🐑 Use `cargo generate` to Clone this Template
+
+[Learn more about `cargo generate` here.](https://github.com/ashleygwilliams/cargo-generate)
+
+```
+cargo generate --git https://github.com/rustwasm/wasm-pack-template.git --name my-project
+cd my-project
+```
+
+### 🛠️ Build with `wasm-pack build`
+
+```
+wasm-pack build
+```
+
+### 🔬 Test in Headless Browsers with `wasm-pack test`
+
+```
+wasm-pack test --headless --firefox
+```
+
+### 🎁 Publish to NPM with `wasm-pack publish`
+
+```
+wasm-pack publish
+```
+
+## 🔋 Batteries Included
+
+* [`wasm-bindgen`](https://github.com/rustwasm/wasm-bindgen) for communicating
+ between WebAssembly and JavaScript.
+* [`console_error_panic_hook`](https://github.com/rustwasm/console_error_panic_hook)
+ for logging panic messages to the developer console.
+* [`wee_alloc`](https://github.com/rustwasm/wee_alloc), an allocator optimized
+ for small code size.