When I wrote this, only God and I understood what I was doing. Now, only God knows.
Start here: Story behind Postwoman
β€οΈ Lightweight: Crafted with minimalistic UI design
- Faster, lighter, cleaner, minimal & responsive
β‘ Real-time: Send requests and get/copy responses right away!
Methods:
GET
- Retrieve information about the REST API resourceHEAD
- Asks for a response identical to that of a GET request, but without the response body.POST
- Create a REST API resourcePUT
- Update a REST API resourceDELETE
- Delete a REST API resource or related componentOPTIONS
- Describe the communication options for the target resourcePATCH
- Applies partial modifications to a REST API resource
History entries are synced with local session storage
π VIBGYOR: Neon combination background, foreground & accent colors - because customization === freedom β¨
Customizations:
- Dark and Light background themes
- Choose accent color
- Toggle multi-colored frames
Customized themes are also synced with local session storage
π₯ PWA: Install as a PWA on your device
Features:
- Instant loading with Service Workers
- Offline support
- Low RAM/memory and CPU usage
π Request: Retrieve data from a URL without having to do a full page refresh
- Choose
method
- Enter
URL
- Enter
Path
- Copy public "Share URL"
- Generate request code for JavaScript XHR, Fetch, cURL
- Copy generated request code to clipboard
π Web Socket: Establish full-duplex communication channels over a single TCP connection
- Send and receive data
π Authentication: Allows to identity the end user
Types:
- None
- Basic authentication using username and password
- Token based authentication
π’ Headers: Describes the format the body of your request is being sent as
π« Parameters: Use request parameters to set varying parts in simulated requests
π Request Body: Used to send and receive data via the REST API
Options:
- Set content Type
- Toggle between RAW input and parameter list
π Responses: Contains the status line, headers and the message/response body
- Copy response to clipboard
- View preview for HTML responses
HTML responses have "Preview HTML" feature
β° History: Request entries are synced with local session storage to reuse with a single click
Fields
- Timestamp
- Method
- Status code
- URL
- Path
History entries can be deleted one-by-one or all together
https://liyasthomas.github.io/postwoman
- Specify your request method
- Type in your API URL
- Add API path
- Send request
- Get response!
You're done!
- Chromium - Thanks for being so fast!
- HTML - For the web framework
- CSS - For styling components
- JavaScript - For magic!
- Vue - To add to the JavaScript magic!
- Nuxt - To add to the Vue magic!
- Clone this repo with git.
- Install dependencies by running
npm install
within the directory that you cloned (probablypostwoman
). - Start the development server with
npm run dev
. - Open development site by going to http://localhost:3000 in your browser.
- Clone this repo with git.
- Install dependencies by running
npm install
within the directory that you cloned (probablypostwoman
). - Build the release files with
npm run build
. - Find the built project in
./dist
.
Please read CONTRIBUTING for details on our CODE OF CONDUCT, and the process for submitting pull requests to us.
We use Travis CI for continuous integration. Check out our Travis CI Status.
This project is developed by Liyas Thomas using the Semantic Versioning specification. For the versions available, see the releases on this repository.
See the CHANGELOG file for details.
- Liyas Thomas - Author
- John Harker
- Andrew Bastin
- Nick Palenchar
- Abraham Williams
- Nicholas La Roux
- RifqiAlAbqary
- izerozlu
- Thomas Yuba
See the list of contributors who participated in this project.
This project is licensed under the MIT License - see the LICENSE file for details.
- Hat tip to anyone who's code was used
- Inspirations: