🏔️ 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. |
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
