port-registry

What problem does it solve?

This Skill prevents port conflicts between services in development and production environments by centralizing port allocation. It leads to more stable and predictable infrastructure, eliminating hard-to-debug "address in use" errors.

Core Features & Use Cases

• Centralized Port Allocation: Defines a single source of truth for all service ports in lib/ports.nix, ensuring consistency across your entire infrastructure.
• NixOS & process-compose Integration: Seamlessly integrates with NixOS modules and process-compose for consistent port usage, from system services to local development stacks.
• Compile-Time Conflict Detection: Enables early detection of potential port conflicts during compilation, preventing runtime failures and saving debugging time.
• Use Case: A developer is setting up a new microservice that needs a database and an API server. They can use this skill to add new port entries to lib/ports.nix and then reference these ports in their process-compose.yaml and NixOS modules, ensuring no conflicts arise.

Quick Start

Add a new port entry for a 'payment-service' API to 'lib/ports.nix' within the 'development' category, assigning it an available port in the 3000-3999 range.