diff --git a/README.md b/README.md
index 0450d57d..401ecc18 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,13 @@
-> freeCodeCamp's UI Component Library
+<img src="https://cdn.freecodecamp.org/platform/universal/fcc_banner_new.png" alt="freeCodeCamp banner">
+
+
+freeCodeCamp's component library is a collection of reusable React components that can be used in your projects. The components are built with accessibility in mind and are designed to be easy to use and customize.
+
+## Installation
+To install the component library, run the following command:
+```bash
+pnpm install @freecodecamp/ui
+```
+
+## Docs
+To see the components in action, check out the [Storybook](https://freecodecamp.github.io/ui/).