kind-local-dev

Orchestrates the Navigator local Kubernetes development stack on KIND.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/neon-law-foundation/navigator --skill kind-local-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kind-local-dev
Source: https://github.com/neon-law-foundation/navigator/tree/main/.claude/skills/kind-local-dev
Command: npx skills add https://github.com/neon-law-foundation/navigator --skill kind-local-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you work productively with Navigator's KIND-based local development loop when you need to run the full stack, iterate on the web app, or diagnose cluster issues without guessing which component belongs on the host versus inside Kubernetes.

Core Features & Use Cases

  • Local cluster lifecycle guidance for Navigator's dev server, deploy flow, and teardown.
  • Host-run-web iteration pattern with in-cluster Postgres, Keycloak, fake GCS, Restate, OPA, and workflows-service.
  • Operational troubleshooting for ingress, port mappings, image loading, pod logs, rollouts, and common KIND failures.
  • Use it when onboarding a fresh machine, validating end-to-end behavior, taking browser screenshots, or reproducing deployment problems.

Quick Start

Use the kind-local-dev skill to bring up the Navigator KIND environment, connect the host web app to in-cluster dependencies, and troubleshoot the stack safely.

Frequently Asked Questions about kind-local-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a local Kubernetes development environment with KIND?

Setting up local Kubernetes development with KIND involves orchestrating cluster lifecycle, loading Docker images, applying ingress manifests, and bridging environment variables through a .devx/env file to connect host web apps to in-cluster dependencies.

Can I run a web app on my host machine while connecting it to in-cluster Postgres and Keycloak?

Yes, you can run the web app on your host machine while connecting it to in-cluster Postgres, Keycloak, fake GCS, Restate, and OPA using a host-run-web iteration pattern with port-forwarding.

How do I troubleshoot Kubernetes KIND failures like broken ingress or port mappings?

Troubleshooting KIND failures involves running guarded kubectl diagnostics to inspect pod logs, check deployment rollouts, verify port mappings, and debug ingress routing issues within the local cluster.

How do I run end-to-end smoke tests and capture browser screenshots in a local Kubernetes stack?

Running end-to-end smoke tests in a local Kubernetes stack requires bringing up the KIND cluster, deploying services, validating cluster behavior, and capturing browser screenshots against locally forwarded web endpoints.

Do I need a specific CLI tool to manage the KIND deployment workflow?

You need the Navigator CLI to manage the KIND deployment workflow, which orchestrates cluster lifecycle, handles Docker image loading, applies service manifests, and configures environment variable bridging.