{"id":21006237,"url":"https://github.com/derlin/pwa-ize","last_synced_at":"2025-07-19T22:38:03.646Z","repository":{"id":151664428,"uuid":"292505923","full_name":"derlin/pwa-ize","owner":"derlin","description":"Transform any web page into a PWA that can be launched in a dedicated/separate browser instance on Mobile","archived":false,"fork":false,"pushed_at":"2021-10-28T18:04:33.000Z","size":1403,"stargazers_count":6,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-26T02:42:51.711Z","etag":null,"topics":["javascript","progressive-web-app","pwa","utility","vue3","website"],"latest_commit_sha":null,"homepage":"https://derlin.github.io/pwa-ize/","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/derlin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-03T08:02:38.000Z","updated_at":"2025-03-03T09:52:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"72545063-8a46-4d94-a9a6-61ed9e18b157","html_url":"https://github.com/derlin/pwa-ize","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derlin%2Fpwa-ize","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derlin%2Fpwa-ize/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derlin%2Fpwa-ize/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derlin%2Fpwa-ize/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/derlin","download_url":"https://codeload.github.com/derlin/pwa-ize/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248534110,"owners_count":21120226,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["javascript","progressive-web-app","pwa","utility","vue3","website"],"created_at":"2024-11-19T08:50:01.868Z","updated_at":"2025-04-12T07:33:23.906Z","avatar_url":"https://github.com/derlin.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PWA-ize\n\n\nTransform any website into a PWA that feels like a regular mobile application.\n\n**➙ https://derlin.github.io/pwa-ize ✨**\n\n\n## What is it ?\n\nPWA-ize is a simple app that can turn any website into a PWA (**P**rogressive **W**eb **A**pp).\nWhen adding a PWA to your mobile phone's homescreen (using _Settings_ ➙ \"_Add to home screen_\"),\nthe shortcut will open in a standalone browser instance, instead of launching the website into a new browser tab.\n\nUnder the hood, what PWA-ize does is generate a manifest with the target website icon and a `start_url` that will automatically\nredirect to the target site. This is fairly simple and works well.\n\n## Demo\n\n**Usage**\n\nHere is a comparison of how [dev.to](https://dev.to) behaves when added to home screen with and without PWA-ize.\n\n\u003cdetails\u003e\n  \u003csummary\u003eDemo without PWA\u003c/summary\u003e\n  \u003cbr /\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/5463445/138928901-e3c6575c-cecd-4a81-ad77-31364bd2561c.gif\" alt=\"regular app\" /\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eDemo with PWA-ized app\u003c/summary\u003e\n  \u003cbr /\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/5463445/138928877-339b3ca5-2b8e-423b-875c-d6ad165f5bd7.gif\" alt=\"PWA-ized app\" /\u003e\n\u003c/details\u003e\n\n**Full install**\n\nHere are the full gifs with also the install phase. Note that the PWA-ize install is quite long: this is due to the fetching of icons from GoogleS2 and processing the manifest, not from this code 😉. This is only once on install though.\n\n\u003cdetails\u003e\n  \u003csummary\u003eFull install without PWA\u003c/summary\u003e\n  \u003cbr /\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/5463445/138927804-ff461e90-1d3a-4121-96b0-c6c2690b405c.gif\" alt=\"regular app\" /\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eFull install with PWA-ize\u003c/summary\u003e\n  \u003cbr /\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/5463445/138927653-ce5a3cf7-333d-4b7a-bfcf-0d4084d7ec48.gif\" alt=\"PWA-ized app\" /\u003e\n\u003c/details\u003e\n\n\n\n## Why this project ?\n\nI don't know about you, but personally I never use the Chrome app on my Android phone. Well, I use it, but only for bookmarking.\nAll my browsing is done inside the _Google Now_ app, or app shortcuts (aka PWAs).\nThis stems from my laziness: I know that once I close _Google Now_, there is nothing left; I don't have to clean tabs, and don't have\nto manage 46 opened tabs that drain my battery.\n\nAnyway, most of the sites I use daily are either available through an app (reddit), or have a manifest (HN).\nWell, until I decided to increase my tech reading and started looking at [Lobsters](https://lobste.rs),\n[dev.to](https://dev.to) or [Pythonic News](https://news.python.sc/).\nWhen added to home screen, they will open into a new Chrome tab (even if it is already opened in another !!!!!).\nSo annoying.\n\nHence PWA-ize.\n\nI now have more than 10 PWA-ize shortcuts on my homescreen, that I use daily to check the meteo, register to gym classes,\nchecking the canteen's menu, and do my tech readings.\n\n## About PWAs and PWA-ize\n\nThe only requirements for a website to open in a dedicated browser window when added to the home screen are for the page to:\n\n1. reference a valid [Web Manifest](https://developer.mozilla.org/en-US/docs/Web/Manifest) (`\u003cmeta name=\"manifest\" src=\"...\"\u003e`),\n2. have the `display` property in the manifest set to something different from `browser`.\n\nPWA-ize generates this valid manifest for a target URL you give, adding also some icons (grabbed from Google S2,\ne.g. https://www.google.com/s2/favicons?sz=64\u0026domain_url=yahoo.com).\nSince a manifest cannot set a `start_url` outside of the domain of the current page, it is set to `redirect.html?url=target-site`,\nwhich will automatically do a redirect on load.\n\nThat's it.\n\n\u003cdiv align=\"center\"\u003e\n⇨ https://derlin.github.io/pwa-ize/ ⇦\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderlin%2Fpwa-ize","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fderlin%2Fpwa-ize","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderlin%2Fpwa-ize/lists"}