> 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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://adatrack-io.gitbook.io/docs/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.