diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fa0ae82
--- /dev/null
+++ b/README.md
@@ -0,0 +1,89 @@
+# Temporalz
+
+A Zig library for working with temporal types based on the [Temporal Standard](https://tc39.es/proposal-temporal/).
+
+Temporalz provides Zig bindings to the Rust-based [temporal_rs](https://github.com/boa-dev/temporal) library for handling dates, times, and durations with proper timezone support.
+
+## Features
+
+- [x] Instant - Exact moment in time
+- [x] Duration - Length of time
+- [ ] PlainDate - Date without time or timezone
+- [ ] PlainTime - Time without date or timezone
+- [ ] PlainDateTime - Date and time without timezone
+- [ ] PlainYearMonth - Year and month
+- [ ] PlainMonthDay - Month and day
+- [ ] ZonedDateTime - Date, time, and timezone
+
+## Installation
+
+### Prerequisites
+
+- Zig 0.15.2 or later
+- Rust toolchain (only required if prebuilt binaries are not available for your platform)
+
+### Add as a Dependency
+
+```bash
+zig fetch --save=temporalz https://github.com/nurulhudaapon/temporalz/archive/refs/tags/v0.1.2.tar.gz
+```
+
+### Use in build.zig
+
+Add temporalz to your executable in `build.zig`:
+
+```zig
+const temporalz_dep = b.dependency("temporalz", .{ .target = target, .optimize = optimize });
+
+const exe = b.addExecutable(.{
+    .name = "my_app",
+    .root_module = b.createModule(.{
+        .root_source_file = b.path("src/main.zig"),
+        .target = target,
+        .optimize = optimize,
+        .imports = &.{
+            .{ .name = "temporalz", .module = temporalz_dep.module("temporalz") },
+        },
+    }),
+});
+```
+
+## Supported Platforms
+
+Prebuilt binaries are available for:
+
+- aarch64-macos
+- x86_64-macos
+- aarch64-linux-gnu
+- x86_64-linux-gnu
+- x86_64-windows-gnu
+- aarch64-windows-gnu
+
+For unsupported platforms, the library will automatically build from source if the Rust toolchain is installed.
+
+## Development
+
+### Clone the Repository
+
+```bash
+git clone https://github.com/nurulhudaapon/temporalz.git
+cd temporalz
+```
+
+### Build and Run
+
+```bash
+zig build
+zig build run
+```
+
+### Run Tests
+
+```bash
+zig build test
+```
+
+## License
+
+MIT
+