UK Travel Recommendation is a full-stack mobile application that helps you discover the best attractions across England, Scotland, Wales, Northern Ireland, and beyond. The system continuously learns your tastes — every swipe shapes your preference profile, and every recommendation is tailored specifically to you.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/viet2811/uk-travel-recommendation/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Get the backend and frontend running locally in minutes
Architecture
Understand how the recommendation engine, API, and mobile app fit together
API Reference
Explore every endpoint — auth, preferences, recommendations, and interactions
Core Concepts
Learn how vector embeddings and MMR re-ranking power personalised discovery
How It Works
Create an account
Register with a username and password. A blank preference profile is initialised automatically.
Set your preferences
Choose attraction categories you enjoy and (optionally) import places you’ve already visited. The system builds an initial taste vector from your selections.
Discover & swipe
The Discovery screen serves a ranked deck of UK attractions. Swipe right to like, left to pass. Each interaction updates your profile vector in real time.
Key Features
Vector-Based Recommendations
Attractions and user profiles are encoded as 777-dimensional vectors. Cosine similarity finds the best matches from thousands of UK attractions.
MMR Re-Ranking
Maximal Marginal Relevance balances personal relevance with diversity so you never see a monotonous feed.
Real-Time Profile Updates
Liking or disliking an attraction updates your profile vector immediately using configurable learning rates.
Geo-Area Filtering
Filter recommendations by UK country, region, or county to plan trips to a specific destination.
JWT Authentication
Secure access with short-lived access tokens (15 min) and long-lived refresh tokens (30 days), handled transparently in the mobile app.
Docker Compose Setup
Spin up the Django backend and pgvector PostgreSQL database with a single command.