Shows uploading and resizing an image client-side, but could just as well be ran on a node backend by changing build flags. The resizing WASM library is built in rust and can be imported by any process that can run JavaScript.
Note that while this project is public, it is still work in progress! For now, the WASM Module just returns an identical image. But it will resize soon (tm)
TODO:
- Accept more formats than just PNGs
- Actually resize images
- Link to example showing direct import of module in component, instead of via Context
- Example of server-side WASM?
This project uses Wasm-Pack to build rust-generated WebAssembly packages with JavaScript interop from the NextJS project. Wasm-Pack is part of the rust-wasm group. Visit ther repo to learn more!
It then uses a small NextJS web-app to demo the WASM functions we have written by exposing our WASM library via the React Context. Using Context allows us to share one instance of our library between several components in the three, but we could also instantiate the module directly in our component as well.
The project also uses Tailwind for styling.
The WASM module was initialized as a lib. So it can not work on its own. If we have a look at the Cargo.toml inside the ./wasm
directory, we see that it is actually a cdylib
; C dynamic library.
We can create a dev build of the package from the ./wasm
folder with:
wasm-pack build --target web --dev
Alternatively, just run build-wasm.sh
to generate a release build targeting the web.
Building the module gives us our module, plus type definitions and a JavaScript wrapper inside the pkg
folder.
Remember to rebuild the package if you make any changes!
All the files for the library will be in the ./wasm/src
folder, and all generated WASM and supporting files will be inside the ./wasm/pkg/
folder. If you have a look in tsconfig.js
, you can see that we have aliased this folder, so we can import with @wasm/module-name
.
First, run the development server:
pnpm dev
Open https://localhost:3000 with your browser to see the result.
You can start editing the page by modifying app/page.tsx
. The page auto-updates as you edit the file.
This project uses next/font
to automatically optimize and load Inter, a custom Google Font.
To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!