Skip to main content
Prerequisites:
  • Helm installed locally
  • Write access to the charts repository
  • Familiarity with the existing chart layout and release workflows
Use these steps to add a new Helm chart to the repository.
1

Create Chart Directory

Create a new directory that matches the chart name:
mkdir your-chart-name
cd your-chart-name
2

Initialize Helm Chart

Use Helm to create a new chart structure:
helm create your-chart-name
Or manually create the required files:
  • Chart.yaml - Chart metadata
  • values.yaml - Default configuration values
  • templates/ - Kubernetes manifest templates
Verify that the chart directory contains the files your repository workflows expect before you continue.
3

Create Chart README

Create a README.md in your chart directory with:
  • Chart description
  • Prerequisites
  • Installation instructions
  • Configuration options
  • Examples
4

Update Repository Index

Add your chart to the repository index. This is typically done through CI/CD or manually:
helm repo index . --url https://github.com/groundsgg/charts/releases/download/your-chart-name
5

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
6

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
Verify that the chart builds and that the repository workflows include it in CI and release automation.

​
Resources

For detailed instructions and examples, see the charts repository README.
Refer to the Helm documentation for comprehensive chart development guidelines.