marclave

Get paid how and where you want—let your customer pay the way that works for them. Receive payments straight to your wallet or bank account. For businesses/freelancers globally.

theyre using scalar :)

https://scalar.com https://github.com/scalar/scalar

(disclaimer: im the co-founder & ceo of scalar)

Like pip-compile, uv generates a platform-specific requirements.txt file (unlike, e.g., poetry and pdm, which generate platform-agnostic poetry.lock and pdm.lock files). As such, uv's requirements.txt files may not be portable across platforms and Python versions.

really curious on the reasoning behind this decision :)

this is unreal! i was just thinking about this on a walk yesterday for our internal evals on our new models we are building.

big kudos for this, so wonderfully excited to see this on HN and we will be using this

hey! co-founder here, what about the demo is off-sync?

We debounce the input slight before parsing the spec to not block the browser

hey! We released a fix for Safari, it should be all fixed now. Let me know if this resolved it for you

Swagger + OpenAPI v3/v3.1 parser, sorry I needed more coffee was up way too late this week with launch

Will update the README to make this more clear

yes! it's on our list of things to add this week, appreciate the comment :)

We just shipped adding headers + params interactive so people can add `x-api-key`

https://github.com/scalar/scalar/pull/237

We support Swagger + OAS 3/3.1

The language can be better throughout the repo so we will update that :) appreciate the comment

co-founder here! thanks for the kind words.

I am also excited for another alternative, that feels modern!

Appreciate the comment :)

Sidenote: we are going to be building a docusaurus plugin soon!

co-founder here :) Appreciate the kind words!

Our plans are to make it easier to integrate with existing SDK generation tools so you can use them inside of our API docs.

https://www.speakeasyapi.dev/ is a really great platform and I think we can integrate with them and have examples from custom SDKs.

In the scenario with custom domains, we would have to rely on docstrings or comments depending on the language, I'll need more thought on that

appreciate your comment! So sorry to hear this, what iPhone do you have? I have an older iPhone so im not getting this issue.

Going to try to recreate this thought, maybe the page is slightly zoomed in on your device?

Also feel free to email me (marc@scalar.com) if that's easier :)

Hey HN, Marc co-founder & CEO of scalar here!

Thanks so much for your thoughtful feedback and giving our first open sourced tool a try. Please don't hesitate to reach out here or email me directly at marc@scalar.com if you have any feedback or if I can help you in any way shape or form with your API.

our swagger parser isnt perfect yet, appreciate this comment and I added it to triage. We will get this fixed quick

very cool :)

Appreciate the kind words, and the suggestions!

It was tough to close the "Test request" window. - I wasn't sure how to interact with the product without more trial and error.

Ah, this is great feedback. We can make it more clear with a button, as well that you can hit escape.

Add OpenAPI linting to the editor. ah, great idea. will triage this and get this in.

Allow users to import an example spec from the initial Getting Started page. In the getting started page we have "import url, paste swagger" & "petstore + tableau + cmc" examples to import by clicking.

Did you mean to add it to the editor?

Ah that's very cool, back in the day I always would install redocly instead of swagger UI, great work with Redocly :)

Again I really appreciate the kind words and your time.

this is great context, it definitely can sometimes be confusing with the dual usage and sometimes not using either-or. :)

appreciate your comment!

Ah that's fantastic news about the custom views with Vue.js components.

Feel free to email me (marc@scalar.com) or join the Discord if you have any questions, need any features or bugs fixed please reach out :)

co-founder here, we appreciate the kind words!

you're right! I updated the description[1] to include OpenAPI since people do still loog for swagger :)

[1] Beautiful API references from Swagger/OpenAPI files

hey! co-founder here, appreciate your comment.

Ah that's great feedback!

As for the rendering of the schemas, we have a pull request in draft from this morning! hopefully will be done ASAP

https://github.com/scalar/scalar/pull/244

hey ceo & co-founder here!

First of all we love open-source, we saw a huge opportunity to bring a modern design and some new features to swagger-ui & redocly.

Great question how we make money! We currently have: - a premium plan for hosting with a custom domain and guides

Our longer term plan is to build a dedicated REST API Client that is deeply integrated with all of our produts.

Feel free to join our discord, email me marc@scalar.com or sign up on scalar.com to stay updated :)

appreciate the comment!

the hosted version has SSG :) but we can probably do an ssg build option... going to triage that and maybe get that in over the weekend with some redbulls

ha love the username too :)

Appreciate the comment!

Docusaurus integration is going to be the next one we do! Sign up and we can notify you there, on our discord or of course when we push it to github :)

hey! ceo & co-founder here, some key differentiators. It definitely is a busy space, but we feel like there's some key differentiators:

- modern design - deeply integrated rest api client - free hosting with an apidocumentation.com subdomain - offline search with fuse.js - and more!

We also have a full api docs platform, where you can: - have full customization so you get on brand docs - subdomain & custom domain hosting

We put a lot of time to make these products integrated, cause what we see right now with current solutions is deep fragmentation.

I agree on most tools making it worse, long term we aim to make this better with a git sync feature and docstring parsing! :) -

I remember first discovering the game of Go, after watching the AlphaGo Documentary [1]. I highly recommend it, will definitely be signing up for this, I usually play on mobile :)

[1] https://www.youtube.com/watch?v=WXuK6gekU1Y

It's always impressive to me that, the co-founder of Figma (https://twitter.com/evanwallace) who essentially built a browser in a browser (figma.com) built esbuild. Could honestly be the Woz of our generation.

Have you looked into webassembly and how browsers give access to filesystems[1], there could be hope for a future of high performant filesystem access.

[1] https://developer.mozilla.org/en-US/docs/Web/API/FileSystem

What would the optimizations be for a larger canvas?

Does it redraw the whole canvas when an update is made* to a single line when there are several other lines on the canvas?

*edit for spelling mistakes