← Phone apps and app stores (App store)
How do I give my app an icon and a name on a phone's home screen?
Short answer
Ask your AI to add a small file with your app's name and icons, then publish again; people add it from their phone's browser.
Deeper
Your app is a web app: it opens in a web browser at https://<name>.pages.dev, the address it gets when it goes live, where <name> is the name given to your site. A phone's browser can put an icon for it on the home screen, so it opens like an app. The person who uses your app does that themselves, in their phone's browser; your app cannot put itself there. MDN, Mozilla's guide for web developers, says Safari on an iPhone installs such an app with its add-to-home-screen command, and Chrome for Android has the install command in the browser's menu. It also says: "On iOS 16.4 and later, PWAs can be installed from the Share menu in Safari, Chrome, Edge, Firefox, and Orion." A PWA, a progressive web app, is a website made so it can be installed like an app.
Where the name and the icon come from. They come from a manifest, a small file with the app's name, its icons in 192 and 512 pixels, the page it starts on and how it is shown. MDN says browsers may use the short name "when there is insufficient space to display the full name, such as on a device's home screen", and that icons identify your app in places such as the home screen. So you could give your app a short name of a word or two as well as its full name. Without a manifest, MDN says, the icon only opens the bookmarked link in the default browser (https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable, https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Installing, https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/short_name and https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/icons, read 13 November 2026).
What to do.
1. Have your icon ready as a square picture, such as a PNG file, and decide the name and the short name.
2. Tell your AI coder, the AI that writes your app's code, to add a manifest with that name, short name and icon, in 192 and 512 pixels. A published site may hold a manifest file and PNG pictures. Put the icon in your app's own files: a published app may show pictures only from its own files and from GilbPlatform's own addresses.
3. Put the changed app live again. Publishing a site you already hold again works and does not use a new one; the answer How do I update my app after it is live? shows how.
4. To check, open the address in your phone's browser and add it to the home screen.
This works the same for an app and for a website. The small icon and title in a browser tab are set in the page itself; the answer How do I set my site's tab icon, title and the preview shown when it is shared? tells more. An icon on the home screen does not make your app work without internet; see Can my app work without internet, or be installed on a phone's home screen?
This answer is written for a computer screen.
Source: MDN Web Docs, read 13 November 2026: Making PWAs installable, https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable (manifest members name or short_name, icons 192px and 512px, start_url, display; "On iOS 16.4 and later, PWAs can be installed from the Share menu in Safari, Chrome, Edge, Firefox, and Orion."); short_name, https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/short_name; icons, https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/icons; Installing, https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Installing. GilbPlatform 0fc5a548 (https://id.gilb.com/version, read 13 November 2026): workers/publish-ingest/src/checks.ts:11-15 (webmanifest and png accepted), :164-173 (img-src 'self' data: blob: https://*.gilb.com). Standard Agent.Coder.AskGoLive (publishing a site again that the person already holds does not use a new one). Live help pages, sentences shared: Can my app work without internet, or be installed on a phone's home screen?; How do I update my app after it is live?; How many sites can I have, and how do I get more?
Checked against GilbApp d529620.