Yuber

The Uber for Home Emergencies

Tell the AI what broke. It finds the nearest pro, dispatches them, and tracks the job — all in under 60 seconds.

How It Works · Features · Quick Start · Architecture · Contributing

---

Your pipe bursts at 2 AM. Your door lock jams on a Sunday. Your power goes out before a deadline. What do you do? Google frantically, call five numbers, get voicemail, and wait. The current system for emergency home services is broken — it's slow, stressful, and analog.

Yuber is instant help with intelligent dispatch. You tell the AI what happened in plain English. It understands your crisis, finds the nearest top-rated pro through Yelp, dispatches them automatically, and tracks the job until help arrives. No searching. No phone trees. No panic.

"My kitchen pipe burst and water is everywhere"

Yuber understands, finds a 4.8-star plumber 0.3 miles away, dispatches them, and gives you a live ETA. Done.

Yuber started in a late-night Discord voice call. Three strangers were talking about why every AI app still feels like a chatbot that can't help in the real world. We wondered why no one built an agent that actually solves problems — real problems. Pipes bursting. Doors locked. Power failing. That call turned into a mission, and we shipped a working prototype before sunrise.

• AI-Powered Triage — Mastra agents understand your emergency and route to the right service category
• Intelligent Dispatch — Automated provider matching based on proximity, ratings, and availability
• Yelp Integration — Real-time search for top-rated local professionals
• Google Maps — Live location tracking and ETA visualization
• Phone UI Experience — Native mobile-app feel rendered in the browser
• Typed API — End-to-end type safety with tRPC + Zod validation
• Cookie Auth — JWT-based session management with demo login
• Docker Ready — Full Docker Compose setup for instant deployment
• Multi-Agent System — Help agent, dispatch agent, and settings agent working in concert

Yuber uses Mastra to orchestrate three specialized AI agents:

Each agent has access to core functions: chat, search_providers, dispatch, and get_history.

• Bun >= 1.0
• Docker (optional, for containerized setup)

git clone https://github.com/Alexi5000/yuberapp1.git
cd yuberapp1
bun install

cp .env.example .env

Set your API keys:

bun run db:push

bun run dev

Open http://localhost:3000.

docker compose up

Full setup guide: SETUP.md

Next.js App Router renders a minimal shell and dynamically loads the client app. app/page.tsx imports client/src/app_entry.tsx with ssr: false, creating a native phone-UI experience in the browser.

tRPC provides end-to-end type safety from client to server. server/routers.ts defines the main appRouter, and server/_core/context.ts attaches authenticated user context.

JWT cookie-based sessions with local auth (server/_core/localAuth.ts) and demo login support for quick testing.

Drizzle ORM with Turso/libSQL. Schema defined in drizzle/schema.ts, data access through server/db.ts.

yuberapp1/
├── app/                   # Next.js App Router pages + API routes
│   ├── api/              # tRPC endpoint + auth routes
│   └── login/            # Login page
├── client/                # Phone UI client application
│   └── src/
│       ├── pages/        # Screen components (splash, home, tracking, etc.)
│       ├── components/   # Reusable UI components
│       ├── hooks/        # Custom React hooks
│       └── contexts/     # React context providers
├── server/                # Backend logic
│   ├── mastra/           # AI agent definitions and core functions
│   │   ├── agents/      # Help, Dispatch, Settings agents
│   │   └── core/        # Chat, search, dispatch, history functions
│   └── _core/            # Auth, env, DB, Yelp client utilities
├── shared/                # Shared constants and screen IDs
├── drizzle/               # Database schema + migrations
├── scripts/               # DB seed, inspect, and verification scripts
├── docs/                  # Architecture diagrams and notes
└── .github/               # CI/CD, issue templates, CODEOWNERS

bun run dev        # Start Next.js dev server
bun run build      # Production build
bun run start      # Run production server
bun run check      # TypeScript typecheck
bun run db:push    # Generate + apply Drizzle migrations

• Real-time push notifications for dispatch updates
• Expanded service categories (HVAC, pest control, appliance repair)
• Provider-side dashboard for job management
• Payment integration (Stripe)
• Rating and review system
• SMS/WhatsApp dispatch notifications
• Multi-language support

MIT — see LICENSE for details.