roto-rooter

Static analysis and functional verifier tool for React Router applications.

Installation

npm install -g roto-rooter

Usage

# Check all files in current directory
rr

# Check specific file(s)
rr app/routes/employees.tsx

# Run specific checks only
rr --check links,forms

# Output as JSON
rr --format json

# Set project root (the directory containing the app/ folder)
rr --root ./my-app

# Automatically fix issues where possible
rr --fix

# Preview fixes without applying
rr --dry-run

# Fix specific file(s)
rr --fix app/routes/dashboard.tsx

# Enable Drizzle ORM persistence checking (auto-discovers schema)
rr --orm drizzle

# Drizzle checking with explicit schema path
rr --orm drizzle --drizzle-schema src/db/schema.ts

Checks

• links: Validates <Link>, redirect(), and navigate() targets exist as defined routes. Suggests closest matching route when a typo is detected. Auto-fixable when a close match exists.

• forms: Validates <Form> components submit to routes with action exports, and that form fields match what the action reads via formData.get(). Supports intent-based dispatch patterns. Auto-fixable when targeting a mistyped route.

• loader: Validates useLoaderData() is only used in routes that export a loader function.

• params: Validates useParams() accesses only params defined in the route path (e.g., :id in /users/:id).

• hydration: Detects SSR hydration mismatch risks:

  • Date/time operations without consistent timezone handling
  • Locale-dependent formatting (e.g., toLocaleString()) without explicit timeZone option
  • Random value generation during render (Math.random(), uuid(), nanoid())
  • Browser-only API access outside useEffect (window, document, localStorage)

  Some hydration issues are auto-fixable (e.g., adding { timeZone: "UTC" } to locale methods, replacing uuid() with useId()).

• interactivity: Detects disconnected interactive elements:

  • Dialog/modal forms where "Save" button only closes the dialog without persisting data
  • "Delete" confirmation buttons that only close without performing the action
  • Buttons with empty or stub onClick handlers (console.log only)
  • Validates dialogs use React Router <Form> or useFetcher.submit() for data operations

• persistence: Validates database operations against Drizzle ORM schema. Requires --orm drizzle flag. Auto-discovers schema from common locations (db/schema.ts, src/db/schema.ts, etc.) or use --drizzle-schema for custom paths.

  • Missing required columns on db.insert() calls
  • Type mismatches (e.g., string from formData.get() to integer column)
  • Enum columns receiving unvalidated external input

Programmatic API

import { analyze, applyFixes } from 'roto-rooter';

// Run analysis
const result = analyze({
  root: './my-app',
  files: [], // empty = all files
  checks: [], // empty = all checks
  format: 'text',
});

console.log(result.issues);

// Apply auto-fixes
const fixResult = applyFixes(result.issues);
console.log(`Fixed ${fixResult.fixesApplied} issues`);

Development

npm install      # Install dependencies
npm test         # Run tests
npm run build    # Build for distribution