mcpField
T
tinybird-typescript-sdk-guidelines

tinybird-typescript-sdk-guidelines

github.com/tinybirdcoData & databases221.0k installsUpdated 13w ago
Repository

About tinybird-typescript-sdk-guidelines

Guidance for developers using `@tinybirdco/sdk` to define Tinybird resources in TypeScript with inferred types. It covers setup, typed clients, data operations, and CLI workflows, including migration from legacy resource files.

Key features

  1. 01TypeScript datasource and pipe definitions
  2. 02Typed Tinybird clients
  3. 03Type-safe ingestion and queries
  4. 04Connection and view configuration
  5. 05Development, build, and deployment commands

Use cases

  1. 01Setting up a TypeScript Tinybird project
  2. 02Creating typed datasources and endpoints
  3. 03Migrating legacy resource files
  4. 04Deploying and previewing project changes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tinybirdco/tinybird-agent-skills --skill tinybird-typescript-sdk-guidelines

After installing, type/tinybird-typescript-sdk-guidelinesin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

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

Details

From the project README

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

Comments

Markdown supported