Rewrite TypeScript README in the format of the Python README

libs/typescript/core/README.md

@@ -1,22 +1,47 @@
-# Cua Core TypeScript Library
+<div align="center">
+<h1>
+  <div class="image-wrapper" style="display: inline-block;">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" alt="logo" height="150" srcset="https://raw.githubusercontent.com/trycua/cua/main/img/logo_white.png" style="display: block; margin: auto;">
+      <source media="(prefers-color-scheme: light)" alt="logo" height="150" srcset="https://raw.githubusercontent.com/trycua/cua/main/img/logo_black.png" style="display: block; margin: auto;">
+      <img alt="Shows my svg">
+    </picture>
+  </div>
 
-The core cua library with support for telemetry and other utilities.
+  [![TypeScript](https://img.shields.io/badge/TypeScript-333333?logo=typescript&logoColor=white&labelColor=333333)](#)
+  [![macOS](https://img.shields.io/badge/macOS-000000?logo=apple&logoColor=F0F0F0)](#)
+  [![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?&logo=discord&logoColor=white)](https://discord.com/invite/mVnXXpdE85)
+  [![NPM](https://img.shields.io/npm/v/@trycua/core?color=333333)](https://www.npmjs.com/package/@trycua/core)
+</h1>
+</div>
+
+**Cua Core** provides essential shared functionality and utilities used across the Cua ecosystem:
+
+- Privacy-focused telemetry system for transparent usage analytics
+- Common helper functions and utilities used by other Cua packages
+- Core infrastructure components shared between modules
+
+## Installation
+
+```bash
+pnpm install @trycua/core
+```
 
 ## Development
 
-- Install dependencies:
+Install dependencies:
 
 ```bash
 pnpm install
 ```
 
-- Run the unit tests:
+Run the unit tests:
 
 ```bash
 pnpm test
 ```
 
-- Build the library:
+Build the library:
 
 ```bash
 pnpm build