Kubecodex is a standardized GitOps repository structure that works with ArgoCD to manage Kubernetes applications across multiple clusters. It provides:

• Organized Structure: Clear separation between cluster-specific and essential applications
• Automated Discovery: ApplicationSet controllers automatically discover and manage applications
• Flexible Configuration: Override defaults through simple config.yaml files
• Multi-Project Support: Logical grouping and access control through ArgoCD projects

After cloning or creating from template, start by using the CLI:

./kubecodex setup

It'll prompt for:

• Repository URL
• ArgoCD namespace

Then you can apply the bootstrap manifests (Argo should already be installed)

./kubecodex bootstrap

or

kubectl apply -f bootstrap.yaml

That's it — your ArgoCD instance will start syncing resources from your GitOps repository!

To make ArgoCD manage itself, uncomment resources in bootstrap/argo-cd/kustomization.yaml

This is a full example you can view and get ideas from kubecodex

This project was inspired by the ideas and best practices from:

• kubezero
• ArgoCD Autopilot

1. Read the Structure Overview to understand the directory layout
2. Follow the Quick Start Guide to set up your first project
3. Explore the Configuration Guide to customize your deployments

For detailed information about each component, see the main documentation index.