update readme.md
Hunter Irving
Monday, July 6th, 2026 at 3:46 PM
54 - once you're happy with your mix, run `./build.py` and follow the interactive prompts to generate `manifest.json` and `service-worker.js`, which enable PWA installation and offline functionality.
55
56 3. **ship it**
- - **public host:** when using media you have distribution rights for, you can upload the entire project directory to any static web host with HTTPS support (GitHub Pages, Neocities, AWS S3, etc).<br>
57 + - using a **public host:**
58 + - when using media you have distribution rights for, you can upload the entire project directory to any static web host with HTTPS support (GitHub Pages, Neocities, AWS S3, etc).<br>
59 **publishing files you don't have the right to distribute may constitute copyright infringement.**
-
- or...
-
- - **your own wifi:** install onto your own devices using a <a href="#local-network-installation">local HTTPS server</a>. no public host needed, and nothing ever leaves your network.
60 + - over **your own wifi:**
61 + - install onto your own devices using a <a href="#local-network-installation">local HTTPS server</a>. no public host necessary, and nothing ever leaves your network.
62
63 4. **save it**
64 - once your mixapp is hosted, anyone can install it by opening the URL and following their browser's PWA installation steps:
81
82 <br>
83
-PWA installation requires a secure (HTTPS) connection. the easiest way to get one is to upload your files to a public host, but publishing files this way is distribution, which means it's only appropriate for content you have the right to distribute.
84 +PWA installation requires a secure (HTTPS) connection. the easiest way to get one is to upload your files to a public host, but publishing files this way is only appropriate for content you have the right to distribute.
85
86 if you'd like to install mixapps without pushing to a public host, you can use `https_serve.py` to serve the necessary files over HTTPS on your local network.
87
122
123 3. scan the second QR code to open your mixapp over HTTPS, then follow the <a href="https://hunterirving.github.io/web_workshop/pages/pwa">PWA installation instructions</a> for your device/OS to add it to your homescreen. after the initial installation and cache, mixapps work completely offline; they no longer need the network, server, or certificate.
124
125 +> **hint:** consider reserving a static IP for your computer in your router's DHCP settings. the cached certificate is tied to your LAN IP, so it breaks if that IP changes (delete `.https_certs/` to re-mint).
126 +
127 <h3 id="cleaning-up">cleaning up</h3>
128
129 - **on the installing device (recommended):** it's good practice to untrust the CA once you're done installing, and only re-enable it when you want to install another mixapp.