Add README.md

Author: coisa

README.md

@@ -0,0 +1,38 @@
+# FastForward\Iterators
+
+[![PHP Version](https://img.shields.io/badge/php-7.4%20%7C%208.0%2B-blue.svg)](https://www.php.net/)
+[![License](https://img.shields.io/github/license/php-fast-forward/iterators)](https://opensource.org/licenses/MIT)
+
+A robust and optimized library for advanced PHP Iterators.  
+Enhance your PHP applications with high-performance iterators, supporting lookahead, peeking, filtering, grouping, and more.
+
+## ✨ Features
+
+- 🔁 Advanced and composable iterator types
+- 👀 Lookahead and peeking support
+- 🧼 Filtering and mapping
+- 🧩 Grouping, chunking, and flattening
+- 🧪 Fully tested, mutation safe, and statically analyzed
+
+## 📦 Installation
+
+Install via Composer:
+
+```bash
+composer require fast-forward/iterators
+```
+
+## 🛠 Usage
+
+This package provides various iterator utilities under the `FastForward\Iterator` namespace.
+
+Check out the [`examples/`](https://github.com/php-fast-forward/iterators/tree/main/examples) directory for hands-on usage of each iterator.
+
+## 🧑‍💻 Author
+
+**Felipe Sayão Lobato Abreu**  
+<[email protected]>
+
+## 📄 License
+
+This project is licensed under the [MIT License](https://opensource.org/licenses/MIT).