Skip to content

Commit 29f7020

Browse files
committed
updated readme
1 parent 6acc40d commit 29f7020

File tree

1 file changed

+80
-1
lines changed

1 file changed

+80
-1
lines changed

README.md

Lines changed: 80 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,82 @@
11
# Req - Test APIs with Terminal Velocity
22

3-
[![tests](https://github.com/maniac-en/req/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/maniac-en/req/actions/workflows/go.yml) ![GitHub repo](https://img.shields.io/badge/built%20at-Boot.dev%20Hackathon-blueviolet)
3+
[![tests](https://github.com/maniac-en/req/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/maniac-en/req/actions/workflows/go.yml)
4+
![GitHub repo](https://img.shields.io/badge/built%20at-Boot.dev%20Hackathon-blueviolet)
5+
6+
## About
7+
8+
`req` is a lightweight, terminal-based API client built for the
9+
[Boot.dev Hackathon 2025](https://github.com/maniac-en/req?tab=License-1-ov-file).
10+
It features a fast and minimal text user interface and lets you create, send,
11+
and inspect HTTP requests interactively from the command line. It is ideal for
12+
testing APIs without leaving your terminal.
13+
14+
Read more about `req` over here -
15+
[Announcement Blog](https://maniac-en.github.io/req/)
16+
17+
## Installation
18+
19+
### You can install `req` using `go install`:
20+
21+
To install a specific release
22+
23+
```
24+
go install github.com/maniac-en/req@v0.1.0
25+
```
26+
27+
Replace `v0.1.0` with the version you want.
28+
29+
### Requirements
30+
31+
- Go version 1.24.4
32+
33+
## Usage
34+
35+
After installing `req`, you can run it using this command.
36+
37+
```
38+
req
39+
```
40+
41+
## Libraries Used
42+
43+
### Terminal UI (by Charm.sh)
44+
45+
- [bubbletea](https://github.com/charmbracelet/bubbletea) — A powerful, fun TUI
46+
framework for Go
47+
- [bubbles](https://github.com/charmbracelet/bubbles) — Pre-built components for
48+
TUI apps
49+
- [lipgloss](https://github.com/charmbracelet/lipgloss) — Terminal style/layout
50+
DSL
51+
52+
## License
53+
54+
This project is licensed under the
55+
[MIT License](https://github.com/maniac-en/req?tab=License-1-ov-file).
56+
57+
```
58+
1. Mudassir Bilal (mailto:mughalmudassir966@gmail.com)
59+
2. Shivam Mehta (mailto:sm.cse17@gmail.com)
60+
3. Yash Ranjan (mailto:yash.ranjan25@gmail.com)
61+
62+
MIT License
63+
64+
Copyright (c) 2025 Mudassir Bilal, Shivam Mehta, Yash Ranjan
65+
66+
Permission is hereby granted, free of charge, to any person obtaining a copy of
67+
this software and associated documentation files (the "Software"), to deal in
68+
the Software without restriction, including without limitation the rights to
69+
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
70+
the Software, and to permit persons to whom the Software is furnished to do so,
71+
subject to the following conditions:
72+
73+
The above copyright notice and this permission notice shall be included in all
74+
copies or substantial portions of the Software.
75+
76+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
77+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
78+
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
79+
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
80+
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
81+
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
82+
```

0 commit comments

Comments
 (0)