ActionBit - Tactical Hub

Tactical Hub is a specialized strategic field overlay application designed for tactical simulations (like Milsim or Airsoft) and team-based coordination. It utilizes real-time geolocation and map overlays to synchronize players on a shared battlefield.

Here is a breakdown of the app's core functions:

1. Mission Creation & "Operation Alpha" Setup
Mission Hosting: A "Commander" (Creator) can start a new operation by naming it and setting up a secure session in the cloud (Firebase).

Map Overlays (Calibration): The app allows the creator to upload a custom image (such as a drone photo, a topographic map, or a site plan) and "anchor" it over the real Google Maps satellite view.

Fine-Tuning: Using a calibration panel, the creator can precisely adjust the latitude, longitude, scale (meters), and transparency of the custom map so it aligns perfectly with reality.

2. Real-Time Team Tracking
Live Positions: Every player’s GPS location is tracked and shared in real-time. Players appear as markers on the map.

Team Isolation: To maintain tactical realism (and prevent "cheating"), the app uses a Group & Password system. You can only see the markers of players who are in your own force or subgroups that you have unlocked with the correct password.

Force Structure: The app supports complex team hierarchies (e.g., BLUE FORCE vs. RED FORCE, with subgroups like Alpha, Beta, etc.).

3. Tactical Navigation Tools
MGRS Support: The app converts standard GPS coordinates into the Military Grid Reference System (MGRS), which is the standard for land navigation in tactical environments.

Dynamic Targeting: By clicking anywhere on the map, a player can set a "Target" (TGT). The app then:

Generates a visual line (Polyline) from the player to the target.

Calculates and displays the MGRS coordinates of the target.

Calculates the real-time distance (in meters or kilometers) to that objective.

4. Operation Lobby
Session Browsing: Players can see a list of active operations, the name of the commander, and the current player count.

Secure Join: Joining a session requires selecting a specific unit and entering the correct password provided by the organizer.

5. Persistent Identity
User Profiles: Players can set a custom alias (callsign) that is saved locally on their device and displayed to others on the map.

Automatic Cleanup: The app tracks "active" status. If a player closes the app, their marker eventually disappears, and the session player count is updated automatically.