Create Rust + TypeScript libraries with ease! PR'S WELCOMED!

I wanted to create a WebAssembly/Rust library with additional JS features, but I couldn't find any resources on how to integrate the npm-ready library built by wasm-pack with TypeScript. All the examples online either seemed to use the output of wasm-pack using npm link, or didn't have TypeScript support. So, I created this, a template that allows you to embed wasm-pack all within one single TypeScript-based library. Enjoy!

Before development, make sure you have installed:

• wasm-pack
• cargo-watch

# clone the repo
git clone --depth 1 --branch master https://github.com/iantheearl/rust-typescript-template.git your-project-name
cd your-project-name

# install dependencies
yarn

# start development
yarn run dev

# run example
yarn run example

# visit http://localhost:8080

After installation, start developing here:

• ./pkg: Rust source files
• ./src: TypeScript source files

# build the library to ./dist, including .wasm
yarn build

# push to npm
npm publish --access public

# build the example to `./example/build`, and push that folder to the gh-pages branch
yarn deploy

Configure github to deploy branch gh-pages.

• ./core: Rust code, the core of your library
• ./pkg: wasm-pack built npm-ready library
• ./src: TypeScript source code, where u can import from wasm-pack
• ./example: A web app that uses your library directly from ./dist
• ./tests: To test your library

MIT © Rust TypeScript Template