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

# Titan

Titan is a lightweight message dispatch platform built around **STOMP over TCP**, destination routing, and observable in-memory delivery.

{% hint style="info" icon="signal-stream" %}
**CONNECT → SEND → ROUTE → DELIVER**\
One compact runtime for live messages, fanout, and operational visibility.
{% endhint %}

## Choose your path

<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><h3><i class="fa-bolt" style="color:$primary;">:bolt:</i></h3></td><td><strong>Start in five minutes</strong></td><td>Launch a node, verify its health, and send your first message.</td><td><a href="/pages/ZSK52kIAU84uybggZt9E">/pages/ZSK52kIAU84uybggZt9E</a></td></tr><tr><td><h3><i class="fa-diagram-project" style="color:$primary;">:diagram-project:</i></h3></td><td><strong>Understand the runtime</strong></td><td>Follow a STOMP frame through transport, routing, fanout, and delivery.</td><td><a href="/pages/5DQnWLNwXngNZw6FcPYI">/pages/5DQnWLNwXngNZw6FcPYI</a></td></tr><tr><td><h3><i class="fa-spring" style="color:$primary;">:spring:</i></h3></td><td><strong>Build with Spring</strong></td><td>Publish with <code>TitanTemplate</code> and consume with <code>@TitanListener</code>.</td><td><a href="/pages/6tTuyDi5Zm7snPZmgxfc">/pages/6tTuyDi5Zm7snPZmgxfc</a></td></tr></tbody></table>

## One runtime, three views

{% columns %}
{% column width="60%" %}

### Build

Run from `titan-env.yml`, embed the STOMP server, or connect through the transport-neutral `TitanClient` facade and Spring Boot integration.

### Route

Address live traffic with opaque destination paths. Titan maps every exact destination to one FIFO dispatcher queue; path prefixes do not change delivery semantics.
{% endcolumn %}

{% column width="40%" %}
{% hint style="success" icon="chart-network" %}

### Observe

Inspect health, JVM state, connections, and dispatcher queues from HTTP or the terminal-first Titan CLI.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

## See the signal move

```mermaid
flowchart LR
    P[Producer] -->|SEND| T{Titan}
    T -->|/orders| Q[DispatcherQueue /orders]
    Q --> C1[Subscriber A]
    Q --> C2[Subscriber B]
    T -.->|snapshot| M[Monitor & CLI]
```

{% hint style="warning" icon="triangle-exclamation" %}
Titan focuses on fast, real-time, in-memory dispatch. It is not currently a durable queue or broker replacement. Review [Project scope](/titan/reference/project-scope.md) before using Titan for reliability-sensitive workloads.
{% endhint %}

## Explore the system

<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><h3><i class="fa-route" style="color:$primary;">:route:</i></h3></td><td><strong>Dispatch routing</strong></td><td>Trace exact destination keys through FIFO dispatcher queues.</td><td><a href="/pages/Ted02pvjEYg1Cu8Fcdp7">/pages/Ted02pvjEYg1Cu8Fcdp7</a></td></tr><tr><td><h3><i class="fa-arrows-split-up-and-left" style="color:$primary;">:arrows-split-up-and-left:</i></h3></td><td><strong>Fanout</strong></td><td>Dispatch one live publication to every matching subscriber.</td><td><a href="/pages/GvgCgKA1bAtG5t5UT5F5">/pages/GvgCgKA1bAtG5t5UT5F5</a></td></tr><tr><td><h3><i class="fa-wave-pulse" style="color:$primary;">:wave-pulse:</i></h3></td><td><strong>Monitoring and CLI</strong></td><td>See node health and dispatcher pressure without leaving the terminal.</td><td><a href="/pages/lRyD29UW6Z0HnVqUjiWm">/pages/lRyD29UW6Z0HnVqUjiWm</a></td></tr></tbody></table>

<sub>Documentation examples target Titan</sub> <sub></sub><sub>`0.8.0`</sub> <sub></sub><sub>and JDK 21 or newer.</sub>