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

# Mango Notify

A standalone, premium notification framework for FiveM — one notification system for every resource on your server.

<figure><img src="https://3694989814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6edDnCRamvDxPx0AsLch%2Fuploads%2FNej1mMaphfexKOlCe2y7%2Fimage-1784958466911.png?alt=media&#x26;token=2f463d1c-e5da-475e-8b6e-5f95a181af84" alt=""><figcaption></figcaption></figure>

> **One notification system for your whole server** — clean design, rich layouts, and an API built for developers.

Mango Notify replaces the patchwork of per-script notification styles with a single polished system: dispatch cards with badges and distance, money notifications with coloured amounts, success/error/warning/info toasts, progress bars, persistent notifications you can update live, and a full queue with priorities — all rendered in a dark glass design that matches modern server UIs.

It is **fully standalone**: no framework dependency, no database, no other resources required, and no external requests — fonts and icons ship inside the resource. It runs at **0.00ms idle** — there are no loops anywhere; everything is driven by exports and events. And it is built to be *the* notification layer other scripts talk to, with an API surface designed for integration: 20+ exports, event aliases, server-side helpers, themes, and per-notification styling.

## Start here

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🚀 Getting Started</strong></td><td>Drop it in, add one line to server.cfg, send your first notification — under five minutes.</td><td></td></tr><tr><td><strong>⚙️ Configuration</strong></td><td>Position, colours, animations, types, themes, and sounds — everything lives in one config.lua.</td><td></td></tr><tr><td><strong>🧩 Developer Guide</strong></td><td>The full data-field reference, every export and event, and drop-in framework integration.</td><td></td></tr><tr><td><strong>📖 Reference</strong></td><td>The test command, performance notes, troubleshooting, and updating.</td><td></td></tr></tbody></table>

## Highlights

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🚨 Dispatch layout</strong></td><td>Officer/agency header, priority badge, location and description rows, distance readout, progress bar.</td><td></td></tr><tr><td><strong>💸 Money layout</strong></td><td>"You received / You paid" with coloured amounts and direction-tinted accent lines.</td><td></td></tr><tr><td><strong>🔁 Live updates</strong></td><td>Give a notification an id, then Update() it in place — perfect for progress tasks.</td><td></td></tr><tr><td><strong>🗂️ Queue &#x26; priority</strong></td><td>FIFO queue with priority jump, duplicate prevention, and a replace mode.</td><td></td></tr><tr><td><strong>🎨 Themes &#x26; styling</strong></td><td>Ship themes, register your own at runtime, or restyle a single notification inline.</td><td></td></tr><tr><td><strong>🔊 Sounds</strong></td><td>Six built-in synthesized sounds — zero audio files — plus drop-in custom .ogg/.mp3/.wav support.</td><td></td></tr></tbody></table>

{% hint style="info" %}
**New install?** Start at Installation — under five minutes start to finish. **Something not working?** Troubleshooting covers the common cases, and I Need Support explains how to reach us.
{% endhint %}