tui-trends 1.0.0
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 +60 -0
- package/dist/cli.js +46297 -0
- package/package.json +33 -0
package/README.md
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# tui-trends
|
|
2
|
+
|
|
3
|
+
Cyberpunk Google Trends visualizer in your terminal.
|
|
4
|
+
|
|
5
|
+
## Install globally
|
|
6
|
+
|
|
7
|
+
**From npm (once published):**
|
|
8
|
+
```bash
|
|
9
|
+
npm install -g tui-trends
|
|
10
|
+
tui-trends "buy bitcoin"
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
**From this repo (no npm publish needed):**
|
|
14
|
+
```bash
|
|
15
|
+
npm install
|
|
16
|
+
npm run build
|
|
17
|
+
npm install -g .
|
|
18
|
+
tui-trends "buy bitcoin"
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
**One-off without installing:**
|
|
22
|
+
```bash
|
|
23
|
+
npx tui-trends "buy bitcoin"
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Development
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
npm install
|
|
30
|
+
npm start -- "buy bitcoin" # runs via tsx, no build step
|
|
31
|
+
npm run dev -- "buy bitcoin" # tsx watch mode, reloads on save
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Keybindings
|
|
35
|
+
|
|
36
|
+
| Key | Action |
|
|
37
|
+
|-----|--------|
|
|
38
|
+
| `q` | Quit |
|
|
39
|
+
| `r` | Refresh / re-fetch data |
|
|
40
|
+
| `↑ ↓` | Scroll the related queries table |
|
|
41
|
+
|
|
42
|
+
## What you'll see
|
|
43
|
+
|
|
44
|
+
- **Loading screen** — animated spinner with ASCII art banner while data is fetched
|
|
45
|
+
- **Interest Over Time** — braille-rendered line chart (0–100 scale, last 12 months)
|
|
46
|
+
- **Top Regions** — horizontal bar chart of countries with highest search interest
|
|
47
|
+
- **Related Queries** — scrollable table of related search terms and their scores
|
|
48
|
+
|
|
49
|
+
## Stack
|
|
50
|
+
|
|
51
|
+
- [Rezi](https://rezitui.dev) — TypeScript TUI framework with native C rendering engine
|
|
52
|
+
- [google-trends-api](https://www.npmjs.com/package/google-trends-api) — unofficial Google Trends client
|
|
53
|
+
- [figlet](https://www.npmjs.com/package/figlet) — ASCII art banner
|
|
54
|
+
- [tsx](https://github.com/privatenumber/tsx) — run TypeScript directly
|
|
55
|
+
|
|
56
|
+
## Notes
|
|
57
|
+
|
|
58
|
+
- Requires an internet connection (hits `trends.google.com` directly)
|
|
59
|
+
- Google Trends may rate-limit requests if called too frequently
|
|
60
|
+
- Best displayed in a terminal at least 120 columns wide
|