DEV Community

Cover image for Launching Hoppscotch v1.0 πŸ‘½ - free, fast & beautiful API request builder πŸŽ‰
Liyas Thomas
Liyas Thomas

Posted on • Edited on

Launching Hoppscotch v1.0 πŸ‘½ - free, fast & beautiful API request builder πŸŽ‰

So, here’s how Hoppscotch happened.

GitHub β†’ Web app β†’

You know the drill. You’re developing an app for a client and you need to test every APIs and every APIs response in every method, on every requests.

Our team was already using Postman to test all the variations of an API, but my 7 year old PC couldn't afford to run another Electron app just to see the request responses in all of them. And that’s how it all started.

How about making a tool where you can test your APIs from your browser itself without switching between apps as you work? That would be neat, huh!

GitHub logo hoppscotch / hoppscotch

Open source API development ecosystem - https://hoppscotch.io (open-source alternative to Postman, Insomnia)

How it all began

The initial tweet about the idea got 250+ likes and 60+ retweets so people were definitely interested in this kind of tool.

I literally launched Hoppscotch on a dev.to article and wrote about it on Hacker News, HackerNoon, Medium, HashNode, Reddit, Twitter etc.

I saw a guy writing JavaScript today.
No frameworks.
No libraries.
No problems.
He just did it.
Writing JavaScript.
Like a Psychopath.

It was me πŸ™ƒ

I had some problems with CORS in deployment, but I found a quick workaround. I used Vue.js and apparently migrated to Nuxt.js.

At that point I started thinking that the tool can actually be published as a standalone web app, and the WebSocket testing feature can just be an addition. So I shifted my goal and starting working towards that.

I added few themes, polished up the UI a bit, struggled for 30 mins to come up with a name and..... drumroll Hoppscotch it is. I setup a GitHub repo for people who were interested to contribute.

After I open sourced the code, polished up the UI, and finished bunch of other smaller things, hoppscotch.io was live πŸŽ‰

I actually wrapped up work at 4:30 AM because I just couldn’t go to sleep without finishing that one thing πŸ˜…

Screenshot1

Features

  • πŸ’š Open Source
  • πŸ”₯ Runs online
  • πŸš€ Multi-platform & multi-device support
  • πŸ“± Progressive Web App
  • πŸ”Œ WebSocket testing
  • πŸ“‘ Server Sent Events testing
  • 🌩 Socket.IO testing
  • 🦟 MQTT testing
  • πŸ’« GraphQL testing
  • 🌈 Customizations
  • ⏰ History
  • πŸ“ Collections
  • 🌐 Proxy
  • πŸ“œ Pre-Request Scripts & environment variables Ξ²
  • 🐳 Docker
  • β›³ Keyboard Shortcuts
  • βœ… Post-Request Tests Ξ²
  • Full features

After the launch, analytics were going crazy! Got 17,700+ stars on GitHub, made it to GitHub Trending couple of times, became #2 product of the day on Product Hunt, got featured in Indie Hackers, Hacker news, Hacker noon, BetaList, YouTube & open source dev podcast etc.

Apart from the project development, there were other goodies happened since initial release:

I was solving my own problem with the hope that I'll also gonna solve other people’s problems. The most important thing about is that in the end, you get a lot of amazing and positive feedback, which is basically the only thing that drives you to do better and more awesome work! πŸŽ‰

If you think Hoppscotch is worthy of existing as a free, fast alternative to Postman, please consider giving us a confidence boost! Star the repo on GitHub, Tweet, share among your friends, teams and contacts!

Support

I want to thank everyone for your feedback and support. You can follow me on Twitter if you’re interested in future updates.

If you want a heads up on my next projects, or just want to chat about the web, make sure to follow me @liyasthomas πŸ’™. If any of my projects helped you please consider Buying me a coffee or making a donation on PayPal.

Latest comments (46)

Collapse
 
ajkachnic profile image
Andrew • Edited

This looks interesting. Is the best way to develop with localhost to use Ngrok? Or is there something that I am missing?

Collapse
 
liyasthomas profile image
Liyas Thomas

localhost endpoints can be tested by installing a middleware browser extension. Links are in repo's readme.

Collapse
 
ajkachnic profile image
Andrew

Okay thanks

 
liyasthomas profile image
Liyas Thomas • Edited

Well said! πŸ”₯πŸ‘

Collapse
 
neverendingqs profile image
Mark Tse • Edited

Curious - do you have any concerns around storing potentially sensitive information in local storage? My understanding is that any app can view what is in local storage.

Collapse
 
liyasthomas profile image
Liyas Thomas

Postwoman is a 100% client side application. PW just works even if you download the entire web page to system and opened from there, there's no client-server data transfer ever happening, except on Proxy mode, which is optional.

We uses localStorage for storing the History entries and the current state of request section. We stay compliant on Same origin policy throughout our implementation. Moreover, there's always an option to Clear/Disallow cookies.

When I first started working PW, I never wanted to have a Sign-up flow because it somehow seemed to decrease my testing flow. But as the project gained such traction & grew tremendously, having a Sign-in with GitHub/Google and storing data on a GitHub repo is pipelined for future with prime priority.

Collapse
 
nijeesh4all profile image
Nijeesh Joshy • Edited

I had some problems with CORS in deployment, but I found a quick workaround.

i have been following postwomen since the DEV post. How did you fix it ?

Collapse
 
liyasthomas profile image
Liyas Thomas • Edited

We implemented Proxy mode. For requests having CORS issues, go to Settings > Turn on Proxy
That's it. But you don't want to do this at first. We'll prompt you to enable proxy only if the requests requires it. πŸ‘½βœ¨

Collapse
 
seveneye profile image
seveneye

Is there a suppor for environments? That would be awesome! :)

Collapse
 
liyasthomas profile image
Liyas Thomas • Edited

Pre-request scripts and Environment variables are deployed to production but experimental!
Full list of feature are here: github.com/liyasthomas/postwoman

Usage:

  1. Open Pre-request scripts by clicking the "<>" icon button under request Method

  2. Set env variables with JavaScript notation: pw.environment.set("key", "value"); inside pre-request script textarea.

Ex: pw.environment.set("route", "/api/users");

  1. Use <<key>> (including double angle brackets) anywhere inside request section as an env var

Ex: <<route>> inside Path field

Screenshots:

1

2

Other use cases are:

  • Including the timestamp in the request headers
  • Sending a random alphanumeric string in the URL parameters
  • You can even chain requests in near future πŸ”₯

Full information can be found here: github.com/liyasthomas/postwoman/p...

Collapse
 
seveneye profile image
seveneye

cool. thanks for your work!

I'm thinking of something like environment in postman where you can easily change variables without modifying the request.

Thread Thread
 
liyasthomas profile image
Liyas Thomas

Actually this is cooking up! and will be deployed soon.
github.com/liyasthomas/postwoman/i...

Thread Thread
 
seveneye profile image
seveneye

wow. will be looking forward to this feature. You're awesome! :)

Thread Thread
 
liyasthomas profile image
Liyas Thomas

Glad you liked it! Star the project on GitHub, share among your friends/teams πŸ™πŸ‘½πŸ›Έβœ¨

Collapse
 
erikjonker_ profile image
Erik Jonker

This is a cool project! Well done! Just one thing though. It is quite difficult to take anyone serious using so many emoji's, especially a developer, especially in github commit messages. Besides my 2 cents, this seems like a fun alternative to postman

Collapse
 
liyasthomas profile image
Liyas Thomas

I don't think usage of emojis in commit messages limit the project's seriousness. Gitmoji (gitmoji.carloscuesta.me) is a highly appreciated project on GitHub supported by a huge community of devs πŸ€”

Collapse
 
jonrandy profile image
Jon Randy πŸŽ–οΈ

Insomnia is the best such tool I've used - insomnia.rest

Collapse
 
liyasthomas profile image
Liyas Thomas • Edited

Postwoman is an online web app. No need to install or update build, because of this, there's no other overhead to system for using a testing tool. Moreover apps such as Postman and insomnia are built with electron which consumes a considerable amount of resources of the system.

+

Postwoman have multi platform, multi device support. API testing can be done even from your smartphone now.

Collapse
 
catalin560 profile image
catalin560

but why would you do it from a smartphone? the other clients are multi platform too...

Thread Thread
 
liyasthomas profile image
Liyas Thomas

Handy feature isn't it?

Collapse
 
wobsoriano profile image
Robert

No POSTLGBTQ+? JK. Awesome content!

Collapse
 
liyasthomas profile image
Liyas Thomas

lol

Collapse
 
harishankards profile image
Harishankar Ayandev

Hey Liyas,

You know, it was much needed. Thanks for giving us a great app. Will be grateful and I will try to contribute to the project as well.

Collapse
 
liyasthomas profile image
Liyas Thomas

Thats awesome! πŸ™ŒπŸΌ

Some comments may only be visible to logged-in visitors. Sign in to view all comments.