skills.rest
NangoHQ
NangoHQOFFICIAL
Explore all skills by this author →
Website𝕏@NangoHQGitHub

nango-dry-run

Test Nango sync jobs locally with parameterized dryrun commands.

1|1|Updated Oct 30, 2025
Search Tags:#automation#testing#debugging#integration#cli#sync#nango#dry run
One-click install
npx skills add https://github.com/NangoHQ/ai-ide-prompts --skill nango-dry-run
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nango-dry-run
Source: https://github.com/NangoHQ/ai-ide-prompts/tree/main/.claude/skills/nango-dry-run
Command: npx skills add https://github.com/NangoHQ/ai-ide-prompts --skill nango-dry-run

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers need a reliable way to test Nango sync logic, data mapping, and API integrations locally without affecting production data or incurring unnecessary costs. This Skill provides the essential guidance to perform safe, efficient dry runs, ensuring your syncs work as expected before deployment.

Core Features & Use Cases

  • Local Sync Testing: Master the nango dryrun command to verify sync logic and data transformations in a controlled environment.
  • Production Data Protection: Test changes without the risk of corrupting live data, ensuring peace of mind during development.
  • Accelerated Debugging: Implement temporary short-circuits for large datasets to speed up testing and quickly pinpoint issues.
  • Comprehensive Verification: Learn to log and verify mapped data, manager resolution, and relationship logic, catching subtle bugs before they reach users.
  • Use Case: Before deploying a new Nango integration that syncs employee data, use this skill to run a dry run, verify that all employee fields are correctly mapped, and ensure manager relationships are resolved without impacting your live HR system.

Quick Start

Use the nango-dry-run skill to help me run a dry run for my 'employees' sync, using connection ID 'abc-123' and integration 'workday' in the 'prod' environment.

Frequently Asked Questions about nango-dry-run

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test Nango sync logic without affecting production data?▼

Use the `nango dryrun` command to test sync logic locally in a controlled environment. Dry runs execute your sync without persisting data, letting you verify data mapping, API integration, and manager resolution safely before deployment.

What can I verify with a Nango dry run?▼

Dry runs validate sync logic, data mapping accuracy, API integration behavior, manager relationship resolution, and incremental synchronization logic. Detailed logging shows exactly how your sync transforms and maps data.

Can I debug data mapping issues in my Nango sync locally?▼

Yes. Run a dry run with your sync configuration to inspect mapped fields and relationships without costs or production impact. Logging reveals where transformations fail or produce unexpected results.

How do I speed up testing with large Nango datasets?▼

Implement temporary short-circuits in your sync during dry runs to test against smaller data subsets. This accelerates debugging and lets you pinpoint issues quickly before testing full datasets.

What parameters do I need to run a Nango dry run?▼

Provide your sync name, connection ID, integration identifier, and target environment. The `nango dryrun` command accepts these parameterized inputs to scope your test to specific configurations.

Related Skills

Explore More Software Engineering Skills→
ChwistopheChwistophe

rails-37-style-infrastructure-and-testing-configuration

Configure Rails environments, DRY YAML, and credential-free testing with Kamal.

Community
Intermediate
AztecProtocolAztecProtocol
449

unit-test-implementation

Implement unit tests in a TypeScript monorepo with Jest.

Official
Intermediate
merge-apimerge-api

post-connection-build-settings-page

Create a post-connection settings page for Merge integrations with health monitoring and sync configuration.

Official
Advanced
mreferremreferre

creating-api-gateway-stage

Create API Gateway stages with logging, tracing, throttling, and WAF.

Community
Advanced