Overview
What is MyEasyGuide?
MyEasyGuide is a Nepal-focused travel marketplace that connects travelers with local activity providers. The platform allows travelers to browse, book, and review treks, tours, and activities across Nepal. Suppliers manage their listings and availability, while administrators oversee the entire marketplace.
The project consists of three independently deployable sub-projects housed in a single monorepo:
| Directory | Purpose | Framework | Port |
|---|---|---|---|
api.myeasyguide.com/ | REST API backend | Express 5 + TypeScript | 3000 |
cms-myeasyguide/ | Content management system | Next.js 16 (App Router) | — |
myeasyguide.com/ | Public frontend | Next.js 15 (App Router) | 3001 |
Who uses the platform?
| Role | What they can do |
|---|---|
| Travelers (Users) | Browse activities, search, book trips, pay online, leave reviews, manage wishlists |
| Suppliers | Register, manage activity listings, set availability, view bookings and revenue |
| Authors | Write blog posts and travel guides via the CMS |
| Admins | Oversee everything — approve suppliers, manage trips, users, content, revenue |
| Visitors | Browse public content, read blogs, view activities (no login required) |
Key capabilities
- Activity management — CRUD for treks, tours, and activities with rich metadata (itinerary, inclusions, pricing, difficulty levels)
- Booking & payments — Full booking flow with Stripe Checkout integration, payment webhooks, automatic booking confirmation
- Supplier dashboard — Suppliers manage their own listings, availability, bookings, and revenue
- Content management — Blog posts and travel guides via a dedicated CMS with categories, tags, authors, and SEO metadata
- AI content generation — Automated batch blog post generation using Anthropic's Claude API
- Recommendations — ML-based "You may also like" suggestions powered by Recombee
- Popularity scoring — Automatic cron-based scoring of activities based on views, bookings, and ratings
- Reviews & ratings — Post-booking review system with aggregated rating statistics
- Image management — Cloudflare Images for delivery, Sharp for server-side processing
- Newsletter — Email subscription management with Resend for transactional emails
- SEO — Canonical URLs, structured data (JSON-LD), sitemap generation, slug-based routing
- Admin dashboards — Separate admin panels for the main platform (activities/bookings/users) and the CMS (content)