Decision Guide: Find Your Path

Not sure where to start with TypeKro? This guide helps you quickly find the right path based on your experience and goals.

🎯 What Do You Want to Build?

🚀 Simple Application (Deploy one service quickly)

Perfect for: Learning TypeKro, prototyping, simple web apps

Start Here: 5-Minute Quick Start → First App Tutorial

You'll learn:

• Basic TypeKro concepts
• Direct deployment
• Type-safe schemas

---

🏗️ Multi-Service Application (Database + frontend + backend)

Perfect for: Full-stack web apps, microservices, production systems

Start Here: Factory Functions → Magic Proxy System

You'll learn:

• Resource composition
• Cross-service references
• Dynamic status expressions

---

🌐 Complex Distributed System (Multiple interconnected services)

Perfect for: Enterprise applications, multi-team environments

Start Here: External References → Advanced Architecture

You'll learn:

• Cross-composition coordination
• External reference patterns
• Advanced deployment strategies

---

👤 What's Your Background?

🆕 New to Kubernetes

TypeKro simplifies Kubernetes complexity with type safety.

Your Journey:

1. 🚀 Quick Start - Get something running fast
2. 📱 First App - Understand the basics
3. 🏭 Factory Functions - Learn the building blocks
4. ✨ Magic Proxy - Discover TypeKro's power

---

🧑‍💻 Experienced with Kubernetes

You know kubectl and YAML - TypeKro adds type safety and magic references.

Your Journey:

1. 🏭 Factory Functions - See how factories replace YAML
2. ✨ Magic Proxy - Understand TypeKro's unique approach
3. 🔗 External References - Advanced coordination
4. 🏗️ Architecture - Deep technical understanding

---

🏛️ Infrastructure as Code Background (Pulumi, CDK8s, Terraform)

TypeKro offers type safety with runtime awareness and cross-composition magic.

Your Journey:

1. ✨ Magic Proxy - See what makes TypeKro unique
2. 🔗 External References - Cross-graph coordination
3. 🏗️ Architecture - Technical deep-dive
4. 🚢 Deployment Strategies - Production patterns

---

🎯 What Do You Want to Learn?

💡 Core TypeKro Concepts

Choose based on complexity:

• Beginner: Factory Functions - Building blocks
• Intermediate: Magic Proxy System - Dynamic references
• Advanced: External References - Multi-composition patterns

🚢 Deployment & Operations

Choose based on your workflow:

• Development: Direct Deployment - Immediate cluster deployment
• GitOps: GitOps Workflows - Git-based deployment
• Advanced: KRO Integration - Advanced orchestration

🔧 Extending TypeKro

Choose based on your needs:

• Custom Resources: Custom Factories - Build your own factories
• Architecture: Advanced Architecture - Internal design
• Integration: API Reference - Complete function documentation

---

🚦 Quick Decision Tree

Answer these questions to find your ideal starting point:

Question 1: Experience Level?

• New to TypeKro? → 🚀 Quick Start
• New to Kubernetes? → 📱 First App
• Experienced developer? → ✨ Magic Proxy

Question 2: Project Complexity?

• Single service? → 🚀 Quick Start
• Multi-service app? → 🏭 Factory Functions
• Complex distributed system? → 🔗 External References

Question 3: Primary Goal?

• Learn TypeKro basics? → 📱 First App
• Build production system? → 🏗️ Architecture
• Migrate from other tools? → ✨ Magic Proxy

---

📚 Complete Learning Paths

🌱 Beginner Path (New to TypeKro/Kubernetes)

🚀 Quick Start → 📱 First App → 🏭 Factories → ✨ Magic Proxy

Estimated time: 4-6 hours

🚀 Intermediate Path (Some Kubernetes experience)

🏭 Factories → ✨ Magic Proxy → 🔗 External References → 🏗️ Architecture

Estimated time: 6-8 hours

🎯 Advanced Path (Infrastructure experience)

✨ Magic Proxy → 🔗 External References → 🏗️ Architecture → 🚢 Deployment

Estimated time: 8-12 hours

---

🆘 Still Not Sure?

Start Here Based on Time Available:

⏱️ 15 minutes: 🚀 Quick Start - Deploy your first app
⏱️ 1 hour: 📱 First App - Complete tutorial with explanations
⏱️ 2-3 hours: 🏭 Factory Functions - Master the building blocks
⏱️ Half day: Work through the complete 📚 Learning Path

Get Help:

• 💬 Questions? Open a discussion
• 🐛 Issues? Report a bug
• 📚 More examples? Browse Examples
• 🔍 API docs? API Reference

---

🎉 Ready to Start?

Pick your path above and dive in! TypeKro's type-safe, magic proxy system will transform how you think about Kubernetes infrastructure.

Most Popular Starting Points:

1. 🚀 Quick Start - Fast success in 5 minutes
2. 📱 First App - Complete tutorial with context
3. ✨ Magic Proxy - See what makes TypeKro unique