v3.0.0 — Zero-Cost Migration + MCP Server

What Changed

NS RideShare has moved from Replit to Cloudflare — completely free hosting, custom domain, and a new way to interact with rides through AI.

Infrastructure

• Backend: Express → Hono on Cloudflare Workers at api.ns-rideshare.com
• Frontend: Replit → Cloudflare Pages at ns-rideshare.com
• Database: Same NeonDB PostgreSQL — zero data migration, all 419 users and 278 rides preserved
• Cost: ~$25/mo (Replit) → $0/mo (Cloudflare free tier)

Auth

• Passport.js sessions → JWT in httpOnly cookies (SameSite=None; Secure)
• Backward-compatible scrypt password hashing (all existing passwords work)
• New X-NS-User header auth for programmatic/MCP access (auto-registers users)

MCP Server (New!)

Use NS RideShare directly from Claude Code as an MCP server:

{
  "mcpServers": {
    "ns-rideshare": {
      "command": "node",
      "args": ["path/to/NS-RIDESHARE/mcp-server/dist/index.js"],
      "env": {
        "NS_USER": "your_username"
      }
    }
  }
}

6 tools available:

Tool	What it does
find_rides	Search rides by direction + date
create_ride	Create a ride with smart defaults
join_ride	Join an existing ride
my_rides	List your upcoming rides
book_driver	Assign a driver to a ride
list_drivers	Show available drivers

Docs Page

New /docs page on the website with:

• Getting started guide
• Full API reference (all endpoints)
• MCP server setup instructions

API Endpoints

Full REST API at https://api.ns-rideshare.com/api/:

• GET /health · GET /stats
• POST /register · POST /login · POST /logout · GET /auth/me
• GET /rides · POST /rides · PATCH /rides/:id · DELETE /rides/:id
• POST /rides/:id/join · POST /rides/:id/leave
• GET /rides/:id/passengers · GET /my-rides
• PATCH /users/:id · GET /drivers

Setup

# MCP server
cd mcp-server && npm install && npm run build

# Frontend dev
cd client && npm run dev

# Backend dev
cd worker && wrangler dev