How nangohq/nango works
Nango is a platform for building and operating product integrations: teams configure providers, authorize customer connections, then make authenticated API calls or deploy integration functions that sync data, process webhooks, and perform actions. The graph follows those user-facing stages into execution, persistence, and observability, while retaining the CLI and embedded connection UI as distinct entry points. README statements establish the high-level product workflow; source-index references and excerpts support several internal links. Unsampled implementations are represented only where the tree supports a path.
Main entry points: routes.public.ts Public API routes · app.ts Jobs service · oauth.controller.ts OAuth controller · server.ts Function runner
Components 20
Integration setup
- CLI
packages/cli/lib/cli.ts - Integration config
packages/nango-yaml/lib/parser.ts
Connection and API access
- Connect UI
packages/connect-ui/src/App.tsx - Public API routes
packages/server/lib/routes.public.ts - OAuth controller
packages/server/lib/controllers/oauth.controller.ts - Connection service
packages/shared/lib/services/connection.service.ts - Node client
packages/node-client/lib/index.ts - Outbound policy
packages/shared/lib/services/proxy/outbound-policy.ts
Function execution
- Task orchestrator
packages/orchestrator/lib/app.ts - Jobs service
packages/jobs/lib/app.ts - Runtime selection
packages/jobs/lib/runtime/runtimes.ts - Function runner
packages/runner/lib/server.ts - Sync manager
packages/shared/lib/services/sync/manager.service.ts
Data and state
- Persistence API
packages/persist/lib/server.ts - Record storage
packages/records/lib/store.ts
Operations
- Logs storage
packages/logs/lib/storage/logsStorageClient.ts - Usage and audit
packages/metering/lib/app.ts
Other components
- Developer
- External APIs
- Customer application
Connections 22
- Developer → CLI: configures
README.md - CLI → Integration config: parses config
- Developer → Connect UI: embeds auth
README.md - Connect UI → Public API routes: starts auth
- Customer application → Public API routes: requests access
README.md - Public API routes → OAuth controller: routes OAuth
packages/server/lib/routes.public.ts - OAuth controller → Connection service: updates connection
- OAuth controller → Outbound policy: checks URL
- Customer application → Node client: calls API
README.md - Node client → Public API routes: sends requests
- Public API routes → External APIs: proxies requests
README.md - Developer → Task orchestrator: schedules functions
README.md - Task orchestrator → Jobs service: dispatches tasks
- Jobs service → Runtime selection: selects runtime
packages/jobs/lib/app.ts - Runtime selection → Function runner: runs functions
- Function runner → Persistence API: stores records
packages/runner/lib/server.ts - Persistence API → Record storage: reads and writes
- Developer → Sync manager: deploys syncs
README.md - Sync manager → Task orchestrator: schedules syncs
- Function runner → External APIs: calls APIs
README.md - Jobs service → Logs storage: emits telemetry
- Jobs service → Usage and audit: publishes usage