🌍 RoamIQ — The Operating System for Digital Nomads

🎨 Redesigned frontend has been merged into main. A modern Next.js 16 + Tailwind 4 + shadcn/ui stack. The original Vite + MUI frontend is preserved in the main branch history.

One platform for digital nomads to live, work, and thrive anywhere.

🌐 Live Demo · 📄 YC Application · 🗺️ Roadmap · 🐛 Report Bug

---

🎯 The Problem

35 million digital nomads face a fragmented experience with no single tool that works:

Pain Point	Impact
❌ Visa rules scattered across 100+ government sites	Weeks of research per trip
❌ Generic job boards not built for remote work	Wasted applications, wrong roles
❌ No tool tracks visas + trips + expenses together	Manual spreadsheets, missed deadlines
❌ Finding nomad-friendly cities is manual research	10–20 hours/month navigating fragmented tools
❌ Loneliness — hard to find community in new cities	Isolation, fewer connections

We estimate digital nomads waste 10–20 hours/month navigating fragmented tools. RoamIQ is the OS that fixes this.

---

💡 Our Solution

RoamIQ is the operating system for digital nomads — one platform for everything nomads need:

Feature	What It Does
🛂 AI Visa Intelligence	Personalized visa recommendations by passport, skills & goals
💼 Remote Job Board	Curated 100% remote positions, updated daily
🗺️ Global Listings	500+ cities with cost-of-living, WiFi, weather, safety data
💰 Savings Calculator	Compare real costs across 500+ cities side-by-side
🏢 Company Directory	Verified remote-first companies hiring globally
📅 Workation Planner	Plan and book workations with co-living/co-working partners
📞 Expert Consultations	Book 1:1 with visa agents, tax experts, relocation specialists
🎉 Events & Community	Discover nomad meetups, find nearby digital nomads
📝 Trip Tracker	Track all your trips, visas, and workations in one place
⭐ World Rankings	Community-driven rankings of best cities for remote work
💬 Forum	Q&A with nomads — visas, taxes, destinations, gear

---

🏗️ Tech Stack

Frontend (Next.js 16 + React 19)
├── Tailwind CSS 4 + shadcn/ui (design system)
├── Supabase (auth, listings, forum, trips)
├── Google Maps API (location features)
└── Motion / Framer Motion 12 (animations)

Backend (Node.js + Express)
├── MongoDB Atlas + Mongoose ODM
├── JWT + Refresh Tokens (auth)
├── AWS S3 (file uploads)
├── Nodemailer (email)
├── Multer + Sharp (image processing)
└── Yup (validation)

---

🚀 Getting Started

Prerequisites

• Node.js ≥ 18
• MongoDB (local or MongoDB Atlas)
• Supabase project (create free)
• AWS S3 bucket (for media uploads)
• Google Maps API key

1. Clone & Install

git clone https://github.com/pranavgawasproject/Nomads_Travel.git
cd Nomads_Travel

2. Backend

cd backend
cp .env.example .env    # Fill in your credentials
npm install
npm run dev             # → http://localhost:3000

3. Frontend

cd ../frontend
cp .env.example .env    # Fill in your API keys
npm install
npm run dev             # → http://localhost:3000

4. Supabase Setup

Run the schema in your Supabase SQL editor:

# In Supabase SQL editor (Project → SQL Editor)
# Paste contents of supabase_schema.sql and run
# Then seed sample data:
psql -h <host> -U postgres -d postgres < supabase_seed_data.sql

5. Docker (optional)

docker-compose up -d

---

📁 Project Structure

Nomads_Travel/
├── frontend/                    # Next.js 16 application
│   └── src/
│       ├── app/                 # Next.js pages & layouts
│       ├── components/          # Reusable UI & shadcn components
│       ├── hooks/               # Custom React hooks
│       └── utils/               # Helpers, validators
│
├── backend/                     # Express.js API
│   ├── controllers/             # Business logic (30+ controllers)
│   ├── models/                  # Mongoose schemas (20+ models)
│   ├── routes/                  # Express route definitions
│   ├── middlewares/             # JWT auth, error handling
│   ├── config/                  # DB, S3, Mailer, CORS
│   ├── __tests__/               # Unit tests
│   └── server.js                # Express server entry
│
├── supabase_schema.sql          # Supabase schema + RLS policies
├── supabase_seed_data.sql       # Sample data
├── docker-compose.yml           # Local development
├── docker-compose.prod.yml      # Production deployment
├── Makefile                     # Dev shortcuts
├── PITCH.md                     # YC pitch deck
├── ROADMAP.md                   # Feature roadmap
└── CONTRIBUTING.md              # Contributor guidelines

---

💼 Business Model

Tier	Price	Features
Free	$0	Browse listings, job board, basic search, forum
Pro	$9/mo	AI recommendations, trip tracker, priority support
Business	$29/mo	Company listings, recruitment tools, analytics

Unit Economics: CAC ~$15 (organic + content), LTV ~$280 (18-mo Pro), LTV/CAC = 18.7x

---

📈 Traction & Milestones

Metric	Value
GitHub repositories	17+ across the org
Features built	55+ pages, 30+ API endpoints
Remote job listings	Daily updated
City data coverage	500+ cities worldwide
Forum posts	Community-driven Q&A

---

🤝 Contributing

We welcome contributors! Please read CONTRIBUTING.md before submitting PRs.

# Fork → Clone → Branch → Code → Test → PR
git checkout -b feature/your-feature-name
npm test   # Run tests
git push origin feature/your-feature-name

Good first issues are tagged good first issue.

---

📞 Contact

• GitHub: @pranavgawasproject
• Email: hello@roamiq.io
• YC Application: PITCH.md

---

📜 License

MIT © 2024–2026 Pranav Gawas

---

Built for the 35 million digital nomads who deserve better tools.
🌍 Remote work. Any country. One platform.