An immersive web platform for exploring Sikkim's sacred monasteries through 360Β° virtual tours, interactive maps, multilingual audio guides, a cultural events calendar, a digital archive of ancient artifacts, and an AI-powered guide.
| Feature | Description |
|---|---|
| π 360Β° Virtual Tours | Immersive monastery walkthroughs using A-Frame & Three.js |
| πΊοΈ Interactive Map | Explore all sacred sites across Sikkim with filters by location, century, and festival |
| π Digital Archive | Browse 847+ digitally preserved manuscripts, murals, prayer scrolls, and ritual artifacts |
| π§ Audio Guides | Multilingual narrations with offline support and per-monastery playlists |
| π Cultural Calendar | Upcoming monastery events, festivals, and ceremonies |
| π€ AI Guide (Gemini) | Ask questions about monasteries β powered by Gemini 1.5 Flash |
| π Firebase Auth | Sign in with Google/Email via Firebase Authentication |
| π Dark / Light Mode | Full theme toggle across all pages |
| π Community | Shared experiences and user-contributed content |
Monastery360/
βββ backend/ # Spring Boot (Java 17)
β βββ src/main/java/com/monastery360/
β βββ controller/
β β βββ MonasteryController.java # GET /api/monasteries
β β βββ EventController.java # GET /api/events
β β βββ HealthController.java # GET /health
β βββ model/ # Monastery, Event
β βββ dto/ # ApiResponse<T>
β βββ service/ # In-memory service layer
β
βββ src/ # React + TypeScript frontend
β βββ components/ # Pages, UI, 360Β° viewers
β βββ contexts/ # Auth, Chatbot context
β βββ data/ # Audio metadata
β βββ lib/firebase.ts # Firebase init
β βββ services/gemini.ts # Gemini REST integration
β βββ App.tsx # Router & layout
β βββ main.tsx # Entry point
β
βββ public/ # Static audio/video assets
βββ build/ # Production build output
βββ vite.config.ts # Dev server, proxy, asset config
βββ firebase.json
βββ vercel.json
Frontend
- Vite 6 + React 18 + TypeScript
- Tailwind CSS 4 + Radix UI + Framer Motion
- A-Frame + Three.js β 360Β° viewer
- @react-google-maps/api β interactive maps
Backend
- Spring Boot 3 (Java 17)
- RESTful JSON APIs wrapped in
ApiResponse<T>
Cloud & AI
- Firebase β Auth, Firestore, Analytics
- Google Gemini 1.5 Flash β AI chatbot (REST)
- Node.js 18+ and npm
- Java 17 and Maven
- Firebase project (for Auth / Firestore)
- Google Cloud API key (for Gemini chatbot β optional)
git clone https://github.com/Rishankgupta08/Monastery360.git
cd Monastery360npm install
npm run dev
# Runs at http://localhost:3000cd backend
mvn spring-boot:run
# Runs at http://localhost:8080Create a .env file at the project root:
# Firebase (required for Auth & Firestore)
VITE_FIREBASE_API_KEY=...
VITE_FIREBASE_AUTH_DOMAIN=...
VITE_FIREBASE_PROJECT_ID=...
VITE_FIREBASE_STORAGE_BUCKET=...
VITE_FIREBASE_MESSAGING_SENDER_ID=...
VITE_FIREBASE_APP_ID=...
# Gemini AI chatbot (optional but recommended)
VITE_GEMINI_API_KEY=...Vite only exposes variables prefixed with
VITE_to the browser.
Base URL: http://localhost:8080
| Method | Endpoint | Description |
|---|---|---|
| GET | / |
Health check string |
| GET | /health |
Basic health response |
| GET | /api/health |
{ success: true, data: "ok" } |
| GET | /api/monasteries |
{ success: true, data: Monastery[] } |
| GET | /api/events |
{ success: true, data: Event[] } |
All responses are wrapped in ApiResponse<T>. Dev CORS allows http://localhost:3000.
npm run build
# Output: /build directoryDeploy the /build folder to any static host β Firebase Hosting, Vercel, Netlify, or S3/CloudFront. Ensure backend CORS is configured for your production origin.
- Media files live under
public/assets/{audio,videos}/ - Supported formats:
.mp3,.mp4,.mkv,.webm,.ogg - Vite's
assetsIncludeconfig handles all media types - See
AUDIO_INTEGRATION_GUIDE.mdandAUDIO_PLAYBACK_EXPLAINED.mdfor details
- Firebase config is loaded from
VITE_FIREBASE_*env vars insrc/lib/firebase.ts - Analytics is initialized only in browser environments where supported
- Gemini integration lives in
src/services/gemini.tsβ setVITE_GEMINI_API_KEYto enable
Additional guides included in the repo:
FIREBASE_SETUP.mdβ initial project configurationFIREBASE_AUTH_FIX.mdβ common auth troubleshootingFIREBASE_CONSOLE_CHECKLIST.mdβ pre-launch checklistCURRENT_SETUP_GUIDE.mdβ complete local setup walkthroughFINAL_IMPLEMENTATION_SUMMARY.mdβ architecture summary
| Issue | Fix |
|---|---|
| Backend unreachable banner | Ensure backend runs on :8080 or update vite.config.ts proxy |
| CORS errors | Verify @CrossOrigin on controllers matches your frontend origin |
| Firebase init errors | Confirm all VITE_FIREBASE_* env vars match your Firebase project |
| Gemini returns null | Verify VITE_GEMINI_API_KEY is set and the Gemini endpoint is reachable |
| Audio/video not loading | Confirm file types are in vite.config.ts assetsInclude and files exist under public/ |
This project is provided as-is for demonstration and educational purposes. Please add an appropriate license file if you intend to use or redistribute it.