Skip to content

Latest commit

 

History

History
42 lines (28 loc) · 1.87 KB

README.md

File metadata and controls

42 lines (28 loc) · 1.87 KB

Yew PWA Minimal

This project contains a minimal Progressive Web App (PWA) using Yew. It is based on Yew's sample app and James Johnson's Simple PWA Tutorial.

Compared to Yew's sample app, the following changes were implemented:

  • Add a manifest file (manifest.json) describing the PWA.
  • Add a service worker (service_worker.js) that allows the app to work offline.
  • Add an icon (icon-256.png).
  • Register the service worker and manifest file in index.html.
  • Add a trunk config (Trunk.toml) that sets the public url to ./. The default is root (/), which doesn't work if the project files aren't served at the domain's root. The change allows to deploy the files to github pages (https://USERNAME.github.io/PROJECT_NAME).

Preparation

Install the wasm32-unknown-unknown target:

rustup target add wasm32-unknown-unknown

Install trunk:

cargo install trunk

Build

Build using trunk:

trunk build
# or
trunk build --release

Test / Deploy

PWAs need to be accessed via https. If you don't have a https server set up already, the simplest way to test your PWA is to use Github Pages. Create a new project, activate Github Pages for the master branch and upload the contents of the dist/ folder to it.

The website should become available under https://USERNAME.github.io/PROJECT_NAME after a couple of minutes. I've uploaded the deployment files to https://github.com/fkohlgrueber/yew-pwa-deploy. The PWA is available under https://fkohlgrueber.github.io/yew-pwa-deploy/.

Feel free to open issues if anything doesn't work for you.