Thanks to visit codestin.com
Credit goes to github.com

Skip to content

A secure family location tracking system built with React, TypeScript, and Leaflet maps.

License

Notifications You must be signed in to change notification settings

odaysec/family-secure

Repository files navigation

FamilySecure | Home Location

FamilySecure Banner

A secure family location tracking system built with React, TypeScript, and Leaflet maps.

🌟 Features

πŸ—ΊοΈ Real-time Location Tracking

  • Interactive map interface with custom markers
  • Real-time location updates for family members
  • Battery level and device status monitoring
  • Historical movement paths and patterns

🎯 Geo-Fencing

  • Create circular geo-fences with customizable radius
  • Set entry/exit notifications for specific family members
  • Visual representation on the interactive map
  • Active/inactive fence toggling

πŸ‘₯ Family Member Management

  • Role-based access control (Admin, Family, Child)
  • Device tracking and management
  • Online/offline status monitoring
  • Activity history and statistics

πŸ“Š Statistics & Analytics

  • Distance traveled tracking
  • Time spent at locations
  • Battery level history
  • Movement pattern analysis

πŸ”” Smart Notifications

  • Geo-fence entry/exit alerts
  • Battery level warnings
  • Device offline notifications
  • Real-time status updates

βš™οΈ Advanced Settings

  • Security & privacy controls
  • System configuration
  • Database management
  • Tracking preferences

πŸš€ Tech Stack

  • Frontend: React 18, TypeScript
  • Mapping: Leaflet with React-Leaflet
  • Styling: Tailwind CSS
  • Icons: Lucide React
  • Date Handling: date-fns
  • Routing: React Router DOM

πŸ“¦ Installation

  1. Clone the repository:
git clone https://github.com/odaysec/family-secure.git
cd family-secure
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev

πŸ”§ Configuration

Environment Variables

Create a .env file in the root directory:

VITE_MAP_TILE_LAYER=https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
VITE_DEFAULT_CENTER_LAT=-6.2088
VITE_DEFAULT_CENTER_LNG=106.8456

πŸ—οΈ Building for Production

  1. Build the project:
npm run build
  1. Preview the production build:
npm run preview

πŸš€ Deployment

Netlify

  1. Create a new site on Netlify
  2. Connect your GitHub repository
  3. Configure build settings:
    • Build command: npm run build
    • Publish directory: dist
  4. Deploy!

πŸ” Security Features

  • End-to-end encryption for location data
  • Role-based access control
  • Secure authentication system
  • Privacy-focused data handling
  • Customizable data retention policies

🎨 Customization

Theme Colors

The project uses a cyberpunk theme with customizable colors in tailwind.config.js:

colors: {
  'cyber-black': '#0c0c0f',
  'cyber-dark': '#121218',
  'cyber-gray': '#1e1e26',
  'cyber-light': '#2a2a36',
  'neon-green': '#00ff9d',
  'neon-blue': '#00f0ff',
  'alert-red': '#ff355e',
  'alert-orange': '#ff9f1c'
}

πŸ“± Mobile Responsiveness

The application is fully responsive and works on:

  • Desktop browsers
  • Tablets
  • Mobile devices

🀝 Contributing

  1. Fork the repository
  2. Create your feature branch: git checkout -b feature/AmazingFeature
  3. Commit your changes: git commit -m 'Add some AmazingFeature'
  4. Push to the branch: git push origin feature/AmazingFeature
  5. Open a pull request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • OpenStreetMap for map tiles
  • React and TypeScript communities
  • All contributors and users

πŸ“ž Contact

🌟 Support

If you found this project helpful, please give it a ⭐️ on GitHub!

About

A secure family location tracking system built with React, TypeScript, and Leaflet maps.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published