> For the complete documentation index, see [llms.txt](https://adatrack-io.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adatrack-io.gitbook.io/docs/readme.md).

# Welcome to AdaTrack

AdaTrack is a high-performance, full-stack IoT tracking platform designed for real-time geospatial analytics. It is engineered to process high-throughput UDP telemetry, execute dynamic payload decoding, and provide real-time visualization for thousands of assets.

<h2 align="center">The Foundation for Your IoT Fleet</h2>

<p align="center">From low-power battery-operated sensors to high-speed vehicle trackers, AdaTrack provides the infrastructure to ingest, process, and visualize your data.</p>

<p align="center"><a href="/spaces/8Ys0or8cn4JHMI9K2Lr5/pages/PrW85wq8nmPhC3AJps1p" class="button primary">Get Started</a> <a href="https://github.com/xpointsolution/adatrack/" class="button secondary">GitHub Repository</a></p>

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-bolt">:bolt:</i></td><td><strong>High Throughput</strong></td><td>Built with Go and Kernel-tuned UDP ingestion to handle millions of packets.</td><td><a href="/spaces/8Ys0or8cn4JHMI9K2Lr5/pages/9JWG7B4rNsa6jQRxgTeW">/spaces/8Ys0or8cn4JHMI9K2Lr5/pages/9JWG7B4rNsa6jQRxgTeW</a></td></tr><tr><td><i class="fa-code">:code:</i></td><td><strong>Dynamic Decoders</strong></td><td>Define binary payload decoders in JavaScript (Goja VM) without restarting the server.</td><td><a href="/spaces/8Ys0or8cn4JHMI9K2Lr5/pages/RtKEUrDkPtaC4J4Y7DKQ">/spaces/8Ys0or8cn4JHMI9K2Lr5/pages/RtKEUrDkPtaC4J4Y7DKQ</a></td></tr><tr><td><i class="fa-map-location-dot">:map-location-dot:</i></td><td><strong>Geospatial Analytics</strong></td><td>Real-time visualization using Deck.gl and Mapbox with PostGIS-powered geofencing.</td><td><a href="/spaces/8Ys0or8cn4JHMI9K2Lr5/pages/kI3WEfAxxjsYk54RgRil">/spaces/8Ys0or8cn4JHMI9K2Lr5/pages/kI3WEfAxxjsYk54RgRil</a></td></tr><tr><td><i class="fa-chart-line">:chart-line:</i></td><td><strong>Advanced Statistics</strong></td><td>Explore your data with a visual query builder and interactive time-series charts.</td><td><a href="/spaces/8Ys0or8cn4JHMI9K2Lr5/pages/OlioxXGDet3Tvu18L5y4">/spaces/8Ys0or8cn4JHMI9K2Lr5/pages/OlioxXGDet3Tvu18L5y4</a></td></tr></tbody></table>

### Core Philosophy

* **Vertical Efficiency:** Optimized "Modular Monolith" architecture on AWS EC2 for minimum latency and maximum throughput.
* **Developer Flexibility:** Backend-defined decoding allows you to support any device profile without firmware changes.
* **Hyper-Converged Data:** Unified spatiotemporal analytics using PostgreSQL with TimescaleDB (Time-series) and PostGIS (Spatial).
* **Interactive Visuals:** GPU-accelerated rendering for smooth, real-time asset movement and density mapping.

### Getting Started in 5 Minutes

Whether you're deploying AdaTrack on your own hardware or using our SaaS offering, setting up your first device is straightforward.

1. **Create a Device Profile:** Define how your device communicates and how its data should be decoded.
2. **Register a Device:** Add your device's unique identifier and security keys.
3. **Point your Telemetry:** Configure your device to send UDP packets to the AdaTrack ingestion endpoint.
4. **Visualize:** Watch your data appear on the real-time map and in historical reports.

<a href="/spaces/8Ys0or8cn4JHMI9K2Lr5/pages/PYqX1SevIcqTvaWRh7wQ" class="button primary" data-icon="rocket-launch">Launch Quickstart</a> <a href="/spaces/fhwILz4xCugrDVI1nl16" class="button secondary" data-icon="headset">Get Support</a>

***

### Join the Community

Join our Discord community or contribute to the project on GitHub.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><i class="fa-discord">:discord:</i></td><td><strong>Discord</strong></td><td>Connect with other developers and IoT enthusiasts.</td><td><a href="https://discord.gg/sdZjavNUtS" class="button secondary">Join Discord</a></td></tr><tr><td><i class="fa-github">:github:</i></td><td><strong>GitHub</strong></td><td>Contribute to the core platform or build your own plugins.</td><td><a href="https://github.com/xpointsolution/adatrack/" class="button secondary">Open GitHub</a></td></tr></tbody></table>