What's New

Storefront Integration & Analytics

Major release with Shopify theme integration and analytics tracking.

Theme App Extension

• Store Finder Block - Embeddable widget for any theme page
• Location Card Block - Individual location display component
• App Proxy Routes - SSR storefront pages at /storefront/*

SEO Enhancements

• XML Sitemap Generation - Automatic sitemap for search engine indexing
• Meta Tags per Location - Configurable titles and descriptions
• Location Status - DRAFT, ACTIVE, ARCHIVED states with URL slugs
• Admin SEO Settings - Business type, page templates, social links

Google Analytics 4

• GA4 Measurement ID - Configure in SEO Settings
• Automatic Injection - GA4 script added to storefront SSR pages

Analytics Roadmap

• Search origin mapping with geographic heatmaps
• Per-store engagement metrics (views, clicks, directions)
• Conversion funnel and trend reporting

Developer Experience

Improved local development and documentation.

• Development Mode Auth - Bypass OAuth for local testing without full flow
• Shop ID Mapping - Fixed frontend API service mapping
• Sentry Graceful Degradation - No-op middleware when DSN not configured
• Comprehensive Test Plan - Full testing documentation for all features
• Development Guide - Local setup, environment config, troubleshooting
• Project Roadmap - Prioritized next steps and future enhancements

Initial Release

The foundation of OptimizedStoreFinder is here!

• Backend API - Express, TypeScript, PostgreSQL + PostGIS
• Redis Caching - Fast location queries with intelligent caching
• Shopify OAuth - Secure authentication integration
• Admin UI - React + Shopify Polaris interface
• Location CRUD - Full create, read, update, delete with soft delete
• Geocoding Service - Dual providers (Mapbox + Nominatim fallback)
• Auto-populate Fields - Coordinates, city, state, zip from address lookup
• Proximity Search - PostGIS-powered nearby location queries
• Input Validation - Zod schema validation

SEO Features

Comprehensive SEO optimization for location pages.

• Individual Location Pages - SEO-optimized HTML with proper meta tags
• LocalBusiness Schema - JSON-LD structured data for Google rich results
• Open Graph Tags - Social sharing optimization for Facebook, Twitter
• Opening Hours Schema - Multiple format support for business hours
• Breadcrumb Navigation - Schema.org compliant breadcrumbs
• Public API Endpoints - HTML pages, JSON data, and structured data endpoints
• Redis Caching - 1 hour cache for SEO endpoints, auto-invalidation on updates

UX Improvements

Enhanced the admin experience with smarter forms and real-time feedback.

• Address Autocomplete - Dropdown suggestions as you type (min 3 characters)
• Auto-populate on Select - All fields fill automatically when address is selected
• Auto-geocoding - Coordinates set automatically from selected address
• Form Validations - Required fields, email/URL format, coordinate ranges
• Real-time Feedback - Errors appear on blur and update as you type
• Character Limits - Enforced length limits with clear indicators

Error Handling & Monitoring

Production-ready error tracking and comprehensive error handling.

Error Handling

• Extended Error Types - ValidationError, NotFoundError, UnauthorizedError, ForbiddenError, ConflictError, RateLimitError, DatabaseError, ExternalServiceError
• Prisma Error Handling - Automatic handling of unique constraints, not found, foreign keys
• Zod Validation Errors - Field-level details with user-friendly messages
• React Error Boundary - Graceful error UI with retry/reload options

Sentry Integration

• Backend Monitoring - Request and tracing handlers, performance monitoring
• Frontend Monitoring - Session replay on errors, React Error Boundary integration
• Privacy Features - Sensitive data filtering, text masking in replays
• Environment-aware - Full details in dev, user-friendly messages in production