@getpara/paramedic

Paramedic

Para SDK diagnostic and troubleshooting CLI tool. Quickly identify common integration issues in your Para SDK project.

Quick Start

npx @getpara/paramedic

Run in any directory containing a Para SDK project to get instant diagnostics.

Features

• Auto-detection - Automatically detects framework (Next.js, Vite, etc.) and SDK version
• Comprehensive checks - Validates configuration, imports, and setup patterns
• Actionable feedback - Provides specific fixes for each issue found
• Zero configuration - Works out of the box with sensible defaults

Usage

Scan Current Directory

npx @getpara/paramedic

Scan Specific Directory

npx @getpara/paramedic ./my-para-app

Show Help

npx @getpara/paramedic --help

Diagnostic Checks

Paramedic runs the following checks on your project:

Check	Description
API Key	Verifies NEXT_PUBLIC_PARA_API_KEY or equivalent is configured and not a placeholder
CSS Import	Ensures Para SDK styles are imported in your application
ParaProvider	Validates ParaProvider component is properly set up
QueryClientProvider	Checks React Query provider wrapping (required for Para SDK)
Version Consistency	Detects mismatched versions across Para packages
Chain Dependencies	Validates network-specific dependencies (EVM, Solana, Cosmos)
"use client" Directive	Ensures proper client directive for Next.js App Router
Environment Variable Prefix	Checks correct env var prefix for your framework
Deprecated Packages	Warns about deprecated Para packages that should be upgraded

Example Output

┌  Paramedic - Para SDK Diagnostics
│
◇  Analysis complete
│
│  Framework: Next.js (App Router)
│  SDK: @getpara/react-sdk@2.5.0
│
◇  Checks complete
│
│  ✓ API key configured
│  ✓ CSS styles imported
│  ✓ ParaProvider found
│  ✗ QueryClientProvider missing
│    └─ Wrap your app with QueryClientProvider from @tanstack/react-query
│  ⚠ Version mismatch
│    └─ @getpara/react-sdk@2.5.0 and @getpara/evm-wallet-connectors@2.4.0
│
└  2 issues found (1 error, 1 warning)

Supported Frameworks

• Next.js (App Router & Pages Router)
• Vite (React)
• Create React App
• Remix
• Other React-based frameworks

Supported SDKs

• @getpara/react-sdk
• @getpara/react-sdk-lite

Requirements

• Node.js 18.0.0 or higher

How It Works

• Detection Phase - Scans package.json to identify framework and Para SDK version
• Context Building - Indexes project files while respecting .gitignore
• Check Execution - Runs all applicable diagnostic checks
• Reporting - Displays results with severity levels and fix suggestions

Exit Codes

Code	Description
0	All checks passed
1	One or more checks failed (errors found)

Extending Paramedic

Paramedic uses a modular check system. Each check is a standalone module in src/checks/ that implements the Check interface:

interface Check {
  id: string;
  name: string;
  category: CheckCategory;
  run: (context: DiagnosticContext) => Promise<CheckResult>;
}

Documentation

• Para Documentation
• Para React SDK
• Troubleshooting Guide

License

MIT