📍 SnapMap

A hyperlocal, map-based photo sharing app designed for college campuses.

SNAP-MAP allows students to instantly capture photos and share them on a live campus map. All photos are geo-tagged, stored securely, and shown as clusters/bubbles on a dynamic map. Students can explore events happening around them, view photos contributed by others, and participate in the campus community in real time.

---

🚀 Features

📸 Camera & Upload

• Capture photos directly using the in-app camera
• Auto-attaches GPS coordinates
• Uploads securely to Azure Blob Storage
• Preview + retake option

🗺️ Map-Based Discovery

• Interactive map with user location
• Bubbles indicate photos uploaded around campus
• Clustered markers for multiple events or heavy hotspots
• Tap a bubble → see All Photos or Event-wise Photos

🎉 Event Clustering

• System auto-detects events based on photo density + proximity
• Groups photos under event IDs
• Shows “hotspot” visuals on the map

👤 User Accounts (via Clerk)

• College email login (domain restricted)
• Secure sessions
• View your uploaded photos
• Manage profile + logout

📂 Profile & Gallery

• All uploads in a grid
• Delete option
• Event galleries with horizontal swipe viewer

---

🧱 Tech Stack

Frontend

• React Native (Expo)
• Expo Camera + Expo Location
• Mapbox or react-native-maps
• Axios for API calls
• Clerk for authentication

Backend

• Node.js + Express
• Clerk server-side JWT verification
• Mongoose + MongoDB Atlas
• Azure Blob Storage (file storage only)

Database

• MongoDB Atlas
  • Users
  • Photos
  • Events
  • Geospatial queries enabled

File Storage

• Azure Blob Storage
  • All images compressed + uploaded here
  • URLs stored in MongoDB

---

API Endpoints

All endpoints are prefixed with /api/v1

Health Check

GET /health

• Description: Server health check
• Auth Required: No
• Response:

  { "status": "ok" }

---

Authentication

POST /auth/login

• Description: User login endpoint (placeholder)
• Auth Required: No
• Response: "Login call"

POST /auth/signup

• Description: Register a new user with Clerk authentication
• Auth Required: Yes (Clerk JWT)
• Request Body:

  {
    "clerkId": "string",
    "email": "string",
    "rollNumber": "string"
  }

POST /auth/profile-update

• Description: Update user profile information
• Auth Required: Yes (Clerk JWT)
• Content-Type: multipart/form-data
• Form Data:
  • profileImg (file): Profile image (max 10MB)
  • Other user fields

---

Photos

GET /photos/ping

• Description: Photo service health check
• Auth Required: No
• Response:

  { "pong": true }

POST /photos/upload-photo

• Description: Upload a single photo with GPS coordinates
• Auth Required: Yes (Clerk JWT)
• Content-Type: multipart/form-data
• Form Data:
  • photo (file): Image file (max 10MB)
  • latitude (number): GPS latitude
  • longitude (number): GPS longitude
• Response: Photo object with Azure Blob URL

POST /photos/upload-photos

• Description: Upload multiple photos (max 10) at once
• Auth Required: Yes (Clerk JWT)
• Content-Type: multipart/form-data
• Form Data:
  • photos[] (files): Up to 10 image files
  • GPS coordinates for each photo
• Response: Array of photo objects

POST /photos/test-upload

• Description: Test photo upload endpoint (for debugging)
• Auth Required: No
• Content-Type: multipart/form-data
• Form Data:
  • photo (file): Test image file

GET /photos/all-photos

• Description: Retrieve all uploaded photos
• Auth Required: No
• Response: Array of all photo objects with URLs and metadata

Auth routes need Authorization: Bearer <clerk_token> header. Max image size is 10MB.

📂 Project Structure

SnapMap/                         → Project root
│
│   CONTRIBUTING.md               → Contribution guidelines
│   README.md                     → Project overview
│
├── backend/                      → Backend API
│   │   package-lock.json
│   │   package.json
│   │   server.js                 → Server entry point
│   │   v1.js                     → /api/v1 all routes are here
│   │
│   ├── config/
│   ├── controllers/              → Request handlers
│   ├── db/                       → Database setup
│   ├── middleware/               → Request middleware
│   ├── models/                   → Database models
│   ├── routes/                   → API routes
│   └── utils/                    → Helper utilities
│
├── contributors/                 → Contributor records
│   └── <your_roll_no>.txt
│
├── frontend/                     → Mobile frontend
│   │   .gitignore
│   │   app.config.ts             → Expo app config
│   │   babel.config.js
│   │   index.js                  → App entry point
│   │   package-lock.json
│   │   package.json
│   │
│   ├── .expo/
│   │   │   devices.json
│   │   │   README.md
│   │   │   settings.json
│   │
│   └── src/
│       │   App.js                → Root component
│       │
│       ├── assets/               → Images & fonts
│       ├── components/           → Reusable UI
│       ├── context/
│       ├── navigation/           → App navigation
│       ├── screens/              → App screens
│       └── services/             → API services
│
└── UI-UX/                        → Design resources
    └── contributors/             → UI/UX credits

---

🤝 Contributing

• Submit PRs after reading CONTRIBUTING.md

---

💬 Contact

Reach out to me on Discord, ID: terrormanzero aka terror_quota

Our Server: https://bit.ly/OpencodeDiscord