swagger-petstore VS bulletproof-nodejs

Now, we can start our server and visit the Swagger UI at http://localhost:port/documentation. The documentation will be empty for now, but we will add our endpoints later on. You can also have a look at how the Swagger UI looks in the Swagger's online demo.

I think there's also a missing gap in how to present Swagger beautifully, the default one ( https://petstore.swagger.io/ ) is meh. I'm looking for something that can generate like https://stripe.com/docs/api but open source (since the OP is talking about it).

I imagine a tool(chain) that can take Swagger generated from annotations in code, and combine it with a folder containing Markdown files for "free form" documentation, and generate a Hugo/Jekyll static site that can be deployed in Cloudflare Pages in docs.mycompany.com

You can go to https://petstore.swagger.io/

Controllers handle the incoming requests, and their responses. Generally you design a "contract" that describes how to properly format a request to your application, and which response you may expect. Swagger is the tool to write the contract, and REST are the principles that guide you. Take a look at the swagger petstore for an example. Ask for a swagger file of your application, and the corresponding Controller, and you should be able to see the connection.

Your question is a bit unclear. Are you trying to find an example OpenAPI document for some REST web services? If yes, check the Pet Store project: https://petstore.swagger.io/

So you mean there is an endpoint on each of your service that will bring you to a view like the PetStore example?

I am a backend dev myself. I use pet store api collection as a reference for REST APIs best practices https://petstore.swagger.io

Automation for many routines starts with interaction via API. This case can be treated in many ways, but I want to take a look at interacting with web API using a generated Kotlin client. I found a lot of academic examples for generating Kotlin clients (most of them are based on the PetStore), but nothing was close to real-world examples. My goal is to build a Kotlin client for a complex API and see how it works. Here is the source code of the Kotlin project that I will use in the post.

If you are looking for a typescript one, I used the following boilerplate in one of my projects and it works fine and fast(after some improvements): https://github.com/santiq/bulletproof-nodejs

https://github.com/santiq/bulletproof-nodejs - it has an article linked in it's README going into a lot of detail around the architecture / structure.

The express.js official website makes use of the express-generator library which is not bad but hasn't been updated since 2019. But personally, I build my folder structure based on Bulletproof node but I don't have as much library as the creator does at all but just focus on the overall folder structure

https://github.com/santiq/bulletproof-nodejs but you need to tweak it way more than the react one and testing isn't done on it

This one https://softwareontheroad.com/ideal-nodejs-project-structure/

8. Bullet Proof Node.js

For NodeJS https://github.com/santiq/bulletproof-nodejs