Complete guide for setting up and deploying the Client St0r mobile apps for iOS and Android.
Client St0r includes a native React Native mobile application that provides full access to your IT documentation platform on iOS and Android devices.
Key Features:
- Native performance on iOS and Android
- Secure token-based authentication
- Real-time data sync via GraphQL
- Offline-capable (coming soon)
- Dark mode optimized UI
- Biometric authentication support (coming soon)
- Client St0r v2.66.0+ installed and running
- GraphQL API enabled - Required for mobile app
- HTTPS enabled - Recommended for production (mobile apps require secure connections)
To develop or build the mobile app, you need:
- Node.js 18+ and npm
- Expo CLI:
npm install -g expo-cli - Development environment:
- iOS: Mac with Xcode 14+
- Android: Android Studio with SDK 33+
- Testing: iOS Simulator or Android Emulator
The mobile app requires the GraphQL API to be enabled on your Client St0r backend.
cd ~/clientst0r
source venv/bin/activate
pip install -r requirements-graphql.txt
sudo systemctl restart clientst0r-gunicorn.serviceThe GraphQL API is already configured to allow mobile app origins:
http://localhost:19006(Expo default)http://localhost:8081(React Native)
For production, add your mobile app's production URLs to config/settings.py:
CORS_ALLOWED_ORIGINS = [
# ... existing origins ...
"https://your-mobile-app-domain.com",
]Test that the GraphQL API is accessible:
curl -X POST http://localhost:8000/api/v2/graphql/ \
-H "Content-Type: application/json" \
-d '{"query":"{ __schema { queryType { name } } }"}'You should see a JSON response with schema information.
cd ~/clientst0r/mobile-app
npm installThis will install all required packages including:
- React Native and Expo
- Apollo Client for GraphQL
- React Navigation
- React Native Paper (UI components)
Edit mobile-app/app.json and update the API URLs:
{
"expo": {
"extra": {
"apiUrl": "https://your-clientst0r-server.com",
"graphqlUrl": "https://your-clientst0r-server.com/api/v2/graphql/"
}
}
}Development: Use http://YOUR_LOCAL_IP:8000 (not localhost - phones need real IP)
Production: Use your public HTTPS URL
The mobile app needs branded icons. You can:
Option A: Use existing Client St0r logo
cd mobile-app/assets
# Copy and resize your logo to create:
# - icon.png (1024x1024)
# - adaptive-icon.png (1024x1024)
# - splash.png (1242x2436)Option B: Auto-generate from a single image
npm install -g expo-icon
cd mobile-app
expo-icon generate path/to/your-logo.pngStart the Expo development server:
cd ~/clientst0r/mobile-app
npm startThis opens the Expo DevTools in your browser. From here you can:
- Press
ito run on iOS Simulator - Press
ato run on Android Emulator - Scan QR code with Expo Go app on physical device
Requirements: Mac with Xcode installed
npm run iosThis will:
- Build the app
- Start iOS Simulator
- Install and launch the app
Requirements: Android Studio with emulator set up
npm run androidThis will:
- Build the app
- Start Android Emulator (if not running)
- Install and launch the app
Option 1: Expo Go App (Easiest)
- Install "Expo Go" from App Store or Play Store
- Run
npm startin mobile-app directory - Scan the QR code with your phone
- App loads and connects to your dev server
Option 2: Development Build
For testing features not supported by Expo Go (like biometrics):
# iOS
expo build:ios -t simulator
# Android
expo build:android -t apk-
Join Apple Developer Program ($99/year)
-
Configure app signing:
cd mobile-app expo build:ios -
Follow prompts to:
- Choose credentials (let Expo manage or provide your own)
- Select distribution method
- Wait for build to complete
-
Download IPA and upload to App Store Connect
-
Create Google Play Developer account ($25 one-time)
-
Generate upload keystore:
cd mobile-app expo build:android -t app-bundle -
Follow prompts to:
- Generate or provide keystore
- Wait for build to complete
-
Download AAB and upload to Play Console
For distribution outside app stores:
expo build:android -t apkDownload and distribute the APK directly.
Create mobile-app/.env for environment-specific settings:
API_URL=https://your-server.com
GRAPHQL_URL=https://your-server.com/api/v2/graphql/
ENABLE_DEV_TOOLS=falseEdit App.js to enable/disable features:
const FEATURES = {
biometrics: true,
offline: false, // Coming soon
pushNotifications: false, // Coming soon
};Problem: App can't connect to backend
Solutions:
- Check API URL in
app.json - Ensure backend is running:
sudo systemctl status clientst0r-gunicorn - Verify CORS settings allow mobile app origin
- On physical device, use real IP not localhost
- Check firewall allows connections
Problem: GraphQL not installed on backend
Solution:
cd ~/clientst0r
source venv/bin/activate
pip install -r requirements-graphql.txt
sudo systemctl restart clientst0r-gunicorn.serviceSolutions:
- Clear Expo cache:
expo start -c - Clear node modules:
rm -rf node_modules && npm install - Check console for errors
- Verify all dependencies installed correctly
Solutions:
- Update Xcode to latest version
- Clear derived data:
rm -rf ~/Library/Developer/Xcode/DerivedData - Update CocoaPods:
sudo gem install cocoapods - Clean and rebuild
Solutions:
- Update Android SDK in Android Studio
- Clear Gradle cache:
cd android && ./gradlew clean - Verify Java version (should be 11 or 17)
- Check Android SDK path in environment variables
- HTTPS only - Never use HTTP in production
- Certificate pinning - Consider implementing SSL pinning
- Token storage - Tokens stored in Expo Secure Store (encrypted)
- Biometric auth - Enable biometric authentication for sensitive data
- Code obfuscation - Consider ProGuard/R8 for Android
- API rate limiting - Ensure backend has rate limiting enabled
- Session timeout - Implement automatic logout after inactivity
- Use HTTPS for all API calls
- Validate SSL certificates
- Implement certificate pinning for production
- Never log sensitive data (passwords, tokens)
When Client St0r backend is updated:
- Check for API changes in release notes
- Update mobile app to match new API
- Test all features
- Build and deploy new version
Expo supports OTA updates for JavaScript changes:
expo publishUsers get updates automatically without app store approval.
Note: Native code changes (dependencies, permissions) require full rebuild and app store submission.
- Check mobile app logs: Expo DevTools console
- Check backend logs:
/var/log/itdocs/gunicorn-error.log - Review GraphQL errors in browser DevTools (Network tab)
- File issues: https://github.com/agit8or1/clientst0r/issues
- Main README:
/home/administrator/README.md - Mobile app README:
/home/administrator/mobile-app/README.md - Expo docs: https://docs.expo.dev/
- React Native docs: https://reactnative.dev/
Planned features for future releases:
- Offline mode with local caching
- Push notifications for alerts
- Biometric authentication
- QR code scanner for asset tagging
- File upload from camera
- Dark/Light theme toggle
- iPad/Tablet optimized layout
- Apple Watch companion app
- Android Wear support
- Share Sheet integration
- Home screen widgets
MIT License - Same as Client St0r parent project