How can I get it?
You can download the application via the releases folder on Google Drive* or alternatively you can build it yourself using the Gulp build in the source.
* Please note that the application has only been tested on macOS and the Windows and Linux builds are considered unstable and untested.
What does it do?
This app allows you to proxy network requests and mock responses based on rule sets.
Why would you want to use it?
If you are working with APIs that are not built, or need to modify a response from an API to preview how changes to the API will affect the UI, this is the tool for you.
It is also open source and free!
How to use it
Set up proxy server and target
Open the settings panel:
Set the proxy server port to the port number that you want to access the proxied site on. For example if you want to access the proxied site on localhost:8080 input 8080.
Next set the proxy target host and port number. The proxy target can be local (in which case use localhost) or an external site, however the external site may block your requests. Again, set the port that you want to proxy on the target host (the standard web port is 80).
Set up rules
Open the rules panel and either click the add button to create a new rule or click an existing rule to edit it:
The rule editor will look as follows:
Begin setting up the Intercept rule by inputting the URL to match (currently has to match exactly, there are future plans to add Regex support). Set the Request Method (from the list of HTTP verbs) and your rule is set!
Next, you need to set the response parameters including content type, status code, headers, latency simulation, and finally the actual content for the response. This content can be served from a file on your file system or can be input directly as shown above.
View requests
In the requests panel you can now view requests that pass through the proxy in realtime, with latency information:
This list can be filtered:
Enjoy!
I hope this tool is as useful to you as it was fun to build!
Feel free to contribute!
If you would like a feature, please request it! Even better, submit a PR!
Current limitations
- The matching rules currently don't allow regexes, or multiple request methods.
- The proxy cannot proxy on a HTTPS server, so only HTTP requests are currently supported.