diff --git a/packages/astro/README.md b/packages/astro/README.md
index e69de29b..09674906 100644
--- a/packages/astro/README.md
+++ b/packages/astro/README.md
@@ -0,0 +1,20 @@
+# Spotlight for Astro
+
+This is package is specifically built to add Spotlight to your Astro application with one command.
+
+## Installation
+
+```js
+npx astro add @spotlightjs/astro
+```
+
+## Usage
+
+```js
+// astro.config.mjs
+import spotlight from '@spotlightjs/astro';
+
+export default defineConfig({
+  integrations: [spotlight()],
+});
+```