Monitoring Policy
Stackshield monitors public Laravel repositories to help the ecosystem improve its security posture. Here's exactly what we do, what's visible, and how to opt out.
What we scan
Stackshield scans the top 500 Laravel open source projects on GitHub, ranked by a combination of stars, Packagist downloads, and ecosystem significance. We run 40 framework-aware security checks covering code patterns, route configuration, environment settings, filesystem exposure, and dependencies.
What's public
- A-list: Projects that score A-grade are listed publicly. Sorted alphabetically, no numeric scores.
- Scanned directory: All scanned repos are listed by name. No scores, no findings, no grades for non-A projects.
- Ecosystem stats: Aggregate numbers across all scanned repos. No individual project is ever named.
What's private
Full findings, severity breakdowns, file locations, and remediation guidance are only visible to verified maintainers who claim their repo via GitHub OAuth. We never display B/C/D grades publicly.
How to opt out
Two mechanisms, both honored unconditionally:
1. stackshield.yaml (recommended)
Add a stackshield.yaml file to your repository root:
# stackshield.yaml
monitoring:
indexed: false # remove from public scanned directory
a_list: false # do not include in A-list even if eligible
scanning: false # do not scan at all
Settings are checked on every scan cycle and respected immediately. Set any combination of these flags to control your visibility.
2. Manual removal
Email monitoring@stackshield.io with your repository name. Requests are honored within 24 hours, permanently, with no verification beyond a plausible maintainer claim.
Data retention
We store scan results for historical comparison. Cloned repositories are deleted immediately after scanning. When a maintainer opts out, all scan data is deleted within 24 hours.
Questions?
Reach out at monitoring@stackshield.io. We're committed to making this process transparent and respectful of maintainer preferences.