diff --git a/packages/core/README.md b/packages/core/README.md
index 3cb632af..67124c3e 100644
--- a/packages/core/README.md
+++ b/packages/core/README.md
@@ -2,12 +2,14 @@
**@stitches/core** is a framework-agnostic implementation of [stitches](https://stitches.dev), a CSS-in-JS library with a best-in-class developer experience.
+
+
```sh
# with npm
-npm install @stitches/react
+npm install @stitches/core
# with yarn
-yarn add @stitches/react
+yarn add @stitches/core
```
diff --git a/packages/react/README.md b/packages/react/README.md
index c7adc252..33a83fc0 100644
--- a/packages/react/README.md
+++ b/packages/react/README.md
@@ -1,12 +1,45 @@
-# Stitches React
+# @stitches/react
-React wrapper including the `styled` API.
+**@stitches/react** is a react implementation of [stitches](https://stitches.dev), a CSS-in-JS library with a best-in-class developer experience.
+
+
```sh
+# with npm
npm install @stitches/react
+
+# with yarn
+yarn add @stitches/react
+```
+
+
+
+
+
+
+
+```html
+
+```
+
+
+
+
+
+
+
+```js
+
+
```
----
+
## Documentation