Skip to content
Cross-platform HTTP and GraphQL Client
Branch: develop
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add "Needs Discussion" to stalebot ignore Jun 25, 2018
docker Add RPM build Feb 20, 2019
packages New data models for hotkeys and store the key bindings in settings (#… Mar 12, 2019
plugins Add support for Base64url encoding (#1348) (#1349) Mar 13, 2019
screenshots Add screenshot to repo Nov 16, 2017
.appveyor.yml
.dockerignore
.editorconfig Beta 4 changelog Nov 27, 2017
.gitattributes Add .gitattributes (#506) Oct 10, 2017
.gitignore
.nvmrc Update Electron and node-libcurl (#1215) Oct 20, 2018
.prettierignore Add Prettier Jun 25, 2018
.prettierrc
.travis.yml
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md Jan 26, 2018
CONTRIBUTING.md Merge develop for 5.1.0 (#246) May 24, 2017
LICENSE
README.md
docker-compose.yaml
lerna.json Update Electron and node-libcurl (#1215) Oct 20, 2018
package-lock.json
package.json Adjusted top-level deps Dec 11, 2018

README.md

Insomnia REST Client

Insomnia Travis Slack Channel Twitter Follow license

Insomnia is a cross-platform REST client, built on top of Electron.

Insomnia REST Client Screenshot

Download

Insomnia is available for Mac, Windows, and Linux and can be downloaded from the website.

https://insomnia.rest/download

Bugs and Feature Requests

Have a bug or a feature request? First, read the issue guidelines and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

For more generic product questions and feedback, join the Slack Team or email support@insomnia.rest

Contributing

Please read through our contributing guidelines and code of conduct. Included are directions for opening issues, coding standards, and notes on development.

Editor preferences are available in the editor config for easy use in common text editors. Read more and download plugins at editorconfig.org.

Developing

Development on Insomnia can be done on Mac, Windows, or Linux as long as you have NodeJS 8 and Git.

Initial Dev Setup

This repository is structured as a monorepo and contains many Node.JS packages. Each package has its own set of commands, but the most common commands are available from the root [package.json](package.json) and can be accessed using the npm run ... command. Here are the only three commands you should need to start developing on the app.

# Install and Link Dependencies
npm run bootstrap

# Run Tests
npm test

# Start App with Live Reload
npm run app-start
Editor Requirements

You can use any editor you'd like, but make sure to have support/plugins for the following tools:

  • ESLint – For catching syntax problems and common errors
  • JSX Syntax – For React components
  • Flow – For type annotations

Plugins

Here is a list of plugins available for installation via NPM.

  • Chance – Generates a random value using Chance.JS
  • Cuid – Generate random cuids
  • Custom Timestamp – Advanced timestamp creator
  • Default Headers – Set default headers on requests
  • Defaults - Set request defaults through your environment
  • Faker - Generate Faker data right within Insomnia!
  • Github Apps – Generates a JWT for auth with the GitHub API as your GitHub App
  • Javascript Eval - Evaluate/run Javascript code
  • JWT Decode – Decode header or payload of JWT tokens
  • OS Util – Get OS information
  • Random Credit Card – Generate random credit card numbers
  • Random Number – Generate a random integer between a minimum and maximum
  • Random UK Sort Code – Generate random UK bank sort codes
  • Regex – Extract a value from an environment variable using a regular expression
  • Swagger Validator – Validate an API response to a swagger spec
  • XDebug – Enable Xdebug debugging by adding an XDEBUG_SESSION cookie to the request

Community Projects

  • GitHub API Spec Importer – A complete set of GitHub REST API route specifications that can be imported straight into Insomnia
  • Swaggymnia – Generate Swagger documentation for your existing API in Insomnia.

License

MIT © Insomnia

You can’t perform that action at this time.