mirror of
https://github.com/Kong/insomnia
synced 2024-11-07 22:30:15 +00:00
90 lines
3.5 KiB
Markdown
90 lines
3.5 KiB
Markdown
# Insomnia REST Client
|
||
|
||
[](https://insomnia.rest)
|
||
[](https://travis-ci.org/getinsomnia/insomnia)
|
||
[](https://ci.appveyor.com/project/gschier/insomnia)
|
||
[](LICENSE)
|
||
[](https://chat.insomnia.rest/)
|
||
[](https://twitter.com/getinsomnia)
|
||
|
||
Insomnia is a cross-platform _REST client_, built on top of [Electron](http://electron.atom.io/).
|
||
|
||
|
||
|
||
## Download
|
||
|
||
Insomnia is available for Mac, Windows, and Linux and can be downloaded
|
||
from the website.
|
||
|
||
**[https://insomnia.rest/download](https://insomnia.rest/download/)**
|
||
|
||
## Bugs and Feature Requests
|
||
|
||
Have a bug or a feature request? First, read the
|
||
[issue guidelines](CONTRIBUTING.md#using-the-issue-tracker) and search for existing and
|
||
closed issues. If your problem or idea is not addressed yet, [please open a new issue](/issues).
|
||
|
||
For more generic product questions and feedback, join the [Slack Team](https://chat.insomnia.rest) or email
|
||
[support@insomnia.rest](mailto:support@insomnia.rest)
|
||
|
||
## Contributing
|
||
|
||
Please read through our [contributing guidelines](CONTRIBUTING.md). Included are directions
|
||
for opening issues, coding standards, and notes on development.
|
||
|
||
Editor preferences are available in the [editor config](.editorconfig) for easy use in
|
||
common text editors. Read more and download plugins at [editorconfig.org](http://editorconfig.org).
|
||
|
||
## Developing
|
||
|
||
Development on Insomnia can be done on Mac, Windows, or Linux as long as you have
|
||
[NodeJS 8](https://nodejs.org) and [Git](https://git-scm.com/).
|
||
|
||
<details>
|
||
<summary>Initial Dev Setup</summary>
|
||
|
||
```bash
|
||
# Install dependencies and build add-ons for Electron
|
||
npm install
|
||
npm run rebuild
|
||
|
||
# Start app
|
||
npm run dev
|
||
|
||
# Run tests
|
||
npm test
|
||
```
|
||
|
||
</details>
|
||
|
||
<details>
|
||
<summary>Editor Requirements</summary>
|
||
|
||
You can use any editor you'd like, but make sure to have support/plugins for
|
||
the following tools:
|
||
|
||
- [ESLint](http://eslint.org/) – For catching syntax problems and common errors
|
||
- [JSX Syntax](https://facebook.github.io/react/docs/jsx-in-depth.html) – For React components
|
||
- [Flow](https://flow.org/) – For type annotations
|
||
|
||
</details>
|
||
|
||
## Plugins
|
||
|
||
Here is a list of plugins available for installation via NPM.
|
||
|
||
- [JWT Decode](https://www.npmjs.com/package/insomnia-plugin-jwtdecode) – Decode header or payload of JWT tokens
|
||
- [XDebug](https://www.npmjs.com/package/insomna-plugin-xdebug) – Enable Xdebug debugging by adding an `XDEBUG_SESSION` cookie to the request.
|
||
- [Default Headers](https://www.npmjs.com/package/insomnia-plugin-default-headers) – Set default headers on requests
|
||
- [Random Number](https://www.npmjs.com/package/insomnia-plugin-randomnumber) – Generate a random integer between a minimum and maximum
|
||
- [Random Credit Card](https://www.npmjs.com/package/insomnia-plugin-randomcreditcard) – Generate random credit card numbers
|
||
|
||
## Community Projects
|
||
|
||
[Swaggymnia](https://github.com/mlabouardy/swaggymnia) – Generate [Swagger](https://swagger.io/) documentation for your existing API in Insomnia.
|
||
|
||
|
||
## License
|
||
|
||
[GNU AGPLv3](LICENSE) © [Insomnia](https://insomnia.rest)
|