ng-openapiAngular OpenAPI Client Generator

Type-safe Angular services, models, and validation schemas — generated straight from your OpenAPI specification.

Quick Start

What is ng-openapi?

View on GitHub

🚀

Modern Angular

Generated code uses inject(), provider functions, and optionally the httpResource API — no legacy module boilerplate.

Angular integration

🌐

Multi-Client Architecture

Generate several API clients into one app, each with its own base path and its own HTTP interceptors.

Multiple clients

🛡️

Runtime Validation

Validate responses at runtime through the parse hook — with generated Zod schemas or any validation library.

Schema validation

🎯

Smart Enum Handling

Preserve your backend enum names instead of unreadable generated ones — as TypeScript enums or literal unions.

Enum style

📅

Automatic Date Handling

date-time strings become real Date objects via a generated interceptor, with a customizable detection pattern.

Date handling

🔌

Pluggable

httpResource and Zod ship as official plugins; write your own against a small documented contract.

Plugin authoring

Introduction

ng-openapi is a modern Angular-first OpenAPI client generator that creates type-safe services and interfaces from your OpenAPI specifications. Unlike generic TypeScript generators, ng-openapi is built specifically for Angular developers who want clean, maintainable code that leverages Angular's latest features.

Quick Example

bash

# Install ng-openapi
npm install ng-openapi --save-dev

# Generate from OpenAPI spec
ng-openapi -i swagger.json -o ./src/api

typescript

// Use in your Angular app
import { provideDefaultClient } from './api/providers';

export const appConfig: ApplicationConfig = {
  providers: [
    provideDefaultClient({ basePath: 'https://api.example.com' })
  ]
};

What's Included

TypeScript Interfaces - Accurate type definitions from your OpenAPI schemas
Angular Services - Injectable services with proper dependency injection
HTTP Interceptors - Automatic date transformation and custom headers
Provider Functions - Easy setup with provideDefaultClient()
File Utilities - Download helpers and file handling
CLI Tool - Powerful command-line interface with config file support

See Generated Output for a tour of every generated file.

Support the Project

ng-openapi’s mission is to remain the #1 Angular client generation library. If you’d like to support this journey, feel free to sponsor me with a coffee — after all, we all know a developer’s fuel is coffee 😄

Sponsor on GitHub