🏔️ Travel Platform by Pahari Yatri

Connecting travellers with authentic local experiences across the Himalayas

---

📖 Overview

Travel Platform by Pahari Yatri (https://app.pahariyatri.com) is a community-driven travel marketplace built by Pahari Yatri (https://www.pahariyatri.com) that bridges the gap between adventurous travellers and trusted local service providers across Himalayan regions. The platform enables locals to list services (guides, homestays, transport, experiences) while giving travellers a curated, verified directory with custom multi-day trip building, real-time booking, and escrow payment support.

🗂 This repo contains the Next.js frontend for app.pahariyatri.com. The backend REST API lives in a separate repository.

---

✨ Features

• 🔍 Discover Local Services — Browse verified guides, homestays, transport & experiences
• 💬 Real-time Chat — Connect with service providers directly in-app
• 🔔 Push Notifications — Stay updated on bookings, messages & offers
• 🌐 Multilingual (i18n) — Supports Hindi (hi) and English (en) out of the box
• 💳 Razorpay Payments — Seamless INR checkout for bookings
• 📱 PWA-ready — Installable on mobile, works offline
• 🗺️ SEO & Sitemap — Auto-generated sitemaps and robots.txt

---

🛠️ Tech Stack

Layer	Technology
Framework	Next.js 16 (App Router, standalone output)
Language	TypeScript 5
Styling	Tailwind CSS 3
State	Zustand 5
i18n	next-intl + dictionary files
Payments	Razorpay
Push	Web Push / VAPID
Runtime	Node 22 (see .nvmrc)

---

🚀 Getting Started

Prerequisites

• Node.js >=22 (use nvm use if you have nvm)
• npm >=10
• A running instance of the Pahari Yatri backend API

1 — Clone & Install

git clone [email protected]:pahariyatri/local-connect-app.git
cd local-connect-app
npm install --legacy-peer-deps

2 — Configure Environment

cp .env.example .env.local
# Open .env.local and fill in your values

Tip: The API client automatically appends /api/v1 to NEXT_PUBLIC_API_BASE_URL. Set only the bare host — e.g. http://localhost:4000, not http://localhost:4000/api/v1.

3 — Start the Dev Server

npm run dev
# → http://localhost:3000

---

⚙️ Available Scripts

Command	Description
npm run dev	Start local development server with hot-reload
npm run build	Create optimised production build (standalone)
npm run start	Serve the production build locally
npm run lint	Run ESLint across the project

---

🌿 Environment Variables

Copy .env.example → .env.local and configure:

Variable	Required	Description
NEXT_PUBLIC_API_BASE_URL	✅	Base URL of the backend API (no /api/v1 suffix)
NEXT_PUBLIC_RAZORPAY_KEY_ID	✅	Razorpay public key for checkout
NEXT_PUBLIC_VAPID_PUBLIC_KEY	Optional	Web Push public key
NEXT_PUBLIC_GTM_ID	Optional	Google Tag Manager container ID — loads GTM, which owns GA4/portal event tracking (lib/analytics.ts). Blank = tracking off, nothing loads.
NEXT_PUBLIC_GA_ID	Optional	Legacy — not read by any code path today
NEXT_PUBLIC_SENTRY_DSN	Optional	Sentry DSN for error monitoring
NEXT_PUBLIC_ENABLE_CHAT	Optional	Feature flag — enable real-time chat (default: true)
NEXT_PUBLIC_ENABLE_NOTIFICATIONS	Optional	Feature flag — enable push notifications (default: true)

⚠️ All NEXT_PUBLIC_* variables are baked in at build time. When building the Docker image, pass them as build args (see below).

---

🐳 Docker

Build & Run

# Build — inject the API URL at build time
docker build \
  --build-arg NEXT_PUBLIC_API_BASE_URL=https://api.pahariyatri.com \
  -t pahariyatri-local-connect .

# Run
docker run -p 3000:3000 pahariyatri-local-connect

⚠️ For Docker/Next.js standalone builds, all NEXT_PUBLIC_* variables — including NEXT_PUBLIC_GTM_ID — are baked into the client bundle at build time, not read at container runtime. Setting NEXT_PUBLIC_GTM_ID (or any NEXT_PUBLIC_* var) only on the running container via docker run -e ... or a platform's runtime-env panel is not enough — the bundle copied into the final image has already been compiled without it. To enable GTM tracking, pass it to the build itself:

docker build \
  --build-arg NEXT_PUBLIC_API_BASE_URL=https://api.pahariyatri.com \
  --build-arg NEXT_PUBLIC_GTM_ID=GTM-XXXXXXX \
  -t pahariyatri-local-connect .

Docker Compose

NEXT_PUBLIC_API_BASE_URL=https://api.pahariyatri.com docker compose up --build

The Docker image uses Next.js standalone output for a minimal runtime footprint and runs as a non-root user with a healthcheck on /.

---

🌐 Deployment

Platform	How
Vercel	Import repo → set NEXT_PUBLIC_* env vars (including NEXT_PUBLIC_GTM_ID if using GTM) → deploy. No Dockerfile needed — Vercel handles the build-time inlining itself.
Fly.io / Render / ECS / K8s	Build the image with the correct NEXT_PUBLIC_API_BASE_URL and NEXT_PUBLIC_GTM_ID build args → deploy the container. A platform's runtime env-var panel is not sufficient for these — see the Docker section above.

This is the beginning of the README. Read the rest at the original. Read the full README ↗