Top 23 TypeScript Swagger Projects
-
Redoc is an open-source tool for generating documentation from OpenAPI (fka Swagger) definitions. There is a paid service with more features called Redocly, but for this project we are utilizing the open source redoc-cli tool.
-
loopback-next
LoopBack makes it easy to build modern API applications that require complex integrations.
Loopback 4: A framework for building APIs and Microservices GitHub Popularity: 3.9K Stars
-
Appwrite
Appwrite - The Open Source Firebase alternative introduces iOS support . Appwrite is an open source backend server that helps you build native iOS applications much faster with realtime APIs for authentication, databases, files storage, cloud functions and much more!
-
mockoon
Mockoon is the easiest and quickest way to run mock APIs locally. No remote deployment, no account required, open source.
Project mention: What servers / programs can I use to test REST or SOAP programming against? | reddit.com/r/linux | 2022-02-17I use Mockoon for this sort of thing locally, but it also looks like it supports running on a remote server/headless environment.
-
autorest
OpenAPI (f.k.a Swagger) Specification code generator. Supports C#, PowerShell, Go, Java, Node.js, TypeScript, Python
Project mention: i learned the basics of how to create and use the MS Graph API. here's my notes | reddit.com/r/PowerShell | 2022-04-07It is definitely created with AutoRest. That's both its strength and its greatest weakness. :(
-
prism
Turn any OpenAPI2/3 and Postman Collection file into an API server with mocking, transformations and validations. (by stoplightio)
Having the API documentation in a standard format also makes it possible to for you to spawn mock servers directly from the specification using tools such as Stoplight's prism.
-
-
Ts.ED
:triangular_ruler: Ts.ED is a Node.js and TypeScript framework on top of Express to write your application with TypeScript (or ES6). It provides a lot of decorators and guideline to make your code more readable and less error-prone.
Project mention: Writing a new simple API in Typescript - what are some things I can do to make it faster to write? Libraries, tools, boilerplate code, etc. | reddit.com/r/node | 2022-04-13check tsed.io and your all problems will be resolved
-
Scout APM
Less time debugging, more time building. Scout APM allows you to find and fix performance issues with no hassle. Now with error monitoring and external services monitoring, Scout is a developer's best friend when it comes to application development.
-
Project mention: Azure Bicep - How do I know what property values are valid? | reddit.com/r/AZURE | 2021-07-23
I feel your pain, a good resource for me has been the REST API specs - https://github.com/Azure/azure-rest-api-specs/tree/master/specification
-
spectral
A flexible JSON/YAML linter for creating automated style guides, with baked in support for OpenAPI v2 & v3.
In this post, I show how to use Spectral to check if only lowercase alphanumeric characters are used in the keys of OpenAPI paths.
-
dis True, config can be a pain at first. Lot's of good templates out there though utilizing rollup or babel. just search npm or github for your usecase. express/mongo whatever. this one looks decent -> Express TS template
-
Erik Wittern, Alan Cha, and Jim A. Laredo from IBM wrote a very interesting article about the difficulties of converting REST-like API to a GraphQL schema. Those concepts are implemented in openapi-to-graphql library, which is being used by GraphQL Mesh and we are contributing to. We apply similar approach to other API specifications.
-
NestJS provides a dedicated module which allows generating OpenAPI (Swagger) - Github - nestjs/swagger
-
Project mention: [AskJS] What's a good option for building a backend with minimal glue code for the frontend? | reddit.com/r/javascript | 2022-04-12
If your backend is able to generate Swagger/OpenAPI JSON, you can use https://github.com/acacode/swagger-typescript-api to generate both TypeScript interfaces and an API client from the Swagger JSON.
-
Optic
-
openapi-typescript-codegen
NodeJS library that generates Typescript or Javascript clients based on the OpenAPI specification
Project mention: Don't make me think, or why I switched to Rails from JavaScript SPAs | news.ycombinator.com | 2022-02-04I'm currently working on two separate projects, the first is a Django project with DRF and I codegen with drf-spectacular [1] and openapi-typescript-codegen [2]. The other project also uses Django, with the API through Hasura and codegen with graphql-codegen [3]. In both of these cases I've been able to largely avoid duplicating my models clientside, or at least it isn't manual.
1: https://github.com/ferdikoomen/openapi-typescript-codegen
-
orval
orval is able to generate client with appropriate type-signatures (TypeScript) from any valid OpenAPI v3 or Swagger v2 specification, either in yaml or json formats. 🍺
If your asp.net project has a good documentation on its endpoint, you can actually generate models, services, tests, ... With something like Orval
-
Portman documentation
-
Project mention: Show /r/rust: a Rust implementation of the Realworld demo app spec using Axum and SQLx, written by a co-author of SQLx. | reddit.com/r/rust | 2022-01-31
That's obviously not a great situation, so I've started experimenting with airtasker/spot which uses a Typescript-based DSL to generate OpenAPI specs. It's a decent stopgap, although I would love it if we could adapt something like this to Rust using doc-comments and attributes or something so the documentation can live in the code itself.
-
In order to use Redocusaurus, I needed a single spec file. Both Swagger cli and OpenApi cli offered an option to merge separate specs into one. The problem was that one of them required a "root spec file" to drive the merging and the other required extra information to resolve conflicts. My specs had neither.
-
Project mention: How to create custom response message using nodejs (express, typescript)? | reddit.com/r/node | 2022-04-27
I‘ve done something similar, due to the way openapi-backend handles validation.
-
Project mention: Testing in production: using JSON Schema for 3rd party API response validation | news.ycombinator.com | 2021-08-08
Json schema validation is cpu expensive in nodejs, so you do not want it in production for every request. We made a proxy [1] that only allows requests that are conform to the swagger json which is easy to hook between frontend and backend in dev-mode
-
-
TypeScript Swagger related posts
- From OpenAPI to a working integration in minutes
- Why you need static documentation for your GraphQL API
- API Documentation release automation with Github, redocly and Open API
- i learned the basics of how to create and use the MS Graph API. here's my notes
- How can I expand parameters shown by lsp.buf.signature_help()?
- Launch HN: Theneo (YC W22) – Generate Stripe-Style API Docs
- Should I migrate to TS?
Index
What are some of the best open-source Swagger projects in TypeScript? This list will help you:
Project | Stars | |
---|---|---|
1 | redoc | 17,259 |
2 | loopback-next | 4,148 |
3 | mockoon | 3,836 |
4 | autorest | 3,785 |
5 | prism | 2,850 |
6 | graphql-mesh | 2,418 |
7 | Ts.ED | 2,077 |
8 | azure-rest-api-specs | 1,593 |
9 | spectral | 1,443 |
10 | typescript-express-starter | 1,316 |
11 | openapi-to-graphql | 1,287 |
12 | swagger | 1,081 |
13 | swagger-typescript-api | 1,048 |
14 | Optic | 977 |
15 | openapi-typescript-codegen | 790 |
16 | orval | 547 |
17 | portman | 424 |
18 | spot | 378 |
19 | redocly-cli | 377 |
20 | openapi-backend | 356 |
21 | openapi-cop | 353 |
22 | openapi-client-axios | 284 |
23 | nestjs-boilerplate | 256 |
Are you hiring? Post a new remote job listing for free.