> ## Documentation Index
> Fetch the complete documentation index at: https://timoni.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Package Manager for Kubernetes

> Distribution and lifecycle management for cloud-native applications, powered by CUE.

<div id="timoni-home">
  <section className="mx-auto max-w-6xl px-6 pt-12 pb-14 lg:pt-16 lg:pb-20">
    <div className="grid items-center gap-10 lg:grid-cols-[1.4fr_1fr]">
      <div>
        <h1 className="text-3xl font-bold tracking-tight text-gray-900 dark:text-white sm:text-4xl">
          Distribution and Lifecycle Management for Cloud-Native Applications
        </h1>

        <p className="mt-4 max-w-xl text-base leading-7 text-gray-600 dark:text-gray-400">
          Timoni brings CUE's type safety, code generation, and data validation features to Kubernetes,
          making the experience of crafting complex deployments into a pleasant journey.
        </p>

        <div className="mt-6 flex flex-wrap items-center gap-3">
          <a href="/web-api/iframe-proxy?url=https://timoni.sh/quickstart" className="rounded-lg bg-primary px-5 py-2.5 text-sm font-semibold text-white shadow-sm transition hover:bg-primary-dark dark:bg-primary-light dark:text-gray-950 dark:hover:bg-primary">
            Get started
          </a>

          <a href="/web-api/iframe-proxy?url=https://timoni.sh/install" className="rounded-lg border border-gray-300 px-5 py-2.5 text-sm font-semibold text-gray-900 transition hover:border-primary hover:text-primary dark:border-gray-700 dark:text-white dark:hover:border-primary-light dark:hover:text-primary-light">
            Install
          </a>
        </div>
      </div>

      <div className="hidden lg:flex lg:justify-end">
        <img src="/web-api/iframe-proxy?url=https://mintcdn.com/timoni/8xOqj2ulwazG1u2D/images/logo_icons.svg?fit=max&auto=format&n=8xOqj2ulwazG1u2D&q=85&s=f578c56854189805b74aceb8216cb2fb" alt="Timoni" className="tm-hero-logo w-64 max-w-full lg:w-80" noZoom width="406" height="286" data-path="images/logo_icons.svg" />
      </div>
    </div>
  </section>

  <section className="tm-band">
    <div className="mx-auto max-w-6xl px-6 py-16">
      <h2 className="text-center text-2xl font-bold tracking-tight text-gray-900 dark:text-white">
        Next Gen Package Manager for Kubernetes
      </h2>

      <p className="mx-auto mt-3 max-w-2xl text-center text-sm text-gray-600 dark:text-gray-400">
        Timoni uses CUE for defining apps and OCI artifacts for distributing them.
        Bundles compose apps into deployable units, and the CLI manages their lifecycle on Kubernetes clusters.
      </p>

      <div className="mt-10">
        <CardGroup cols={3}>
          <Card title="App definition" icon="layer-group" href="/web-api/iframe-proxy?url=https://timoni.sh/module">
            Software vendors define complex application deployments packaged as modules,
            using type-safe Kubernetes templates and rich customisation options for end-users.
          </Card>

          <Card title="App distribution" icon="cloud-arrow-up" href="/web-api/iframe-proxy?url=https://timoni.sh/cue/module/publishing">
            The app configuration contained in a module is distributed as an OCI artifact,
            next to the app container images. Modules are semantically versioned and cryptographically signed.
          </Card>

          <Card title="App lifecycle" icon="arrows-spin" href="/web-api/iframe-proxy?url=https://timoni.sh/bundle">
            With bundles, users manage the whole lifecycle of applications deployed on Kubernetes:
            customised installation, seamless upgrades, end-to-end testing, safe rollback and uninstallation.
          </Card>

          <Card title="App composition" icon="object-group" href="/web-api/iframe-proxy?url=https://timoni.sh/bundle-runtime">
            Bundle microservices and distributed monoliths into a deployable unit. The Bundle Runtime API
            offers a declarative way of managing the app delivery across environments.
          </Card>

          <Card title="Kubernetes CRD support" icon="https://mintcdn.com/timoni/7u6WQ6Bmm4qfUd3q/images/icons/kubernetes.svg?fit=max&auto=format&n=7u6WQ6Bmm4qfUd3q&q=85&s=60e5a9ee593495839fed88769b40c2e6" href="/web-api/iframe-proxy?url=https://timoni.sh/cue/module/custom-resources" width="24" height="24" data-path="images/icons/kubernetes.svg">
            Manage the lifecycle of Kubernetes controllers, including the upgrade of CRDs.
            Module authors can import CRD schemas from YAML files and use custom resources in their modules.
          </Card>

          <Card title="Drift detection and correction" icon="code-fork" href="/web-api/iframe-proxy?url=https://timoni.sh/cmd/timoni_apply">
            Review the cluster state diff before an upgrade. When correcting drift, Timoni waits for the
            changes to roll out and reports back the application health status.
          </Card>
        </CardGroup>
      </div>
    </div>
  </section>

  <section className="mx-auto max-w-6xl px-6 py-16 lg:py-20">
    <div className="grid items-center gap-12 lg:grid-cols-[1fr_1.35fr]">
      <div>
        <h2 className="text-2xl font-bold tracking-tight text-gray-900 dark:text-white">
          Define once, deploy everywhere
        </h2>

        <p className="mt-4 text-sm leading-6 text-gray-600 dark:text-gray-400">
          Describe the apps you want to run in a bundle and the clusters you want to run them on in a runtime.
          A single command then deploys the bundle to every selected cluster and waits for the workloads to become ready.
        </p>

        <ul className="mt-6 space-y-3 text-sm text-gray-600 dark:text-gray-400">
          <li className="flex gap-3">
            <span className="tm-check">
              <Icon icon="check" />
            </span>

            <span>Target all clusters, a group, or a single cluster.</span>
          </li>

          <li className="flex gap-3">
            <span className="tm-check">
              <Icon icon="check" />
            </span>

            <span>Vary the configuration by cluster name and group.</span>
          </li>

          <li className="flex gap-3">
            <span className="tm-check">
              <Icon icon="check" />
            </span>

            <span>Inject values from Secrets, ConfigMaps or CI env vars.</span>
          </li>
        </ul>

        <div className="mt-8 flex flex-wrap gap-3">
          <a href="/web-api/iframe-proxy?url=https://timoni.sh/bundle-multi-cluster" className="rounded-lg bg-primary px-4 py-2 text-sm font-semibold text-white shadow-sm transition hover:bg-primary-dark dark:bg-primary-light dark:text-gray-950 dark:hover:bg-primary">
            Multi-cluster deployments
          </a>

          <a href="/web-api/iframe-proxy?url=https://timoni.sh/bundle-runtime" className="rounded-lg border border-gray-300 px-4 py-2 text-sm font-semibold text-gray-900 transition hover:border-primary hover:text-primary dark:border-gray-700 dark:text-white dark:hover:border-primary-light dark:hover:text-primary-light">
            Bundle Runtime API
          </a>
        </div>
      </div>

      <div className="tm-diagram-frame">
        <img src="/web-api/iframe-proxy?url=https://mintcdn.com/timoni/5oyHPxxmEPpsGZcj/images/multi-cluster-light.svg?fit=max&auto=format&n=5oyHPxxmEPpsGZcj&q=85&s=811e24121d6650691064cc94eb1a991e" alt="A bundle and a runtime applied by timoni to a staging cluster and two production clusters" className="block w-full dark:hidden" noZoom width="760" height="360" data-path="images/multi-cluster-light.svg" />

        <img src="/web-api/iframe-proxy?url=https://mintcdn.com/timoni/5oyHPxxmEPpsGZcj/images/multi-cluster-dark.svg?fit=max&auto=format&n=5oyHPxxmEPpsGZcj&q=85&s=63fffd9e61082ee0685a32e4cb9fd25d" alt="A bundle and a runtime applied by timoni to a staging cluster and two production clusters" className="hidden w-full dark:block" noZoom width="760" height="360" data-path="images/multi-cluster-dark.svg" />
      </div>
    </div>
  </section>

  <section className="tm-band">
    <div className="mx-auto max-w-6xl px-6 py-16 lg:py-20">
      <div className="grid items-center gap-12 lg:grid-cols-[1fr_1.35fr]">
        <div>
          <h2 className="text-2xl font-bold tracking-tight text-gray-900 dark:text-white">
            Built for AI agents
          </h2>

          <p className="mt-4 text-sm leading-6 text-gray-600 dark:text-gray-400">
            Timoni ships agent skills and a documentation MCP server so that AI coding agents
            can operate Timoni end-to-end, from authoring modules and bundles to orchestrating
            multi-cluster deployments.
          </p>

          <ul className="mt-6 space-y-3 text-sm text-gray-600 dark:text-gray-400">
            <li className="flex gap-3">
              <span className="tm-check">
                <Icon icon="check" />
              </span>

              <span>Skills tested end-to-end with various LLMs.</span>
            </li>

            <li className="flex gap-3">
              <span className="tm-check">
                <Icon icon="check" />
              </span>

              <span>Safe by default: diff and dry-run previews before every apply.</span>
            </li>

            <li className="flex gap-3">
              <span className="tm-check">
                <Icon icon="check" />
              </span>

              <span>Docs searchable over MCP and available as markdown.</span>
            </li>
          </ul>

          <div className="mt-8 flex flex-wrap gap-3">
            <a href="/web-api/iframe-proxy?url=https://timoni.sh/ai-agents" className="rounded-lg bg-primary px-4 py-2 text-sm font-semibold text-white shadow-sm transition hover:bg-primary-dark dark:bg-primary-light dark:text-gray-950 dark:hover:bg-primary">
              Set up your agent
            </a>
          </div>
        </div>

        <CardGroup cols={1}>
          <Card title="Agent skills" icon="wand-magic-sparkles" href="/web-api/iframe-proxy?url=https://timoni.sh/ai-agents#agent-skills" horizontal>
            Install the Timoni skills for any agent with: <span className="block mt-1"><code>{"npx skills add https://timoni.sh"}</code></span>
          </Card>

          <Card title="Docs MCP server" icon="plug" href="/web-api/iframe-proxy?url=https://timoni.sh/ai-agents#docs-mcp-server" horizontal>
            Connect your agent to grep and fetch the docs: <span className="block mt-1"><code>{"https://timoni.sh/mcp"}</code></span>
          </Card>
        </CardGroup>
      </div>
    </div>
  </section>

  <section className="mx-auto max-w-6xl px-6 py-16">
    <div>
      <h2 className="text-center text-2xl font-bold tracking-tight text-gray-900 dark:text-white">
        Where to go next
      </h2>

      <div className="mt-10 grid gap-6 md:grid-cols-3">
        <Card title="Coming from Helm?" icon="https://mintcdn.com/timoni/7u6WQ6Bmm4qfUd3q/images/icons/helm.svg?fit=max&auto=format&n=7u6WQ6Bmm4qfUd3q&q=85&s=e914395454755fbed87e25aa6a021847" href="/web-api/iframe-proxy?url=https://timoni.sh/comparison" width="24" height="24" data-path="images/icons/helm.svg">
          A module is the equivalent of a chart, a bundle of an umbrella chart, and an instance of a release.
          See how Timoni compares to Helm and Kustomize.
        </Card>

        <Card title="New to CUE?" icon="https://mintcdn.com/timoni/7u6WQ6Bmm4qfUd3q/images/icons/cue.svg?fit=max&auto=format&n=7u6WQ6Bmm4qfUd3q&q=85&s=5259a3d0b6b17c1c869bf7f90acea42b" href="/web-api/iframe-proxy?url=https://timoni.sh/cue/introduction" width="24" height="24" data-path="images/icons/cue.svg">
          Learn why Timoni is built on CUE and walk through the language features used to
          generate and validate Kubernetes objects.
        </Card>

        <Card title="GitOps with Flux" icon="https://mintcdn.com/timoni/7u6WQ6Bmm4qfUd3q/images/icons/flux.svg?fit=max&auto=format&n=7u6WQ6Bmm4qfUd3q&q=85&s=826d91869db232bf2c15e6e20915e513" href="/web-api/iframe-proxy?url=https://timoni.sh/gitops-flux" width="24" height="24" data-path="images/icons/flux.svg">
          Combine Timoni with Flux to build a GitOps delivery pipeline for module instances
          and to orchestrate Helm charts.
        </Card>
      </div>
    </div>
  </section>

  <section className="tm-band">
    <div className="mx-auto max-w-6xl px-6 py-16">
      <div className="tm-gradient rounded-2xl px-8 py-12 text-center shadow-xl lg:px-16">
        <h2 className="text-2xl font-bold tracking-tight text-white">
          Ready to try Timoni?
        </h2>

        <p className="mx-auto mt-3 max-w-xl text-sm leading-6 tm-on-gradient">
          Install the CLI, deploy your first module and compose a bundle in a few minutes.
        </p>

        <div className="mt-6 flex flex-wrap items-center justify-center gap-3">
          <a href="/web-api/iframe-proxy?url=https://timoni.sh/quickstart" className="rounded-lg bg-white px-5 py-2.5 text-sm font-semibold text-gray-900 shadow-sm transition hover:bg-gray-100">
            Quickstart
          </a>

          <a href="/web-api/iframe-proxy?url=https://github.com/stefanprodan/timoni" className="rounded-lg tm-outline-light px-5 py-2.5 text-sm font-semibold transition">
            View on GitHub
          </a>
        </div>
      </div>
    </div>
  </section>

  <div className="tm-footer">
    <div className="mx-auto max-w-6xl px-6 py-12">
      <div className="grid gap-10 md:grid-cols-[1.5fr_1fr_1fr_1fr]">
        <div>
          <img src="/web-api/iframe-proxy?url=https://mintcdn.com/timoni/8xOqj2ulwazG1u2D/images/logo_text_black.svg?fit=max&auto=format&n=8xOqj2ulwazG1u2D&q=85&s=85ffbf62ec541a621a19255513199222" alt="Timoni" className="block h-7 w-auto dark:hidden" noZoom width="409" height="129" data-path="images/logo_text_black.svg" />

          <img src="/web-api/iframe-proxy?url=https://mintcdn.com/timoni/8xOqj2ulwazG1u2D/images/logo_text_white.svg?fit=max&auto=format&n=8xOqj2ulwazG1u2D&q=85&s=89788f7e520a7c81896a693804eb502d" alt="Timoni" className="hidden h-7 w-auto dark:block" noZoom width="409" height="129" data-path="images/logo_text_white.svg" />

          <p className="mt-4 max-w-xs text-sm text-gray-600 dark:text-gray-400">
            Package manager for Kubernetes, powered by CUE and inspired by Helm.
          </p>
        </div>

        <div>
          <h3 className="text-sm font-semibold text-gray-900 dark:text-white">Documentation</h3>

          <ul className="mt-4 space-y-2 text-sm">
            <li><a href="/web-api/iframe-proxy?url=https://timoni.sh/quickstart">Quickstart</a></li>
            <li><a href="/web-api/iframe-proxy?url=https://timoni.sh/concepts">Concepts</a></li>
            <li><a href="/web-api/iframe-proxy?url=https://timoni.sh/cue/introduction">CUE reference</a></li>
            <li><a href="/web-api/iframe-proxy?url=https://timoni.sh/cmd/timoni">CLI reference</a></li>
          </ul>
        </div>

        <div>
          <h3 className="text-sm font-semibold text-gray-900 dark:text-white">Project</h3>

          <ul className="mt-4 space-y-2 text-sm">
            <li><a href="/web-api/iframe-proxy?url=https://github.com/stefanprodan/timoni">Source code</a></li>
            <li><a href="/web-api/iframe-proxy?url=https://github.com/stefanprodan/timoni/releases">Releases</a></li>
            <li><a href="/web-api/iframe-proxy?url=https://github.com/stefanprodan/timoni/blob/main/CONTRIBUTING.md">Contributing</a></li>
            <li><a href="/web-api/iframe-proxy?url=https://github.com/stefanprodan/timoni/blob/main/LICENSE">License</a></li>
          </ul>
        </div>

        <div>
          <h3 className="text-sm font-semibold text-gray-900 dark:text-white">Community</h3>

          <ul className="mt-4 space-y-2 text-sm">
            <li><a href="/web-api/iframe-proxy?url=https://github.com/stefanprodan/timoni/discussions">Discussions</a></li>
            <li><a href="/web-api/iframe-proxy?url=https://github.com/stefanprodan/timoni/issues">Issues</a></li>
            <li><a href="/web-api/iframe-proxy?url=https://github.com/sponsors/stefanprodan">Sponsors</a></li>
            <li><a href="/web-api/iframe-proxy?url=https://cloud-native.slack.com/team/ULPRMFH38">Slack</a></li>
          </ul>
        </div>
      </div>

      <div className="tm-footer-bottom mt-10 flex flex-wrap items-center justify-between gap-4 pt-6 text-sm text-gray-500 dark:text-gray-400">
        <span>Copyright © 2026 <a href="/web-api/iframe-proxy?url=https://stefanprodan.com">Stefan Prodan</a></span>

        <span className="tm-footer-socials">
          <a href="/web-api/iframe-proxy?url=https://github.com/stefanprodan/timoni" aria-label="GitHub">
            <Icon icon="github" iconType="brands" />
          </a>

          <a href="/web-api/iframe-proxy?url=https://cloud-native.slack.com/team/ULPRMFH38" aria-label="Slack">
            <Icon icon="slack" iconType="brands" />
          </a>

          <a href="/web-api/iframe-proxy?url=https://x.com/stefanprodan" aria-label="X">
            <Icon icon="x-twitter" iconType="brands" />
          </a>

          <a href="/web-api/iframe-proxy?url=https://linkedin.com/in/stefanprodan" aria-label="LinkedIn">
            <Icon icon="linkedin" iconType="brands" />
          </a>
        </span>
      </div>
    </div>
  </div>
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.