mirror of https://github.com/AmruthPillai/Reactive-Resume.git synced 2026-08-25 07:42:20 +10:00

Files

T

Amruth Pillai 62f8270b3e Squashed commit of the following:

commit b2b0470a1d9267d042ec0ac66523c6635bf5b199
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Tue May 19 13:13:38 2026 +0200

    chore: update .gitignore to include .vite-hooks and modify pnpm-lock.yaml for dependencies

commit d28fadb5cd8706c874e616102878b4a394ec84c1
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Tue May 19 13:08:04 2026 +0200

    fix: remove timestamp conflict guard

commit c6998d9dbab19d09d3c8054feef1d2e4117555eb
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Tue May 19 12:11:51 2026 +0200

    chore(release): v5.1.5

commit f33d168711804880e1f12e88d24290aae16cc258
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Tue May 19 11:58:35 2026 +0200

    revert: compose.yml

commit d961e6535811a10c335525fb33a08d03e737278d
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Tue May 19 11:58:08 2026 +0200

    refactor(agent): replace 'revert' terminology with 'restore' for clarity, resolves #3086

commit 17f351171be218e33f01c469d95e4164d4c8dc57
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Tue May 19 11:10:41 2026 +0200

    refactor(pdf): simplify sidebar section filtering and update summary feature logic

commit d55179b9d76879e3204de185e8b53fadd0a107ed
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Tue May 19 09:53:37 2026 +0200

    chore: update pnpm-lock.yaml and turbo.json

commit 7cade6980e1a04352536bd44ef773f338c4ef599
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Tue May 19 09:38:30 2026 +0200

    fix(polyfill): add tested polyfill for Map Upsert methods

commit 26d175bb9c53d93225d1e907678445252c13d660
Merge: 1cf33dc6c 5b1297fa2
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Tue May 19 09:23:29 2026 +0200

    Merge remote-tracking branch 'origin/main' into feat/explore-hono-orpc-migration

    # Conflicts:
    #	packages/api/src/services/agent-url.ts
    #	packages/runtime-externals/package.json

commit 1cf33dc6c9d81735730ad656e16dab6501c6d6a1
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Tue May 19 09:22:12 2026 +0200

    chore: preserve branch changes before main sync

commit b380a4b00fdbcdd81ff4f8ef72b330fd027ccda5
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Mon May 18 07:50:28 2026 +0200

    chore: lot of fixes for monorepo migration

commit 8fcf0ec64e1c29572ebaff494338368bfcf75760
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 13:57:17 2026 +0200

    chore: update knip version and refine web app routing with new SEO endpoints

commit 234e68086ff15610a93877354c98e2c020364533
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 12:10:06 2026 +0200

    refactor(auth): update OAuth routes to include API prefix and remove unused schema endpoint

commit 91c84b9a8496b0ce21d71cae9f8b2a027638c9ac
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 11:54:29 2026 +0200

    chore: update dependencies and enhance PWA metadata in web app

commit 150117d4a5a9dd6cd92c64891aad8cae90f6a7af
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 11:12:35 2026 +0200

    docs: revise manifest-only pwa testing scope

commit 6b939a55661aec9dd8122b184e4b60a5c7325fb5
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 11:11:33 2026 +0200

    docs: add manifest-only pwa design

commit 1422e1fc96c400948b273210a1067251087d15d4
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 11:05:04 2026 +0200

    chore(dev): simplify server proxy config

commit bc2ff5a9f6fda41e6c40333c8f163aa23a6c5e48
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 11:04:50 2026 +0200

    docs: add unsafe oauth redirect plan

commit 445359ebe9b96c1515bf1c4c3f73ba8a8448ec12
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 11:04:34 2026 +0200

    feat(auth): add unsafe oauth redirect flag

commit 73fffdd24598e56b2793f7657919bc794835892e
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 10:55:02 2026 +0200

    docs: design unsafe oauth redirect flag

commit c0066aa19c15fc8a4c8e5179ed49889c117519f4
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 10:22:04 2026 +0200

    chore: update translation source paths

commit 9033da082418d252aafd6c2eed72f71f014be3d9
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 10:09:25 2026 +0200

    refactor(arch): react spa + hono migration

commit 6f27936c11bda895977dc63ee550c3346d4ce24b
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Fri May 15 01:10:47 2026 +0200

    docs: add docker nightly tagging design

commit ecc1fd9a88a0ee1dca2f1977dfc17f74527fe1da
Author: Amruth Pillai <im.amruth@gmail.com>
Date:   Thu May 14 20:05:44 2026 +0200

    feat: migrate to hono spa server

2026-05-19 13:14:21 +02:00

4.0 KiB

Raw Blame History

Manifest-Only PWA Design

Date: 2026-05-15

Goal

Reduce Reactive Resume's PWA implementation to install metadata only.

The site should remain installable on supported phones and desktops through the web app manifest, icons, screenshots, and mobile app meta tags. The PWA implementation should not generate, register, or rely on a service worker, and it should not provide offline support, app-shell precaching, runtime caching, or fallback navigation.

Non-Goals

Do not add offline support.
Do not add a no-op service worker.
Do not add runtime caching rules for app assets, API responses, uploaded files, generated PDFs, or routes.
Do not change product UI, routing, auth, resume editing, public resume pages, or PDF generation behavior.
Do not change normal browser or HTTP caching behavior owned by the browser or server.

Architecture

Keep install metadata in apps/web/public/manifest.webmanifest. That static manifest remains the source of truth for app name, description, theme color, background color, icons, screenshots, categories, scope, and start URL.

Keep mobile install/open-as-app meta tags in apps/web/src/libs/pwa.ts. That module continues to own:

pwaHeadMetaTags
app name and theme color used by those head meta tags

Add the same manifest, icon, and mobile install hints directly to apps/web/index.html so install metadata is present in the initial HTML without relying on vite-plugin-pwa HTML injection or client-side route head updates.

Remove the service-worker part of the current architecture:

Remove VitePWA usage from apps/web/vite.config.ts.
Remove the vite-plugin-pwa dependency from apps/web/package.json and the lockfile.
Remove the now-unused pwaManifest and pwaServiceWorkerRegistrationScript exports from apps/web/src/libs/pwa.ts.
Stop injecting the production navigator.serviceWorker.register("/sw.js", { scope: "/" }) script from apps/web/src/routes/__root.tsx.

The root route keeps the existing manifest link:

{ rel: "manifest", href: "/manifest.webmanifest", crossOrigin: "use-credentials" }

The root route also keeps the PWA-related head meta tags, including theme-color and Apple mobile web app tags, because those are part of the install/open-as-app experience rather than offline behavior.

Data Flow

Browsers discover install metadata by reading the root document head and fetching /manifest.webmanifest.

Manifest-linked assets continue to be served as static public assets from apps/web/public, including:

favicon assets
PWA icons
maskable icon
Apple touch icon
installation screenshots

No service worker is emitted by the web build, no service worker is registered at runtime, and no Workbox precache manifest is produced.

Error Handling

There is no PWA-controlled offline fallback.

When the network is unavailable, the app behaves like a normal website: navigations, API calls, uploaded assets, and generated downloads fail according to the browser and server behavior already in place. This is intentional because installability is the only remaining PWA goal.

Testing

Remove apps/web/src/libs/pwa.test.ts.

The file currently tests both install metadata and service-worker registration behavior. After this change, the remaining PWA surface is static manifest/head metadata with no behavior-specific module contract worth preserving as a dedicated unit test.

Implementation should still verify by inspection and build output that:

apps/web/dist/index.html includes the manifest link and mobile install meta tags
the root route keeps the manifest link
PWA head meta tags remain present
no service-worker registration script is exported or injected by the root route
no sw.js or Workbox precache output is emitted by the web build

Focused validation after implementation:

pnpm --filter web typecheck
pnpm --filter web build

If the package dependency removal changes the lockfile, verify the lockfile remains scoped to removing vite-plugin-pwa and its now-unused Workbox dependency graph.

4.0 KiB Raw Blame History