mirror of
https://github.com/AmruthPillai/Reactive-Resume.git
synced 2026-08-25 15:52:21 +10:00
Amruth Pillai
62f8270b3e
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
100 lines
4.0 KiB
Markdown
100 lines
4.0 KiB
Markdown
# 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:
|
|
|
|
```tsx
|
|
{ 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:
|
|
|
|
```sh
|
|
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.
|