[PR #2310] [MERGED] feat(web): immich as webapp, add apple icons and manifest file #9488

Closed
opened 2026-02-05 14:05:39 +03:00 by OVERLORD · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/immich-app/immich/pull/2310
Author: @faupau03
Created: 4/21/2023
Status: Merged
Merged: 4/24/2023
Merged by: @alextran1502

Base: mainHead: feature-web-immich-as-webapp


📝 Commits (6)

📊 Changes

37 files changed (+323 additions, -0 deletions)

View changed files

web/src/lib/assets/apple/apple-icon-180.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1125-2436.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1136-640.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1170-2532.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1179-2556.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1242-2208.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1242-2688.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1284-2778.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1290-2796.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1334-750.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1536-2048.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1620-2160.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1668-2224.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1668-2388.png (+0 -0)
web/src/lib/assets/apple/apple-splash-1792-828.png (+0 -0)
web/src/lib/assets/apple/apple-splash-2048-1536.png (+0 -0)
web/src/lib/assets/apple/apple-splash-2048-2732.png (+0 -0)
web/src/lib/assets/apple/apple-splash-2160-1620.png (+0 -0)
web/src/lib/assets/apple/apple-splash-2208-1242.png (+0 -0)
web/src/lib/assets/apple/apple-splash-2224-1668.png (+0 -0)

...and 17 more files

📄 Description

This Pull Request adds apple specific header links and icons. Also a manifest.json file.
For a full PWA a service worker would still be needed.

Should fix #1987

For ios/ipados devices the apple-touch-icon is used to display the app on the home screen. That's at least how it used to be: https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariWebContent/ConfiguringWebApplications/ConfiguringWebApplications.html#//apple_ref/doc/uid/TP40002051-CH3-SW3

The different image sizes are needed to fit to the different screen sizes (They were auto generated by this wonderful piece of software).

For other browsers and devices that support the webmanifest, which should include the newest iOS/iPadOS Versions, I added the webmanifest and the fitting icons (manifest-icon-512.maskable.png and manifest-icon-192.maskable.png).

To test it, you can simply add the website to your ios home screen or install it in chrome as a webapp.

homescreen-menu share-menu

homescreen


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/immich-app/immich/pull/2310 **Author:** [@faupau03](https://github.com/faupau03) **Created:** 4/21/2023 **Status:** ✅ Merged **Merged:** 4/24/2023 **Merged by:** [@alextran1502](https://github.com/alextran1502) **Base:** `main` ← **Head:** `feature-web-immich-as-webapp` --- ### 📝 Commits (6) - [`edb873d`](https://github.com/immich-app/immich/commit/edb873d66a71caeaaf548fef61315cafb9453a10) add apple specific icons - [`ad0feb6`](https://github.com/immich-app/immich/commit/ad0feb66a3d83b425629ff644b3d37a4433ed920) Merge branch 'immich-app:main' into feature-web-immich-as-webapp - [`98da4b3`](https://github.com/immich-app/immich/commit/98da4b38d8fab65cac528cbf35ce9b42ef4d4ac9) remove jpg icons - [`0969483`](https://github.com/immich-app/immich/commit/09694834f024598fb4385bd60d1731018b3e0456) Merge branch 'feature-web-immich-as-webapp' of https://github.com/faupau03/immich into feature-web-immich-as-webapp - [`dfa2494`](https://github.com/immich-app/immich/commit/dfa2494e10f40e958c2ddb467232cdaad68cb708) change background color to white - [`f5935a5`](https://github.com/immich-app/immich/commit/f5935a544791344171a68c6c399c0ecddc825be8) Merge branch 'immich-app:main' into feature-web-immich-as-webapp ### 📊 Changes **37 files changed** (+323 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `web/src/lib/assets/apple/apple-icon-180.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1125-2436.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1136-640.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1170-2532.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1179-2556.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1242-2208.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1242-2688.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1284-2778.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1290-2796.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1334-750.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1536-2048.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1620-2160.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1668-2224.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1668-2388.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-1792-828.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-2048-1536.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-2048-2732.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-2160-1620.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-2208-1242.png` (+0 -0) ➕ `web/src/lib/assets/apple/apple-splash-2224-1668.png` (+0 -0) _...and 17 more files_ </details> ### 📄 Description This Pull Request adds apple specific header links and icons. Also a manifest.json file. For a full PWA a service worker would still be needed. Should fix #1987 For ios/ipados devices the apple-touch-icon is used to display the app on the home screen. That's at least how it used to be: https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariWebContent/ConfiguringWebApplications/ConfiguringWebApplications.html#//apple_ref/doc/uid/TP40002051-CH3-SW3 The different image sizes are needed to fit to the different screen sizes (They were auto generated by [this ](https://github.com/elegantapp/pwa-asset-generator) wonderful piece of software). For other browsers and devices that support the webmanifest, which should include the newest iOS/iPadOS Versions, I added the webmanifest and the fitting icons (manifest-icon-512.maskable.png and manifest-icon-192.maskable.png). To test it, you can simply add the website to your ios home screen or install it in chrome as a webapp. <img width="474" alt="homescreen-menu" src="https://user-images.githubusercontent.com/22776173/233770947-db3c6b54-b3fb-4e93-b3d1-7391e5c994e8.png"> <img width="449" alt="share-menu" src="https://user-images.githubusercontent.com/22776173/233770948-9cad848c-68be-406d-86a7-e40c7fcfa2fb.png"> ![homescreen](https://user-images.githubusercontent.com/22776173/233770950-953deb20-02d7-4c4b-bf24-0e7d92d815c0.png) --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
OVERLORD added the pull-request label 2026-02-05 14:05:39 +03:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: immich-app/immich#9488