# Thunder Client

Thunder Client is a lightweight Rest API Client Extension for Visual Studio Code, hand-crafted by [Ranga Vadhineni](https://twitter.com/ranga_vadhineni) with simple and clean design.

- Voted as **#10 Product of the day** on [Product Hunt](https://www.producthunt.com/posts/thunder-client)
- Website - [www.thunderclient.com](https://www.thunderclient.com)
- Follow Twitter for updates - [twitter.com/thunder_client](https://twitter.com/thunder_client)
- Support: [github.com/rangav/thunder-client-support](https://github.com/rangav/thunder-client-support)

### Story behind Thunder Client

- Read Launch Blog Post on [Medium](https://rangav.medium.com/thunder-client-alternative-to-postman-68ee0c9486d6)

## Usage

- Install the Extension, Click Thunder Client icon on the Action Bar.
- From Sidebar click `New Request` button to test API

<img width="850" alt="Thunder Client" src="https://github.com/rangav/thunder-client-support/blob/master/images/thunder-client-v2.png?raw=true">

## Videos

- Thunder Client quick overview video by [James Quick](https://www.youtube.com/watch?v=AbCTlemwZ1k)
- Thunder Client introduction video on [Youtube](https://www.youtube.com/watch?v=NKZ0ahNbmak)

## Main Features

- **Lightweight** Rest API Client for VS Code.
- **Simple & Easy** to use UI
- Supports **Collections and Environment variables** & Graphql Queries.
- **Scriptless Testing:** Test API response easily with GUI based interface .
- **Themes:** The extension also supports VS Code themes.
- **Local Storage** All the requests data is saved locally on your device.

## Documentation

- For updated documentation please visit our [github](https://github.com/rangav/thunder-client-support) page

## CLI & CI/CD Integration

- Test APIs using the `CLI` and integrate with the `CI/CD build` pipeline, see [documentation](https://rangav.medium.com/d91eb5c71d8e).

## Git Sync

> Subscription Required to use this feature

- This feature allows you to store requests data in git project, for details visit [github](https://github.com/rangav/thunder-client-support#team) page.

## Import/Export

- You can import from Postman, Insomnia, OpenAPI and Curl, for more details visit [github](https://github.com/rangav/thunder-client-support#import) page.

## Run Collection

- You can test multiple requests using Collection, select `Run All` option from the collection menu.
- The collection runner will execute all requests and test cases and display the result.

## Proxy

- Proxy is supported using vscode proxy setting. for details visit [github](https://github.com/rangav/thunder-client-support#proxy) page.

## Scriptless Testing

<img width="850" alt="Thunder Client" src="https://github.com/rangav/thunder-client-support/blob/master/images/thunder-client-tests-v2.png?raw=true">

- We need to write lot of boilerplate code in Postman and other api clients to do basic testing using scripting like status code equal 200. So I implemented GUI based tests, where you select couple of dropdowns to do most standard tests very easily without any scripting knowledge.
- **Set Environment Variable** from response, Headers, Cookie in Tests tab is now supported, see our [github](https://github.com/rangav/thunder-client-support#testing) page for details.

## Privacy

- Basic anonymised telemetry data of extension usage is collected using [vscode-extension-telemetry](https://github.com/Microsoft/vscode-extension-telemetry), No Personal or request data is collected. You can opt out using VS Code Settings [details here](https://code.visualstudio.com/docs/getstarted/telemetry)
- There is no backend or cloud sync currently, all the data is stored locally on your computer.