quvur-dev 1.0.2 → 1.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +137 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
# 🚰 Quvur CLI
|
|
2
|
+
|
|
3
|
+
**Quvur** is a lightweight CLI tool that exposes your local development server to the internet through a secure tunnel.
|
|
4
|
+
|
|
5
|
+
It allows developers to instantly share local services without deploying them.
|
|
6
|
+
|
|
7
|
+
Common use cases:
|
|
8
|
+
|
|
9
|
+
- Testing webhooks
|
|
10
|
+
- Sharing a local development server
|
|
11
|
+
- Demonstrating applications
|
|
12
|
+
- Remote debugging
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# ✨ Features
|
|
17
|
+
|
|
18
|
+
- 🚀 Fast HTTP tunneling
|
|
19
|
+
- 🌍 Public URLs for local servers
|
|
20
|
+
- 🏷 Custom subdomain support
|
|
21
|
+
- 🔐 Authentication
|
|
22
|
+
- 🔁 Automatic reconnect
|
|
23
|
+
- ⚡ Lightweight CLI
|
|
24
|
+
|
|
25
|
+
> Currently only **HTTP tunneling** is supported.
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
# 📦 Installation
|
|
30
|
+
|
|
31
|
+
Install globally using npm:
|
|
32
|
+
|
|
33
|
+
```bash id="w6j9tt"
|
|
34
|
+
npm install -g quvur-dev
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
After installation the CLI command will be available:
|
|
38
|
+
|
|
39
|
+
```bash id="0u7a0p"
|
|
40
|
+
quvur
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
# 🚀 Quick Start
|
|
46
|
+
|
|
47
|
+
Expose a local server running on port **3000**:
|
|
48
|
+
|
|
49
|
+
```bash id="6m5aqm"
|
|
50
|
+
quvur http 3000
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
This creates a public tunnel that forwards traffic to your local server.
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
# 🌍 Custom Subdomain
|
|
58
|
+
|
|
59
|
+
You can request a specific subdomain using the `-s` option.
|
|
60
|
+
|
|
61
|
+
Example:
|
|
62
|
+
|
|
63
|
+
```bash id="fd4d18"
|
|
64
|
+
quvur http 3000 -s myapp
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
Your application will be accessible through a custom subdomain provided by the Quvur gateway.
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
# 📖 Usage
|
|
72
|
+
|
|
73
|
+
```bash id="v7m59e"
|
|
74
|
+
quvur <command> [options]
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
# 🧰 Commands
|
|
80
|
+
|
|
81
|
+
## http
|
|
82
|
+
|
|
83
|
+
Start an HTTP tunnel to expose a local web server.
|
|
84
|
+
|
|
85
|
+
```bash id="g3mt6r"
|
|
86
|
+
quvur http <port> [options]
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
Example:
|
|
90
|
+
|
|
91
|
+
```bash id="i3qk39"
|
|
92
|
+
quvur http 3000
|
|
93
|
+
quvur http 5173 -s myapp
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## auth
|
|
99
|
+
|
|
100
|
+
Authenticate with the Quvur server.
|
|
101
|
+
|
|
102
|
+
```bash id="8q14o2"
|
|
103
|
+
quvur auth
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## logout
|
|
109
|
+
|
|
110
|
+
Remove the stored authentication token.
|
|
111
|
+
|
|
112
|
+
```bash id="7x6m2o"
|
|
113
|
+
quvur logout
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## config
|
|
119
|
+
|
|
120
|
+
Load or reset CLI configuration.
|
|
121
|
+
|
|
122
|
+
```bash id="9z0m8d"
|
|
123
|
+
quvur config
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
Reset configuration:
|
|
127
|
+
|
|
128
|
+
```bash id="7d5a1s"
|
|
129
|
+
quvur config --reset
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
# 📌 Notes
|
|
135
|
+
|
|
136
|
+
- Only **HTTP tunneling** is currently supported.
|
|
137
|
+
- TCP tunneling may be added in future releases.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "quvur-dev",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.3",
|
|
4
4
|
"description": "A lightweight developer tunneling CLI that securely exposes local HTTP and TCP services to the internet via a remote gateway.",
|
|
5
5
|
"license": "ISC",
|
|
6
6
|
"author": "Muhammadali Yuldoshev <mukhammadaliweb@gmail.com>",
|