{"id":29184201,"url":"https://github.com/kadirmetin/locatr","last_synced_at":"2025-07-04T00:04:33.123Z","repository":{"id":302245645,"uuid":"1009747666","full_name":"kadirmetin/locatr","owner":"kadirmetin","description":"Real-time family location tracking app with privacy-first approach. Built with React Native, Next.js, and Node.js.","archived":false,"fork":false,"pushed_at":"2025-07-01T09:47:42.000Z","size":1476,"stargazers_count":13,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-01T10:40:47.145Z","etag":null,"topics":["expo","express","family-safety","location-tracker","mapbox","mobile-app","mongodb","monorepo","nextjs","privacy-focused","react","react-native","real-time-tracking","socket-io","typescript","web-app"],"latest_commit_sha":null,"homepage":"https://locatr.tech","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kadirmetin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-27T16:36:34.000Z","updated_at":"2025-07-01T09:37:15.000Z","dependencies_parsed_at":"2025-07-01T10:41:10.226Z","dependency_job_id":"d272fedb-7f38-4f66-aa76-23f90e3de702","html_url":"https://github.com/kadirmetin/locatr","commit_stats":null,"previous_names":["kadirmetin/locatr"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/kadirmetin/locatr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadirmetin%2Flocatr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadirmetin%2Flocatr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadirmetin%2Flocatr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadirmetin%2Flocatr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kadirmetin","download_url":"https://codeload.github.com/kadirmetin/locatr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadirmetin%2Flocatr/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263035772,"owners_count":23403423,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["expo","express","family-safety","location-tracker","mapbox","mobile-app","mongodb","monorepo","nextjs","privacy-focused","react","react-native","real-time-tracking","socket-io","typescript","web-app"],"created_at":"2025-07-01T21:02:31.845Z","updated_at":"2025-07-01T21:06:57.889Z","avatar_url":"https://github.com/kadirmetin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📍 Locatr: Real-Time Family Location Tracker\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/ca0eb7ed-37f1-44fa-bec5-18390273f965\" alt=\"Locatr Logo\" width=\"256\" height=\"256\"\u003e\n\n  \n  **Track your family's location with Locatr**\n  \n  [![Website](https://img.shields.io/badge/Website-locatr.tech-blue?style=for-the-badge)](https://locatr.tech)\n  [![GitHub](https://img.shields.io/badge/GitHub-Repository-black?style=for-the-badge\u0026logo=github)](https://github.com/kadirmetin/locatr)\n  [![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)\n\u003c/div\u003e\n\n---\n\n## 🌟 Overview\n\nLocatr is a modern and secure family location tracking app designed to help families stay connected and ensure the safety of their loved ones. Developed using the latest technology and with a focus on privacy, Locatr offers real-time location sharing features. All of this is brought together in an intuitive and user-friendly interface.\n\n**Key Highlights:**\n- 🔒 **Privacy-First**: Your family's location data is encrypted and secure\n- 👨‍👩‍👧‍👦 **Family-Friendly**: Designed specifically for family use cases\n- 📱 **Cross-Platform**: Available on iOS, Android, and Web\n- ⚡ **Real-Time**: Instant location updates\n- 👁️ **No Data Mining**: We never sell, share, or monetize your personal data\n\n---\n\n## 🚀 Features\n\n### 📍 **Core Location Features**\n- **Real-Time Tracking**: Live location sharing with family members\n- **Battery Optimization**: Smart location updates to preserve device battery\n\n### 🎨 **User Experience**\n- **Intuitive Interface**: Clean, modern design that's easy to navigate\n- **Dark Mode**: Full dark mode support for comfortable viewing\n- **Accessibility**: Built with accessibility standards in mind\n- **Multilingual**: Support for multiple languages and regions\n\n---\n\n## 🛠️ Technology Stack\n\n### **📱 Mobile App (React Native + Expo)**\n- **React Native** - Cross-platform mobile development\n- **Expo** - Development platform and toolchain\n- **TypeScript** - Type-safe development\n- **Mapbox** - Advanced mapping functionality\n\n### **🌐 Web Application (Next.js)**\n- **Next.js** - React framework with SSR/SSG\n- **React** - Latest React with concurrent features\n- **TypeScript** - Type-safe development\n- **React Query** - Data fetching and caching\n- **React Leaflet** - Interactive mapping for web\n\n### **⚡ Backend Server (Node.js + Express)**\n- **Node.js** - Server-side JavaScript runtime\n- **Express.js** - Fast web application framework\n- **TypeScript** - Type-safe backend development\n- **MongoDB** - NoSQL database and ODM\n\n### **🔥 Infrastructure**\n- **Imagekit** - Image optimization and delivery\n- **Socket.io** - Real-time communication\n- **Docker** - Containerization and deployment\n\n### **💻 Development Tools**\n- **Monorepo Architecture** - Organized codebase\n- **ESLint \u0026 Prettier** - Code quality and formatting\n- **GitHub Actions** - CI/CD pipeline\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n- **Node.js** (v20 or higher)\n- **yarn**\n- **Android Stuido and Java SE Development Kit (JDK)** (for mobile development)\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/kadirmetin/locatr.git\n   cd locatr\n   ```\n\n2. **Install dependencies**\n   ```bash\n   yarn install\n   ```\n\n3. **Set up environment variables**\n\n4. **Start the development server**\n   ```bash\n   yarn dev\n   ```\n\n---\n\n## 📱 Screenshots\n\n### 🌐 Web Dashboard\n*Experience the full power of Locatr on desktop with our comprehensive web interface*\n\n\u003cdiv align=\"center\"\u003e\n  \n| **🏠 Landing Page** | **📊 Dashboard** | **🗺️ Live Map** | **📱 Devices** | **⚙️ Settings** |\n|:---:|:---:|:---:|:---:|:---:|\n| \u003cimg src=\"https://github.com/user-attachments/assets/e7962ea1-e2c2-403d-adc5-5f61a32c13cd\" alt=\"Landing Page\" width=\"180\"\u003e | \u003cimg src=\"https://github.com/user-attachments/assets/a3fde4d1-a1ee-425f-a5ef-c9d418413d20\" alt=\"Dashboard Overview\" width=\"180\"\u003e | \u003cimg src=\"https://github.com/user-attachments/assets/c5b3ef6a-2551-4d9f-8cf8-961d75c645ec\" alt=\"Live Map View\" width=\"180\"\u003e | \u003cimg src=\"https://github.com/user-attachments/assets/8c67f174-a2f5-4801-92c6-b7d163636cbc\" alt=\"Device Management\" width=\"180\"\u003e | \u003cimg src=\"https://github.com/user-attachments/assets/e21fd48f-bd19-4b81-bb2f-a89c4ea844a1\" alt=\"Settings Panel\" width=\"180\"\u003e |\n| *Welcome to Locatr* | *Family overview* | *Real-time tracking* | *Manage devices* | *Customize experience* |\n\n\u003c/div\u003e\n\n---\n\n### 📱 Mobile Application\n*Stay connected on-the-go with our intuitive mobile experience*\n\n\u003cdiv align=\"center\"\u003e\n  \n| **👋 Welcome Screen** | **🏠 Home Dashboard** | **⚙️ Settings**\n|:---:|:---:|:---:|\n| \u003cimg src=\"https://github.com/user-attachments/assets/ca747648-348e-48fe-b49a-8ad416bb7f54\" alt=\"Mobile Welcome Screen\" width=\"250\"\u003e | \u003cimg src=\"https://github.com/user-attachments/assets/c2a5b0b1-6bd9-47d9-a8ea-61f1459e3b4e\" alt=\"Mobile Home Screen\" width=\"250\"\u003e | \u003cimg src=\"https://github.com/user-attachments/assets/ef9ad808-4188-4ae4-b3b5-589b0dacd5c8\" alt=\"Mobile Settings\" width=\"250\"\u003e\n| *Get started with Locatr* | *Track your family members* | *Customize experience* |\n\n\u003c/div\u003e\n\n---\n\n## 🔧 Configuration\n\n### Environment Variables\n\nCreate a `.env` file in the root directory of each application:\n\n```env\n# Mobile\nEXPO_NO_METRO_WORKSPACE_ROOT=true\nEXPO_PUBLIC_API_BASE_URL=\"http://localhost:8000/api/v1\"\nEXPO_PUBLIC_SOCKET_BASE_URL=\"http://localhost:8000\"\nEXPO_PUBLIC_WEB_APP_URL=\"http://localhost:3000\"\nMAPBOX_READ_DOWNLOAD_TOKEN=\"\"\nEXPO_PUBLIC_MAPBOX_ACCESS_TOKEN=\"\"\n\n# Server\nAPP_ORIGIN=\"http://localhost:3000\"\nSERVER_PORT=5000\nBASE_PATH=\"/api/v1\"\nMONGO_URI=\"\"\nJWT_SECRET=\"\"\nJWT_EXPIRES_IN=\"15m\"\nJWT_REFRESH_SECRET=\"\"\nJWT_REFRESH_EXPIRES_IN=\"7d\"\nRESEND_API_KEY=\"\"\nRESEND_MAILER_SENDER=\"\"\nIMAGEKIT_PUBLIC_KEY=\"\"\nIMAGEKIT_URL_ENDPOINT=\"\"\nIMAGEKIT_PRIVATE_KEY=\"\"\nADMIN_EMAIL=\"\"\n\n# Web\nNEXT_PUBLIC_WEB_APP_URL=\"http://localhost:3000\"\nNEXT_PUBLIC_API_BASE_URL=\"http://localhost:5000/api/v1\"\nNEXT_PUBLIC_SOCKET_BASE_URL=\"http://localhost:5000\"\nNEXT_PUBLIC_CAPTCHA_SITE_KEY=\"\"\nCAPTCHA_SECRET_KEY=\"\"\nNEXT_PUBLIC_IMAGEKIT_URL_ENDPOINT=\"\"\nNEXT_PUBLIC_MAPBOX_ACCESS_TOKEN=\"\"\nNEXT_PUBLIC_GA_ID=\"\"\nNEXT_PUBLIC_GTM_ID=\"\"\nNEXT_PUBLIC_C15T_URL=\"\"\n\n```\n---\n\n## 🚀 Deployment\n\n### Production Build\n```bash\n# Build all applications\nyarn build\n\n# Build specific app\ncd apps/mobile \u0026\u0026 eas build --platform android --profile production\ncd apps/web \u0026\u0026 yarn build\ncd apps/server \u0026\u0026 yarn build\n```\n---\n\n## 📋 Roadmap\n\n### 🎯 **Version 2.0** (Q4 2025)\n- [ ] **Advanced Analytics**: Location patterns and insights\n- [ ] **...and more to be added!**\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.\n\n### How to Contribute\n\n1. **Fork the repository**\n2. **Create a feature branch**\n   ```bash\n   git checkout -b feature/amazing-feature\n   ```\n3. **Make your changes**\n4. **Test your changes**\n5. **Commit your changes**\n   ```bash\n   yarn commit\n   ```\n6. **Push to your branch**\n   ```bash\n   git push origin feature/amazing-feature\n   ```\n7. **Open a Pull Request**\n\n### Development Guidelines\n\n- **Code Style**: Follow ESLint and Prettier configurations\n- **Testing**: Make sure all changes work\n- **Commit Messages**: Use conventional commit format\n\n### Bug Reports \u0026 Feature Requests\n\n- **🐛 [Report a Bug](https://github.com/kadirmetin/locatr/issues/new)**\n- **✨ [Request a Feature](https://github.com/kadirmetin/locatr/issues/new)**\n\n---\n\n## 🔒 Privacy \u0026 Security\n\nLocatr takes privacy and security seriously:\n\n- **🎯 Minimal Data Collection**: We only collect data necessary for core functionality\n- **👤 User Control**: Users have full control over their data and sharing preferences\n- **🛡️ Regular Security Audits**: Regular third-party security assessments\n- **📜 Transparent Privacy Policy**: Clear and comprehensive privacy policy\n\nFor more details, read our [Privacy Policy](https://locatr.tech/privacy) and [Terms of Service](https://locatr.tech/terms).\n\n---\n\n## 📞 Support \u0026 Community\n\n### Getting Help\n\n- **📧 [Email Support](mailto:support@locatr.tech)** - Direct support for urgent issues\n- **🐛 [GitHub Issues](https://github.com/kadirmetin/locatr/issues)** - Report bugs and request features\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 Acknowledgments\n\n### Special Thanks\n\n- **Open Source Community**: For the incredible tools and libraries that make this possible\n- **Family \u0026 Friends**: For inspiration and continuous support\n\n### Built With Love By\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/kadirmetin\"\u003e\n    \u003cimg src=\"https://github.com/kadirmetin.png\" width=\"60\" height=\"60\" alt=\"Kadir Metin\" style=\"border-radius: 50%;\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  \u003cstrong\u003eKadir Metin\u003c/strong\u003e\n  \u003cbr\u003e\n  \u003cem\u003eFull Stack Developer\u003c/em\u003e\n  \u003cbr\u003e\n  \u003ca href=\"https://kadirmetin.dev\"\u003eWebsite\u003c/a\u003e • \n  \u003ca href=\"https://github.com/kadirmetin\"\u003eGitHub\u003c/a\u003e • \n  \u003ca href=\"https://linkedin.com/in/kadirmetin\"\u003eLinkedIn\u003c/a\u003e\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cstrong\u003eMade with ❤️ for families everywhere\u003c/strong\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  \n  ⭐ **Star this repository if you find it helpful!** ⭐\n  \n  \u003cbr\u003e\n  \n  [![GitHub Stars](https://img.shields.io/github/stars/kadirmetin/locatr?style=social)](https://github.com/kadirmetin/locatr/stargazers)\n  [![GitHub Forks](https://img.shields.io/github/forks/kadirmetin/locatr?style=social)](https://github.com/kadirmetin/locatr/network/members)\n  [![GitHub Watchers](https://img.shields.io/github/watchers/kadirmetin/locatr?style=social)](https://github.com/kadirmetin/locatr/watchers)\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkadirmetin%2Flocatr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkadirmetin%2Flocatr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkadirmetin%2Flocatr/lists"}