2017-04-04 23:06:43 +00:00
|
|
|
# Insomnia REST Client
|
2016-03-22 05:05:37 +00:00
|
|
|
|
2017-04-04 23:06:43 +00:00
|
|
|
[![Insomnia REST Client](https://img.shields.io/badge/maintainer-Insomnia-purple.svg?colorB=6e60cc)](https://insomnia.rest)
|
2017-05-04 17:37:33 +00:00
|
|
|
[![Build status](https://ci.appveyor.com/api/projects/status/pj03skhct2p1sved/branch/master?svg=true)](https://ci.appveyor.com/project/gschier/insomnia/branch/master)
|
2017-05-04 15:35:06 +00:00
|
|
|
[![license](https://img.shields.io/github/license/getinsomnia/insomnia.svg)]()
|
2016-04-14 01:08:39 +00:00
|
|
|
|
2017-04-04 23:06:43 +00:00
|
|
|
Insomnia is a cross-platform _REST client_, built on top of [Electron](http://electron.atom.io/).
|
2016-04-23 04:06:31 +00:00
|
|
|
|
2017-04-04 23:06:43 +00:00
|
|
|
![Insomnia REST Client Screenshot](https://insomnia.rest/images/docs/promo.png)
|
2016-04-14 01:08:39 +00:00
|
|
|
|
2017-04-04 23:06:43 +00:00
|
|
|
## Bugs and Feature Requests
|
2016-04-23 04:01:28 +00:00
|
|
|
|
2017-04-04 23:06:43 +00:00
|
|
|
Have a bug or a feature request? Please 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).
|
2016-04-14 01:08:39 +00:00
|
|
|
|
2017-04-04 23:06:43 +00:00
|
|
|
## Contributing
|
2016-11-16 17:18:39 +00:00
|
|
|
|
2017-04-04 23:06:43 +00:00
|
|
|
Please read through our [contributing guidelines](CONTRIBUTING.md). Included are directions
|
|
|
|
for opening issues, coding standards, and notes on development.
|
2016-04-14 01:08:39 +00:00
|
|
|
|
2017-04-04 23:06:43 +00:00
|
|
|
More over, if your pull request contains JavaScript patches or features, you must
|
|
|
|
include relevant unit tests.
|
2016-11-16 17:18:39 +00:00
|
|
|
|
2017-04-04 23:06:43 +00:00
|
|
|
Editor preferences are available in the [editor config](.editorconfig) for easy use in
|
|
|
|
common text editors. Read more and download plugins at <http://editorconfig.org>.
|
2016-11-16 17:18:39 +00:00
|
|
|
|
2017-04-12 23:43:19 +00:00
|
|
|
## Developing
|
|
|
|
|
|
|
|
Development on Insomnia can be done on Windows, Mac, and Linux with few requirements and only
|
|
|
|
requires [NodeJS 7.4](https://nodejs.org) and [Git](https://git-scm.com/) to get started.
|
|
|
|
|
|
|
|
```bash
|
2017-05-03 17:48:23 +00:00
|
|
|
# Install dependencies and build addons for Electron
|
2017-04-12 23:43:19 +00:00
|
|
|
npm install
|
2017-05-03 17:48:23 +00:00
|
|
|
npm run rebuild
|
2017-04-12 23:43:19 +00:00
|
|
|
|
|
|
|
# Start app
|
|
|
|
npm run dev
|
|
|
|
|
|
|
|
# Run tests
|
|
|
|
npm test
|
|
|
|
```
|
|
|
|
|
2017-04-04 23:06:43 +00:00
|
|
|
## License
|
2016-11-16 17:18:39 +00:00
|
|
|
|
2017-04-04 23:06:43 +00:00
|
|
|
[GNU AGPLv3](LICENSE) © [Insomnia](https://insomnia.rest)
|