Features

• Interactive CLI setup with npx @ts-sdk-gen/openapi-ts init
• Support for OpenAPI 2.0, 3.0, and 3.1 specifications
• Generate TypeScript interfaces, SDKs, and JSON Schemas
• Multiple HTTP client options (Fetch API, Axios)
• Framework integrations (React Query, SWR, etc.)
• Customizable code output with formatting and linting
• Watch mode for automatic regeneration during development

Quick Start

The fastest way to get started is with our interactive init command:

npx @ts-sdk-gen/openapi-ts init

This will guide you through setting up your project with:

• Package manager selection (npm, pnpm, yarn, or bun)
• TypeScript framework integration options
• Schema path configuration
• Output directory settings
• API base URL configuration

Manual Installation

If you prefer to set up manually:

# Install the required packages
pnpm add -D @ts-sdk-gen/openapi-ts
pnpm add @ts-sdk-gen/client-fetch

Configuration

Create an openapi-ts.config.ts file in your project root:

import { defineConfig } from '@ts-sdk-gen/openapi-ts';

const config = defineConfig({
  apiConfigFile: './api.config.ts',
  client: {
    name: '@ts-sdk-gen/client-fetch',
  },
  input: {
    path: './openapi-schema.json',
  },
  output: {
    format: 'prettier',
    lint: 'eslint',
    path: './src/sdk',
  },
  plugins: ['@tanstack/react-query'],
  watch: {
    enabled: true,
    interval: 1000,
    timeout: 0,
  },
});

export default config;

Documentation

For more detailed documentation, visit our GitHub repository.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

# Clone the repository
git clone https://github.com/abdulrahmanmousa/ts-sdk-gen.git
cd ts-sdk-gen

# Install dependencies
pnpm install

# Build the project
pnpm run --recursive build

License

MIT