diff --git a/packages/core/README.md b/packages/core/README.md
index 2d7d4e75..9d4b2766 100644
--- a/packages/core/README.md
+++ b/packages/core/README.md
@@ -1,3 +1,37 @@
+<p align="center">
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://formwerk.dev/logo-dark.svg">
+  <source media="(prefers-color-scheme: light)" srcset="https://formwerk.dev/logo-light.svg">
+  <img alt="Formwerk Logo" src="https://formwerk.dev/logo-dark.svg" width="340">
+</picture>
+</p>
+
+<p align="center">
+  <a href="https://npmjs.com/package/@formwerk/core">
+    <img alt="NPM Version" src="https://img.shields.io/npm/v/%40formwerk%2Fcore">
+  </a>
+  <a href="https://npmjs.com/package/@formwerk/core">
+    <img alt="NPM Downloads" src="https://img.shields.io/npm/dm/%40formwerk%2Fcore">
+  </a>
+  <a href="https://formwerk.dev">
+    <img src="https://img.shields.io/badge/Documentation-02B361?logo=gitbook&logoColor=white" alt="Documentation">
+  </a>
+  <a href="https://discord.gg/gQ7wqpvT5X">
+    <img src="https://img.shields.io/discord/1198932605740003388?logo=discord&logoColor=white" alt="Discord">
+  </a>
+  <img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/formwerkjs/formwerk/ci?logo=githubactions&logoColor=white">
+  <a href="https://github.com/sponsors/logaretm">
+    <img alt="GitHub Sponsors" src="https://img.shields.io/github/sponsors/logaretm?logo=githubsponsors&logoColor=white">
+  </a>
+  <img alt="License" src="https://img.shields.io/github/license/formwerkjs/formwerk">
+  <a href="https://bluesky.social/formwerk.dev">
+    <img alt="Follow us on BlueSky" src="https://img.shields.io/badge/Follow%20formwerk.dev-0284c7?style=flat&logo=bluesky&logoColor=white">
+  </a>
+  <a href="https://x.com/useformwerk">
+    <img alt="Follow us on X (formerly Twitter)" src="https://img.shields.io/badge/Follow%20@useformwerk-1f2937?style=flat&logo=x">
+  </a>
+</p>
+
 # Formwerk
 
 Formwerk is a Vue.js framework that simplifies forms by providing a comprehensive suite of composables for building accessible, high-quality, and scalable form components.