gackstonew-lgtm/YARDLY-Automotive

Car yard sales in Kenya # YARDLY — Digital Automotive Marketplace & Car Yard Platform (Kenya) > **Tagline:** "Find it. Buy it. Drive it." > **Supporting message:** "Kenya's smarter way to buy and sell quality vehicles." YARDLY is a production-ready, fintech-grade Kenyan automotive marketplace and digital car-yard platform inspired by UnitPay visual design principles. It features real-time search & filter query synchronization, instant vehicle submission with logbook protection under Supabase RLS, configurable Safaricom Daraja M-Pesa / PayHero payment provider architecture, Resend transactional emails, and Vercel serverless deployment. --- ## WINDOWS CMD SETUP Follow these exact steps to set up and run the platform locally on Windows: 1. Open Command Prompt. 2. Navigate to the project directory: ```cmd cd path\to\project ``` Example: ```cmd cd C:\Projects\yardly ``` 3. Install dependencies: ```cmd npm install ``` 4. Create the environment file: ```cmd copy .env.example .env ``` 5. Add the required Supabase, payment and email environment variables to .env. 6. Start the development server: ```cmd npm run dev ``` 7. Open: localhost --- ## LOCAL DEVELOPMENT & HOSTING - The project uses standard Node.js and Vite for local development. - Do **NOT** require XAMPP, Apache, PHP, Laragon, Node HTTP servers, or any external web servers. - Runs seamlessly across **Windows CMD**, **PowerShell**, and **VS Code Integrated Terminal**. - All API endpoints are invoked relative to the application origin (`/api/...`). - Network sharing is enabled by default via `host: true` and `port: 5173` in `vite.config.ts`. --- ## LOCAL WEBHOOK DEVELOPMENT During local development (`npm run dev`), external payment gateways (Safaricom Daraja / PayHero) cannot directly reach `localhost...`. To test real external webhooks on your local machine: 1. Use a secure tunnel provider like **ngrok** or **Cloudflare Tunnel**: ```cmd ngrok http 5173 ``` 2. Copy the generated HTTPS …