Getting started: mobile

Dioxus is unique in that it actually supports mobile. However, support is very young and you might need to dip down into some of the primitives until better supported is ready.

Currently, only iOS is supported through us, however you can add android support by following the same instructions below, but using the android guide in cargo-mobile.

Also, Dioxus Desktop and Dioxus Mobile share the same codebase, and dioxus-mobile currently just re-exports dioxus-desktop.

Getting Set up

Getting set up with mobile can but quite challenging. The tooling here isn't great (yet) and might take some hacking around to get things working. macOS M1 is broadly unexplored and might not work for you.

We're going to be using cargo-mobile to build for mobile. First, install it:

$ cargo install --git

And then initialize your app for the right platform. Use the winit template for now. Right now, there's no "Dioxus" template in cargo-mobile.

$ cargo mobile init 

We're going to completely clear out the dependencies it generates for us, swapping out winit with dioxus-mobile.

name = "dioxus-ios-demo"
version = "0.1.0"
authors = ["Jonathan Kelley <>"]
edition = "2018"

# leave the `lib` declaration
crate-type = ["staticlib", "cdylib", "rlib"]

# leave the binary it generates for us
name = "dioxus-ios-demo-desktop"
path = "gen/bin/"

# clear all the dependencies
mobile-entry-point = "0.1.0"
dioxus = { version = "*", features = ["mobile"] }
simple_logger = "*"

Edit your

use dioxus::prelude::*;

fn main() {

fn app(cx: Scope) -> Element {
        div {
            "hello world!"

To configure the webview, menubar, and other important desktop-specific features, checkout out some of the launch configuration in the API reference.

Future Steps

Make sure to read the Dioxus Guide if you already haven't!