@upsnap/strapi 1.0.0 β†’ 1.0.1

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 CHANGED
@@ -1,245 +1,110 @@
1
- # πŸš€ Upsnap – Advanced Website Health Monitoring for Strapi
1
+ # UpSnap
2
2
 
3
- > Enterprise-grade website monitoring directly inside your Strapi Admin Panel.
3
+ A lightweight, all-in-one monitoring plugin for Strapi that keeps your site healthy, secure, and fast.
4
4
 
5
- Upsnap is a powerful monitoring plugin for Strapi that enables you to track uptime, SSL certificates, broken links, performance health, domain integrity, and mixed content issues β€” all from a clean, real-time dashboard inside your CMS.
5
+ ## Description
6
+ UpSnap delivers real-time monitoring and actionable insights so you can detect downtime, performance issues, and security risks before they impact your users.
6
7
 
7
- Designed for agencies, SaaS platforms, and enterprise teams.
8
+ ## Core Monitoring Features
9
+ πŸ” Reachability monitoring with uptime tracking, response times, HTTP status checks, and historical trends
10
+ πŸ”’ SSL/TLS certificate validation with expiry alerts and security checks
11
+ πŸ”— Broken link scanning for internal and external URLs
12
+ πŸ“Š Google Lighthouse analysis with Performance, Accessibility, Best Practices, and SEO scores
13
+ 🌐 Domain health checks including DNS validation and expiry monitoring
14
+ πŸ”„ Mixed content detection to identify insecure resources on HTTPS pages
8
15
 
9
16
  ---
10
17
 
11
- ## ✨ Why Upsnap?
18
+ ## 🌍 Multi-Region Monitoring
19
+ Monitor your website from multiple global locations to detect regional downtime, latency issues, and real user impact across different geographies.
12
20
 
13
- Modern websites fail silently β€” expired SSL, broken internal links, mixed content errors, slow response times.
14
- Upsnap helps you detect issues before your users do.
21
+ ## πŸ“‘ Public Status Page Monitoring
22
+ Create and share public status pages to display uptime, performance history, and live monitoring stats with your users or clients.
15
23
 
16
- βœ” Monitor multiple domains
17
- βœ” Detect critical infrastructure issues
18
- βœ” Visual health dashboard inside Strapi
19
- βœ” Built for Strapi v5 architecture
24
+ ## 🚨 Incidents Lists & Reporting
25
+ Track monitoring incidents with detailed timelines, status history, recovery tracking, and per-monitor reporting for better visibility and troubleshooting.
20
26
 
21
- ---
22
-
23
- ## πŸ“¦ Installation
24
-
25
- Install via npm:
26
-
27
- ```bash
28
- npm install @upsnap/strapi
29
- ```
30
-
31
- or via yarn:
32
-
33
- ```bash
34
- yarn add @upsnap/strapi
35
- ```
27
+ ## πŸ”” Rich Notification Integrations
28
+ Get real-time alerts through multiple channels:
29
+ Email
30
+ Slack
31
+ Discord
32
+ SMS
33
+ Telegram
34
+ Google Chat
35
+ Microsoft Teams
36
+ Webhooks
37
+ PagerDuty
38
+ Zapier
39
+ …and more integrations coming soon.
36
40
 
37
- Restart Strapi:
38
-
39
- ```bash
40
- npm run develop
41
- ```
41
+ ## 🌐 Website Monitoring
42
+ Comprehensive website health monitoring including availability, performance checks, SSL status, and content integrity monitoring in one place.
42
43
 
43
- Upsnap will appear in your admin sidebar.
44
+ **UpSnap** helps Strapi developers, agencies, and site owners maintain reliable, secure, and high-performing websites - all from a simple, integrated dashboard.
44
45
 
45
46
  ---
46
47
 
47
- ## βš™οΈ Requirements
48
-
48
+ ## Requirements
49
49
  - Strapi v5.x
50
- - Node.js 18+
50
+ - Nodejs ">=18.0.0 <=22.x.x"
51
51
  - React 18 (provided by Strapi)
52
52
 
53
- ---
54
-
55
- ## πŸ›  Features
56
53
 
57
- ### 🌐 Uptime Monitoring
58
- - HTTP status validation
59
- - Response time measurement
60
- - Availability tracking
61
-
62
- ### πŸ” SSL Certificate Monitoring
63
- - Expiry date detection
64
- - Certificate validity checks
65
- - Security warnings
66
-
67
- ### πŸ”— Broken Link Detection
68
- - Internal link scanning
69
- - External link validation
70
- - Dead link reporting
71
-
72
- ### ⚑ Performance Health
73
- - Server response analysis
74
- - Latency tracking
75
- - Basic performance indicators
76
-
77
- ### πŸ›‘ Mixed Content Detection
78
- - HTTP resources inside HTTPS pages
79
- - Security vulnerability detection
80
-
81
- ### πŸ“Š Clean Admin Dashboard
82
- - Real-time monitoring overview
83
- - Status visualization
84
- - Health summary per domain
85
-
86
- ---
87
-
88
- ## 🧠 How It Works
89
-
90
- Upsnap performs secure server-side checks:
91
-
92
- 1. Fetches target domain
93
- 2. Validates HTTP status
94
- 3. Inspects SSL certificate
95
- 4. Scans DOM for broken links
96
- 5. Detects mixed content
97
- 6. Measures response metrics
98
-
99
- All results are aggregated and displayed within Strapi's admin interface.
100
-
101
- ---
102
-
103
- ## πŸ”§ Configuration
104
-
105
- After installation:
106
-
107
- 1. Go to **Settings β†’ Plugins β†’ Upsnap**
108
- 2. Add your target domains
109
- 3. Configure monitoring options
110
- 4. Save and start monitoring
111
-
112
- ---
113
-
114
- ## πŸ“Š Use Cases
115
-
116
- - SaaS platforms managing multiple domains
117
- - Agencies maintaining client websites
118
- - DevOps monitoring dashboards
119
- - Enterprise content systems
120
- - Website audit automation
121
-
122
- ---
123
-
124
- ## πŸ— Development
54
+ ## πŸ“¦ Installation
125
55
 
126
- Clone the repository:
56
+ Install via npm:
127
57
 
128
58
  ```bash
129
- git clone https://github.com/Appfoster/upsnap-strapi
59
+ npm install @upsnap/strapi
130
60
  ```
131
61
 
132
- Install dependencies:
62
+ or via yarn:
133
63
 
134
64
  ```bash
135
- npm install
65
+ yarn add @upsnap/strapi
136
66
  ```
137
67
 
138
- Build plugin:
68
+ Enable it in confing/plugins:
139
69
 
140
70
  ```bash
141
- npm run build
71
+ upsnap: {
72
+ enabled: true,
73
+ }
142
74
  ```
143
75
 
144
- Watch mode (for development):
76
+ Restart Strapi:
145
77
 
146
78
  ```bash
147
- npm run watch
148
- ```
149
-
150
- ---
151
-
152
- ## πŸ“ Project Structure
153
-
154
- ```
155
- /admin β†’ Admin UI (React)
156
- /server β†’ Backend logic
157
- /dist β†’ Compiled output (published to npm)
79
+ npm run develop
158
80
  ```
159
81
 
160
- ---
161
-
162
- ## πŸ”’ Security
163
-
164
- - Runs server-side within Strapi
165
- - No external tracking
166
- - No third-party data storage
167
- - Respects Strapi permission system
168
-
169
- ---
170
-
171
- ## 🧩 Compatibility
172
-
173
- | Strapi Version | Supported |
174
- |----------------|------------|
175
- | v5.x | βœ… Yes |
176
- | v4.x | ❌ No |
177
-
178
- ---
179
-
180
- ## πŸ§ͺ Production Readiness
181
-
182
- - Built using Strapi Plugin SDK
183
- - Peer dependency aligned with Strapi v5
184
- - TypeScript support
185
- - Modular architecture
186
- - Designed for scalability
187
-
188
- ---
189
-
190
- ## πŸ“„ License
191
-
192
- MIT License
193
-
194
- ---
195
-
196
- ## πŸ‘¨β€πŸ’» Author
197
-
198
- **Appfoster**
199
- Website: https://upsnap.ai
200
- Email: support@upsnap.ai
201
-
202
- ---
203
-
204
- ## 🌍 Roadmap
205
-
206
- - Scheduled monitoring (cron-based)
207
- - Email / Slack alerts
208
- - Historical monitoring logs
209
- - Public status page integration
210
- - Performance scoring system
211
-
212
- ---
213
-
214
- ## 🀝 Contributing
215
-
216
- Contributions are welcome.
82
+ Upsnap will appear in your admin sidebar.
217
83
 
218
- 1. Fork the repository
219
- 2. Create your feature branch
220
- 3. Commit changes
221
- 4. Open a pull request
84
+ ## πŸ”§ Configuration
222
85
 
223
- ---
86
+ ## Quick Setup Guide
224
87
 
225
- ## ⭐ Support
88
+ After installing the plugin and restarting Strapi:
226
89
 
227
- If you find Upsnap useful:
90
+ 1. Go to **Upsnap β†’ Settings β†’ API Token**
91
+ Add your API Token from https://upsnap.ai website
228
92
 
229
- - Star the repository
230
- - Share with your team
231
- - Submit feature requests
232
- - Report issues
93
+ 2. Add a new monitor
94
+ or select a primary monitor if one is already created
233
95
 
234
- ---
96
+ 3. Configure monitoring options
235
97
 
236
- ## πŸ“Œ About Strapi
98
+ 4. Save and go to dashboard
237
99
 
238
- Upsnap is built for Strapi β€” the leading open-source headless CMS.
239
100
 
240
- Learn more at: https://strapi.io
101
+ ## Documentation
102
+ [Full Documentation](https://github.com/Appfoster/upsnap/wiki)
241
103
 
242
- ---
104
+ ## Issue Tracking
105
+ [GitHub Issues](https://github.com/Appfoster/upsnap-strapi/issues)
106
+ [Changelog](https://github.com/Appfoster/upsnap/blob/main/CHANGELOG.md)
243
107
 
244
- Built with precision. Designed for reliability.
245
- Monitor smarter with Upsnap.
108
+ ## Contact
109
+ **Email**: support@upsnap.ai
110
+ **Website**: [UpSnap](https://upsnap.ai/)