code-forge-io / code-forge-io/react-router-devtools

Port conflict (EADDRINUSE) when running typegen and dev server simultaneously

Open
#243 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
972
Forks
55
PR merge metrics
No merged PRs in 30d

Description

# Port conflict (EADDRINUSE) when running typegen and dev server simultaneously

## Context

I'm using React Router DevTools with type generation tools (react-router typegen, safe-routes typegen).

## Reproduction

When running type generation tools and the development server simultaneously, both try to bind to port 42069 (used by TanStack DevTools), resulting in an `EADDRINUSE` error.

### Steps to Reproduce

```bash
# Terminal 1: Start dev server
pnpm dev

# Terminal 2: Run type generation
pnpm typegen
# or
react-router typegen
```

### Error Message

```
Error: listen EADDRINUSE: address already in use :::42069
```

## System Info

- **OS**: macOS 14.6.0 (Darwin 24.6.0)
- **Node**: v20.x
- **Package Manager**: pnpm 10.18.0
- **react-router-devtools**: 6.0.1
- **@tanstack/devtools**: 5.x
- **Vite**: 6.3.6

## Used Package Manager

pnpm

## Expected Behavior

Type generation tools and the dev server should be able to run simultaneously without port conflicts. The DevTools should automatically disable itself when running in a type generation context.

## Actual Behavior

The second process fails to start due to port 42069 already being in use by TanStack DevTools, which is initialized by both the dev server and type generation process.

## Possible Solution

Detect type generation context (via environment variables like `TYPEGEN_RUNNING=1` or command-line arguments) and disable DevTools initialization when running type generation, preventing unnecessary port binding.

Implementation approach:
- Check for typegen indicators: `TYPEGEN_RUNNING=1`, `SAFE_ROUTES_TYPEGEN=1`, `process.argv` includes "typegen"
- Return empty plugin array when in typegen context
- Maintain backward compatibility for normal dev mode

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.