tinybird-typescript-sdk-guidelines

Tinybird TypeScript SDK Guidelines

Guidance for using the @tinybirdco/sdk package to define Tinybird resources in TypeScript with complete type inference.

When to Apply

• Installing or configuring @tinybirdco/sdk
• Defining datasources or pipes in TypeScript
• Creating typed Tinybird clients
• Using type-safe ingestion or queries
• Running tinybird dev/build/deploy commands for TypeScript projects
• Migrating from legacy .datasource/.pipe files to TypeScript
• Defining connections (Kafka, S3, GCS)
• Creating materialized views, copy pipes, or sink pipes

Rule Files

• rules/getting-started.md
• rules/configuration.md
• rules/defining-datasources.md
• rules/defining-endpoints.md
• rules/typed-client.md
• rules/low-level-api.md
• rules/cli-commands.md
• rules/connections.md
• rules/materialized-views.md
• rules/copy-sink-pipes.md
• rules/tokens.md

Quick Reference

• Install: npm install @tinybirdco/sdk
• Initialize: npx tinybird init
• Dev mode: tinybird dev (uses configured devMode, typically branch)
• Build: tinybird build (builds against configured dev target)
• Deploy: tinybird deploy (deploys to main/production)
• Preview in CI: tinybird preview
• Server-side only; never expose tokens in browsers