> ## Documentation Index
> Fetch the complete documentation index at: https://grounds-docs-platform-architecture.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding a New Chart

> Step-by-step guide to add a new Helm chart to the repository

<Info>
  **Prerequisites**:

  * Helm installed locally
  * Write access to the charts repository
  * Familiarity with the existing chart layout and release workflows
</Info>

Use these steps to add a new Helm chart to the repository.

<Steps>
  <Step title="Create Chart Directory">
    Create a new directory that matches the chart name:

    ```bash theme={null}
    mkdir your-chart-name
    cd your-chart-name
    ```
  </Step>

  <Step title="Initialize Helm Chart">
    Use Helm to create a new chart structure:

    ```bash theme={null}
    helm create your-chart-name
    ```

    Or manually create the required files:

    * `Chart.yaml` - Chart metadata
    * `values.yaml` - Default configuration values
    * `templates/` - Kubernetes manifest templates

    <Check>
      Verify that the chart directory contains the files your repository workflows expect before you continue.
    </Check>
  </Step>

  <Step title="Create Chart README">
    Create a `README.md` in your chart directory with:

    * Chart description
    * Prerequisites
    * Installation instructions
    * Configuration options
    * Examples
  </Step>

  <Step title="Update Repository Index">
    Add your chart to the repository index. This is typically done through CI/CD or manually:

    ```bash theme={null}
    helm repo index . --url https://github.com/groundsgg/charts/releases/download/your-chart-name
    ```
  </Step>

  <Step title="Update GitHub Workflow">
    Update the chart matrix in all workflows so the new chart builds and tests:

    * `.github/workflows/ci.yml`: add your chart to `strategy.matrix.chart` for CI validation
    * `.github/workflows/release.yml`: add your chart for release automation
  </Step>

  <Step title="Follow Chart Standards">
    Before you open a pull request, make sure the chart follows these standards:

    * Use semantic versioning
    * Include proper labels and annotations
    * Document all values in `values.yaml`
    * Include example configurations
    * Follow Kubernetes naming conventions

    <Check>
      Verify that the chart builds and that the repository workflows include it in CI and release automation.
    </Check>
  </Step>
</Steps>

## Resources

For detailed instructions and examples, see the [charts repository README](https://github.com/groundsgg/charts/).

<Note>
  Refer to the [Helm documentation](https://helm.sh/docs/) for comprehensive chart development guidelines.
</Note>