Don't Travel Alone. Find Your perfect Global Mate.
Journey-mate is a mission-driven, technical masterpiece designed to connect travelers with verified companions. Rebuilt for Peak Performance, Total Inclusivity, and World-Class Security.
- High-Fidelity Virtual Tickets: Airline-inspired boarding pass visualization with real-time field synchronization.
- Real-Time Weather Pulse 🌦️: Global, coordinate-based arrival forecasts using the Open-Meteo API.
- Universal Scan Loop 🔍: Scannable deep-link QR codes that reconstruct tickets on any mobile device.
- Native Wallet Integration 💳: One-tap "Add to Apple Wallet" and "Add to Google Wallet" buttons.
- Rich Media Narratives: Dynamic blogging system for travelers to share their stories.
- Interactive Orientation Maps 🗺️: Integrated Leaflet maps with great-circle journey pathing.
- Traveler Attribution: Premium author cards with community trust indicators.
- 100/100 Lighthouse Suite: Optimized for sub-2s TTI and perfect SEO rankings.
- On-Demand Communication: Agora RTC SDK is deferred and dynamically loaded only when a call starts.
- Hydration-Safe SSR: Advanced React pattern for stable dynamic asset rendering.
- Nuclear Accessibility ♿: 100% WCAG AA compliant contrast and semantic hierarchy.
- Gated Pairing Flow: Journey owners manage access via a real-time request system.
- AI Smart Drafts 🪄: Instantly generate compelling journey descriptions using AI.
- Luggage Tracker 🧳: Smart luggage capacity tracking and "Luggage Guard" trust badges.
- Collaborative Expenses: Real-time group cost sharing and settlement reconciliation.
- Security Vault 🔒: Secure, time-gated emergency contact sharing.
Journey-mate is a high-performance monorepo architected for scale:
- Framework: Next.js 15+ (Turbopack) with App Router.
- Database/Realtime: Supabase with PostgREST and Realtime Channels.
- Auth: Clerk Elite Identity & User Management.
- RTC Engine: Agora SDK for ultra-low latency voice/video.
- UI Engine: Material UI v6 + Tailwind CSS v4.
- Maps: Leaflet with Great Circle Pathing (geodesics).
# Clone the repository
git clone git@github.com:krishnaUIDev/Journey-mate.git
cd Journey-mate
# Install dependencies with lockfile integrity
pnpm install# Launch the Turbopack dev server
pnpm run devThe application will be available at http://localhost:3000.
.
├── apps
│ └── web # Next.js 15 Web Application (Marketplace & Dashboard)
├── packages
│ ├── ui # Shared Design System & Components
│ ├── eslint-config # Professional Linting Rules
│ └── typescript-config # Strict TS Configurations
├── supabase # Database Migrations & RLS Policies
└── database_schema.md # [View Database Relationships](./database_schema.md)
Built with ❤️ for a safer, more connected world. ✨🌑🧥✅🌍🚀