How banujanr29/website-audit-ai works
PagePulse AI is a single-page website auditing application. A user submits a URL through the Next.js interface; the backend fetches and parses the page, extracts factual metrics, calculates a score, and requests grounded insights and prioritized recommendations from Gemini. The frontend presents the combined report and exposes prompt logs. The README documents the full analysis stages; sampled source confirms the API entry point, frontend request hook, and Gemini request/parsing behavior. Some frontend rendering and backend orchestration links are documented rather than shown in excerpts.
Main entry points: page.tsx Audit page · AuditServiceImpl.java Audit orchestration · api.ts API client · GeminiServiceImpl.java Gemini integration
Components 21
Audit interface
- Audit page
frontend/app/page.tsx - Audit form
frontend/components/audit/AuditForm.tsx - Audit state hook
frontend/hooks/useAudit.ts - API client
frontend/services/api.ts
Audit API
- Audit endpoint
backend/src/main/java/com/eight25/audit/controller/AuditController.java - Audit orchestration
backend/src/main/java/com/eight25/audit/service/impl/AuditServiceImpl.java
Page analysis
- Page fetcher
backend/src/main/java/com/eight25/audit/service/impl/WebsiteScraperServiceImpl.java - Metrics extractor
backend/src/main/java/com/eight25/audit/service/impl/MetricsExtractorServiceImpl.java - Score calculator
backend/src/main/java/com/eight25/audit/service/impl/WebsiteScoreCalculatorImpl.java
AI analysis
- Prompt builder
backend/src/main/java/com/eight25/audit/service/impl/PromptBuilder.java - Gemini integration
backend/src/main/java/com/eight25/audit/service/impl/GeminiServiceImpl.java
Audit report
- Audit response
backend/src/main/java/com/eight25/audit/dto/response/AuditResponse.java - Score overview
frontend/components/audit/ScoreOverview.tsx - Metrics grid
frontend/components/audit/MetricsGrid.tsx - AI insights
frontend/components/audit/AIInsights.tsx - Recommendations
frontend/components/audit/Recommendations.tsx - Prompt transparency
frontend/components/audit/DeveloperDrawer.tsx
Other components
- Website owner
- Browser client
- Target website
- Google Gemini
Connections 21
- Website owner → Audit form: enters URL
README.md - Audit form → Audit state hook: submits URL
- Audit state hook → API client: posts audit
frontend/hooks/useAudit.ts - API client → Browser client: sends REST request
- Browser client → Audit endpoint: POST /api/audit
README.md - Audit endpoint → Audit orchestration: calls audit
backend/src/main/java/com/eight25/audit/controller/AuditController.java - Audit orchestration → Page fetcher: fetches page
README.md - Page fetcher → Target website: fetches HTML
README.md - Audit orchestration → Metrics extractor: extracts metrics
README.md - Audit orchestration → Score calculator: calculates score
README.md - Audit orchestration → Gemini integration: requests insights
README.md - Gemini integration → Prompt builder: builds prompts
backend/src/main/java/com/eight25/audit/service/impl/GeminiServiceImpl.java - Gemini integration → Google Gemini: sends analysis
backend/src/main/java/com/eight25/audit/service/impl/GeminiServiceImpl.java - Audit orchestration → Audit response: assembles report
README.md - Audit response → API client: returns report
- API client → Audit page: provides result
- Audit page → Score overview: renders score
- Audit page → Metrics grid: renders metrics
- Audit page → AI insights: renders insights
- Audit page → Recommendations: renders recommendations
- Audit page → Prompt transparency: shows prompt logs