First-run setup

The onboarding flow runs once when you first open the app. It walks you through the three permissions locationjoystick needs to work.

• Location permission

  Grant Precise location so the map can center on your position and route recording works correctly.

• Overlay permission

  Grant Display over other apps to enable the floating joystick and widget. The app opens the system settings page directly — toggle locationjoystick in the list and return to the app.

• Mock location provider

  Enable Developer Options on your device (Settings → About phone → tap Build number seven times), then go to Settings → Developer Options → Select mock location app and choose locationjoystick. Tap Check again in the app — it verifies the setting and advances automatically.

• All done

  Onboarding completes and you land on the Map screen ready to start spoofing. You won't see this flow again unless you clear app data.

Skipping steps

Each step can be skipped. If a required permission is missing later, a banner appears on the relevant screen prompting you to grant it. The app checks permission state every time you return to a screen that needs it.

Troubleshooting

• Mock location not detected — some devices require rebooting after changing the Developer Options setting. Try rebooting, then tap Check again.
• Overlay permission resets on reboot — a known issue on some custom Android skins (MIUI, ColorOS). Re-grant the permission after each reboot or check your device's autostart settings.
• Another app holds the mock location slot — only one app can be the active mock location provider. Make sure no other mock location app is selected in Developer Options.