Update README.md

Author: vsanthanam

README.md

@@ -1 +1,76 @@
-# JBird
+# JBird
+
+[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Swift 6.1](https://img.shields.io/badge/Swift-6.1-orange.svg)](https://swift.org)
+[![Platform](https://img.shields.io/badge/Platforms-iOS%20%7C%20macOS%20%7C%20watchOS%20%7C%20tvOS%20%7C%20visionOS-lightgrey.svg)](https://developer.apple.com)
+
+A high-performance JSON parsing and manipulation library for Swift with a focus on speed, type safety, and a modern Swift API.
+
+## Features
+
+- ⚡️ **High Performance**: Built with a C core for optimized parsing with SIMD acceleration where available
+- 🛡️ **Type Safe**: Rich Swift API with proper type checking and error handling
+- 🧩 **Declarative**: Build JSON objects and arrays using SwiftUI-like builders
+- 🔄 **Swift Macros**: Utilize Swift macros for cleaner, more concise code
+- 📊 **Flexible API**: Easily convert between JSON and native Swift types
+- 🧪 **Well Tested**: Comprehensive test suite ensures reliability
+- 📝 **Fully Documented**: Complete DocC documentation
+- 🔧 **Customizable**: Extensible to fit your specific needs
+
+## Installation
+
+JBird is currently distributed exclusively through the [Swift Package Manager](https://www.swift.org/package-manager/). 
+
+To add JBird as a dependency to an existing Swift package, add the following line of code to the `dependencies` parameter of your `Package.swift` file:
+
+Add JBird to your `Package.swift` file:
+
+```swift
+dependencies: [
+    .package(url: "https://github.com/vsanthanam/JBird.git", from: "1.0.0")
+]
+```
+
+Then add the dependency to your target:
+
+```swift
+.target(
+    name: "YourTarget",
+    dependencies: ["JBird"]
+)
+```
+
+To add JBird as a dependency to an Xcode Project: 
+
+- Choose `File` → `Add Packages...`
+- Enter package URL `https://github.com/vsanthanam/JBird.git` and select your release and of choice.
+
+Other distribution mechanisms like CocoaPods or Carthage may be added in the future.
+
+## Performance
+
+JBird is designed for high performance, with benchmarks showing it to be one of the fastest JSON parsers available for Swift. The core parsing engine is written in C with SIMD acceleration where available, making it significantly faster than pure Swift implementations.
+
+JBird demonstrates exceptional performance compared to other popular JSON parsing libraries:
+
+- **Speed**: JBird parses JSON 2-5x faster than SwiftyJSON and about 25% faster than Foundation
+- **Memory Efficiency**: JBird uses significantly less memory than other parsers (up to a 95% reduction)
+- **Resource Usage**: JBird requires dramatically fewer CPU instructions and memory allocations for equivelent payloads
+- **Consistent Performance**: JBird maintains its performance advantage across different JSON file sizes and formats
+
+These benchmarks were run on a variety of JSON files ranging from 64KB to 5MB, in both minified and pretty-printed formats. You can explore the comparisons with common Swift JSON libraries (Foundation, SwiftyJSON, etc.) in the `/Benchmarks` directory.
+
+## Usage & Documentation
+
+JBird's documentation is built with [DocC](https://developer.apple.com/documentation/docc) and included in the repository as a DocC archive. The latest version is hosted on [GitHub Pages](https://pages.github.com) and is available [here](https://usejbird.com/docs/documentation/jbird).
+
+Additional installation instructions are available on the [Swift Package Index](https://swiftpackageindex.com/vsanthanam/JBird)
+
+[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fvsanthanam%2FJBird%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/vsanthanam/JBird)
+[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fvsanthanam%2FJBird%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/vsanthanam/JBird)
+
+Explore [the documentation](https://usejbird.com/docs/documentation/jbird) for more details.
+
+## License
+
+**JBird** is available under the [MIT license](https://en.wikipedia.org/wiki/MIT_License). See the [LICENSE](https://github.com/vsanthanam/JBird/blob/main/LICENSE) file for more information.