# swaggie

> Tool for generating TypeScript client code for given Swagger API endpoints

- **URL**: https://www.freshcrate.ai/projects/swaggie
- **Author**: yhnavein
- **Category**: Developer Tools
- **Latest version**: `v2.3.0` (2026-05-28)
- **License**: MIT
- **Source**: https://github.com/yhnavein/swaggie
- **Homepage**: https://yhnavein.github.io/swaggie/
- **Language**: TypeScript
- **GitHub**: 25 stars, 9 forks
- **Registry**: github
- **Tags**: `code-generation`, `code-generators`, `codegen`, `nswag`, `openapi`, `openapi3`, `openapi30`, `openapi31`, `typescript`

## Description

Tool for generating TypeScript client code for given Swagger API endpoints

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v2.3.0` | 2026-05-28 | High | - **feat**: ability to filter operations out in an easy way from being generated.  ## How  In the json config file you can add following section: ``` "exclude": {   "tags": [     "skip"   ],   "operationIds": [       "DestroyWorld",       "Admin*"   ] } ```  And now any operation that is either: - named as `DestroyWorld` - or starts with Admin - or has tag `skip`  will not be generated in the code. |
| `v2.2.2` | 2026-05-28 | High | - **feat**: expose all SWR variables in mocks |
| `v2.1.3` | 2026-05-21 | High | - **fix**: improve logic for prefixing api types to support string literal enum values correctly - **chore**: upgrade deps |
| `v2.1.1` | 2026-04-21 | High | - **fix**: For `ky` template let's use encodeParams to serialize query strings accordingly to user's needs. Unfortunately default ky serializer is very poor |
| `v2.1.0` | 2026-04-21 | High | - **feat**: new http client template: `ky` - **feat**: ability to separate reactive hooks to a different file. That's especially important for NextJS apps, where you would like to use types or http client in the server side. (`--hooksOut <PATH>` option) - **feat**: Due to `ky` we now have a different approach for setting up http instance. For xior or axios you can customize interceptors after http instance is created. In `ky` it has to be other way around. `--clientSetup <PATH>` will generate |
| `v2.0.1` | 2026-04-08 | High | - **fix**: issues with mocks for TanStack Query template |
| `v2.0.0` | 2026-04-07 | Medium | The biggest release so far!  Full changelog and review of the new features is here: https://yhnavein.github.io/swaggie/  In a nutshell:  - **feat**: Add auto-generated mocks for client - **feat**: Separate templates into reactive and http clients and allow to use them together - **feat**: Generate mutations for reactive templates (like SWR and TSQ) - **feat**: Add `useClient` option for generating NextJS-compatible code - **feat**: Add Query parameter grouping  There are **Breaking c |
| `v1.9.0` | 2026-03-30 | Medium | - **feat**: Include in JSDocs `@format` and `@default` values from the spec - **feat**: More ignores in the file header. Most notably: ignore for istanbul coverages and biomejs - **fix**: Currently handle `{ "type": "object" }`, as according to OpenAPI 3 spec this is equal to `Record<string, unknown>` - **feat**: Use `Record<T, V>>` instead of `{ [key: T]: V }`  ## Examples  ```diff export interface User { +  /** @format int64 */   id?: number;    /**    * The role of the user. + |
| `v1.8.8` | 2026-03-28 | Medium | - **fix**: Include comment about file being auto-generated to schema-only generations |
| `v1.8.7` | 2026-03-27 | Medium | - **feat**: Add support for verbatim types (custom `x-ts-type` attribute)  Sometimes the spec cannot express the exact desired result. In those cases, we may want TypeScript to generate a very specific type from a given schema.  This feature adds deep customization through the custom `x-ts-type` attribute, which can be used directly in the spec.  A verbatim type lets you render any custom type you want. When used, it overrides and ignores all other definitions for that schema.  ## Exampl |

## Citation

- HTML: https://www.freshcrate.ai/projects/swaggie
- Markdown: https://www.freshcrate.ai/projects/swaggie.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/swaggie/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._