Merge branch 'main' into feature/add-appearance-configuration-per-cluster-rebased

Author: alexmathieu22

.github/workflows/helm-chart-release.yml

@@ -80,10 +80,9 @@ jobs:
 
       - name: Push Charts to GHCR
         run: |
-          for pkg in .cr-release-packages/*; do
+          for pkg in .cr-release-packages/*.tgz; do
             if [ -z "${pkg:-}" ]; then
               break
             fi
-
             helm push "${pkg}" oci://ghcr.io/${{ github.repository }}/charts
           done

CONTRIBUTING.md

@@ -17,3 +17,74 @@ Since Headlamp is part of the Kubernetes Community, please read also:
 - [Contributor License Agreement](https://git.k8s.io/community/CLA.md) Kubernetes projects require that you sign a Contributor License Agreement (CLA) before we can accept your pull requests
 - [Kubernetes Contributor Guide](https://git.k8s.io/community/contributors/guide) - Main contributor documentation, or you can just jump directly to the [contributing section](https://git.k8s.io/community/contributors/guide#contributing)
 - [Contributor Cheat Sheet](https://git.k8s.io/community/contributors/guide/contributor-cheatsheet/README.md) - Common resources for existing developers
+
+## Local Development Setup
+
+Ready to run Headlamp locally? Here's the full setup from scratch.
+
+### Prerequisites
+
+Make sure you have Node.js (>= 20.11.1 with npm >= 10.0.0) and Go installed before starting; see the development dependencies for the full list.
+
+### Build and Run
+
+1. **Install root dependencies**
+
+   ```bash
+   npm install
+   ```
+
+2. **Build the backend** (requires Go)
+
+   ```bash
+   npm run backend:build
+   ```
+
+3. **Install frontend dependencies**
+
+   ```bash
+   cd frontend
+   npm install
+   cd ..
+   ```
+
+4. **Start the application**
+
+   ```bash
+   npm start
+   ```
+
+That's it—you should now have Headlamp running locally.
+
+### Apple Silicon (ARM64)
+
+If you're developing on an M1/M2/M3 Mac and want to use Minikube, you'll need a driver that supports ARM64. Two good options:
+
+- **docker** – uses the Docker runtime
+- **vfkit** – a lightweight hypervisor for macOS
+
+Example commands:
+
+```bash
+minikube start --driver=docker
+```
+
+or
+
+```bash
+minikube start --driver=vfkit
+```
+
+> **Note:** VirtualBox does not support ARM64. Avoid `--driver=virtualbox` on Apple Silicon.
+
+### macOS Gatekeeper / Security Warning
+
+When you first launch the Headlamp app on macOS, you might see a warning that the app is "damaged" or can't be opened. This is due to Gatekeeper's quarantine flag.
+
+Run the following command using the actual path to your .app file:
+
+```bash
+xattr -cr /path/to/Headlamp.app
+```
+
+Then try opening the app again.

README.md

@@ -69,6 +69,14 @@ permissions, you may not be able to view your cluster resources correctly.
 
 See the documentation on [how to easily get a Service Account token](https://headlamp.dev/docs/latest/installation#create-a-service-account-token) for your cluster.
 
+## Quick Start for Contributors
+
+Want to hack on Headlamp? We'd love your help!
+
+Check out the [Contributing Guidelines](./CONTRIBUTING.md) for detailed instructions on setting up your local development environment, building the project, and platform-specific tips (including Apple Silicon and macOS).
+
+For more in-depth development docs, see the [Development Guide](https://headlamp.dev/docs/latest/development/).
+
 ## Tested platforms
 
 We maintain a list of the [Kubernetes platforms](./docs/platforms.md) we have

app/electron/main.ts

@@ -1327,6 +1327,11 @@ function adjustZoom(delta: number) {
 function startElectron() {
   console.info('App starting...');
 
+  // Increase max listeners to prevent false positive warnings
+  // The app legitimately needs multiple IPC listeners (currently 11)
+  // Default is 10, setting to 20 provides headroom for future additions
+  ipcMain.setMaxListeners(20);
+
   let appVersion: string;
   if (isDev && process.env.HEADLAMP_APP_VERSION) {
     appVersion = process.env.HEADLAMP_APP_VERSION;