add help for when service workers get stuck; bump to version 0.3.2

CHANGELOG.md

@@ -10,7 +10,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Nothing
 
 
-## [0.3.0] - 2024.03.17
+## [0.3.2] - 2024.03.17
 ### Added
 - Photo on gift record
 ### Fixed

README.md

@@ -38,17 +38,17 @@ npm run lint
 
 * Run the correct build
 
-  * Production
+  * Test
 ```
-# This picks up values from .env.production
+# (See .env.development for more details.)
-npm run build
+# The test BVC_MEETUPS_PROJECT_CLAIM_ID does not resolve as a URL because it's only in the test DB and the prod redirect won't redirect there.
+APP_TITLE="TimeSafari_Test" VUE_APP_BVC_MEETUPS_PROJECT_CLAIM_ID=https://endorser.ch/entity/01HNTZYJJXTGT0EZS3VEJGX7AK VUE_APP_DEFAULT_ENDORSER_API_SERVER=https://test-api.endorser.ch VUE_APP_DEFAULT_IMAGE_API_SERVER=https://test-image-api.timesafari.app npm run build
 ```
 
-  * Development
+  * Production
 ```
-# Set test values. (See .env.development for more details.)
+# This picks up values from .env.production
-# The test BVC_MEETUPS_PROJECT_CLAIM_ID does not resolve as a URL because it's only in the test DB and the prod redirect won't redirect there.
+npm run build
-APP_TITLE="TimeSafari_Test" VUE_APP_BVC_MEETUPS_PROJECT_CLAIM_ID=https://endorser.ch/entity/01HNTZYJJXTGT0EZS3VEJGX7AK VUE_APP_DEFAULT_ENDORSER_API_SERVER=http://localhost:3000 VUE_APP_DEFAULT_IMAGE_API_SERVER=http://localhost:3002 npm run build
 ```
 
 * Get on the server and back up the DB and the time-safari folder.

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "TimeSafari",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "TimeSafari",
-      "version": "0.3.1",
+      "version": "0.3.2",
       "dependencies": {
         "@dicebear/collection": "^5.3.5",
         "@dicebear/core": "^5.3.5",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "TimeSafari",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "private": true,
   "scripts": {
     "serve": "vue-cli-service serve",

src/views/HelpView.vue

@@ -11,7 +11,7 @@
           class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
           @click="$router.back()"
         >
-          <fa icon="chevron-left" class="fa-fw"></fa>
+          <fa icon="chevron-left" class="fa-fw" />
         </h1>
       </div>
 
@@ -217,6 +217,28 @@
       </ul>
       <p>To erase your data from our servers, contact us (below).</p>
 
+      <h2 class="text-xl font-semibold">
+        How do I get higher limits?
+      </h2>
+      <p>
+        Let's talk. Contact us (below).
+      </p>
+
+      <h2 class="text-xl font-semibold">
+        How do I access even more functionality?
+      </h2>
+      <p>
+        There is an "Advanced" section at the bottom of the Account
+        <fa icon="circle-user" /> page.
+      </p>
+      <p>
+        There is a even more functionality in a mobile app (and more
+        documentation) at
+        <a href="https://endorser.ch" class="text-blue-500">
+          EndorserSearch.com
+        </a>
+      </p>
+
       <h2 class="text-xl font-semibold">
         I know there is a record from someone, so why can't I see that info?
       </h2>
@@ -240,35 +262,64 @@
       </h2>
       <p>
         <router-link class="text-blue-500" to="/help-notifications"
-          >Here.</router-link
+        >Here.</router-link
         >
       </p>
 
       <h2 class="text-xl font-semibold">
-        How do I get higher limits?
+        My app is misbehaving, like showing me a blank screen or failing to show a feed.
+        What can I do?
       </h2>
       <p>
-        Let's talk. Contact us (below).
+        First, note that clearing the cache will clear all your identity and contact info,
-      </p>
+        so we recommend doing other things first (unless you know you have your backups ready).
-
-      <h2 class="text-xl font-semibold">
-        How do I access even more functionality?
-      </h2>
-      <p>
-        There is an "Advanced" section at the bottom of the Account
-        <fa icon="circle-user" /> page.
       </p>
+      <ul class="list-disc list-outside ml-4">
+        <li>
+          Drag down on the screen to refresh it; do that multiple times, because
+          it sometimes takes multiple tries for the app to refresh to the current version.
+          You can see the version information at the bottom of this page; the best
+          way to determine the current version is to open this page in an incognito
+          browser window and look at the version there.
+        </li>
+        <li>
+          Close all tabs that have Time Safari open; it can be difficult to find them all,
+          and you may have to close all your tabs. In addition, it may be running as an
+          installed app, so look for any Time Safari app that may be running outside a browser.
+        </li>
+        <li>
+          It can help to reregister the service worker:
+          <ul>
+            <li>
+              In Chrome, open a tab to
+              "chrome://serviceworker-internals",
+              find "timesafari.app", and click "Unregister".</li>
+            <li>
+              In Firefox,
+              open a tab to "about:serviceworkers",
+              find "timesafari.app", and click "Unregister".
+            </li>
+            <li>
+              <a href="https://duckduckgo.com/?q=unregister+service+worker" class="text-blue-500">Search</a>
+              for instructions for other browsers.</li>
+          </ul>
+          Then reload Time Safari.
+        </li>
+        <li>
+          Restart your device.
+        </li>
+      </ul>
       <p>
-        There is a even more functionality in a mobile app (and more
+        If you still have problems, you can clear the cache and even uninstall
-        documentation) at
+        and reinstall the app, but be sure to have your backups ready or be
-        <a href="https://endorser.ch" class="text-blue-500">
+        prepared to restart with a new identity and recreate your network.
-          EndorserSearch.com
+        Nobody else has access to your identity or contact information because
-        </a>
+        this app is designed to give you full control over your data.
       </p>
 
       <h2 class="text-xl font-semibold">What are the terms & conditions and the privacy policy?</h2>
       <p style="display:inline; align-items: center">
-        This work is marked with
+        This work is public domain, governed by
         <a href="http://creativecommons.org/publicdomain/zero/1.0?ref=chooser-v1" target="_blank" rel="license noopener noreferrer">
           <span class="text-blue-500 mr-1">CC0 1.0</span>
           <img

vue.config.js

@@ -3,7 +3,8 @@ const { gitDescribeSync } = require("git-describe");
 const { exec } = require("child_process");
 
 process.env.VUE_APP_GIT_HASH = gitDescribeSync().hash;
-const APP_TITLE = process.env.APP_TITLE || require("./package.json").name;
+const TIME_SAFARI_APP_TITLE =
+  process.env.TIME_SAFARI_APP_TITLE || require("./package.json").name;
 
 module.exports = defineConfig({
   transpileDependencies: true,
@@ -31,7 +32,7 @@ module.exports = defineConfig({
     ],
   },
   pwa: {
-    name: APP_TITLE,
+    name: TIME_SAFARI_APP_TITLE,
     iconPaths: {
       faviconSVG: "img/icons/safari-pinned-tab.svg",
     },