Docs/Orb Phone/Overview

The Orb Phone

A premium, multi-framework phone for FiveM with an identity of its own — monochrome, glass & blur, editorial layout and ultra-consistent motion. One device, 21 apps, four languages, server-authoritative.

Highlights

  • 21 apps plus a full OS shell (lock screen, home, control center, notifications, global search, onboarding).
  • Multi-framework: QBox, QBCore and ESX — auto-detected, plug-and-play.
  • Server-authoritative: all money, items and gated actions are validated server-side. The client is never the source of truth.
  • Auto-migrating database: every orb_* table is created and upgraded on startup — no manual SQL.
  • Internationalized: English (default), Spanish, French and Portuguese; each player picks their own.
  • Integration layer: a server event bus, Discord webhooks and exports (usePhone, SendEmail, SetTwitterVerified).

The 21 apps

AppWhat it does
PhoneKeypad, recents and voice/video calls + group calls (up to 5).
MessagesPersistent 1-to-1 chats — text, voice notes, images, reactions.
ContactsPer-line address book with favorites and nearby AirShare.
Dark ChatAnonymous channels with a stable per-player alias.
OrbitTwitter/X-style global feed — posts, replies, reposts, likes, trends.
OrbgramInstagram-style photo app — stories, DMs, follows + Live streaming.
BankFramework bank account — balance, transfers and money requests.
WalletSimulated crypto market (reactive AMM) + virtual card.
MarketPlayer-to-player marketplace with images and categories.
ServicesDispatch police/EMS/mechanic mapped to jobs, role-gated.
HubPlayer-managed business directory (Yellow Pages).
GarageRead-only view of framework vehicles + "Set GPS".
MailOrbMail inbox/sent/drafts with attachments + SendEmail export.
CameraIn-game screenshots saved to a persistent gallery.
GalleryPhoto viewer over the Camera catalog.
NotesPrivate autosave notes with pinning.
MapsInteractive Los Santos map — waypoints, saved & shared places.
WeatherEditorial weather synced to the game + shared forecast.
Music"Orb FM" real audio player with a config-driven catalog.
SettingsWallpaper, theme, accent color, language, notifications.
Orb StoreIn-phone app store to install/remove and arrange apps.

Requirements

Requiredoxmysql, ox_lib, and a supported framework: QBox (qbx_core), ESX (es_extended) or QBCore (qb-core).

Optional (recommended)ox_inventory (plug-and-play; falls back to the framework inventory) and screenshot-basic (powers Camera and the video-call fallback).

Tech & performance

React 18 + TypeScript + Vite + Tailwind 4 + Zustand + Framer Motion on the NUI; Lua 5.4 + ox_lib + oxmysql behind a multi-framework bridge.

MetricIdleActive
Server resmon<0.01ms<0.05ms
Client resmon<0.05ms<0.15ms
NUI bundle<250 KB gzip

Continue with Installation.