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.
Files changed (2) hide show
  1. package/README.md +137 -0
  2. 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.2",
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>",