TypeKro

Appearance

Kubernetes with TypeScript instead of YAML

Build Kubernetes infrastructure with runtime dependencies in clean TypeScript that compiles to Kubernetes Resource Orchestrator (KRO) YAML.

Get Started
View Examples
⭐ Star on GitHub
🔒

Full Type Safety

Catch infrastructure errors at compile time with TypeScript's powerful type system. Get IDE autocomplete for all Kubernetes resources.

🔄

Runtime Dependencies

Built on Kubernetes Resource Orchestrator (KRO), cross-resource references and CEL expressions evaluate at runtime, enabling dynamic infrastructure that adapts to cluster state.

📦

KRO-Native YAML

Compiles to KRO ResourceGraphDefinitions with deterministic YAML output. No external state backends or custom orchestration layers needed.

🚀

Deployment Modes

Choose direct deployment for rapid feedback, KRO mode for advanced orchestration, or YAML generation for GitOps workflows.

🔗

Ecosystem Integration

Seamlessly integrate with Alchemy for multi-cloud infrastructure (AWS, GCP, Azure) and GitOps workflows (ArgoCD, Flux). Unified TypeScript experience across your entire stack.

⚡

Developer Experience

Write infrastructure in pure TypeScript with full IDE support. Refactor safely with compile-time validation and modern tooling.

⚠️ BETA - Not for production

Getting Started

Step 1 of 6

Define Your Application Schema

Start with type-safe schema definitions using ArkType

typescript
import { type } from 'arktype';

// Define your application's specification schema
const WebAppSpecSchema = type({
  name: 'string',
  image: 'string',
  replicas: 'number%1',
  port: 'number%1'
});

// Define the status schema for runtime information
const WebAppStatusSchema = type({
  url: 'string',
  ready: 'boolean',
  deployedReplicas: 'number'
});

ArkType provides runtime type validation with TypeScript inference. This ensures your infrastructure definitions are type-safe at both compile time and runtime, giving you excellent developer experience with IntelliSense and catching errors early.

Why TypeKro? ​

Because nobody likes YAML and Kubernetes dependencies are hard. TypeKro provides runtime intelligence through Kubernetes Resource Orchestrator (KRO), enabling resources to reference each other's live cluster state with CEL expressions. Here's what you get compared to other tools:

FeatureTypeKroPulumiCDK8sHelmKustomizeCrossplane
Type Safety✅ Full TypeScript✅ Multi-language✅ TypeScript❌ Templates❌ YAML❌ YAML
GitOps Ready✅ Deterministic YAML❌ State backend✅ YAML output✅ Charts✅ YAML✅ YAML
Runtime Dependencies✅ KRO + CEL expressions❌ Deploy-time only❌ Static❌ Templates❌ Static✅ Compositions
IDE Support✅ Full autocomplete✅ Language support✅ TypeScript❌ Limited❌ Limited❌ Limited
Learning Curve🟢 Just TypeScript🔴 New concepts🟡 TypeScript + K8s🔴 Templates🔴 YAML hell🔴 Complex
Kubernetes Native✅ Pure K8s resources❌ Abstraction layer✅ Pure K8s✅ K8s resources✅ K8s resources✅ K8s + CRDs
Cross-Resource Refs✅ Runtime resolution❌ Deploy-time❌ Manual❌ Manual❌ Manual✅ Built-in
Multi-Cloud🟡 Via Alchemy✅ Native❌ K8s only❌ K8s only❌ K8s only✅ Native
State Management✅ Stateless❌ State backend✅ Stateless✅ Stateless✅ Stateless✅ Controller

What is KRO? ​

Kubernetes Resource Orchestrator (KRO) is an open-source project by AWS Labs, with contributions from Google, Microsoft, and the broader Kubernetes community. KRO enables advanced resource orchestration with runtime dependencies and CEL expressions. TypeKro builds on KRO to provide:

  • 🔄 Runtime Intelligence: Resources can reference each other's runtime state (like IP addresses, status conditions)
  • 📋 Custom Resource Types: Define your own Kubernetes resource types with TypeScript schemas
  • 🎯 CEL Expressions: Use Google's Common Expression Language for dynamic resource configuration
  • 🔧 GitOps Native: Generates standard Kubernetes YAML that works with any GitOps workflow

TypeKro works in Direct Mode (no KRO required) for simple deployments, or KRO Mode for advanced orchestration with runtime dependencies.

Learn more: KRO Documentation →

Ready to Get Started? ​

Released under the Apache 2.0 License.

Copyright © 2024-present TypeKro Contributors