Development Workflow

This guide covers the typical development workflow when building applications with the Tailor Platform SDK.

Local Development

Project Structure

A typical SDK project has the following structure:

my-app/
├── src/
│   ├── tailordb/        # Database schema definitions
│   ├── resolvers/       # Custom GraphQL resolvers
│   ├── executors/       # Event-driven handlers
│   └── index.ts         # Main entry point
├── tailor.config.ts     # SDK configuration
└── package.json

Development Commands

# Start development with hot reload
npm run dev

# Generate TypeScript types
npm run generate

# Run tests
npm run test

Deployment

Deploy to a Workspace

# Deploy to your workspace
npm run deploy -- --workspace-id <your-workspace-id>

Environment Management

Use environment variables for configuration:

# Set environment-specific values
TAILOR_WORKSPACE_ID=your-workspace-id npm run deploy

Testing

The SDK supports testing your application logic:

import { test, expect } from "vitest";
import hello from "./resolvers/hello";

test("hello resolver returns greeting", async () => {
  const result = await hello.body({
    input: { name: "World" },
  });
  expect(result.message).toBe("Hello, World!");
});