CLAUDE.md

1# Screenshot Tool for LLMs
2 
3## Quick Usage
4 
5Use the Bash tool to run screenshot commands:
6 
7```bash
8cd /home/thakala/go/src/github.com/tphakala/birdnet-go/frontend/tools
9node screenshot.js http://192.168.4.152:8080/ui/dashboard
10```
11 
12## Common Commands
13 
14```bash
15# Dashboard screenshot (default 1400x1800)
16node screenshot.js http://192.168.4.152:8080/ui/dashboard
17 
18# Analytics page
19node screenshot.js http://192.168.4.152:8080/ui/analytics -o analytics.png
20 
21# Settings page with custom dimensions
22node screenshot.js http://192.168.4.152:8080/ui/settings -w 1920 -h 1080
23 
24# Mobile viewport
25node screenshot.js http://192.168.4.152:8080/ui/dashboard -w 390 -h 844 -o mobile-dashboard.png
26 
27# Tablet viewport
28node screenshot.js http://192.168.4.152:8080/ui/dashboard -w 768 -h 1024 -o tablet-dashboard.png
29```
30 
31## Parameters
32 
33- `<url>` - Required URL to screenshot
34- `-o, --output <file>` - Output filename (auto-generated if not specified)
35- `-w, --width <pixels>` - Viewport width (default: 1400)
36- `-h, --height <pixels>` - Viewport height (default: 1800)
37- `--no-fullpage` - Capture viewport only instead of full page
38 
39## Output Location
40 
41Screenshots are saved to `../doc/` relative to the script (i.e., `frontend/doc/`)
42 
43## Error Handling
44 
45- Script will timeout after 60 seconds
46- Will create output directory if it doesn't exist
47- Returns proper exit codes for automation
48 
49## Viewport Standards
50 
51Use these standard viewports for consistent testing:
52 
53- **Desktop**: 1400x1800 (default)
54- **Large Desktop**: 1920x1080
55- **Tablet**: 768x1024
56- **Mobile**: 390x844
57 
58## Tips for LLMs
59 
601. Always `cd` to the tools directory first
612. Use descriptive output filenames for documentation
623. Check if screenshot was successful by looking for success message
634. Screenshots are automatically saved to frontend/doc/ for easy access
64