Skip to content

helmforgedev/site

Repository files navigation

HelmForge Banner

Open-source Helm charts, forged to last.

The ultimate open-source alternative to Bitnami. We package popular applications with sane defaults for security, built-in backups, and day-two operations. No proprietary layers. No limits.

WebsiteDocumentationHelm Charts Repository

CI Deploy License: Apache-2.0 PRs Welcome

WCAG 2.2 AA axe-core Validated Multi-browser Testing Astro 6 Tailwind CSS v4


Overview

This repository contains the source code for the HelmForge web portal and documentation engine (helmforge.dev).

HelmForge is designed to fill the void left by commercialized chart ecosystems. It provides 100% open-source, OCI-compliant, and production-hardened Kubernetes Helm Charts, directly utilizing upstream images without proprietary vendor lock-in.

This frontend is built for extreme performance, rich aesthetics, and massive SEO discoverability.

Tech Stack

Layer Technology Purpose
Framework Astro 6 Ultra-fast static site generator with zero JS by default
Styling Tailwind CSS v4 Utility-first CSS with native design tokens
Content MDX Markdown components driving the entire documentation portal
Search Pagefind Static search index with instant client-side results
E2E Testing Playwright Multi-browser testing across Chromium, Firefox, and WebKit
Accessibility axe-core Automated WCAG 2.2 AA compliance validation
Linting ESLint + Prettier Code quality and consistent formatting

Features

  • 55+ chart playground configs — Interactive playground with live YAML preview for every stable chart
  • Stack Builder — Compose multi-chart stacks visually and export install commands
  • Full documentation — MDX-powered docs with sidebar navigation, search, and copy-to-clipboard
  • Public roadmap — GitHub Milestones integration with static timeline
  • Chart request form — Pre-filled GitHub issue creation for new chart suggestions
  • Dark/Light themes — System-aware theme toggle with smooth transitions

Accessibility & Compliance

The site is built to WCAG 2.2 Level AA standards and validated on every PR:

  • axe-core scans all 9 major pages with wcag22aa rule tags
  • ARIA patterns: menu roles with keyboard navigation (ArrowDown/Up, Escape), tab panels with proper role/aria-labelledby
  • Color contrast: all text meets 4.5:1 ratio (normal) / 3:1 (large) across both themes
  • Target sizes: desktop minimum 36px, mobile touch targets minimum 44px
  • Form accessibility: autocomplete, aria-required, and visible labels on all inputs
  • Skip-to-content link for keyboard users

See DESIGN-PRINCIPLES.md for the 7 UX principles governing site development.

Quality Gates (CI)

Every pull request runs through:

Check Tool What it validates
Lint & Format ESLint + Prettier Code quality and style consistency
Build Astro + Pagefind Successful build, sitemap, page count, HTML validity
Link Check Custom script All internal links resolve to valid pages
E2E Tests Playwright 225 tests across 3 browsers (Chromium, Firefox, WebKit)
Accessibility axe-core WCAG 2.2 AA on all pages, keyboard nav, ARIA roles
Dependency Audit npm audit No high-severity vulnerabilities
Bundle Size Custom script Build output stays within budget

Local Development

Ensure you have Node.js >= 22 installed.

# Install dependencies
npm install

# Start the dev server at localhost:4321
npm run dev

# Build the production bundle
npm run build

# Preview the built production site
npm run preview

Testing

# Run full E2E suite (Chromium + Firefox + WebKit)
npx playwright test

# Run accessibility tests only
npm run test:a11y

# Run E2E tests for a single browser
npx playwright test --project=chromium

# View test report
npx playwright show-report

Install Playwright browsers if running for the first time:

npx playwright install --with-deps chromium firefox webkit

Related Repositories

Repository Description
helmforgedev/charts Helm charts source, CI/CD pipelines, and release automation

License

This project is licensed under the Apache License 2.0.

About

HelmForge documentation website — helmforge.dev

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors