WayFy is an accessibility-focused travel platform built for people with reduced mobility. It brings together interactive accessible maps, AI-powered trip planning, verified community reviews, and curated place discovery — all in one place. Whether you’re looking for a wheelchair-friendly restaurant, planning a multi-stop city itinerary, or seeking honest accessibility reviews from fellow travelers, WayFy gives you the tools and community knowledge to travel with confidence.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/jhonyes04/new-wayfy/llms.txt
Use this file to discover all available pages before exploring further.
The Problem
Planning accessible travel is unnecessarily hard. Accessibility information is scattered across dozens of sources — tourism websites, review apps, municipal portals — each with inconsistent standards and no reliable way to verify claims. A restaurant might advertise a “step-free entrance” without mentioning the inaccessible restroom. A hotel’s website might show a “wheelchair-accessible room” that doesn’t meet the needs of every wheelchair user. Travelers with reduced mobility are forced to cross-reference multiple sources, contact venues directly, and still arrive unsure of what they’ll find. This friction discourages travel, limits spontaneity, and places an unfair research burden on people who already face greater logistical challenges.The Solution
WayFy addresses this by combining OpenStreetMap’s structured accessibility data with community-contributed reviews in a single, searchable interface. OSM’swheelchair tags (yes, limited, no) provide a baseline for thousands of locations across hotel, restaurant, transport, health, culture, recreation, and other categories. On top of that foundation, WayFy users submit their own firsthand reviews and photos, which go through a community approval pipeline before appearing on the public map. An integrated AI assistant — powered by Groq and Llama 3.3 — answers natural-language questions about accessibility, helps plan itineraries, and surfaces relevant places based on user needs.
Key Features
Accessibility Map
An interactive Mapbox GL map rendering OSM places and community-submitted locations across four layers: clustered OSM data, individual OSM points, community-approved places, and pending community submissions. Filter by wheelchair accessibility level (
yes, limited, no) and category.Trip Planner
Build and manage multi-stop accessible itineraries. Trips can be kept private or shared publicly at
/trips/public. Each trip can include a mix of OSM and community places, with accessibility notes per stop.AI Assistant
A conversational assistant backed by Groq’s Llama 3.3 model. Ask about accessibility at specific locations, get itinerary suggestions, or query the platform’s place data in natural language.
Community Reviews
Users submit accessibility reviews with photos (stored via Cloudinary) and wheelchair ratings. Submissions enter a moderation queue and are marked
community-pending until approved, at which point they appear as community-approved on the map.Place Discovery
Dedicated browsing pages for Hotels (
/hotels), Restaurants (/restaurants), Transport hubs (/transports), and Entertainment venues (/entertainment). Each page filters the OSM and community dataset for that category and displays accessibility metadata.Favorites & User Dashboard
Authenticated users can save places to a favorites list, manage their submitted reviews, and view their trip history from a personal dashboard at
/user-dashboard. Profile details and avatar are managed at /user-profile.Tech Stack
WayFy is built on a modern, open-standards stack designed for performance and accessibility.| Layer | Technology |
|---|---|
| Frontend framework | React 18 + Vite |
| Backend framework | Python Flask |
| Database ORM | SQLAlchemy + PostgreSQL |
| Maps | Mapbox GL JS |
| AI / LLM | Groq API · Llama 3.3 |
| Image storage | Cloudinary |
| Authentication | JWT (Flask-JWT-Extended) |
| Geodata source | OpenStreetMap Overpass API |
Frontend Routes
The React app is served as a single-page application. Key routes include:| Route | Description |
|---|---|
/ | Landing page |
/map | Interactive accessibility map |
/login · /register · /forgot-password | Authentication flows |
/hotels · /restaurants · /transports · /entertainment | Category browsing |
/trips · /trips/:tripId | Authenticated trip management |
/trips/public · /trips/public/:id | Public itinerary discovery |
/user-dashboard · /user-profile · /user-favorites | User account pages |
/admin/places | Admin moderation queue |
Map Layers
The Mapbox GL map renders four distinct source layers:| Layer ID | Data source | Description |
|---|---|---|
clusters | OSM via Overpass API | Grouped OSM points at lower zoom levels |
unclustered-point | OSM via Overpass API | Individual OSM places at higher zoom levels |
community-approved | WayFy PostgreSQL | Community-submitted places that have passed moderation |
community-pending | WayFy PostgreSQL | Community submissions awaiting moderator approval |
OSM Categories
WayFy queries the Overpass API for these OSM category keys:gastronomia, alojamiento, transporte, salud, cultura_turismo, recreacion, deporte, gobierno, baños, dinero, tiendas.
Ready to run WayFy locally? Head to the Quickstart guide to have the backend and frontend running in minutes.