Skip to content

Commit 295321a

Browse files
authored
feat: add new tools (swaggie and oapi-bundler) (#710)
1 parent ff1bb32 commit 295321a

File tree

2 files changed

+46
-0
lines changed

2 files changed

+46
-0
lines changed

src/content/tools/oapi-bundler.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
name: oapi-bundler
3+
description: oapi-bundler merges modular OpenAPI files (YAML/JSON) into one output OpenAPI document. It is designed for real-world spec trees where files are split by domain, operation, or component and connected with $ref
4+
categories:
5+
- converters
6+
link: https://github.com/yhnavein/oapi-bundler
7+
languages:
8+
nodejs: true
9+
cli: true
10+
typescript: true
11+
repo: https://github.com/yhnavein/oapi-bundler
12+
oasVersions:
13+
v2: false
14+
v3: true
15+
v3_1: true
16+
v3_2: true
17+
---

src/content/tools/swaggie.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
name: Swaggie
3+
description: Swaggie is an OpenAPI 3.x code generator that produces fully typed TypeScript API clients from JSON or YAML specs. It supports multiple client templates (fetch, axios, xior, SWR, TanStack Query, Angular), and robust schema handling for real-world APIs.
4+
categories:
5+
- code-generators
6+
link: https://yhnavein.github.io/swaggie/
7+
languages:
8+
nodejs: true
9+
cli: true
10+
typescript: true
11+
repo: https://github.com/yhnavein/swaggie
12+
oasVersions:
13+
v2: false
14+
v3: true
15+
v3_1: true
16+
v3_2: true
17+
badges:
18+
- oas-v32-early
19+
---
20+
21+
## Features
22+
23+
- **Works Out of the Box** - Opinionated defaults are chosen for real-world APIs, so most teams get useful, production-ready output with minimal configuration.
24+
- **OpenAPI 3.x Coverage** - Works with OpenAPI 3.0, 3.1, and 3.2 specs (JSON or YAML), so it fits modern API stacks.
25+
- **Fully Typed TypeScript Output** - Generates strongly typed clients and schemas to catch integration errors at compile time.
26+
- **Real-World Schema Support** - Handles allOf, oneOf, anyOf, $ref, nullable fields, enums, and additionalProperties reliably.
27+
- **Flexible Request/Query Handling** - Supports common payload/content types and configurable query param serialization (repeat, brackets, indices, dot notation).
28+
- **Lean, Production-Friendly Output** - Emits a single tree-shakable TypeScript file with JSDoc and no runtime dependency overhead.
29+
- **98% Test Coverage** - Extensively tested to ensure reliable code generation across diverse OpenAPI specs.

0 commit comments

Comments
 (0)