Skip to content

Commit

Permalink
docs: Add README for Kubekit project
Browse files Browse the repository at this point in the history
  • Loading branch information
kahirokunn committed Apr 29, 2024
1 parent 967f749 commit ecfc13c
Showing 1 changed file with 35 additions and 0 deletions.
35 changes: 35 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -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).

0 comments on commit ecfc13c

Please sign in to comment.