Skip to content

Key Features - NepWalk MVP

MVP Features (v1.2)

1. User Authentication

  • Email/password registration and login
  • Google OAuth 2.0 (primary method)
  • JWT session handling (7-day expiry)
  • Forgot password flow

2. Trip Management

  • Create trips with auto-generated slug ({title-slug}-{YYYY}-{4-char-random})
  • Edit trip details (title, description, start date, number of people)
  • Delete trips (with confirmation)
  • Visibility toggle (Private/Public)
  • Trip Leader is auto-assigned on creation

3. Timeline Builder (Core Feature)

  • Day-wise itinerary structure
  • Activities with start_time, end_time, title, description, location, map_link, notes
  • Time validation: 05:00-23:00, no overlaps, end > start
  • Duration auto-calculated
  • Up/Down reorder (no drag-drop)
  • No cross-midnight activities

4. Trip Member Management

  • Invite members by email (registered + pending)
  • Remove members
  • Access control: Trip Leader (full) vs Trip Visitor (view-only)
  • Public trip sharing via slug URL

5. Package System

Personal Packages (My Packages):

  • Save trip as personal package
  • Use package to create new trip
  • View, rename, delete own packages

Global Packages (Explore):

  • 4-5 curated popular Nepal packages seeded by Admin
  • Visible on landing page for unauthenticated users
  • "Plan this Trip" redirects to login, then creates trip

6. Version Log

  • Triggers: add, delete, time change, reorder
  • Field edits (title, notes) do NOT trigger
  • Version number auto-increment
  • Optional change description
  • Trip-level granularity (one entry per save action)

7. Push Notifications

  • Native Web Push API with VAPID keys (no Firebase)
  • Auto-subscribed on joining trip
  • Triggers: activity added, deleted, time changed

8. PWA Support

  • Web app manifest
  • Service worker (cache static assets)
  • Installable on device
  • Offline viewing (previously loaded)

User Roles (MVP)

Role Scope Description
Traveler System Default on registration. Create trips, use packages.
Trip Leader Trip Creator of a trip. Full edit access.
Trip Visitor Trip Invited member. View-only access.
Admin System Seeded in DB. Full system access.

Out of Scope (MVP)

  • AI itinerary generation
  • Vendor portals / Hotel dashboards
  • Payment system / Booking engine
  • Email notifications (push only)
  • Offline editing
  • Drag-drop reorder
  • Guide/Agent trip roles

Future Features (Post-MVP)

  • Vendor Marketplace (2027)
  • Traveler-Facing Booking (2028)
  • AI itinerary planning
  • Government/rescue integration
  • Guide and Agent as trip-level roles