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

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-sdk skill with the open skills CLI:

npx skills add https://github.com/tailor-platform/sdk/tree/main/packages/sdk/skills --skill tailor-sdk

Use the SDK-provided shorthand command (internally uses skills add):

npx tailor-sdk-skills

# Example: install to Codex in non-interactive mode
npx tailor-sdk-skills -a codex -y

npx tailor-sdk-skills requires an environment where the @tailor-platform/sdk package binary is available.

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

• 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 or later
• A Tailor Platform account (request access)