+**dioxus-cli** (inspired by wasm-pack and webpack) is a tool for getting Dioxus projects up and running.
+It handles all build, bundling, development and publishing to simplify web development.
+
+
+## Installation
+
+### Install stable version
+```
+cargo install dioxus-cli
+```
+### Install from git repository
+```
+cargo install --git https://github.com/DioxusLabs/cli
+```
+### Install from local folder
+```
+cargo install --path . --debug
+```
+
+
+## Get Started
+
+Use `dioxus create project-name` 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:
+
+```
+dioxus create hello --template gh:dioxuslabs/dioxus-template
+```
+
+## Dioxus Config File
+
+Dioxus CLI will use `Dioxus.toml` file to Identify some project info and switch some cli feature.
+
+You can get more configure information from [Dioxus CLI Document](https://dioxuslabs.com/cli/configure.html).
\ No newline at end of file
diff --git a/packages/cli/build.rs b/packages/cli/build.rs
new file mode 100644
index 000000000..15935e2da
--- /dev/null
+++ b/packages/cli/build.rs
@@ -0,0 +1,50 @@
+//! Construct version in the `commit-hash date channel` format
+
+use std::{env, path::PathBuf, process::Command};
+
+fn main() {
+ set_rerun();
+ set_commit_info();
+ if option_env!("CFG_RELEASE").is_none() {
+ println!("cargo:rustc-env=POKE_RA_DEVS=1");
+ }
+}
+
+fn set_rerun() {
+ println!("cargo:rerun-if-env-changed=CFG_RELEASE");
+
+ let mut manifest_dir = PathBuf::from(
+ env::var("CARGO_MANIFEST_DIR").expect("`CARGO_MANIFEST_DIR` is always set by cargo."),
+ );
+
+ while manifest_dir.parent().is_some() {
+ let head_ref = manifest_dir.join(".git/HEAD");
+ if head_ref.exists() {
+ println!("cargo:rerun-if-changed={}", head_ref.display());
+ return;
+ }
+
+ manifest_dir.pop();
+ }
+
+ println!("cargo:warning=Could not find `.git/HEAD` from manifest dir!");
+}
+
+fn set_commit_info() {
+ let output = match Command::new("git")
+ .arg("log")
+ .arg("-1")
+ .arg("--date=short")
+ .arg("--format=%H %h %cd")
+ .output()
+ {
+ Ok(output) if output.status.success() => output,
+ _ => return,
+ };
+ let stdout = String::from_utf8(output.stdout).unwrap();
+ let mut parts = stdout.split_whitespace();
+ let mut next = || parts.next().unwrap();
+ println!("cargo:rustc-env=RA_COMMIT_HASH={}", next());
+ println!("cargo:rustc-env=RA_COMMIT_SHORT_HASH={}", next());
+ println!("cargo:rustc-env=RA_COMMIT_DATE={}", next())
+}
diff --git a/packages/cli/docs/.gitignore b/packages/cli/docs/.gitignore
new file mode 100644
index 000000000..7585238ef
--- /dev/null
+++ b/packages/cli/docs/.gitignore
@@ -0,0 +1 @@
+book
diff --git a/packages/cli/docs/book.toml b/packages/cli/docs/book.toml
new file mode 100644
index 000000000..c5c216fe4
--- /dev/null
+++ b/packages/cli/docs/book.toml
@@ -0,0 +1,6 @@
+[book]
+authors = ["YuKun Liu"]
+language = "en"
+multilingual = false
+src = "src"
+title = "Dioxus Cli"
diff --git a/packages/cli/docs/src/SUMMARY.md b/packages/cli/docs/src/SUMMARY.md
new file mode 100644
index 000000000..b5e3b91ae
--- /dev/null
+++ b/packages/cli/docs/src/SUMMARY.md
@@ -0,0 +1,18 @@
+# Summary
+
+- [Introduction](./introduction.md)
+- [Installation](./installation.md)
+- [Create a Project](./creating.md)
+- [Configure Project](./configure.md)
+- [Commands](./cmd/README.md)
+ - [Build](./cmd/build.md)
+ - [Serve](./cmd/serve.md)
+ - [Clean](./cmd/clean.md)
+ - [Translate](./cmd/translate.md)
+- [Plugin Development](./plugin/README.md)
+ - [API.Log](./plugin/interface/log.md)
+ - [API.Command](./plugin/interface/command.md)
+ - [API.OS](./plugin/interface/os.md)
+ - [API.Directories](./plugin/interface/dirs.md)
+ - [API.Network](./plugin/interface/network.md)
+ - [API.Path](./plugin/interface/path.md)
\ No newline at end of file
diff --git a/packages/cli/docs/src/cmd/README.md b/packages/cli/docs/src/cmd/README.md
new file mode 100644
index 000000000..dae226577
--- /dev/null
+++ b/packages/cli/docs/src/cmd/README.md
@@ -0,0 +1,26 @@
+# Commands
+
+In this chapter we will introduce all `dioxus-cli` commands.
+
+> You can also use `dioxus --help` to get cli help info.
+
+```
+dioxus
+Build, bundle, & ship your Dioxus app
+
+USAGE:
+ dioxus [OPTIONS]
+
+OPTIONS:
+ -h, --help Print help information
+ -v Enable verbose logging
+
+SUBCOMMANDS:
+ build Build the Dioxus application and all of its assets
+ clean Clean output artifacts
+ config Dioxus config file controls
+ create Init a new project for Dioxus
+ help Print this message or the help of the given subcommand(s)
+ serve Build, watch & serve the Rust WASM app and all of its assets
+ translate Translate some html file into a Dioxus component
+```
\ No newline at end of file
diff --git a/packages/cli/docs/src/cmd/build.md b/packages/cli/docs/src/cmd/build.md
new file mode 100644
index 000000000..1fb892475
--- /dev/null
+++ b/packages/cli/docs/src/cmd/build.md
@@ -0,0 +1,47 @@
+# Build
+
+The `dioxus build` command can help you `pack & build` a dioxus project.
+
+```
+dioxus-build
+Build the Rust WASM app and all of its assets
+
+USAGE:
+ dioxus build [OPTIONS]
+
+OPTIONS:
+ --example [default: ""]
+ --platform [default: "default_platform"]
+ --release [default: false]
+```
+
+You can use this command to build a project:
+
+```
+dioxus build --release
+```
+
+## Target platform
+
+Use the `platform` option to choose your target platform:
+
+```
+# for desktop project
+dioxus build --platform desktop
+```
+
+`platform` currently only supports `desktop` & `web`.
+
+```
+# for web project
+dioxus build --platform web
+```
+
+## Build Example
+
+You can use the `example` option to select a example to build:
+
+```
+# build the `test` example
+dioxus build --exmaple test
+```
\ No newline at end of file
diff --git a/packages/cli/docs/src/cmd/clean.md b/packages/cli/docs/src/cmd/clean.md
new file mode 100644
index 000000000..bbb3a132e
--- /dev/null
+++ b/packages/cli/docs/src/cmd/clean.md
@@ -0,0 +1,18 @@
+# Clean
+
+`dioxus clean` will clear the build artifacts (the out_dir and the cargo cache)
+
+```
+dioxus-clean
+Clean build artifacts
+
+USAGE:
+ dioxus clean
+```
+
+# Example
+
+```
+dioxus clean
+```
+
diff --git a/packages/cli/docs/src/cmd/serve.md b/packages/cli/docs/src/cmd/serve.md
new file mode 100644
index 000000000..41abf5350
--- /dev/null
+++ b/packages/cli/docs/src/cmd/serve.md
@@ -0,0 +1,61 @@
+# Serve
+
+The `dioxus serve` can start a dev server with hot-reloading
+
+```
+dioxus-serve
+Build, watch & serve the Rust WASM app and all of its assets
+
+USAGE:
+ dioxus serve [OPTIONS]
+
+OPTIONS:
+ --example [default: ""]
+ --platform [default: "default_platform"]
+ --release [default: false]
+ --hot-reload [default: false]ß
+```
+
+You can use this command to build project and start a dev server:
+
+```
+dioxus serve
+```
+
+## Serve Example
+
+You can use the `example` option to serve a example:
+
+```
+# serve the `test` example
+dioxus serve --exmaple test
+```
+
+## Open Browser
+
+You can add the `--open` option to open system default browser when server startup:
+
+```
+dioxus serve --open
+```
+
+## RSX Hot Reloading
+
+You can add the `--hot-reload` flag to enable [rsx hot reloading](https://dioxuslabs.com/docs/0.3/guide/en/getting_started/hot_reload.html). This will allow you to reload some rsx changes without a full recompile:
+
+```
+dioxus serve --open
+```
+
+## Cross Origin Policy
+
+You can add the `cross-origin-policy` option to change cross-origin header to:
+
+```
+ Cross-Origin-Opener-Policy: same-origin
+ Cross-Origin-Embedder-Policy: require-corp
+```
+
+```
+dioxus serve --corss-origin-policy
+```
\ No newline at end of file
diff --git a/packages/cli/docs/src/cmd/translate.md b/packages/cli/docs/src/cmd/translate.md
new file mode 100644
index 000000000..7237e1dcf
--- /dev/null
+++ b/packages/cli/docs/src/cmd/translate.md
@@ -0,0 +1,68 @@
+# Translate
+
+`dioxus translate` can translate some `html` file into a Dioxus compoent
+
+```
+dioxus-translate
+Translate some source file into a Dioxus component
+
+USAGE:
+ dioxus translate [OPTIONS] [OUTPUT]
+
+ARGS:
+