diff --git a/.github/workflows/changesets.yml b/.github/workflows/changesets.yml
index bccfc35..8aa2c2b 100644
--- a/.github/workflows/changesets.yml
+++ b/.github/workflows/changesets.yml
@@ -45,7 +45,7 @@ jobs:
 
       - name: Create version pull request
         id: changesets
-        uses: changesets/action@e0145edc7d9d8679003495b11f87bd8ef63c0cba # v1.5.3
+        uses: changesets/action@a45c4d594aa4e2c509dc14a9f2b3b67ba3780d0d # v1.9.0
         with:
           title: 'chore: version packages'
           commit: 'chore: version packages'
@@ -76,7 +76,7 @@ jobs:
           skip-cache: true # avoid cache poisoning attacks
 
       - name: Publish to npm
-        uses: changesets/action@e0145edc7d9d8679003495b11f87bd8ef63c0cba # v1.5.3
+        uses: changesets/action@a45c4d594aa4e2c509dc14a9f2b3b67ba3780d0d # v1.9.0
         with:
           createGithubReleases: true
           publish: pnpm changeset:publish
diff --git a/README.md b/README.md
index 833c522..d3690df 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,48 @@
-# OpenIndex
+<br/>
 
-An npm package template.
+<p align="center">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://github.com/0xSplits/openindex/blob/main/.github/openindex-dark.svg">
+      <img alt="OpenIndex logo" src="https://github.com/0xSplits/openindex/blob/main/.github/openindex-light.svg" width="auto" height="200">
+    </picture>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/openindex">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/npm/v/openindex?colorA=21262d&colorB=21262d&style=flat">
+      <img src="https://img.shields.io/npm/v/openindex?colorA=f6f8fa&colorB=f6f8fa&style=flat" alt="Version">
+    </picture>
+  </a>
+  <a href="https://github.com/0xSplits/openindex/blob/main/LICENSE">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/npm/l/openindex?colorA=21262d&colorB=21262d&style=flat">
+      <img src="https://img.shields.io/npm/l/openindex?colorA=f6f8fa&colorB=f6f8fa&style=flat" alt="MIT License">
+    </picture>
+  </a>
+  <a href="https://app.codecov.io/gh/0xSplits/openindex">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/codecov/c/github/0xSplits/openindex?colorA=21262d&colorB=21262d&style=flat">
+      <img src="https://img.shields.io/codecov/c/github/0xSplits/openindex?colorA=f6f8fa&colorB=f6f8fa&style=flat" alt="Code coverage">
+    </picture>
+  </a>
+</p>
+
+## Overview
+
+OpenIndex is a lightweight, type-safe EVM indexer built on [viem](https://viem.sh). It uses imperative event handlers so you have full control over event filters, transforms, and storage.
+
+## Install
+
+```bash
+npm install openindex viem
+```
+
+## Documentation
+
+[Head to the documentation](https://openindex.dev) to read and learn more about OpenIndex.
+
+## Community
+
+- Follow [@0xSplits](https://x.com/0xSplits) on X for project updates
+- Join the [discussions on GitHub](https://github.com/0xSplits/openindex/discussions)
diff --git a/src/README.md b/src/README.md
index 75a22c2..8b0c2c0 100644
--- a/src/README.md
+++ b/src/README.md
@@ -2,8 +2,8 @@
 
 <p align="center">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://github.com/gregfromstl/openindex/blob/main/.github/openindex-dark.svg">
-      <img alt="OpenIndex logo" src="https://github.com/gregfromstl/openindex/blob/main/.github/openindex-light.svg" width="auto" height="200">
+      <source media="(prefers-color-scheme: dark)" srcset="https://github.com/0xSplits/openindex/blob/main/.github/openindex-dark.svg">
+      <img alt="OpenIndex logo" src="https://github.com/0xSplits/openindex/blob/main/.github/openindex-light.svg" width="auto" height="200">
     </picture>
 </p>
 
@@ -14,16 +14,16 @@
       <img src="https://img.shields.io/npm/v/openindex?colorA=f6f8fa&colorB=f6f8fa&style=flat" alt="Version">
     </picture>
   </a>
-  <a href="https://github.com/gregfromstl/openindex/blob/main/LICENSE">
+  <a href="https://github.com/0xSplits/openindex/blob/main/LICENSE">
     <picture>
       <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/npm/l/openindex?colorA=21262d&colorB=21262d&style=flat">
       <img src="https://img.shields.io/npm/l/openindex?colorA=f6f8fa&colorB=f6f8fa&style=flat" alt="MIT License">
     </picture>
   </a>
-  <a href="https://app.codecov.io/gh/gregfromstl/openindex">
+  <a href="https://app.codecov.io/gh/0xSplits/openindex">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/codecov/c/github/gregfromstl/openindex?colorA=21262d&colorB=21262d&style=flat">
-      <img src="https://img.shields.io/codecov/c/github/gregfromstl/openindex?colorA=f6f8fa&colorB=f6f8fa&style=flat" alt="Code coverage">
+      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/codecov/c/github/0xSplits/openindex?colorA=21262d&colorB=21262d&style=flat">
+      <img src="https://img.shields.io/codecov/c/github/0xSplits/openindex?colorA=f6f8fa&colorB=f6f8fa&style=flat" alt="Code coverage">
     </picture>
   </a>
 </p>
@@ -38,5 +38,5 @@ OpenIndex is a TypeScript library. <!-- TODO: describe what OpenIndex actually d
 
 ## Community
 
-- Follow [@gregfromstl](https://x.com/gregfromstl) on X for project updates
-- Join the [discussions on GitHub](https://github.com/gregfromstl/openindex/discussions)
+- Follow [@0xSplits](https://x.com/0xSplits) on X for project updates
+- Join the [discussions on GitHub](https://github.com/0xSplits/openindex/discussions)
diff --git a/src/package.json b/src/package.json
index 4fa3e5f..ad4470e 100644
--- a/src/package.json
+++ b/src/package.json
@@ -1,6 +1,6 @@
 {
   "name": "openindex",
-  "description": "A typescript npm package template.",
+  "description": "Easier Indexing for Ethereum",
   "version": "0.0.1",
   "type": "module",
   "main": "./_cjs/index.js",