While is a cool idea on its own, I don't get why they try to reinvent it as a new system. We've got swagger, openapi, graphql and many other systems that already describe the APIs. They mostly include documentation too. Why not just expose those for the same effect? (If I was cynical, I'd guess Vercel wanting a proprietary thing of their own just for less portability)

▲

altern8 4 hours ago | parent | next [-]

OpenAPI is great, there are a lot of tools to go from OpenAPI to UI, but you don't have a lot of control over the presentation.

For instance, you can specify that "first_name","last_name" and "email" are strings, but not that first/last name should be next to each other and email in its own row.

There are supersets of OpenAPI that can control the look and feel more. JSON Forms, for instance.

This is cool, too, though.

▲

css_apologist 5 hours ago | parent | prev [-]

those describe server APIs

how would it relate to ui?

	▲	altern8 4 hours ago \| parent [-]
		OpenAPI is a superset of JSON Schema. You can look at properties in JSON Schema and turn that into UIs. For instance, strings would get a text box, enums would get a dropdown, etc., with validation and everything. Check this out as an example: https://prismatic.io/docs/jsonforms/playground/