How sp4chi/landing-iq works
LandingIQ audits landing pages and turns URL, pasted copy, description, or screenshot inputs into CRO recommendations, reports, and follow-up AI guidance. The principal flow runs from the dashboard through the analysis API and its visual, generative, and deterministic analysis layers to results and saved history. The README documents screenshot fallback, SEO/accessibility, copy optimization, and multiple AI providers; some implementation wiring is unsampled, so only documented or evidenced relationships are shown.
Main entry points: server/index.ts Express API · App.tsx App shell · analyzer.ts Audit endpoint · db/index.ts Database service
Components 21
User experience
- App shell
src/App.tsx - Audit inputs
src/pages/DashboardPage.tsx - Audit results
src/pages/ResultsPage.tsx - CRO Copilot
src/components/ChatCopilot.tsx - Report history
src/pages/HistoryPage.tsx - Account settings
src/pages/AccountPage.tsx - Sign-in UI
src/pages/AuthPage.tsx
API and analysis
- Express API
server/index.ts - Audit endpoint
server/analyzer.ts - Page capture
server/vision.ts - Local NLP metrics
server/ml-analysis.ts - AI provider layer
server/ai-provider.ts - Chat endpoint
server/chat.ts
Identity and reports
- Authentication
server/auth.ts - Report endpoints
server/reports.ts - Database service
src/db/index.ts
External services
- Audited webpage
- AI providers
- PostgreSQL
- Screenshot fallback APIs
Other components
- LandingIQ user
Connections 28
- LandingIQ user → App shell: uses
- App shell → Audit inputs: renders
- App shell → Sign-in UI: renders
- App shell → Audit results: renders
- App shell → Report history: renders
- App shell → Account settings: renders
- Audit inputs → Express API: submits audit
- Express API → Audit endpoint: dispatches
- Audit endpoint → Page capture: requests capture
- Page capture → Audited webpage: renders page
- Page capture → Screenshot fallback APIs: fetches screenshot
- Audit endpoint → AI provider layer: requests audit
- Audit endpoint → Local NLP metrics: computes metrics
- AI provider layer → AI providers: sends prompts
- Audit endpoint → Database service: saves report
- Express API → Authentication: dispatches
- Sign-in UI → Authentication: authenticates
- Authentication → Database service: reads/writes users
- Audit results → CRO Copilot: offers chat
- CRO Copilot → Express API: sends messages
- Express API → Chat endpoint: dispatches
- Chat endpoint → AI provider layer: requests response
- Report history → Express API: loads reports
- Account settings → Express API: manages account
- Express API → Report endpoints: dispatches
- Report endpoints → Database service: reads/writes reports
- Database service → PostgreSQL: queries
- Audit endpoint → Audit results: returns audit