diff --git a/README.md b/README.md
new file mode 120000
index 0000000..6b62377
--- /dev/null
+++ b/README.md
@@ -0,0 +1 @@
+cargo-apk/README.md
\ No newline at end of file
diff --git a/cargo-apk/README.md b/cargo-apk/README.md
index f5f8ad7..3408c5a 100644
--- a/cargo-apk/README.md
+++ b/cargo-apk/README.md
@@ -1,5 +1,15 @@
 # cargo apk
 
+[![Actions Status](https://github.com/rust-mobile/cargo-apk/actions/workflows/rust.yml/badge.svg)](https://github.com/rust-mobile/cargo-apk/actions)
+[![Latest version](https://img.shields.io/crates/v/cargo-apk.svg?logo=rust)](https://crates.io/crates/cargo-apk)
+[![Documentation](https://docs.rs/cargo-apk/badge.svg)](https://docs.rs/cargo-apk)
+[![Lines of code](https://tokei.rs/b1/github/rust-mobile/cargo-apk)](https://github.com/rust-mobile/cargo-apk)
+![MIT](https://img.shields.io/badge/License-MIT-green.svg)
+![Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-green.svg)
+
+> **Warning**
+> This tool is deprecated in favour of [`xbuild`](https://github.com/rust-mobile/xbuild).
+
 Tool for creating Android packages.
 
 ## Installation
@@ -13,7 +23,7 @@ $ cargo install cargo-apk
 From source:
 
 ```console
-$ cargo install --path .
+$ cargo install --path cargo-apk/
 ```
 
 ## Commands
diff --git a/ndk-build/README.md b/ndk-build/README.md
new file mode 100644
index 0000000..3f4152b
--- /dev/null
+++ b/ndk-build/README.md
@@ -0,0 +1,13 @@
+# `ndk-build`
+
+[![Actions Status](https://github.com/rust-mobile/cargo-apk/actions/workflows/rust.yml/badge.svg)](https://github.com/rust-mobile/cargo-apk/actions)
+[![Latest version](https://img.shields.io/crates/v/ndk-build.svg?logo=rust)](https://crates.io/crates/ndk-build)
+[![Documentation](https://docs.rs/ndk-build/badge.svg)](https://docs.rs/ndk-build)
+[![Lines of code](https://tokei.rs/b1/github/rust-mobile/cargo-apk)](https://github.com/rust-mobile/cargo-apk)
+![MIT](https://img.shields.io/badge/License-MIT-green.svg)
+![Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-green.svg)
+
+> **Warning**
+> This crate and `cargo-apk` are deprecated in favour of [`xbuild`](https://github.com/rust-mobile/xbuild).
+
+Helps [`cargo-apk`](https://crates.io/crates/cargo-apk) cross-compile libraries and package APKs in a generic, reusable Rust crate.