# CartLens Protocol: High-Fidelity AI Shopping Instrument Most people leave the store having no idea if they paid a fair price. CartLens fixes that. Scan any receipt or price tag — any store, any category — and get an instant verdict in seconds: did you overpay, and where nearby is cheaper? Powered by the Geospatial Lattice: a live price index built from real receipts, from real shoppers, near you. Not web scrapers. Not delivery apps. Real receipts. Every scan feeds the Lattice, making verdicts smarter for every user. ## Core Documentation ### [Core Technology & Heuristics](/llms/core-technology.md) The technical foundation of CartLens. Details the **Vision-to-State (Heuristic 2.1)** protocol for neural SKU extraction (99.8% precision), the **Geospatial Lattice** (crowdsourced ground-truth prices), and the **Asymmetric Inference Stack** which routes tasks between Gemini 2.0 Flash, 2.5 Pro, and 3.0 Pro to maximize margins and performance. Includes the **Leakage Protocol** for tracking inefficient spending and the **Sovereign Protocol** for data privacy. ### [Technical Stack & Infrastructure](/llms/tech-stack.md) A modern, real-time architecture utilizing **React 19**, **Vite**, and **Tailwind CSS v4**. It leverages **Supabase (PostgreSQL)** for real-time state synchronization, **Clerk** for identity resolution, and **Leaflet.js** for geospatial visualization. The app is a fully optimized **PWA** with 5s background sync pulses and "Midnight Precision" design standards. --- ## Public Interface Nodes ### [Landing Page Overview (/)](/llms/landing-page.md) The primary entry point and capability matrix. It outlines the **12 Nodes of Excellence**, including Global Intelligence (11 locales), Signal Ripple (price gouging detection), and the Optimization Score Gauge. It visualizes the three-phase user loop: Capture (Scan), Analysis (Battle), and Result (Audit). ### [Brand Protocol & Identity (/brand)](/llms/brand-protocol.md) Defines the **"Midnight Precision"** aesthetic. Includes the high-contrast palette (Emerald, Charcoal, Slate), typography standards (Outfit, JetBrains Mono, Instrument Serif), and the "Weighted Precision" motion guidelines. It establishes the brand pillars: Sovereignty, Inference, and Geospatial accuracy. ### [Strategic Pitch Deck (/deck)](/llms/pitch-deck.md) The investment thesis for a $32T market. Details the **$2,400/yr Spending Leakage** problem, the SaaS monetization tiers (Free, Pro, Ultra), financial projections (90%+ margins), and the long-term roadmap toward agentic checkout and predictive replenishment. ### [Global PLU Registry (/plu)](/llms/plu-registry.md) A developer-ready dataset of **1,400+ produce records**. Includes variety identification (e.g., Honeycrisp vs. Gala), emoji mappings, and a public, unauthenticated API for read-only access to global PLU codes and categories. ### [Intelligence Protocol Blog (/blog)](/llms/blog.md) The CartLens editorial layer. Publishes field analysis, product intelligence, and Geospatial Lattice findings. Posts are sourced from real crowdsourced receipt data. Route `/blog` lists all published posts; `/blog/:slug` serves individual articles with `BlogPosting` structured data, full HTML content, author attribution, and tag filtering. ### [Newsroom PR & Press HQ (/newsroom)](/llms/newsroom.md) The official CartLens corporate newsroom and public relations pipeline. Hosts Press Releases, executive Q&A Interviews, and platform announcements. Includes layout variants tailored to specific media types, direct author attribution, dynamic script-based form embed engines for corporate intake forms, and automated integration with dynamic sitemap indexes. ### [Neural FAQ (/faq)](/llms/faq.md) System knowledge base for the CartLens protocol. Provides structured intelligence regarding Spending DNA, the Geospatial Lattice, Sovereign Data protection, and Lattice Rewards. ### [Privacy & Terms (/privacy & /terms)](/llms/privacy-policy.md) The legal and ethical framework. Highlights the **Sunset Protocol** (guaranteed 100% data purging), the **Export Protocol** (JSON portability), and the AI Advisory status (informational recommendations). It enforces data sovereignty and anonymous lattice contribution. --- ## Discovery Interface Nodes ### [Discovery Node: Item Prices](/llms/discovery-prices.md) A dynamic interface for identifying the **Market Floor** for specific items. It resolves SKUs via Heuristic 2.1 and maps regional price fragments across local merchants, providing a **Lattice Confidence Score** based on data freshness. ### [Discovery Node: Cheapest Stores](/llms/discovery-stores.md) Geospatial optimization for merchants. It identifies which stores are the dominant "Price Champions" in a city and provides **Store Efficiency Scores** based on how their pricing aligns with the global lattice floor. ### [Discovery Node: Price History](/llms/discovery-history.md) Temporal price intelligence. Tracks the fluctuation of the market floor over time, identifying **Signal Ripples** (sudden price shifts) and providing historical context for the Master Insight audits. ### [Discovery Node: Price Battle](/llms/discovery-battle.md) Competitive merchant duels. Allows side-by-side comparison of realized prices for specific items or baskets between competing local merchants to calculate potential spending leakage. --- ## Authenticated Interface Nodes (The Control Plane) ### [Dashboard (/home)](/llms/dashboard.md) The master control plane. Features **Master Intelligence** (Gemini 3.0 Pro audits), the **Restock Radar** (predictive supply replenishment), and the **Live Geospatial Lattice** heatmap for Ultra users to monitor real-time price fragments. ### [Logbook (/home/history)](/llms/logbook.md) The archival "Spending DNA" log. Includes the **Digital Receipt Protocol** for reconstructing shopping trips into scannable Code 128 records, geospatial trip mapping, and itemized leakage/savings tracking for every recorded event. ### [Price Battle (/home/comparison)](/llms/price-battle.md) High-intelligence optimization tools. Includes the **Basket IQ** engine for simulating entire shopping lists and the **Global IQ** mode (Ultra only) for fetching real-time crowdsourced lattice prices across a 15-mile radius. ### [Intelligence Calibration (/home/settings)](/llms/calibration.md) Technical customization of the inference engine. Allows users to calibrate their **Intelligence Horizon** (temporal depth) and **Discovery Radius**, manage their credit balance, and customize their **AI Persona** (Frugal, Analyst, etc.) and Manifesto rules. --- ## Identity & Mission **Precision. Optimization. Intelligence.** CartLens is building the physical economy infrastructure by empowering users with the data sovereignty required to defeat market opacity.