FindIt

A mobile app that connects people who lost items with those who found them.

Try it on Expo Go • Demo Video

Try It

Scan to try on your phone:

Demo

How it works

1. Finders post items they found with photos, location, and details
2. AI generates verification questions based on the item description
3. Claimers answer questions to prove ownership
4. Verified claimers chat with finders to arrange pickup
5. Resolution system lets claimers mark items as returned or not, affecting trust scores

Tech Stack

Mobile: React Native, Expo, NativeWind, TanStack Query
Backend: Bun, Express, Drizzle ORM, PostgreSQL
Auth: Better Auth
AI: Groq API for question generation

Setup

Server

cd server
cp .env.example .env
# Add your database URL and Groq API key
bun install
bun run db:push
bun run dev

Mobile

# In project root
npm install
npx expo start

Key Features

• Location-based discovery - Find items within 1km
• AI verification - Answer questions to prove ownership (not just "what color is it?")
• Trust scoring - Finders gain/lose points based on successful returns
• Real-time chat - Coordinate pickup after verification
• Resolution tracking - Claimers confirm when items are returned

Project Structure

app/               # Mobile app
  (tabs)/          # Main screens (Nearby, Claims, Chats, Profile)
  chat/[id].tsx    # Chat screen
  claim/           # Claim flow
server/            # Backend
  src/
    routers/       # API routes
    db/            # Database schema

Environment Variables

Server .env:

DATABASE_URL=
GROQ_API_KEY=
BETTER_AUTH_SECRET=

Running locally

1. Start the server on port 3000
2. Update lib/config.ts with your local IP
3. Run npx expo start
4. Scan QR code with Expo Go or run in simulator