A full-stack web application connecting travelers with authentic local food experiences and unique stays. Hosts can share their culinary expertise and spaces while travelers can discover and book memorable experiences.
- React + TypeScript
- Tailwind CSS for styling
- shadcn/ui component library
- React Router for navigation
- Context API for state management
- Python Flask REST API
- MySQL database
- JWT authentication
- File upload handling
- Browse and search food experiences and stays
- Filter by location, price range, cuisine type etc.
- View detailed listings with images, descriptions, pricing
- Book experiences and stays
- Manage bookings and favorites
- User profiles and reviews
- List food experiences and stays
- Manage listings and availability
- Upload photos and details
- Track bookings and earnings
- Host dashboard
- Profile management
platform2025/ ├── frontend/ │ ├── src/ │ │ ├── components/ # Reusable UI components │ │ ├── pages/ # Page components │ │ ├── contexts/ # Context providers │ │ ├── hooks/ # Custom hooks │ │ └── lib/ # Utilities and helpers │ └── public/ # Static assets └── backend/ ├── app.py # Main Flask application ├── schema.sql # Database schema └── migrations/ # Database migrations
- Node.js v16+
- Python 3.8+
- MySQL 8.0+
- Git
bash git clone cd platform2025
bash cd frontend npm install npm run dev Create .env file cp .env.example .env Add environment variables VITE_API_URL=http://localhost:5000
bash cd backend python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -r requirements.txt
bash cd backend python -m flask db init python -m flask db migrate
Login to MySQL mysql -u root -p Create database CREATE DATABASE platform2025; Run migrations cd backend python migrate.py python migrate_reviews.py python migrate_bathrooms.py
bash cd frontend npm run dev cd backend python app.py
The application will be available at:
- Frontend: http://localhost:5173
- Backend API: http://localhost:5000
- JWT-based authentication
- Protected routes for authenticated users
- Role-based access control (hosts vs regular users)
- Image upload with compression
- Gallery view with navigation
- Secure file storage
- Location-based search
- Price range filters
- Category/amenity filters
- Sort options
- Location picker for hosts
- Map view of listings
- Distance-based search
- POST /api/auth/register
- POST /api/auth/login
- GET /api/auth/me
- GET /api/food-experiences
- GET /api/food-experiences/:id
- POST /api/host/food-experiences
- PUT /api/host/food-experiences/:id
- GET /api/stays
- GET /api/stays/:id
- POST /api/host/stays
- PUT /api/host/stays/:id
- Ensure images are less than 10MB
- Check file type (JPEG, PNG)
- Check file size limits