Development Setup

Step-by-step guide for local portal development and cluster inner-loop workflows.

1. Standalone Execution (pnpm)

# Clone repository and install dependencies
git clone https://github.com/dasomel/narwhal-portal.git
cd narwhal-portal
pnpm install
 
# Setup local environment variables
cp .env.example .env.local
 
# Start development server on port 3000
pnpm dev

2. Skaffold Live Inner-Loop Development

Develop directly against your local Kubernetes cluster with automated synchronization:

# Start Skaffold dev mode with automatic port forwarding
skaffold dev --port-forward

• File modifications sync instantly into running development containers.
• Dependency changes automatically trigger incremental multi-stage image rebuilds.