Changelog
What's New in Geogrid
All the latest features, improvements, and fixes shipped to Geogrid.
Scan calendar view
A new monthly grid surfaces every scan you've ever run, with KPIs for the month, status filters, and a click-through day-detail panel. Find the week you launched a scan in two clicks.
Keyword Gap Finder
Spot every keyword where competitors outrank you across your scan history, sorted by opportunity score. Expand any row to see the full competitor list, or rescan in one click.
Rank drop thresholds
Set a per-schedule visibility-points threshold and a custom recipient email. Geogrid sends an alert the moment a recurring scan dips below the bar — slider + presets directly in the schedules page.
Competitor heatmap overlay
Pick any competitor on a scan and switch to heatmap mode — the grid recolors by their rank, side-by-side with yours. Built-in to the existing scan map, no extra clicks.
Weekly AI digest email
Every Monday morning, an opt-in 1-minute recap of your week — KPIs, top movers, and 3 AI-generated priorities powered by Haiku. Toggle from Settings → Preferences.
Auto AI Insights post-scan
Opt-in for Freelance, Agency and Enterprise plans: every completed scan gets AI Insights generated in the background — ready the moment you open the scan. Costs about $0.003 per scan in Haiku usage.
PWA — install Geogrid as an app
Service worker now caches the dashboard shell and assets, with a clean /offline fallback. Install Geogrid to your home screen for full-screen, app-like usage with shortcuts to New Scan, Calendar and Keyword Gaps.
Google Business Profile integration
Connect your GBP account from Settings → Integrations to overlay real-world metrics (calls, website clicks, directions) directly onto your ranking timeline.
Auto industry tagging
Every new scan is automatically tagged by industry (restaurant, healthcare, legal, home-services…) using AI. Filter your history by industry to spot patterns across clients in the same vertical.
Bulk actions on scan history
Select multiple scans from your history and export them to CSV, rescan them in one click, or delete them in batch. Designed for agencies running weekly client refreshes.
Adaptive savings breakdown
The scan detail panel now shows exactly how the adaptive engine saved you credits — cache hits, smart-seed inferences, water/terrain skips, and probe nodes. Full transparency on every scan.
Granular API key scopes
Create API keys with fine-grained scopes (scans.read, scans.write, credits.read). Give read-only keys to clients, write-enabled keys to your automation, and rotate independently.
Failed-payment notifications
If a recurring charge fails, you now receive an email asking you to update your card before downgrade. Stripe retries for 7 days — we surface the issue early.
Reliability & security pass
Worker now safely handles 21×21 scans without timeouts, automatically refunds credits on failed jobs, and we've tightened auth, encryption, and account-deletion flows across the platform.
New UI Dashboard & Landing Page
A complete visual reinvention of the dashboard. Experience our beautiful new design language featuring elegant typography, immersive edge-to-edge tracking graphs, dynamic grid layouts, and enhanced dark mode aesthetics across all components.
Redesigned Scan Wizard
Step 3 (Grid Config) has been completely redesigned with a clean two-column layout: your business and keyword overview on the left, grid configuration with a live visual heatmap preview on the right. Grid size, radius, and scan mode are now simple pill selectors — no more dropdowns. The Adaptive mode badge clearly shows it's recommended, and a real-time stats row gives you instant feedback on nodes, credits, and estimated scan time.
Custom Market Selector
The market (country) picker in Advanced Settings now features a beautiful custom dropdown with country flag emojis, dark-themed styling, and instant selection — replacing the default browser dropdown that looked inconsistent across operating systems.
Faster Business Search
Business search results are now cached for 7 days. If someone else already searched for the same keyword in your area, you get instant results with zero wait time. Repeat searches during your session are also cached locally for immediate navigation between wizard steps.
Mountain & Unpopulated Area Detection
Our scan engine now actively detects high-altitude mountains and unpopulated terrains, intelligently dropping unneeded scan zones to protect your credits and improve overall scanning efficiency.
Water Detection V7
Massive improvement to coastal and deep water mapping accuracy. Substantially reduces false positives near complex island clusters and correctly handles overlapping water boundaries.
Blog & Deep SEO Audit
Launched the new official Geogrid Blog with deep-dive guides into local SEO. We also finalized critical technical SEO implementations across all routes including proper i18n routing, static OG metadata, and sitemaps.
Unified Dashboard Shell
Every dashboard page now renders inside a single shared shell: persistent sidebar with collapse (220px/52px), dynamic breadcrumb topbar, and real-time credit counter. No more duplicated navbars or back-arrow links across pages — consistent, clean layout everywhere.
Dedicated Scan History Page
New /dashboard/scans route with full-featured scan management. Filter by status, keyword, or tag. Sort by newest, oldest, or score. Bulk-select scans for mass deletion. Inline cancel for running scans, inline delete with confirmation, pin favorites to the top, and sparkline trend charts on every row.
Global Scan Wizard Modal
The ‘New Scan’ wizard is now a global modal accessible from any dashboard page via the topbar button. No more URL redirect workaround — it’s a proper AnimatePresence-powered overlay with smooth open/close transitions, available on every route.
Landing Prospect Tracker
New analytics infrastructure for tracking prospect engagement on the landing page. Landing events are stored in a dedicated table (migration 034) and surfaced in the new /dashboard/insights page with conversion funnels and traffic breakdowns.
Scan Engine Tune-Up
Improved scan reliability: p-limit(5) concurrency control for Serper API calls, toFixed(5) coordinate alignment for cache key consistency, and water detection V6 with a 3-second timeout (Overpass removed). Scans are faster and more cache-friendly.
Dashboard UX Polish
Removed all legacy navigation elements (ArrowLeft back links, inline logo+signout bars) from every dashboard page. Deduplicated MiniSparkline into a shared StatusBadge component. Loading states use skeleton placeholders. All pages now feel part of one cohesive app instead of separate screens.
Multi-Location Dashboard
Easily manage multiple clients and franchise locations. The new Locations tab aggregates all your scans by city or custom location names, showing average visibility scores, sparkline trends, and tracked keywords at a glance.
Interactive Scan Annotations
Click directly on your scan maps to drop annotations and notes. Perfect for marking competitor locations, documenting ranking anomalies, or adding context for your clients. Annotations are saved via API and rendered securely.
Webhooks for Slack & Discord
Automate your workflow with configurable webhooks. Enter your Slack or Discord endpoint URL in Settings, and our background worker will seamlessly dispatch rich notification layouts whenever your scans finish processing.
Hybrid Push Notifications
Never miss a completed scan. We've introduced VAPID Web Push notifications that work even when the app is closed, combined with automated in-app Toast notifications powered by Sonner for an immediate, non-intrusive heads-up.
B2B Lead Email Automation
When a prospect completes a free 3x3 widget scan on your agency site, our worker now automatically generates and emails them a beautifully formatted B2B visibility report, keeping your sales loop fully autonomous.
Real Redis Health Checks
The system status page is now 100% dynamic. The health check endpoint performs real IORedis PINGs with timeouts, and the status page auto-generates a 14-day rolling incident history for true transparency.
B2B Lead Generation Widgets
Agencies can now create embeddable, white-labeled widgets to place on their own websites. Prospects run a free 3x3 scan that captures their email, securely deducting credits from the agency's balance while providing hot SEO leads straight to your dashboard.
Share of Local Voice
Transformed raw ranking data into pure market-share metrics. The new Share of Local Voice donut chart shows exactly what percentage of the 'Top 3 Territory' you own compared to your competitors, an instant ROI metric for executives.
Google Business Profile Integration
Connect your Google Business Profile via OAuth to overlay real-world metrics—like direction requests and calls—directly onto your Geogrid Ranking Timeline. Prove exactly how local SEO translates to foot traffic.
Lead Capture on Free Tool
Our public Free Local Rank Checker now requires an email address before revealing scan results. All scans act as a lead magnet, securely capturing prospects into your waitlist dashboard for future outreach.
GPS-Strict Scan Engine
Upgraded the underlying Serper API scanner. We now strip textual location query noise and force strict GPS coordinate bounding (ll=@lat,lng), entirely eliminating 'flat grid' anomalies where only neutral results were returned.
Free Local Rank Checker
Launched a free public tool at /tools/local-rank-check. Users can run up to 3 free 3x3 scans per day to check their Google Maps visibility score, no account required. Perfect for a quick SEO health check.
Multilingual Keyword AI
Replaced static English keyword templates with Claude 3 Haiku generation. Keyword suggestions in the scan wizard are now dynamically generated in the primary language of your business's location.
Locale Override Engine
Added manual country and language override controls in Step 3 of the scan wizard. If the automatic locale detection (hl/gl) misses, you can force the Google Maps query to use your exact targeting.
Pure Dark Mode
Removed the light mode theme entirely for a more focused, premium aesthetic. Geogrid is now a purely dark-mode application from the ground up, reducing bundle size and UI complexity.
Dynamic Social Previews
Completely overhauled our Open Graph image generation. Links shared on LinkedIn, X, and other platforms now display instant, dynamically generated preview cards with aggressive edge caching.
Local Falcon Alternative Page
New dedicated comparison landing page at /alternatives/local-falcon. Feature-by-feature table (11 criteria), pricing comparison, FAQ with JSON-LD schema, and multiple CTAs. Targets high-intent 'local falcon alternative' searches.
SEO Agency Landing Page
New /use-cases/seo-agency landing page tailored for agency decision-makers. Highlights client portals, city comparison, bulk scanning speed, API integration, and agency/enterprise pricing side-by-side.
Client Portals Management UI
New 'Client Portals' tab in Settings. Create branded portals with client name, logo URL, accent color, and scan selection — all from the dashboard. View active portals, open public links, or delete them instantly. Agency plan and above.
Onboarding Email Sequence
Automated 3-step email drip for new signups: Day 0 Welcome (200 credits + first scan guide), Day 3 Tips (AI insights, competitor tracking, scheduled scans), Day 7 Upgrade CTA (plan comparison for free users). Powered by a daily cron + Resend API, with idempotent tracking to prevent double-sends.
SEO Technical Fixes
JSON-LD BreadcrumbList schema on all pages (auto-generated from URL path). Updated meta descriptions from 13×13 to 21×21 across all OG/Twitter tags. robots.txt updated to block /portal routes. All layout descriptions now accurately reflect the 441-point grid capability.
Scan Auto-Naming
Click any scan’s title to give it a custom name like ‘Client Pizza — March 26’. Names appear in the dashboard scan list and scan detail. Edit via click, save with Enter or blur, cancel with Escape.
Client Portal
Create branded read-only portals for your agency clients. Each portal gets a unique shareable link (geogrid.dev/portal/abc123) with your logo, brand color, and selected scans. Clients see heatmap grids, visibility scores, and sub-metrics — no login required. Agency plan and above.
City Comparison
Compare the same keyword across different cities side-by-side. Select up to 4 scans from different locations and see them in a comparison table (score, coverage, top 3, avg rank) plus side-by-side heatmap grids. Available from the new ‘Compare’ button in the dashboard.
Auto Email Reports
Schedule automatic email reports for your scans — daily, weekly, or monthly. Beautiful dark-themed HTML emails with scan scores, AI insights, and a direct link to the dashboard. Supports multiple recipients. Uses Resend API for reliable delivery. Freelance plan and above.
System Status Page
New /status page showing real-time health for all Geogrid systems (Web, API, Worker, Database). Styled like Statuspage.io — 90-day uptime bars, hover tooltips with date + status + check count, live auto-refresh every 60s. Powered by a real monitoring cron (/api/cron/status-check every 5 min) writing to a status_checks table — zero fake data.
API Documentation Audit
Complete audit of the v1 REST API docs. Added previously undocumented params: hl/gl (language & country), diff_from_scan_id (smart rescan), and full grid_data response fields including competitors[] (top 5 per node) and water (boolean). Fixed POST /scans response from 201 → 202 Accepted. Corrected visibility score formula (sum(1/rank) / totalLandNodes). Added 21×21 = 441 credits to the credit cost callout.
Blog SEO Overhaul
All 10 blog articles now include JSON-LD BlogPosting schema for Google rich snippets. Competitor comparison tables updated with verified data: Local Falcon confirmed 21×21, BrightLocal uses IP proxies (grid size undocumented), Whitespark $10/mo credit-based, Semrush 21×21 at $177/mo total, GBP Crush $39.99 + 15×15, Local Viking 9×9. Four stale ‘13×13 max’ mentions corrected to ‘up to 21×21’.
Landing Page — Speed & Grid Differentiators
Hero description now leads with “up to 441 coordinates (21×21 grid)” and “full results in under 90 seconds — 10× faster than competitors”, highlighted in emerald. This directly counters Local Falcon’s same resolution but 10–15 minute scan time.
Ahrefs Web Analytics
Cookieless analytics via Ahrefs Web Analytics integrated in the site layout (afterInteractive loading). No cookie banner required — fully privacy-friendly by design.
Ranking Depth Fix (num: 20)
Critical fix: Serper Places API was only returning ~8 results (Google Local Pack), making rankings binary — either #1 or ‘not found’. Now requesting 20 results per query (same API cost), so businesses can rank #1 through #20 with real granularity. Heatmaps finally show true color gradients instead of all-green or all-gray.
Visibility Sub-Metrics
The Visibility Score panel now shows three sub-metrics below the score ring: Coverage % (how many grid points found the business), Top 3 % (grid points ranked #1-3), and Avg Rank (mean rank where found). Smarter contextual labels: ‘Dominant presence’, ‘Present but low-ranking’, ‘Not found in this area’.
Scan Templates
Save any completed scan as a reusable template directly from the scan detail toolbar. Open a new scan and pick ‘From Template’ to skip to the config step with keyword, location, business, grid size, radius, and tags pre-filled. Stored locally (up to 20 templates), no account sync required. Huge time saver for agencies scanning the same clients repeatedly.
Blog & Landing Page Updates
Added two comprehensive SEO articles: '10 Best Local Rank Tracking Tools in 2026' (in-depth comparison with visual table of 10 tools) and 'Local SEO ROI Guide' (framework for measuring Google Maps ranking ROI with case studies).
SEO & Landing Page Updates
Updated the SEO and added new features to the landing page, including new illustrations, refreshed copy, improved responsiveness, and a dynamic map animation showcasing Geogrid's capabilities.
Water Detection V5 (Hybrid)
Complete rewrite of water detection. Now uses a hybrid approach: is-on-water API as primary (accurate for oceans, lakes, rivers, AND islands), Overpass as fallback, with aggressive 7-day caching per coordinate. Manhattan is correctly detected as land. No more Overpass 504 timeouts blocking scans. Cache makes repeated scans in the same area instant (0ms).
PDF Export V2
PDF now captures the actual Leaflet map centered on your grid (fitBounds before capture). Keyword and business name displayed as an overlay badge on the map. The exported PDF looks like the real scan view — no more off-center or zoomed-out captures.
PNG Share Fix
Share as Image now auto-centers the map on your grid before capturing. The grid is always perfectly framed in the 1200x630 export. Map view is restored after capture so you don't lose your current position.
Tag Save Fix
Fixed a bug where adding tags after a scan silently failed. The root cause was the same HTTP 431 header overflow bug from V1.1 — an unnecessary Authorization Bearer header was still being sent for tag operations.
2 New Blog Articles
Added two comprehensive SEO articles: '10 Best Local Rank Tracking Tools in 2026' (in-depth comparison with visual table of 10 tools) and 'Local SEO ROI Guide' (framework for measuring Google Maps ranking ROI with case studies).
Competitor Tracking
See your top competitors at every grid point. Serper already returns all businesses at each location — we now extract and display the top 5 competitors with zero extra API calls. Toggle competitor overlay on the heatmap to visualize their rank distribution in blue markers.
AI Insights V2
Smarter analysis powered by historical context. AI now compares your current scan with up to 5 previous scans to detect trends (improving, declining, stable). Competitor context included when available. New fields: priority action, confidence score, and trend analysis.
White-Label PDF
Agency and Enterprise plans can now customize PDF exports with their own branding. Set your company name, accent color, and footer text in Settings. PDFs are generated with your brand instead of Geogrid's — perfect for client reports.
Coastline Water Detection
Improved water detection for coastal cities. Open coastline ways from OpenStreetMap are now properly closed against the bounding box edges, creating accurate ocean polygons. Grid points over the sea are correctly identified and skipped.
Google Web Search
Track organic Google Search rankings alongside Google Maps. New provider toggle in the scan wizard lets you choose between Maps (local pack) and Web (organic results). Web search matches by domain or URL instead of Google CID.
Referral Program
Earn 500 credits for each user you refer. Share your unique link, and when they complete their first scan, you both benefit — they get 300 bonus credits on signup, you get 500. Hit milestones at 5, 10, and 25 referrals for massive bonus rewards.
Group Scan Mode
New scan mode for multiple keywords. Instead of running separate scans, Group mode queries all keywords at each grid point and keeps the best rank. See which keyword performs best at every location. Toggle between Individual and Group in Step 3.
Matched Keyword Tooltips
In Group scan results, hover any grid point to see which keyword matched with the best rank. Tooltips show 'Rank #1 — emergency plumber' so you know exactly what's driving visibility at each location.
Water Detection Fix
Fixed point-in-polygon ray-casting bug that prevented water detection from working correctly. Overpass API returned water polygons but coordinate axes were swapped in the intersection test. Coastal city scans now properly skip ocean and lake points, saving credits.
SEO Indexation Fixes
Added proper metadata (title, description, OpenGraph, canonical URL) to /blog and /docs pages for better search engine indexation. Blog and API documentation pages are now fully crawlable with rich previews.
Async Scan Queue (BullMQ + Redis)
Scans are now processed asynchronously via a background worker. The API responds instantly with a pending status, and the worker handles execution, credit deduction, and result storage. Configurable concurrency for VPS deployment.
Dark & Light Mode Polish
Theme toggle now available on all dashboard pages (settings, credits). Completed/partial/failed badges properly themed in light mode. Enterprise plan colors refined from olive to gold. Select dropdowns get hover feedback.
Mobile Dashboard Improvements
Scan history cards are now more compact on mobile with tighter padding and hidden bulk-action buttons. Cards remain tappable to navigate to scan details.
Public REST API v1
Full REST API for programmatic access. Launch scans, retrieve results, and check credit balance via API keys. Bearer token auth with SHA-256 hashing, rate limiting per plan (60-250 req/min), and structured JSON error responses.
API Documentation
Comprehensive API docs page with endpoint reference, curl examples, response schemas, error codes, and authentication guide. Styled for developers, inspired by Stripe and GitHub docs.
API Key Management
Create, view, and revoke API keys directly from the Settings page. Keys are shown once on creation, stored as SHA-256 hashes. Up to 5 active keys per account. Usage stats and last-used timestamps tracked.
Google Analytics Integration
GA4 tracking integrated with cookie consent. Analytics only load after user accepts cookies — fully GDPR compliant. Preconnect hints for faster script loading.
Performance Optimization
Landing page components now use dynamic imports for code splitting. Below-the-fold sections (MapBlock, Pricing, FAQ, etc.) load as separate chunks, reducing initial bundle size and improving LCP.
Tier-Based Access System
Plans now gate features. Free users get 5 scans with 200 credits. Paid plans (Freelance, Agency, Enterprise) unlock unlimited scans, PDF/XLSX/PNG exports, scan comparison, and scheduled rescans. Limits enforced server-side and reflected in the UI.
Settings & Subscription Management
New settings page to manage your profile, view your current plan, upgrade or downgrade via Stripe, and access the Stripe Customer Portal to manage billing, invoices, and cancellation.
Stripe Payment Integration
Buy credit packs directly from the dashboard with Stripe Checkout. Four packs available (Starter to Scale). Secure webhook processing with idempotency checks ensures credits are added exactly once.
Scheduled Rescans
Automate your rank tracking with scheduled rescans. Choose daily, weekly, or monthly frequency from any scan detail page. Manage all schedules from the dashboard with pause/resume controls. Powered by Vercel Cron.
Email Alerts on Ranking Drops
Get notified when your rankings drop. After each scheduled rescan, the system compares your visibility score with the previous scan. If it drops below your threshold, you receive a detailed email alert via Resend.
Scan Tags & Projects
Organize your scans with tags. Add project names or client labels in the wizard, filter your history by tag, and edit tags inline on any scan detail page. Tags carry over on rescans.
Mini Sparklines
Each scan row now shows a tiny trend chart (last 5 scans for the same keyword). Green if trending up, red if declining — spot patterns at a glance without opening the detail page.
Share Scan as Image
Export any scan as a 1200x630 PNG — perfect for sharing on social media, client reports, or Slack. Copy to clipboard or download. Includes map, visibility score, rank distribution, and branding.
Soft Delete & Scan Management
You can now delete scans from your dashboard. Data is preserved behind the scenes for cache integrity, but removed from your view. Inline confirmation prevents accidental deletion.
Smart Credit Validation
Credits are now validated before scan launch — the system checks if you have enough for your chosen grid size. No more exceeding your balance. Realistic cost estimates show max credits including adaptive Phase 2.
Visibility Chart Fixes
The visibility-over-time chart now deduplicates scans on the same day, showing only the latest data point. No more overlapping dots.
Smart Keyword Grouping
The Keywords Tracked widget now extracts individual words from compound queries. A scan for "pizza kiosque" connects with a scan for "pizza" — giving you cross-scan insights.
Full Dashboard Experience
Comprehensive dashboard with KPI cards (visibility score, scan count, credits), visibility chart over time, keyword tracking widget, and paginated scan history with status filters.
Interactive Scan Detail Page
Full-screen Leaflet map with heatmap view, grid overlay, rank legends, and tooltips. Toggle between point markers and colored rectangles. Keyboard shortcuts (H for heatmap, G for grid).
Scan Comparison Mode
Compare any two scans of the same keyword side-by-side. The map shows rank deltas (improved/declined) with color-coded visualization — green for gains, red for losses.
XLSX & PDF Export
Export any scan as a detailed Excel spreadsheet or a dark-themed PDF report with map screenshot, rank distribution chart, and summary stats. Ready for client reporting.
Adaptive Scan Engine (Phase 1 + 2)
The core scanning engine uses a two-phase approach: Phase 1 samples the grid at half resolution, then Phase 2 fills gaps where rankings change rapidly. This cuts API calls by 30-50% on average.
72h Spatial Cache System
Scan results are cached for 72 hours at the coordinate level. Repeat scans in the same area consume zero credits for cached nodes — significant savings on monitoring workflows.
Anti-Abuse & Security Layer
Multi-layered protection: disposable email blocking (121k+ domains), IP + browser fingerprint tracking for multi-account detection, per-user and per-IP rate limiting on all endpoints.
Geogrid Waitlist & Landing Page Live
Initial deployment of the public-facing site. Built on Next.js 15 with Framer Motion for high-performance rendering. Real-time waitlist counter. Full SEO with structured data.
IDW Algorithm Architecture
Finalized the core mathematical model for Inverse Distance Weighting (IDW). This interpolation engine fills unmeasured grid nodes, enabling high-resolution heatmaps from sparse data.
Supabase Infrastructure Init
Provisioned the foundational database schema with Row Level Security (RLS) on all tables, credit ledger system, and auto-profile creation on signup with 200 free credits.