This is so cool hope to play around with it tonight. I converted the API to a OAS/swagger file and temporarily hosted them here to play around with while the site is hugged to death https://mariomaker2api.apidocumentation.com/
This is definitely a more Javascript heavy approach but without JS you can't get some nice quality of life features like the embedded REST API client for experimenting with endpoints.
As for LLMs we have had the best experience passing them Swagger files directly and not relying on an intermediate parse to text.
Having a REST API client for experimenting in a documentation turns out to be wishful thinking. Its a toy compared to full-blown testing client such as thunder or bruno. Its probably for the best to save the effort and just make documentation itself better and more customizable.
That's what I meant by "interactive features using JavaScript layered over the top" - you can still have the embedded REST API client behaving exactly the same, but if you load the page without JavaScript (e.g. a search engine crawler) you get the rest of the content as HTML.
Great point about feeding the Swagger files straight into the LLM.
As an aside, this is how ChatGPT’s plugin support works, and I always find it slightly mind blowing. You give it some OpenAPI docs, and a some brief instructions on what the API is good for, and then off it goes and uses it.
Besides being huge fans of OSS software we really feel like packages like this only make sense in an Open Source environment. Licensing for developer tooling can't be restrictive or it's just a hassle to use. There great open source business models around support, service, and hosting.
If there's any specific things big or small we can do to help convince your enterprise employer please don't hesitate to reach out (marc@scalar.com) or just let us know in the comments :)
Thanks for the kind words. We honestly would rather people's emails then any money at all. We're working really hard to make good design more accessible, and monetization will certainly come down the line! Plus we already make a bit of money with our other tool listed on the website :)
Love the instant download as well (and everything else). One suggestion though - avoid using "download.zip" for the file name... that gets easily lost in a sea of downloads. Maybe use launchaco_template.zip or if they enter a company name, maybe something like launchaco_<company name>.
Kudos, brilliant idea and great execution! Perfect for those "blitzkrieg" sites. I love it how the page is easily entered, works fast, is small and is still nice looking.
I tried using it now and there are a few suggestions I have:
1) clicking "Let's do it" does nothing, if you are already on the "Build a website" page and the content is empty - it would be better if top <div> hid itself at least partially, or if bottom content animated itself into existance (replayed animation or sth. like that).
2) it would be nice to have an option to clean the page and start with new one (by the way, where do you save the data? I tried deleting everything I could think of and you still presented me the same page I entered... :) )
3) once the page is finished, I would like to share it with people from marketing - it would be nice if you offered a way to share the page through a randomized link
4) great work on emojis, though the selection is somewhat limited. You could probably reach a deal with flaticon.com to allow adding their icons. You could even get a referral fee for the subscriptions if someone wanted to get rid of the copyright statement.
5) selecting text with mouse doesn't work, which is a bit annoying (FF)
6) images are scrollable on lower resolutions instead of being downsized (is this on purpose?)
7) editing. I know, probably not doable, just saying...
But feel free to ignore any of the suggestions, I like the site the way it is too. :)
Exactly. I'm a web designer/developer and even I could use something like this as a shortcut for a job. If it saves me a few hours of stuffing around, then $20-100 as a voluntary tip is an easy decision. Still free for third world businesses or students or tightarses, but at least gives people an option of saying "Thanks, this was worth it."
And while I can grab the files and set up my own hosting, being able to hit a button, enter card details and have everything done automatically would be powerful. Every web developer inevitably does quick jobs on the sides for friends and family, and making that process pain-free would be useful.
