Skip to content
swagger-to-tanstack-query

Output Structure

How the generator lays out one self-contained folder per controller.

The generator produces one folder per controller (OpenAPI tag), each self-contained with five files.

Folder layout

<output>/
├─ contact/                 # one folder per controller (OpenAPI tag)
│  ├─ index.ts              # barrel: re-exports the four files below
│  ├─ types.ts              # interfaces/types this controller uses
│  ├─ apis.ts               # raw axios request functions
│  ├─ queries.ts            # queryOptions object (for GET/HEAD)
│  └─ mutations.ts          # useMutation hooks (for POST/PUT/PATCH/DELETE)
├─ user/
│  └─ …
└─ group/
   └─ …

There is no root-level barrel — each controller is imported directly from its folder so imports stay explicit and grep-able.