Home
TerraQuest is a nature-first platform inspired by eBird and iNaturalist, designed to encourage wildlife conservation, birdwatching, trail exploration, and nature photography.
Driven by a deep passion for both nature and technology, TerraQuest provides a dedicated space where users can:
- Log and track wildlife sightings
- Share observations with media
- Contribute to citizen science and conservation efforts
- 📍 Track & Log Sightings — Submit observations of birds, mammals, insects, fungi, and plants.
- 🗺️ Trail Tracking — Track movement via GPS or manually plot trails; attach multiple sightings.
- 📸 Media Uploads & Peer Reviews — Add photos, audio, and videos. Get validation through community reviews.
- 🏆 Gamified Leaderboard — Explore and contribute to climb the ranks!
- 👥 Community & Collaboration — Engage in forums, plan meetups, and improve your wildlife photography.
Note: This is the planned feature list and may evolve over time.
- Framework: React.js with Vite for lightning-fast performance
- UI: Tailwind CSS / ShadCN for responsive, modern interfaces
- Maps & Geolocation: Leaflet.js / Google Maps API
- Media Uploads: Firebase Storage / Cloudinary
- Auth: NextAuth.js / Firebase Auth (JWT & Google OAuth)
- Framework: Express.js REST API
- Database: MongoDB + Mongoose
- Authentication: JWT + Google OAuth
- Geospatial Queries: MongoDB $geoNear
- API Integrations: Google Maps API, eBird API, iNaturalist API (future scope)
- Frontend: Vercel / Netlify
- Backend: Railway / Render / DigitalOcean
- Database Hosting: MongoDB Atlas
- Media Storage: Firebase / Cloudinary
- Monitoring: LogRocket (frontend), Datadog (backend)
- Log wildlife observations with species name, location, date, and media
- Discover nearby sightings using geospatial filters
- GPS-based live tracking & manual plotting (upcoming)
- Visualize high-density wildlife zones via heatmaps & hotspots
- Rate photos & offer constructive photography feedback
- Join forums and discussion groups to connect with other enthusiasts
- JWT & Google OAuth
- User dashboards for tracking personal sightings and trails
- 🚀 AI Species Recognition (Google Vision / TensorFlow.js)
- 👀 Computer Vision for auto-rating photo quality
- 🤖 ML-based wildlife movement prediction
This wiki serves as a live overview of TerraQuest's direction. Feature rollout and progress can be tracked via the main project roadmap.
We welcome your contributions! Please follow the steps below to get started:
- Fork the repository
- Clone to your system:
git clone <your-forked-repo-url>
- Ensure Node.js & npm are installed
cd terraquest
cd frontend && npm install
cd ../backend && npm install# Frontend
cd ../frontend
npm run dev
# Backend
cd ../backend
npm run server# Format before committing
npm run format:file <file-path>
git add .
git commit -m "Describe your changes"
git push origin <your-branch-name>Then, open a Pull Request on GitHub. Make sure all workflows pass.
Once reviewed, your PR will be merged. 🎉