582 karma · joined June 28, 2014
marc@scalar.com
https://scalar.com https://github.com/scalar/scalar
(disclaimer: im the co-founder & ceo of scalar)
really curious on the reasoning behind this decision :)
big kudos for this, so wonderfully excited to see this on HN and we will be using this
We debounce the input slight before parsing the spec to not block the browser
Will update the README to make this more clear
We just shipped adding headers + params interactive so people can add `x-api-key`
The language can be better throughout the repo so we will update that :) appreciate the comment
I am also excited for another alternative, that feels modern!
Sidenote: we are going to be building a docusaurus plugin soon!
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
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 :)
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.
> 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.
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 :)
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
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
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 :)
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
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 :)
- 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! :) -
[1] https://developer.mozilla.org/en-US/docs/Web/API/FileSystem
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