How titarek/pagelens works
PageLens accepts a URL and inspection mode, validates the target, runs static analysis and—when requested—headless rendering, then presents a scored report with diagnostics, security findings, resources, and export/source-inspection options. The frontend’s report page polls for job completion. The README documents additional audit and dashboard capabilities; unsampled implementation details are represented only where documented, and uncertain links are omitted.
Main entry points: analyzer.py Analysis Orchestrator · report.py Report Schema · Report.tsx Report View · routes_analyze.py Analysis Routes
Components 25
Analysis Dashboard
- Analysis Form
frontend/src/pages/Home.tsx - API Client
frontend/src/lib/api.ts - Report View
frontend/src/pages/Report.tsx - Report Widgets
frontend/src/components - Source Inspector
frontend/src/components/ScrapedSourceViewer.tsx - Interactive Explorer
frontend/src/components/InteractiveExplorer.tsx - App Router
frontend/src/App.tsx
API and Jobs
- Analysis Routes
backend/app/api/routes_analyze.py - Report Routes
backend/app/api/routes_report.py - SSRF Guard
backend/app/core/security.py - Job Cache
backend/app/core/cache.py
Site Inspection
- Analysis Orchestrator
backend/app/services/analyzer.py - HTTP Fetcher
backend/app/scraper/fetcher.py - HTML Parser
backend/app/scraper/parser.py - CSS Collector
backend/app/scraper/css_collector.py - Headless Renderer
backend/app/renderer/playwright_runner.py
Metrics and Reports
- Structural Metrics
backend/app/metrics/structural.py - Timing Metrics
backend/app/metrics/timing.py - Rule Diagnostics
backend/app/metrics/shortcomings.py - Security Audit
backend/app/security/audit.py - Score Calculator
backend/app/metrics/scoring.py - Report Schema
backend/app/schemas/report.py - PDF Exporter
backend/app/services/pdf_exporter.py
Other components
- Developer
- Target Website
Connections 34
- Developer → Analysis Form: submits URL
frontend/src/pages/Home.tsx - App Router → Analysis Form: routes to
frontend/src/App.tsx - App Router → Report View: routes to
frontend/src/App.tsx - Analysis Form → API Client: submits analysis
frontend/src/pages/Home.tsx - Report View → API Client: polls report
frontend/src/pages/Report.tsx - Report View → Report Widgets: renders findings
frontend/src/pages/Report.tsx - Report View → Source Inspector: renders source
frontend/src/pages/Report.tsx - Report View → Interactive Explorer: renders explorer
frontend/src/pages/Report.tsx - API Client → Analysis Routes: HTTP JSON
README.md - API Client → Report Routes: fetches reports
README.md - Analysis Routes → SSRF Guard: validates URL
backend/app/api/routes_analyze.py - Analysis Routes → Job Cache: stores job
backend/app/api/routes_analyze.py - Analysis Routes → Analysis Orchestrator: schedules analysis
backend/app/api/routes_analyze.py - Analysis Routes → Headless Renderer: simulates interaction
backend/app/api/routes_analyze.py - Report Routes → Job Cache: reads job
backend/app/api/routes_report.py - Report Routes → Report Schema: validates report
backend/app/api/routes_report.py - Report Routes → PDF Exporter: generates PDF
backend/app/api/routes_report.py - Analysis Orchestrator → HTTP Fetcher: fetches page
backend/app/services/analyzer.py - Analysis Orchestrator → HTML Parser: parses HTML
backend/app/services/analyzer.py - Analysis Orchestrator → CSS Collector: collects CSS
backend/app/services/analyzer.py - Analysis Orchestrator → Headless Renderer: renders deep mode
backend/app/services/analyzer.py - HTTP Fetcher → Target Website: requests page
README.md - Headless Renderer → Target Website: renders page
README.md - Analysis Orchestrator → Structural Metrics: calculates structure
backend/app/services/analyzer.py - Analysis Orchestrator → Rule Diagnostics: checks rules
backend/app/services/analyzer.py - Analysis Orchestrator → Score Calculator: calculates score
backend/app/services/analyzer.py - Analysis Orchestrator → Security Audit: audits security
backend/app/services/analyzer.py - Headless Renderer → Timing Metrics: collects timings
backend/app/renderer/playwright_runner.py - Analysis Orchestrator → Report Schema: builds report
backend/app/services/analyzer.py - Score Calculator → Report Schema: sets score fields
backend/app/metrics/scoring.py - Structural Metrics → Report Schema: produces metrics
backend/app/metrics/structural.py - Rule Diagnostics → Report Schema: produces findings
backend/app/metrics/shortcomings.py - Security Audit → Report Schema: produces audit
backend/app/security/audit.py - Timing Metrics → Report Schema: produces timings
backend/app/metrics/timing.py