DEMO BETA VER. SEPOLIA TESTNET. QUESTS PROOFS WITH AUTO ACCEPT PHOTOS WITHOUT VERIFICATION.
Transform trip planning from a chore into an adventure
TripX is an AI-powered travel companion that creates personalized trip itineraries, gamifies exploration through quests, and rewards travelers with blockchain-based tokens and NFTs.
📝 Your Input 🤖 AI Magic ✨ Your Trip
───────────── ────────── ──────────
• Destination Gemini 2.5 Pro • Day-by-day itinerary
• Duration ──► + Google Places ──► • Cost estimates
• Budget + Real-time data • Hotel recommendations
• Interests • Quests to complete
Create personalized travel itineraries in seconds using Google Gemini 2.5 Pro.
- Smart Interest Matching - Only shows places matching your selected categories (Food, Culture, Nature, Nightlife)
- Budget-Aware Planning - Low/Medium/High budget tiers with realistic costs
- Dynamic Day Planning - 4-5 activities per day, properly scheduled
- Hotel Recommendations - Best accommodations within your budget with pricing
- Nearby Exploration - Suggests attractions within 25km when local options are limited
Complete challenges at destinations to earn rewards.
- Location-based Quests - Visit specific places, take photos
- XP & Leveling - Progress through traveler ranks
- Daily Challenges - Fresh quests every day
- Photo Verification - AI verifies quest completion
| Token | Type | Purpose |
|---|---|---|
| 🪙 TPX | ERC-20 | Utility token earned for completing trips and quests |
| 🎫 NFT Passport | ERC-721 | Your unique travel identity on the blockchain |
| 🏅 Achievement NFTs | ERC-721 | Collectible badges for milestones |
Smart Contracts (Ethereum Sepolia):
TPX Token: 0x6A19B0E01cB227B9fcc7eD95b8f13D2894d63Ffd
NFT Passport: 0xFc22556bb4ae5740610bE43457d46AdA5200b994
Achievement NFT: 0x110D62545d416d3DFEfA12D0298aBf197CF0e828
Live public transportation data for route planning.
- Metro/Subway schedules
- Bus tracking
- Train connections
- Multi-modal journey planning
Compete with other travelers worldwide.
- Global rankings by XP
- Achievement badges collection
- Travel statistics
| Technology | Purpose |
|---|---|
| React 18 | UI Framework |
| TypeScript | Type Safety |
| Vite | Build Tool |
| Tailwind CSS | Styling |
| Framer Motion | Animations |
| Lucide Icons | Icon System |
| Technology | Purpose |
|---|---|
| Supabase | PostgreSQL Database + Auth |
| Edge Functions | Serverless API (Deno) |
| Row Level Security | Data Protection |
| Technology | Purpose |
|---|---|
| Google Gemini 2.5 Pro | Trip Generation AI |
| Google Places API | Location Data |
| Google Maps | Geocoding & Directions |
| Mapbox GL JS | Interactive Maps |
| Technology | Purpose |
|---|---|
| wagmi + viem | Ethereum Integration |
| RainbowKit | Wallet Connection |
| Ethereum Sepolia | Testnet Blockchain |
- Node.js 18+
- npm or yarn
# Install dependencies
npm install
# Start development server
npm run devCreate a .env file with:
# Supabase (Required)
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
# Google APIs (Required)
VITE_GOOGLE_MAPS_API_KEY=your_google_maps_key
VITE_GOOGLE_AI_KEY=your_gemini_api_key
VITE_MAPBOX_TOKEN=your_mapbox_token
# Web3 (Required for blockchain features)
VITE_TPX_CONTRACT_ADDRESS=0x6A19B0E01cB227B9fcc7eD95b8f13D2894d63Ffd
VITE_NFT_PASSPORT_CONTRACT_ADDRESS=0xFc22556bb4ae5740610bE43457d46AdA5200b994
VITE_ACHIEVEMENT_NFT_CONTRACT_ADDRESS=0x110D62545d416d3DFEfA12D0298aBf197CF0e828
VITE_ADMIN_WALLET_PRIVATE_KEY=your_admin_wallet_key
VITE_ETH_SEPOLIA_RPC_URL=https://ethereum-sepolia.publicnode.comnpm run build┌─────────────────────────────────────────────────────────────┐
│ FRONTEND (React + Vite) │
├─────────────────────────────────────────────────────────────┤
│ components/ │ services/ │ hooks/ │
│ (45+ UI) │ (33+ APIs) │ (Auth, NFT, etc.) │
└─────────────────────────────┬───────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ SUPABASE │
├─────────────────────────────────────────────────────────────┤
│ PostgreSQL │ Edge Functions │ Authentication │
│ (trips, users, │ (generate-trip │ (Magic Link, │
│ quests, etc.) │ -ai, etc.) │ Wallet) │
└─────────────────────────────┬───────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ EXTERNAL SERVICES │
├─────────────────────────────────────────────────────────────┤
│ Google Gemini │ Google Places │ Ethereum Sepolia │
│ (AI) │ (Locations) │ (Smart Contracts) │
└─────────────────────────────────────────────────────────────┘
tripx/
├── components/ # React components
│ ├── pages/ # Page components (Dashboard, CreateTrip, etc.)
│ ├── layout/ # Layout components (Header, Sidebar)
│ └── ... # Shared components
├── services/ # API services
│ ├── aiTripService.ts # AI trip generation
│ ├── web3Service.ts # Blockchain interactions
│ └── ... # Other services
├── hooks/ # Custom React hooks
├── lib/ # Utilities (Supabase client, etc.)
├── styles/ # Global styles
├── types/ # TypeScript types
└── data/ # Static data (operators, etc.)
- Authentication: Supabase Auth with Magic Link & Wallet
- API Keys: Environment variables, never exposed to client
- Database: Row Level Security (RLS) policies
- Smart Contracts: Deployed on testnet, admin-controlled minting
MIT License - see LICENSE file for details.
Built with ❤️ using React, Supabase & Ethereum