From ecfc13cac938914478f9c9741a98d40a4193c4c8 Mon Sep 17 00:00:00 2001
From: kahirokunn <okinakahiro@gmail.com>
Date: Mon, 29 Apr 2024 10:37:40 +0900
Subject: [PATCH] docs: Add README for Kubekit project

---
 README.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 00000000..529b00e9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+# kubekit
+
+kubekit is developed to provide a simple, fast, and customizable TypeScript Kubernetes client and controller runtime. It is designed with type safety and efficiency in mind, and is optimized for Tree Shaking compatibility. It supports Next.js and Node.js, with planned future support for Bun and Deno.
+
+## Features
+
+- **Simple**: Intuitive API that is easy to use
+- **Fast**: Optimized performance
+- **Slim**: Minimal dependencies and lean implementation
+- **Customizable**: A variety of configuration options
+- **Type-Safe**: Fully leverages TypeScript
+- **Tree Shaking Compatibility**: Does not include any unused code
+- **Support**: Next.js, Node.js
+
+## Components
+
+### [@kubekit/client](https://github.com/appthrust/kubekit-ts/tree/main/packages/kubekit-client)
+
+A TypeScript Kubernetes client and controller runtime.
+
+### [@kubekit/sync](https://github.com/appthrust/kubekit-ts/tree/main/packages/kubekit-sync)
+
+Expands the `OpenAPI` schema containing CustomResources obtained from `$ kubectl get --raw /openapi/v3` into files.
+
+### [@kubekit/codegen](https://github.com/appthrust/kubekit-ts/tree/main/packages/kubekit-codegen)
+
+Generates TypeScript type definitions from the `OpenAPI` schema and produces minimal client code that wraps `@kubekit/client`.
+
+## Origin
+
+kubekit was inspired by `RTK Query` and `RTK Query Codegen`, and the creator of kubekit, [kahirokunn](https://github.com/kahirokunn), was an early contributor to [rtk-query-codegen-openapi](https://github.com/reduxjs/redux-toolkit/tree/master/packages/rtk-query-codegen-openapi). This project began by [forking the code](https://github.com/reduxjs/redux-toolkit/commit/52ab548c55198f2c5cacb2be9a8dbae235d4443c) of `RTK Query` and `RTK Query Codegen`, aiming to incorporate the best features of both while adapting to the unique characteristics of Kubernetes. As a result, `@kubekit/client` and `@kubekit/codegen` were developed.
+
+## Support and Contributions
+
+kubekit is an open-source project that welcomes feedback and contributions from the community. Please refer to the [Contribution Guide](https://github.com/appthrust/kubekit-ts/blob/main/CONTRIBUTING.md).