📦✨ Dioxus CLI

Tooling to supercharge Dioxus projects

The **dioxus-cli** (inspired by wasm-pack and webpack) is a tool for getting Dioxus projects up and running. It handles building, bundling, development and publishing to simplify development. ## Installation ### Install the stable version (recommended) ```shell cargo install dioxus-cli ``` ### Install the latest development build through git To get the latest bug fixes and features, you can install the development version from git. However, this is not fully tested. That means you're probably going to have more bugs despite having the latest bug fixes. ```shell cargo install --git https://github.com/DioxusLabs/dioxus dioxus-cli ``` This will download the CLI from the master branch, and install it in Cargo's global binary directory (`~/.cargo/bin/` by default). ### Install from local folder Note: The CLI will fail to build projects in debug profile. This is currently under investigation. ```shell cargo install --path . --release ``` ## Get started Use `dx create` to initialize a new Dioxus project. It will be cloned from the [dioxus-template](https://github.com/DioxusLabs/dioxus-template) repository. Alternatively, you can specify the template path: ```shell dx create --template gh:dioxuslabs/dioxus-template ``` Run `dx --help` for a list of all the available commands. Furthermore, you can run `dx --help` to get help with a specific command. ## Dioxus config file You can use the `Dioxus.toml` file for further configuration. Some fields are mandatory, but the CLI tool will tell you which ones are missing. You can create a `Dioxus.toml` with all fields already set using `dx config init project-name`, or you can use this bare-bones template (only mandatory fields) to get started: ```toml [application] name = "project-name" # Currently supported platforms: web, desktop default_platform = "web" [web.app] title = "Hello" [web.watcher] [web.resource.dev] ``` The full anatomy of `Dioxus.toml` is shown on the [Dioxus website](https://dioxuslabs.com/learn/0.5/CLI/configure).