Tailor Platform SDK

@tailor-platform/sdk is a TypeScript SDK for building applications on the Tailor Platform.

Overview

Tailor Platform is a headless business platform that provides backend services for building enterprise applications. The SDK enables you to:

• Define type-safe database schemas with TailorDB
• Create custom GraphQL resolvers with business logic
• Set up event-driven executors for automation
• Orchestrate complex workflows with multiple jobs
• Configure authentication and authorization

All configurations are written in TypeScript, providing full type safety.

Important Notes

Some SDK concepts differ from the native Tailor Platform. Be aware of these differences when referring to the official Tailor Platform documentation.

Resolver

The SDK's Resolver corresponds to Tailor Platform's Pipeline Resolver. The key difference is that Pipeline steps are replaced with a single body function. See Resolver for details.

Installation

npm install @tailor-platform/sdk
# OR
yarn add @tailor-platform/sdk
# OR
pnpm add @tailor-platform/sdk
# OR
bun add @tailor-platform/sdk

Quick Start

Create a new project using the CLI:

npm create @tailor-platform/sdk -- --template hello-world my-app
cd my-app
npm run deploy -- --workspace-id <your-workspace-id>

See Available Templates for more options.

For more details, see the Quickstart Guide.

Agent Skill

Install the tailor skill from the locally installed SDK package:

npx @tailor-platform/sdk skills add

# Or refresh all skills owned by this CLI
npx @tailor-platform/sdk skills sync

This sources the skill from node_modules/@tailor-platform/sdk/agent-skills so the skill version always matches the installed SDK version. Files are copied into the current project under .agents/skills and .claude/skills, so rerun skills sync after upgrading the SDK.

Learn More

Configuration

• Configuration - Application and service configuration

Services

| Service | Description | | -------------------------------------------------- | -------------------------------------------- | | TailorDB | Type-safe database schema definition | | Resolver | Custom GraphQL resolvers with business logic | | Executor | Event-driven handlers for automation | | Workflow | Job orchestration for complex operations | | Auth | Authentication and authorization | | IdP | Built-in identity provider | | Static Website | Static file hosting | | Secret Manager | Secure credential storage |

Guides

• Multi-Environment Configuration - Deploying one config to multiple workspaces
• Runtime API - Typed wrappers for tailor.iconv, tailor.secretmanager, tailor.idp, tailor.workflow, tailor.context, tailor.authconnection, and tailordb.file
• Testing Guide - Unit and E2E testing patterns
• CLI Reference - Command-line interface documentation

Templates

See Create Tailor Platform SDK for available project templates.

Requirements

• Node.js 22.18.0 or later (or Bun)
• A Tailor Platform account (request access)