App Store & Screenshots

Learn how to publish downloadable apps in the in-game 5M Phone App Store with custom icons, descriptions, and screenshot galleries.

Enabling App Store Mode

By default, core applications (Settings, Camera, Messages) are pre-installed. To make your custom app downloadable through the in-game App Store:

In config.lua:

Lua

Config.DefaultApp = false -- false = App Store download; true = pre-installed on home screen

When DefaultApp is false:

The app does not appear on the home screen by default.
It is indexed in the App Store under the developer name.
Players can view the app details page, browse screenshots, read description text, and tap Get / Install.
Once installed, the app icon appears on the player's home screen.
Players can uninstall the app anytime by holding the icon and tapping Remove.

Dimensions: Square format, recommended 512x512 pixels.
Format: Scalable .svg (recommended for ultra-crisp display) or high-res .png.
Styling: Modern rounded squircle or transparent PNG. 5M Phone applies standard iOS-style corner smoothing automatically.

In config.lua:

Lua

Config.IconPath = 'ui/dist/icon.svg'

The App Store product detail page displays a carousel of screenshots showcasing your app:

In config.lua:

Lua

Config.Screenshots = {
    'ui/dist/store/shot1.svg',
    'ui/dist/store/shot2.svg',
}

Recommended Aspect Ratio: 9:16 vertical mobile aspect ratio (e.g. 750x1334 or 1170x2532).
Path Resolution: Relative paths within your resource directory (e.g. ui/dist/store/shot1.svg) or public https:// URLs.