GOOBY - Closing Store Marketplace

A marketplace platform for discovering and purchasing inventory from closing retail stores, focused on the NY, NJ, CT, and PA areas.

Tech Stack

• Frontend: React 18 + Vite 6
• Styling: Tailwind CSS + shadcn/ui (Radix UI)
• Routing: React Router v6
• State/Data Fetching: TanStack Query v5
• Backend/Auth/DB: Base44 SDK (managed platform)
• Backend API Server: Express.js (port 3001)
• AI: xAI/Grok (via OpenAI-compatible API)
• SMS: Twilio
• Email: Resend
• News: NewsAPI
• Scheduling: node-cron (automated scans)
• Maps: React Leaflet
• Payments: Stripe
• Animations: Framer Motion

Project Structure

├── server/              # Express.js backend server
│   ├── index.js         # Main server entry, API routes
│   ├── xai.js           # xAI/Grok integration (chat, vision)
│   ├── closureScanner.js # Automated store closure discovery (news, X, web)
│   ├── twilio.js        # Twilio SMS integration
│   ├── resend.js        # Resend email integration
│   └── newsapi.js       # NewsAPI integration
├── functions/           # Base44 serverless/edge functions (TypeScript)
├── src/
│   ├── api/
│   │   ├── base44Client.js   # Base44 SDK config
│   │   └── services.js       # Frontend API client for backend services
│   ├── components/      # React components (admin, buyer, seller, ui)
│   ├── hooks/           # Custom React hooks
│   ├── lib/             # Auth context, query client, utils
│   ├── pages/           # Route-level page components
│   └── utils/           # Helper functions
├── public/              # Static assets (gooby-logo.png)
├── index.html
├── vite.config.js
├── tailwind.config.js
└── package.json

Development

• Start: npm run dev (runs backend on port 3001 + Vite frontend on port 5000)
• Build: npm run build
• Vite proxies /api/* requests to the backend server

API Endpoints

• GET /api/health - Health check
• POST /api/xai/chat - xAI/Grok chat (body: {messages, model?, maxTokens?})
• POST /api/xai/analyze-image - xAI vision (body: {imageUrl, prompt?})
• POST /api/twilio/sms - Send SMS (body: {to, body})
• POST /api/resend/email - Send email (body: {from?, to, subject, html?, text?})
• GET /api/news/search?q=... - Search news articles
• GET /api/news/headlines - Get top headlines
• POST /api/scanner/run - Trigger a manual closure scan
• GET /api/scanner/status - Get scanner status and history
• GET /api/scanner/results - Get last scan results

Required Secrets

• XAI_API_KEY - xAI/Grok API key
• GROK_API_KEY - Grok API key (alias)
• TWILIO_ACCOUNT_SID - Twilio Account SID (must start with "AC")
• TWILIO_AUTH_TOKEN - Twilio Auth Token
• TWILIO_PHONE_NUMBER - Twilio phone number
• RESEND_API_KEY - Resend API key
• NEWSAPI_KEY - NewsAPI key

Replit Configuration

• Frontend server: 0.0.0.0:5000 with allowedHosts: true for proxy compatibility
• Backend server: localhost:3001
• Workflow: "Start application" → npm run dev
• Deployment: Autoscale (build: npm run build, run: node server/index.js)

Notes

• This app uses the Base44 platform for authentication, database entities, and serverless functions
• The Base44 SDK requires the app to be registered on the Base44 platform for full functionality
• 404 errors from the SDK in development are expected when not connected to a Base44 app context
• Twilio initialization is lazy - it only validates credentials when an SMS is actually sent
• Frontend uses src/api/services.js to call backend API endpoints
• Automated closure scanning runs daily: full scan at 7am EST (12:00 UTC), partial scan at 12pm EST (17:00 UTC)
• Full scan: all NewsAPI queries + all 5 X queries + all 4 Facebook queries + 5 web queries; Partial scan: news + 2 X queries + 1 Facebook query + 2 web queries
• Scanner searches NewsAPI, X (Twitter), Facebook Marketplace, and general web via Grok for store closures in NY/NJ/CT/PA
• Manual scans via POST /api/scanner/run with optional { mode: "full" | "partial" }
• Discovered closures are returned via API (not auto-saved to DB — admin review step)