diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 2183359..c448660 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -60,8 +60,8 @@ jobs:
           RUSTDOCFLAGS: -D warnings
         run: cargo +stable doc --workspace --no-deps --locked
 
-      - name: Verify Cargo package contents
-        run: cargo +stable package -p stack-theme --locked
+      - name: Verify crates.io package
+        run: cargo +stable publish --dry-run -p stack-theme --locked
 
       - name: Verify repository files
         run: |
diff --git a/README.md b/README.md
index 5d37331..53b882a 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,16 @@ The current `0.5.0` catalog contains the core `default`, `light`, and `dark` the
 
 Provider-specific assets are not bundled. The provider-pack contract lets a CLI or browser validate an archive that the user explicitly selected from the provider's official source, keep it local, preserve the artwork, and carry source and terms notices into diagram output.
 
+## Cargo package
+
+Add the Rust catalog from crates.io with:
+
+```sh
+cargo add stack-theme@0.5.0
+```
+
+The package supports Rust 1.85 or newer and includes only the generated catalog API, repository-authored SVG assets, public schemas, package documentation, and the Apache-2.0 license.
+
 ## Scope
 
 This repository will own:
diff --git a/crates/stack-theme/Cargo.toml b/crates/stack-theme/Cargo.toml
index ae50284..6c12e4c 100644
--- a/crates/stack-theme/Cargo.toml
+++ b/crates/stack-theme/Cargo.toml
@@ -6,6 +6,12 @@ license.workspace = true
 repository.workspace = true
 rust-version.workspace = true
 version.workspace = true
+homepage = "https://stack-diagram.com/"
+documentation = "https://docs.rs/stack-theme"
+readme = "README.md"
+publish = ["crates-io"]
+keywords = ["stack", "diagram", "theme", "icons"]
+categories = ["graphics"]
 include = ["src/**", "assets/**", "licenses/**", "schema/**", "README.md", "LICENSE"]
 
 [dependencies]
diff --git a/crates/stack-theme/README.md b/crates/stack-theme/README.md
index c6a2611..4ecfdc4 100644
--- a/crates/stack-theme/README.md
+++ b/crates/stack-theme/README.md
@@ -3,3 +3,5 @@
 `stack-theme` exposes the typed Stack theme catalog and embeds the same generated catalog revision as the `@stack-sh/theme` npm package.
 
 The public contract and compatibility policy are documented in the repository's [`CONTRACT.md`](https://github.com/stack-sh/theme/blob/main/CONTRACT.md).
+
+Add version 0.5.0 from crates.io with `cargo add stack-theme@0.5.0`. The package supports Rust 1.85 or newer.