5M Phone
Welcome to the official documentation for 5M Phone, the premier smartphone and smartwatch ecosystem engineered for FiveM.
Designed with an ultra-responsive React + TypeScript NUI framework and powered by modular, open backend bridges, 5M Phone provides an iOS-style mobile experience that runs smoothly at 60+ FPS with near-zero resmon idle overhead.
Open Files & Customization Philosophy
To ensure maximum security, stability, and ease of updating, 5M Phone separates core compiled logic from open configuration and integration files:
[!IMPORTANT] What is Escrowed vs What is Open:
- Core Engine (Protected by FiveM Asset Escrow): The compiled React NUI web build (
dist/) and internal client/server session handlers (client/core/*,server/core/*) are protected under FiveM Asset Escrow.- Open, Un-escrowed Files (100% Editable): ALL configuration, dispatch codes, webhooks, cloud API keys, dead zone coordinates, database schemas, and framework/inventory/banking/voice/housing adapters in
bridge/are completely OPEN and UN-ESCROWED.You never need to touch locked code to customize, skin, re-bridge, or extend 5M Phone. Everything is managed through the open files detailed in Open & Un-escrowed Files.
Highlights & Features
- Liquid Smooth UI: Built with React, Tailwind CSS, and Framer Motion for authentic fluid gestures, app switching, notifications, and lockscreen widgets.
- Dynamic Island & Peeks: Context-aware floating pill showing active calls, media playback, dispatch notifications, alarms, and battery warnings even when the full handset is closed.
- 5M Watch Companion: Wirelessly paired smartwatch with health tracking, step counter, heart rate monitor, quick notifications, flashlight, and call management.
- WebRTC Video Calls with Cloudflare TURN: Low-latency, peer-to-peer live camera video and voice calls natively supported in FiveM using enterprise Cloudflare TURN credentials.
- Restricted Dead Zones: Configurable polygon areas (e.g. Prison, Cayo Perico, Mt Chiliad) where cellular signal is lost unless Wi-Fi calling is enabled in Control Center.
- 80+ Public Exports & Synchronized State Bags: Full developer API for third-party scripts, jobs, MDTs, custom apps, and compatibility with
qb-mail/qb-phone. - Comprehensive App Ecosystem:
- Phone & Contacts: Recents, favorites, voicemail, dialer, DTMF tone support.
- Messages: SMS, MMS image attachments, audio voice memos, group chats.
- Mail: Custom email domain (
@5mphone.com), rich attachments,qb-mail/qb-phonedrop-in compatibility. - Social Media:
- Xbird: Microblogging with hashtags, retweets, replies, verified badges, and trending topics.
- Insta: Photo and video feed, stories, filters, captions, likes, and comment threads.
- DarkChat: Burner rooms, anonymous usernames, encrypted chats for underworld roleplay.
- PayUs Banking: Instant person-to-person money transfers, society business accounts, invoice billing, and crypto wallet.
- Dispatch CAD: Real-time law enforcement & emergency services MDT with 10-codes, GPS unit routing, callout blips, and quick responder statuses.
- Maps & GPS: Live interactive street map, custom waypoints, postal code locator, and ride-share / valet tracking.
- Camera & Video Recorder: High-resolution camera, selfie mode, filters, 5-minute video recording, and voice recorder with cloud upload.
- Utility Apps: Notes, Calculator, Clock / Alarms, Weather, App Store, Settings.
Architecture & Compatibility
5M Phone is designed out-of-the-box to detect and bind to your server's existing infrastructure automatically:
| Component | Supported Systems |
|---|---|
| Framework | Qbox (qbx_core), QBCore (qb-core), ESX Legacy (es_extended), ox_core, Standalone |
| Inventory | ox_inventory, qb-inventory, qs-inventory, ps-inventory, tgiann-inventory, codem-inventory, esx_inventory, Standalone |
| Voice | pma-voice, saltychat, mumble-voip, Standalone |
| Database | oxmysql (v2.0+) with MySQL 8.0+ or MariaDB 10.4+ |
| Housing | ps-housing, qbx_properties, qs-housing, qb-houses, loaf_housing, nolag_properties, vms_housing, esx_property |
| Banking | finals_banking, qb-banking, renewed-banking, fd_banking, tgg-banking, ox_core, esx_society |
| Dispatch | Built-in CAD, ps-dispatch, cd_dispatch, qs-dispatch, rcore_dispatch, tk_dispatch, origen_police, lb-tablet, l2s-dispatch |
Quick Navigation
- Open & Un-escrowed Files Breakdown — Detailed guide to all editable files.
- Installation Guide — Step-by-step setup, dependencies, items, and SQL.
- Configuration Guides — Config walkthrough, dispatch, webhooks, and dead zones.
- Migration Tool Guide — Seamless zero-data-loss migration from 8 major phone scripts.
- Custom Apps Guide — Build custom React/TypeScript apps with our starter template.
- Bridge Architecture — How to modify or add framework/inventory adapters.
- Exports & Events API — Full developer reference with 80+ exports and state bags.
