@bysir/herdr-web 0.6.1 → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +29 -0
  2. package/package.json +5 -5
package/README.md CHANGED
@@ -266,6 +266,35 @@ arranged on a phone do not follow you to the desktop, while the definitions stay
266
266
  → Why the gestures are split this way, how the keyboard is handled, copy and paste on a phone, the
267
267
  details of the dock and the top bar: [MOBILE.md](docs/dev/MOBILE.md)
268
268
 
269
+ ### Install it as an app (PWA)
270
+
271
+ You get a **standalone window**: no address bar or toolbar (several free terminal rows), its own
272
+ icon on the desktop or home screen, a separate entry in the task switcher, and some of the keys the
273
+ browser normally eats (`⌘W`, `Ctrl+W`) come back.
274
+
275
+ | Platform | How |
276
+ |---|---|
277
+ | Android (Chrome / Edge) | Menu → **Install**. The menu offers two entries; **"Create shortcut" is not it** — that one is just a bookmark that opens the browser |
278
+ | Desktop Chrome / Edge | The install icon at the right of the address bar, or Menu → Install herdr-web |
279
+ | iPhone / iPad | Share → **Add to Home Screen** (Safari has no "install") |
280
+
281
+ **It requires HTTPS with a valid certificate**, which is where this usually gets stuck:
282
+
283
+ - ✅ A domain with a real certificate (setups 3 and 4 below, `HERDR_WEB_TLS=acme` or `proxy`).
284
+ - ✅ `http://localhost` / `http://127.0.0.1` — browsers treat the local machine as a secure context.
285
+ - ❌ **A self-signed certificate** (`HERDR_WEB_TLS=auto`, the LAN-direct path) — clicking through the
286
+ warning is not enough: the site works and can store passwords, but the browser **will not install
287
+ it**, leaving only "Create shortcut". To install it over the LAN, import the local CA from
288
+ `~/.herdr-web/` into the phone's system trust store.
289
+ - ❌ A plain `http://` LAN address — same, and system notifications are gone too.
290
+
291
+ On iOS, order matters: **add to the home screen first, then pair from inside it** (a home-screen web
292
+ app has its own storage container; credentials set up in Safari do not carry over). Notifications
293
+ likewise only work when opened from the home screen.
294
+
295
+ Not working offline is expected — this is a terminal, and there is nothing to show without the
296
+ server. When it cannot connect you get a short page explaining where it broke, not the dinosaur.
297
+
269
298
  ### Settings panel
270
299
 
271
300
  The ⚙ at the right end of the top bar, in four pages: **Terminal** (font size / light-dark, kitty
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bysir/herdr-web",
3
- "version": "0.6.1",
3
+ "version": "0.7.1",
4
4
  "description": "浏览器里的 herdr 终端 + 语音投稿。一个 Go 二进制,前端嵌在里面。",
5
5
  "license": "MIT",
6
6
  "homepage": "https://github.com/zbysir/herdr-web#readme",
@@ -29,9 +29,9 @@
29
29
  "node": ">=18"
30
30
  },
31
31
  "optionalDependencies": {
32
- "@bysir/herdr-web-darwin-arm64": "0.6.1",
33
- "@bysir/herdr-web-darwin-x64": "0.6.1",
34
- "@bysir/herdr-web-linux-arm64": "0.6.1",
35
- "@bysir/herdr-web-linux-x64": "0.6.1"
32
+ "@bysir/herdr-web-darwin-arm64": "0.7.1",
33
+ "@bysir/herdr-web-darwin-x64": "0.7.1",
34
+ "@bysir/herdr-web-linux-arm64": "0.7.1",
35
+ "@bysir/herdr-web-linux-x64": "0.7.1"
36
36
  }
37
37
  }