feat: add PWA support with Android share intent
Make Favoritter installable as a Progressive Web App with offline
static asset caching and Web Share Target API for Android.
New files:
- internal/handler/pwa.go: handlers for manifest, service worker,
and share target
- web/static/sw.js: service worker (cache-first static, network-first
HTML) with {{BASE_PATH}} placeholder for subpath deployments
- web/static/icons/: placeholder PWA icons (192, 512, 512-maskable)
Key design decisions:
- Share target uses GET (not POST) to avoid CSRF token issues — Android
apps cannot provide CSRF tokens
- Manifest is generated dynamically to inject BasePath into start_url,
scope, icon paths, and share_target action
- Service worker served at /sw.js with Cache-Control: no-cache and
BasePath injected via string replacement
- handleShare extracts URLs from Android's "text" field as fallback
(many apps put the URL there instead of "url")
- handleFaveNew replaced with handleFaveNewPreFill that reads url,
description, notes from query params (enables share + bookmarklets)
- SW registration in app.js reads base-path from <meta> tag (CSP-safe)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
485d01ce45
commit
1260cfd18f
10 changed files with 375 additions and 14 deletions
142
internal/handler/pwa.go
Normal file
142
internal/handler/pwa.go
Normal file
|
|
@ -0,0 +1,142 @@
|
|||
// SPDX-License-Identifier: AGPL-3.0-or-later
|
||||
|
||||
package handler
|
||||
|
||||
import (
|
||||
"encoding/json"
|
||||
"io/fs"
|
||||
"net/http"
|
||||
"net/url"
|
||||
"strings"
|
||||
|
||||
"kode.naiv.no/olemd/favoritter/internal/middleware"
|
||||
"kode.naiv.no/olemd/favoritter/internal/render"
|
||||
"kode.naiv.no/olemd/favoritter/web"
|
||||
)
|
||||
|
||||
// handleManifest serves the Web App Manifest with dynamic BasePath injection.
|
||||
func (h *Handler) handleManifest(w http.ResponseWriter, r *http.Request) {
|
||||
bp := h.deps.Config.BasePath
|
||||
|
||||
manifest := map[string]any{
|
||||
"name": h.deps.Config.SiteName,
|
||||
"short_name": h.deps.Config.SiteName,
|
||||
"description": "Lagre og del dine favoritter",
|
||||
"start_url": bp + "/",
|
||||
"scope": bp + "/",
|
||||
"display": "standalone",
|
||||
"background_color": "#ffffff",
|
||||
"theme_color": "#1095c1",
|
||||
"icons": []map[string]any{
|
||||
{"src": bp + "/static/icons/icon-192.png", "sizes": "192x192", "type": "image/png"},
|
||||
{"src": bp + "/static/icons/icon-512.png", "sizes": "512x512", "type": "image/png"},
|
||||
{"src": bp + "/static/icons/icon-512-maskable.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable"},
|
||||
},
|
||||
"share_target": map[string]any{
|
||||
"action": bp + "/share",
|
||||
"method": "GET",
|
||||
"params": map[string]string{
|
||||
"url": "url",
|
||||
"text": "text",
|
||||
"title": "title",
|
||||
},
|
||||
},
|
||||
}
|
||||
|
||||
w.Header().Set("Content-Type", "application/manifest+json")
|
||||
json.NewEncoder(w).Encode(manifest)
|
||||
}
|
||||
|
||||
// handleServiceWorker serves the service worker JS from root scope.
|
||||
// BasePath is injected via placeholder replacement so the SW can
|
||||
// cache the correct static asset paths.
|
||||
func (h *Handler) handleServiceWorker(w http.ResponseWriter, r *http.Request) {
|
||||
staticFS, err := fs.Sub(web.StaticFS, "static")
|
||||
if err != nil {
|
||||
http.Error(w, "Not found", http.StatusNotFound)
|
||||
return
|
||||
}
|
||||
|
||||
data, err := fs.ReadFile(staticFS, "sw.js")
|
||||
if err != nil {
|
||||
http.Error(w, "Not found", http.StatusNotFound)
|
||||
return
|
||||
}
|
||||
|
||||
content := strings.ReplaceAll(string(data), "{{BASE_PATH}}", h.deps.Config.BasePath)
|
||||
|
||||
w.Header().Set("Content-Type", "application/javascript")
|
||||
w.Header().Set("Cache-Control", "no-cache")
|
||||
w.Write([]byte(content))
|
||||
}
|
||||
|
||||
// handleShare receives Android share intents via the Web Share Target API
|
||||
// and redirects to the new-fave form with pre-filled values.
|
||||
// Uses GET to avoid CSRF issues (Android cannot provide CSRF tokens).
|
||||
func (h *Handler) handleShare(w http.ResponseWriter, r *http.Request) {
|
||||
user := middleware.UserFromContext(r.Context())
|
||||
if user == nil {
|
||||
http.Redirect(w, r, h.deps.Config.BasePath+"/login", http.StatusSeeOther)
|
||||
return
|
||||
}
|
||||
|
||||
sharedURL := r.URL.Query().Get("url")
|
||||
sharedTitle := r.URL.Query().Get("title")
|
||||
sharedText := r.URL.Query().Get("text")
|
||||
|
||||
// Many Android apps send the URL in the "text" field instead of "url".
|
||||
if sharedURL == "" && sharedText != "" {
|
||||
sharedURL = extractURL(sharedText)
|
||||
if sharedURL != "" {
|
||||
// Remove the URL from text so it's not duplicated.
|
||||
sharedText = strings.TrimSpace(strings.Replace(sharedText, sharedURL, "", 1))
|
||||
}
|
||||
}
|
||||
|
||||
description := sharedTitle
|
||||
if description == "" && sharedText != "" {
|
||||
description = sharedText
|
||||
sharedText = "" // Don't duplicate into notes.
|
||||
}
|
||||
|
||||
target := h.deps.Config.BasePath + "/faves/new?"
|
||||
params := url.Values{}
|
||||
if sharedURL != "" {
|
||||
params.Set("url", sharedURL)
|
||||
}
|
||||
if description != "" {
|
||||
params.Set("description", description)
|
||||
}
|
||||
if sharedText != "" {
|
||||
params.Set("notes", sharedText)
|
||||
}
|
||||
|
||||
http.Redirect(w, r, target+params.Encode(), http.StatusSeeOther)
|
||||
}
|
||||
|
||||
// handleFaveNewWithPreFill shows the new fave form, optionally pre-filled
|
||||
// from query parameters (used by share target and bookmarklets).
|
||||
func (h *Handler) handleFaveNewPreFill(w http.ResponseWriter, r *http.Request) {
|
||||
user := middleware.UserFromContext(r.Context())
|
||||
|
||||
h.deps.Renderer.Page(w, r, "fave_form", render.PageData{
|
||||
Title: "Ny favoritt",
|
||||
Data: map[string]any{
|
||||
"IsNew": true,
|
||||
"DefaultPrivacy": user.DefaultFavePrivacy,
|
||||
"Description": r.URL.Query().Get("description"),
|
||||
"URL": r.URL.Query().Get("url"),
|
||||
"Notes": r.URL.Query().Get("notes"),
|
||||
},
|
||||
})
|
||||
}
|
||||
|
||||
// extractURL finds the first http:// or https:// URL in a string.
|
||||
func extractURL(s string) string {
|
||||
for _, word := range strings.Fields(s) {
|
||||
if strings.HasPrefix(word, "http://") || strings.HasPrefix(word, "https://") {
|
||||
return word
|
||||
}
|
||||
}
|
||||
return ""
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue