How created-by-the-creator/surfare-your-digital-safety-assistant works
Surfare is an offline-first digital safety assistant: users submit messages, links, or images for local risk analysis, with consent-enabled online contextual analysis or reputation checks, then receive a classification and guidance. The repository also includes image/OCR and QR capabilities, feedback, and history/settings UI areas. The detector source supports the analysis flow; the sampled React app is only a placeholder, so UI-to-detector wiring is not established. Some capability links are documented in the README but their implementation was not sampled.
Main entry points: index.js API route dispatcher · check-content.js Content workflow · image.js Image review service · detection.js Message and URL detection
Components 25
User experience
- React app
src/App.jsx - Analysis and results
src/pages/Analyze.jsx - History and settings
src/pages/History.jsx
Local analysis
- Detector exports
detectors/index.js - Content workflow
detectors/client/check-content.js - Content assessment
detectors/lib/content-assessment.js - Message and URL detection
detectors/lib/detection.js - Signals and evidence
detectors/lib/safety-signals.js - SMS classification
detectors/lib/sms-model.js - Risk and semantic fusion
detectors/lib/semantic-assessment.js - Safety guidance
detectors/lib/guidance.js - Image processing and OCR
detectors/lib/image-tools.js - Image provenance
detectors/lib/image-provenance.js - QR analysis
detectors/lib
Online analysis
- API route dispatcher
detectors/worker/index.js - Contextual analysis service
detectors/server/services/semantic.js - Structured AI provider
detectors/server/providers/structured.js - Threat reputation check
detectors/server/services/reputation.js - Image review service
detectors/server/services/image.js
Feedback and storage
- Feedback service
detectors/server/services/feedback.js - Feedback storage client
detectors/client/feedback-store.js
Other components
- User
- AI provider
- Threat-checking service
- Supabase storage
Connections 26
- User → React app: uses
- React app → Analysis and results: presents
- Analysis and results → Content workflow: submits content
- Detector exports → Content workflow: exports
detectors/index.js - Content workflow → Content assessment: assesses locally
detectors/client/check-content.js - Content assessment → Message and URL detection: detects indicators
detectors/lib/content-assessment.js - Message and URL detection → Signals and evidence: uses signals
detectors/lib/detection.js - Message and URL detection → SMS classification: classifies message
detectors/lib/detection.js - Content workflow → Risk and semantic fusion: fuses results
detectors/client/check-content.js - Risk and semantic fusion → Safety guidance: guidance capability
- Content workflow → API route dispatcher: posts optional checks
detectors/client/check-content.js - API route dispatcher → Contextual analysis service: routes assess
detectors/worker/index.js - API route dispatcher → Threat reputation check: routes verify
detectors/worker/index.js - API route dispatcher → Image review service: routes image review
detectors/worker/index.js - Contextual analysis service → Structured AI provider: generates assessment
detectors/server/services/semantic.js - Image review service → Structured AI provider: generates image review
detectors/server/services/image.js - Contextual analysis service → AI provider: requests analysis
- Image review service → AI provider: requests image review
- Threat reputation check → Threat-checking service: checks URLs
- Image processing and OCR → Image review service: optional online review
- Image provenance → Image review service: optional review
- QR analysis → Content assessment: evaluates extracted content
README.md - Feedback storage client → API route dispatcher: submits feedback
- API route dispatcher → Feedback service: routes feedback
detectors/worker/index.js - Feedback service → Supabase storage: writes or withdraws
detectors/server/services/feedback.js - History and settings → Feedback storage client: feedback capability