migrating-to-zero-yaml

Name: migrating-to-zero-yaml
Availability: InStock
Author: Nango

Migrate legacy nango.yaml projects to Zero YAML TypeScript scaffolding.

45|32|Updated Sep 23, 2024

Search Tags:#typescript #scaffolding #migration #refactor #nango #model-generation #zero-yaml

Ready to run

npx skills add https://github.com/NangoHQ/integration-templates --skill migrating-to-zero-yaml

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: migrating-to-zero-yaml
Source: https://github.com/NangoHQ/integration-templates/tree/main/.agents/skills/migrating-to-zero-yaml
Command: npx skills add https://github.com/NangoHQ/integration-templates --skill migrating-to-zero-yaml

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams migrate from legacy nango.yaml configurations to a robust Zero YAML TypeScript setup by generating essential scaffolding (models.ts, index.ts, package.json, tsconfig.json) and wrapping existing scripts in createSync(), createAction(), or createOnEvent() without changing business logic.

Core Features & Use Cases

Automates the mechanical migration of YAML-defined models, syncs, actions, and lifecycle handlers into Zero YAML equivalents.
Produces a ready-to-run project skeleton, including type-safe models and a central index for all migrated scripts.
Use when you still rely on nango.yaml and need a controlled, manual migration path that preserves behavior.

Quick Start

Manually invoke the migration workflow on your Nango project root and review generated files before running any builds.

Frequently Asked Questions about migrating-to-zero-yaml

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

FAQPage Schema

How do I migrate a Nango project from nango.yaml to TypeScript?▼

To migrate a Nango project from nango.yaml to TypeScript, you generate a Zero YAML project skeleton including models.ts and index.ts, then wrap existing scripts in createSync() or createAction() without altering business logic.

What is Zero YAML migration for Nango integrations?▼

Zero YAML migration replaces legacy nango.yaml configurations by defining Nango syncs, actions, and models directly in TypeScript files like models.ts and index.ts, ensuring type safety without changing existing behavior.

Does Nango Zero YAML migration preserve existing sync types and trackDeletes?▼

Yes, Nango Zero YAML migration preserves existing behaviors including sync types and trackDeletes, ensuring the migrated project compiles and behaves exactly as it did before the mechanical refactor.

How do I scaffold Nango scripts when moving away from nango.yaml?▼

When moving away from nango.yaml, you scaffold Nango scripts by generating a central index.ts and wrapping your existing logic with createSync(), createAction(), or createOnEvent() functions to register them.

What are the limitations of a mechanical Nango YAML migration?▼

A mechanical Nango YAML migration requires manual inspection of the original YAML and code updates to ensure the project compiles, meaning it focuses strictly on structural translation rather than optimizing or changing business logic.