A modern JavaScript implementation of the Find My Device server with full Android app compatibility.

FMD Server JS is a self-hosted server for the Find My Device Android app. Built with modern JavaScript/TypeScript, it provides full API compatibility with the Android app and features a responsive web dashboard for device management.

• 🔄 API Compatibility: Full compatibility with the FMD Android app
• 🔒 End-to-End Encryption: All sensitive data is encrypted on the device and can only be decrypted by you
• 🖥️ Modern Dashboard: React-based dashboard with real-time updates
• 📱 Responsive Design: Works on both desktop and mobile browsers
• 📍 Location Tracking: View and manage device locations with map visualization
• 📸 Remote Camera: Trigger and view device camera pictures
• 📊 Command System: Send commands to your devices remotely
• 🔔 Notifications: Get alerts when device states change
• 🛡️ Enhanced Security: Secure key management, password reset, and comprehensive audit logging

• Frontend: React, Tailwind CSS, React Query, Shadcn/UI components
• Backend: Node.js, Express, TypeScript, Drizzle ORM
• Database: SQLite (default, can be configured for PostgreSQL)
• Authentication: Passport.js (dashboard), Token-based auth (Android)
• Security: RSA-2048, AES-256-GCM, Argon2id for password hashing

fmd-server-js/
├── client/                # React frontend
│   ├── src/               # Source code
│   │   ├── components/    # UI components
│   │   ├── context/       # React context providers
│   │   ├── hooks/         # Custom React hooks
│   │   ├── lib/           # Utilities and helpers
│   │   └── pages/         # Page components
├── server/                # Express backend
│   ├── api.ts             # Android app API endpoints
│   ├── crypto.ts          # Encryption utilities
│   ├── index.ts           # Server entry point
│   ├── routes.ts          # Web dashboard API routes
│   └── storage.ts         # Database interface
├── shared/                # Shared code between client and server
│   └── db/                # Database schema and utilities
├── migrations/            # Database migrations
└── scripts/               # Utility scripts

• Node.js 18+
• npm or yarn

1. Clone the repository

   git clone https://github.com/yourusername/fmd-server-js.git
   cd fmd-server-js

2. Install dependencies

   npm install

3. Set up the database

   npm run db:setup

4. Start the development server

   npm run dev

5. Start the client (in a new terminal)

   cd client
   npx vite

6. Access the dashboard

   Open your browser and navigate to http://localhost:5173

7. Configure your Android app

   In the Find My Device Android app, set the server URL to http://your-server-ip:3000

• npm run dev - Start the development server
• npm run build - Build for production
• npm start - Run the production build
• npm run db:setup - Set up the database
• npm run db:migrate - Run database migrations
• npm run db:seed - Seed the database with sample data
• npm run db:studio - Open the database administration UI

1. Fork and clone the repository
2. Set up your development environment
3. Create a feature branch
4. Make your changes
5. Test your changes
6. Submit a pull request

We welcome contributions from everyone! Here's how you can help:

• Code: Implement new features or fix bugs
• Documentation: Improve or create documentation
• Bug Reports: Submit well-documented bug reports
• Feature Requests: Suggest new features or enhancements
• Reviews: Review pull requests from other contributors

1. Fork the repository and create your branch from main
2. Follow the code style of the project
3. Add or update tests as necessary
4. Ensure your code passes all tests
5. Update documentation if needed
6. Submit a pull request with a clear description of your changes

Security is a top priority for FMD Server JS:

• End-to-End Encryption: All sensitive data is encrypted on the device
• Key Management: Secure storage and handling of encryption keys
• Audit Logging: Comprehensive logging of security events
• Authentication: Secure password handling and token management

If you discover a security vulnerability, please email security@example.com instead of opening a public issue.

This project is open source and available under the MIT License.