A collection of universal phone apps for FiveM servers, compatible with multiple frameworks (ESX, QBCore, QBX) and phone systems (LB Phone, QB Phone, QS Smartphone).
⚠️ Development Status Notice
These phone apps are currently in development/testing phase and have not been fully tested in production environments. While they pass all validation checks and are designed for universal compatibility, we recommend using them primarily with LB Phone as it has received the most testing attention. Use in production servers at your own discretion and please report any issues you encounter. Additionally this is only my second FiveM project, so please be patient with me as I learn the ropes of this FiveM.
| App | Description | Size | Database Required |
|---|---|---|---|
| 📧 Invoicing | Create and manage professional invoices | 1024 KB | ✅ Yes |
| 📝 Notes | Personal note-taking with categories | 512 KB | ❌ No |
| 💼 Business Cards | Design and share professional cards | 768 KB | ✅ Yes |
| 🧮 Calculator | Advanced calculator with history | 256 KB | ❌ No |
| 📸 Gallery | Photo storage and management | 1536 KB | ✅ Yes |
📱 Recommended Setup: For the best experience, we recommend using LB Phone as it has received the most comprehensive testing with these apps.
# Download the latest release
# Extract to your server's resources directory# Add to server.cfg BEFORE the phone apps
ensure ox_lib
ensure es_extended # OR qb-core OR qbx_core
ensure lb-phone # OR qb-phone OR qs-smartphone# Run the installation script
cd phone_apps
chmod +x install.sh
./install.sh# Phone Apps (add after dependencies)
ensure invoicing
ensure notes
ensure business_cards
ensure calculator
ensure gallery# Restart your FiveM server
restart ox_lib
restart [your-framework]
restart [your-phone-system]
start invoicing
start notes
start business_cards
start calculator
start gallery- ESX (es_extended)
- QBCore (qb-core)
- QBX (qbx_core)
- LB Phone (lb-phone) - 🌟 Recommended & Best Tested
- QB Phone (qb-phone) - Limited testing
- QS Smartphone (qs-smartphone) - Limited testing
- ox_lib (required)
- MySQL Async/oxmysql (for database apps)
Professional invoice management system.
Features:
- Create and send invoices to players
- Automatic tax calculations
- Payment processing
- Invoice history and tracking
- Expiration handling
Database: invoices table (auto-created)
Personal note-taking application.
Features:
- Create and edit personal notes
- Category organization
- Search functionality
- Auto-save feature
- Rich text support
Database: Not required (uses local storage)
Professional business card creator.
Features:
- Design custom business cards
- Multiple professional templates
- Share with nearby players
- Contact management
- QR code generation
Database: business_cards table (auto-created)
Advanced calculator with memory.
Features:
- Basic and advanced operations
- Calculation history
- Keyboard shortcuts
- Memory functions
- Responsive design
Database: Not required
Photo storage and management.
Features:
- Photo upload and storage
- Album organization
- Image viewing and sharing
- Privacy controls
- Slideshow mode
Database: gallery_photos and gallery_albums tables (auto-created)
Each app includes a config.lua file for customization:
-- Example: Invoicing App Configuration
Config.MaxInvoiceAmount = 50000
Config.DefaultTaxRate = 0.10
Config.AllowedJobs = {} -- Empty = all jobs can use
-- Example: Business Cards Configuration
Config.MaxCards = 100
Config.SharingDistance = 5.0
Config.AllowCustomImages = trueApps automatically register with your phone system:
-- LB Phone Integration
Config.PhoneApp = {
identifier = "invoicing",
name = "Invoicing",
description = "Create and manage professional invoices",
icon = "https://cdn-icons-png.flaticon.com/512/1611/1611179.png",
category = "business",
size = 1024
}Validate your installation:
# Run the validation script
./validate_phone_apps.shThe validation script checks:
- ✅ App structure and files
- ✅ Framework compatibility
- ✅ Phone system integration
- ✅ Configuration validity
- ✅ Code quality standards
- Framework: Any (ESX, QBCore, QBX) - All tested and working
- Phone System: LB Phone - Most thoroughly tested
- Environment: Development/Testing servers initially
| Phone System | Testing Level | Status | Recommendation |
|---|---|---|---|
| LB Phone | Comprehensive | ✅ Well Tested | Recommended for production |
| QB Phone | Basic | Use with caution, test thoroughly | |
| QS Smartphone | Basic | Use with caution, test thoroughly |
- ✅ Framework detection and compatibility (ESX/QB/QBX)
- ✅ App installation and registration
- ✅ Basic functionality of all 5 apps
- ✅ Database integration (where required)
- ✅ NUI interface loading and interaction
- ✅ LB Phone integration and app appearance
- 🔄 Extended production use in live servers
- 🔄 QB Phone and QS Smartphone integration edge cases
- 🔄 Performance under high player loads
- 🔄 Cross-framework data compatibility
- 🔄 Advanced features in complex server environments
- Test in a development environment first
- Start with LB Phone if possible
- Monitor console for any errors
- Test with a small group of users initially
- Report any issues you encounter
- Check console for registration messages
- Verify dependencies are loaded first
- Ensure framework is detected correctly
- Check resource loading order
- For best results, use LB Phone (most tested)
-- Debug framework detection
print("Framework:", PhoneApps.GetFramework())LB Phone (Recommended):
- Most stable and tested integration
- Apps should appear automatically in the app grid
- Check LB Phone configuration if apps don't show
QB Phone / QS Smartphone:
- Limited testing - may require additional configuration
- Monitor console for specific error messages
- Consider switching to LB Phone if issues persist
- Verify MySQL resource is running
- Check table creation in database
- Validate Config.TableName settings
# Framework not detected
# Solution: Install ESX, QBCore, or QBX
# Phone system not found
# Solution: Install lb-phone, qb-phone, or qs-smartphone
# ox_lib not found
# Solution: Install ox_lib dependency- 📖 LB Phone Setup Guide - Detailed LB Phone integration
- 🔧 Framework Implementation - Technical details
- 🚀 Universal Implementation - Compatibility guide
- Backup existing app data
- Update phone system references
- Test all features
- Import user data if needed
The apps automatically adapt to your framework:
- No code changes required
- Universal compatibility layer
- Automatic detection and configuration
After installation:
- All apps appear in phone interface
- Apps open without errors
- Framework detection working
- Database tables created (if required)
- NUI interfaces load correctly
- Server callbacks function properly
- Recommended: Test with LB Phone first
- Test in development environment before production
- Monitor console for any warning messages
For issues or questions:
- Check Console: Look for error messages in F8 console
- Run Validation: Use
./validate_phone_apps.sh - Verify Setup: Follow installation guide step by step
- Update Resources: Ensure all dependencies are current
- Try LB Phone: If using QB Phone/QS Smartphone, test with LB Phone
- Report Issues: Help improve the apps by reporting bugs and feedback
🤝 Community Feedback Welcome
Since these apps are in active development, your feedback is valuable! Please report any issues, suggestions, or successful implementations to help improve compatibility across different setups.
This project is licensed under the MIT License - see the LICENSE file for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Run validation script
- Submit a pull request
- ✅ Universal framework compatibility (ESX/QB/QBX)
- ✅ Multi-phone system support (LB/QB/QS)
- ✅ 5 complete phone apps included
- ✅ Automatic validation and testing
- ✅ Comprehensive documentation
- ✅ Production-ready code quality
- 🌟 Best tested with LB Phone
⚠️ Beta status: Requires further testing in production environments
- 🔄 Enhanced QB Phone and QS Smartphone compatibility
- 🔄 Extended production testing
- 🔄 Performance optimizations
- 🔄 Additional features based on community feedback
Compatible with all major frameworks and phone systems - just install and go!