A high-intimacy, real-time app for couples to bridge the gap — one question at a time.
Two people. One question. Two honest answers. A bridge built between them.
The Bridge Builder is a relationship tool that helps couples confront the friction points in their relationship through structured vulnerability and AI-generated micro-actions.
- Discover a Question — Swipe through curated, high-friction relationship questions, or write your own.
- Share Your Truth — Both partners answer independently and honestly. No peeking.
- See the Gap — Answers are revealed simultaneously. The difference is the gap.
- Lay the Bridge — AI reads both answers and generates a concrete, personal micro-action for each partner.
- Cross Together — Each partner walks their path. When both are done, the bridge is crossed.
- 🔄 Real-time sync — Both partners see updates live via Convex
- 🤖 AI-powered bridge tasks — Personalized, direct actions (not coaching advice) generated by Gemini
- 🎴 Swipeable question discovery — Browse questions with a tactile card-swipe interface
- 💜 Swipe feedback — Swipe bridge tasks left/right to silently rate the AI's quality
- 📖 Round history — Re-visit and re-cross past bridges
- ✍️ Custom questions — Bring your own difficult conversations
- 🔒 Session-based auth — No accounts needed, secure token-based identity
- 📱 Mobile-first design — Dark, warm glassmorphism UI built for intimate use
| Layer | Technology |
|---|---|
| Frontend | React 19, TypeScript, Framer Motion, XState |
| Styling | Tailwind CSS 4 |
| Backend | Convex (real-time database + serverless functions) |
| AI | Google Gemini (gemini-3-flash-preview) via @google/genai |
- Node.js 20+
- A Convex account (free tier works)
- A Gemini API key
# Clone the repo
git clone https://github.com/rootbid/bridge-builder.git
cd bridge-builder
# Install dependencies
npm install
# Initialize Convex (creates your own backend)
npx convex dev
# Set your Gemini API key on the Convex backend
npx convex env set GEMINI_API_KEY "your-gemini-api-key"
# Start the dev server
npm run devThe app will be running at http://localhost:3000.
| Variable | Where | Purpose |
|---|---|---|
VITE_CONVEX_URL |
.env.local (auto-generated by npx convex dev) |
Connects frontend to your Convex backend |
GEMINI_API_KEY |
Convex environment (npx convex env set) |
Server-side AI calls — never exposed to the client |
This project is licensed under the GNU Affero General Public License v3.0 — see the LICENSE file for details.
What this means:
- ✅ Free to use, modify, and self-host
- ✅ Free to deploy for personal or organizational use
⚠️ If you modify and deploy as a service, you must open-source your changes- 🏢 Commercial hosted version available at rootbid.github.io/bridge-builder
Not a game. A practice.