Overview

Build Decentraland scenes that look great and play well on the mobile app.

Decentraland is now available on mobile. Players can explore your scenes from iOS and Android devices, in addition to the desktop client and the web. As a creator, you can adapt your scenes so they look great and play well on touch-based devices.

This section covers how to detect mobile clients from your scene code, how to preview and test your scene on a real device from the Creator Hub or the CLI, the safe-area rules for placing UI on small screens, and how to get your scene featured in the mobile Discover section.

Get the mobile app

• Download for iOS (App Store)

• Download for Android (Google Play)

For beta testers: the iOS build is also available via TestFlight for power users who want to try unreleased changes.

In this section

• Detect the platform from code — use @dcl/sdk/platform to branch logic for mobile, desktop, or web.

• Preview your scene on mobile — preview directly on a phone via the Creator Hub or the CLI.

• Mobile safe area — the screen regions reserved for system controls; do not place scene UI inside them.

• UI best practices for mobile — DOs and DON'Ts, sizing recommendations, and current limitations.

• Input on mobile — touch-friendly input mappings and which InputActions to avoid.

• Get featured on mobile Discover — submission requirements for the mobile Discover section.

Quick checklist

Before publishing a scene that should work well on mobile, make sure that:

• You have previewed the scene on a real device — see Preview your scene on mobile.

• All critical UI elements stay inside the mobile safe area.

• Your UI is sized large enough for touch — follow the 3× recommendation.

• Key actions are not bound to IA_ACTION_3–IA_ACTION_6 (the 1/2/3/4 keys), which are not easily reachable on mobile — see Input on mobile.

• Your scene's performance is comfortable on a mid-range phone.