Skip to content

Team-Nifty-GmbH/nuxbe-mobile

Repository files navigation

Nuxbe Mobile

Native iOS & Android mobile app für Flux ERP mit Capacitor.


Store Listing Texts

Google Play Store

Kurze Beschreibung (DE)

Nuxbe – Dein Flux ERP für unterwegs. Aufträge, Tickets und Kontakte immer dabei.

Short Description (EN)

Nuxbe – Your Flux ERP on the go. Orders, tickets and contacts always at hand.

Vollständige Beschreibung (DE)

Nuxbe bringt dein Flux ERP auf dein Smartphone und Tablet. Greife von überall auf deine Geschäftsdaten zu – schnell, sicher und ohne Umwege.

Verbinde dich mit deinem Flux ERP Server und arbeite mobil mit allen wichtigen Funktionen:

Aufträge verwalten Behalte den Überblick über alle Aufträge, Angebote und Rechnungen. Erstelle neue Aufträge direkt vom Handy aus und verfolge den Status in Echtzeit.

Tickets bearbeiten Reagiere sofort auf Kundenanfragen. Tickets einsehen, kommentieren und bearbeiten – egal wo du gerade bist.

Kontakte pflegen Alle Kunden- und Lieferantendaten griffbereit. Kontaktdaten nachschlagen, Adressen prüfen und Ansprechpartner finden.

Dashboard Dein persönliches Dashboard zeigt dir die wichtigsten Kennzahlen und anstehenden Aufgaben auf einen Blick.

Weitere Features: • Push-Benachrichtigungen – Werde sofort informiert wenn sich etwas ändert • QR-Code Setup – Verbinde dich in Sekunden mit deinem Server • Barcode Scanner – Scanne Produktbarcodes direkt mit der Kamera • Kamera-Integration – Fotos aufnehmen und direkt hochladen • Multi-Server – Wechsle zwischen verschiedenen Flux ERP Installationen • Dark Mode – Automatische Anpassung an deine Systemeinstellungen • Mehrsprachig – Verfügbar in Deutsch und Englisch

Nuxbe ist die offizielle Mobile-App für Flux ERP von Team Nifty. Du benötigst einen aktiven Flux ERP Server um die App nutzen zu können.

Full Description (EN)

Nuxbe brings your Flux ERP to your smartphone and tablet. Access your business data from anywhere – fast, secure and straightforward.

Connect to your Flux ERP server and work on the go with all the features that matter:

Order Management Keep track of all orders, quotes and invoices. Create new orders right from your phone and follow their status in real time.

Ticket Handling Respond to customer requests instantly. View, comment and manage tickets – no matter where you are.

Contact Management All customer and supplier data at your fingertips. Look up contact details, check addresses and find the right person to talk to.

Dashboard Your personal dashboard shows key metrics and upcoming tasks at a glance.

More features: • Push Notifications – Get notified instantly when something changes • QR Code Setup – Connect to your server in seconds • Barcode Scanner – Scan product barcodes directly with your camera • Camera Integration – Take photos and upload them on the spot • Multi-Server – Switch between different Flux ERP installations • Dark Mode – Adapts automatically to your system settings • Multilingual – Available in German and English

Nuxbe is the official mobile app for Flux ERP by Team Nifty. You need an active Flux ERP server to use this app.


Apple App Store

Promotional Text (DE)

Nuxbe bringt dein Flux ERP aufs Handy – Aufträge, Tickets und Kontakte immer griffbereit, egal wo du bist.

Promotional Text (EN)

Nuxbe brings your Flux ERP to your phone – orders, tickets and contacts always at hand, wherever you are.

Beschreibung (DE)

Nuxbe ist die offizielle Mobile-App für Flux ERP. Greife von überall auf deine Geschäftsdaten zu – schnell, sicher und ohne Umwege.

Verbinde dich mit deinem Flux ERP Server und arbeite mobil mit allen wichtigen Funktionen:

AUFTRÄGE VERWALTEN Behalte den Überblick über alle Aufträge, Angebote und Rechnungen. Erstelle neue Aufträge direkt vom Handy aus und verfolge den Status in Echtzeit.

TICKETS BEARBEITEN Reagiere sofort auf Kundenanfragen. Tickets einsehen, kommentieren und bearbeiten – egal wo du gerade bist.

KONTAKTE PFLEGEN Alle Kunden- und Lieferantendaten griffbereit. Kontaktdaten nachschlagen, Adressen prüfen und Ansprechpartner finden.

DASHBOARD Dein persönliches Dashboard zeigt dir die wichtigsten Kennzahlen und anstehenden Aufgaben auf einen Blick.

WEITERE FEATURES • Push-Benachrichtigungen – Werde sofort informiert wenn sich etwas ändert • QR-Code Setup – Verbinde dich in Sekunden mit deinem Server • Barcode Scanner – Scanne Produktbarcodes direkt mit der Kamera • Kamera-Integration – Fotos aufnehmen und direkt hochladen • Multi-Server – Wechsle zwischen verschiedenen Flux ERP Installationen • Dark Mode – Automatische Anpassung an deine Systemeinstellungen

Du benötigst einen aktiven Flux ERP Server um Nuxbe nutzen zu können.

Description (EN)

Nuxbe is the official mobile app for Flux ERP. Access your business data from anywhere – fast, secure and straightforward.

Connect to your Flux ERP server and work on the go with all the features that matter:

ORDER MANAGEMENT Keep track of all orders, quotes and invoices. Create new orders right from your phone and follow their status in real time.

TICKET HANDLING Respond to customer requests instantly. View, comment and manage tickets – no matter where you are.

CONTACT MANAGEMENT All customer and supplier data at your fingertips. Look up contact details, check addresses and find the right person to talk to.

DASHBOARD Your personal dashboard shows key metrics and upcoming tasks at a glance.

MORE FEATURES • Push Notifications – Get notified instantly when something changes • QR Code Setup – Connect to your server in seconds • Barcode Scanner – Scan product barcodes directly with your camera • Camera Integration – Take photos and upload them on the spot • Multi-Server – Switch between different Flux ERP installations • Dark Mode – Adapts automatically to your system settings

You need an active Flux ERP server to use Nuxbe.

Keywords (DE)

ERP,Flux,Aufträge,Tickets,Kontakte,Rechnungen,Warenwirtschaft,Büro,CRM,Business

Keywords (EN)

ERP,Flux,orders,tickets,contacts,invoices,business,CRM,management,mobile


📱 Features

  • Multi-Tenant Support: Eine App für alle Flux ERP Installationen
  • QR-Code Setup: Schnelle Server-Konfiguration via QR-Code
  • Push Notifications: FCM-basierte Benachrichtigungen
  • Native Camera: Fotos aufnehmen und hochladen
  • Document Scanner: Dokumente mit ML Kit/VisionKit scannen
  • Barcode Scanner: Produkt-Barcodes scannen
  • WebView Container: Lädt Flux ERP PWA

🚀 Quick Start

Prerequisites

  • Node.js 18+ und npm
  • Xcode 14+ (für iOS Development)
  • Android Studio (für Android Development)
  • Firebase Projekt mit FCM aktiviert

Installation

# Dependencies installieren
npm install

# Native Projekte hinzufügen
npm run add:ios
npm run add:android

Development

# Development Server starten
npm run dev

# Build für Production
npm run build

# Native Projekte syncen
npm run sync

# iOS Projekt in Xcode öffnen
npm run open:ios

# Android Projekt in Android Studio öffnen
npm run open:android

🔧 Konfiguration

Firebase Setup

1. Firebase Projekt erstellen

  1. Gehe zu Firebase Console
  2. Erstelle ein neues Projekt: flux-erp-mobile
  3. Aktiviere Cloud Messaging (FCM)

2. iOS App hinzufügen

  1. In Firebase Console: Add appiOS
  2. Bundle ID: com.teamnifty.nuxbe
  3. App Name: Nuxbe
  4. Download GoogleService-Info.plist
  5. Kopiere die Datei nach: ios/App/App/GoogleService-Info.plist

Wichtig: Die GoogleService-Info.plist ist bereits im Projekt vorhanden und muss nicht ersetzt werden, außer du erstellst ein neues Firebase-Projekt.

3. Android App hinzufügen

  1. In Firebase Console: Add appAndroid
  2. Package name: com.teamnifty.nuxbe
  3. App Name: Nuxbe
  4. Download google-services.json
  5. Kopiere die Datei nach: android/app/google-services.json

Wichtig: Die google-services.json ist bereits im Projekt vorhanden und muss nicht ersetzt werden, außer du erstellst ein neues Firebase-Projekt.

4. APNs Key für iOS (Apple Developer Account benötigt)

  1. In Apple Developer Portal: Certificates, Identifiers & Profiles
  2. Erstelle einen neuen APNs Key
  3. Download den .p8 Key
  4. In Firebase Console: Project SettingsCloud Messaging
  5. Upload APNs Key mit Team ID und Key ID

Laravel Backend Konfiguration

Die Flux Core API-Endpoints sind bereits implementiert. Du musst nur die Migration ausführen:

# Im flux-core Package
php artisan migrate

Die folgenden Endpoints sind verfügbar:

  • GET /api/health - Health Check (öffentlich)
  • GET /api/mobile/config - App Konfiguration (öffentlich)
  • POST /api/mobile/register-device - Device Token registrieren (authentifiziert)
  • POST /api/mobile/unregister-device - Device Token entfernen (authentifiziert)

📝 Server URL Setup

QR-Code generieren (für Admins)

Erstelle einen QR-Code mit der Server-URL für einfaches Setup:

https://mein-server.de

Tools zum QR-Code erstellen:

Manuelles Setup

Benutzer können auch die Server-URL manuell eingeben:

https://mein-server.de

🏗️ Build & Deploy

iOS Build

# Syncen
npm run build
npm run sync:ios

# Xcode öffnen
npm run open:ios

# In Xcode:
# 1. Product → Archive
# 2. Distribute App
# 3. App Store Connect

Android Build

# Syncen
npm run build
npm run sync:android

# Android Studio öffnen
npm run open:android

# In Android Studio:
# 1. Build → Generate Signed Bundle / APK
# 2. Android App Bundle (.aab)
# 3. Release

🔐 Wichtige Hinweise

Keine Secrets im Code

⚠️ Dieses Projekt ist Open Source! Keine API Keys, Tokens oder Secrets im Code committen.

Die Firebase Config-Dateien (GoogleService-Info.plist und google-services.json) sind bereits im Projekt und enthalten nur öffentliche Projekt-Identifikatoren. Diese sind sicher im Repository.

Sensible Firebase-Einstellungen (Server Keys, etc.) bleiben in der Firebase Console und werden niemals committed.

.gitignore

Die folgenden Dateien/Ordner sind bereits in .gitignore:

  • node_modules/
  • dist/
  • ios/App/Pods/
  • android/.gradle/
  • .env* (außer .env.example)

📱 Native Features

Camera Access

const result = await window.nativeBridge.capturePhoto();
if (result.success) {
    console.log('Photo captured:', result.base64);
}

Photo Picker

const result = await window.nativeBridge.pickPhoto();
if (result.success) {
    console.log('Photo selected:', result.base64);
}

Barcode Scanner

const result = await window.nativeBridge.scanBarcode();
if (result.success) {
    console.log('Barcode:', result.barcode);
}

Platform Detection

const isNative = window.nativeBridge.isNative();
const platform = window.nativeBridge.getPlatform(); // 'ios', 'android', or 'web'

🧪 Testing

Web Browser Testing

npm run dev
# Öffne http://localhost:3000

iOS Simulator Testing

npm run build
npm run sync:ios
npm run open:ios
# In Xcode: Run (⌘R)

Android Emulator Testing

npm run build
npm run sync:android
npm run open:android
# In Android Studio: Run

🐛 Troubleshooting

Push Notifications funktionieren nicht

  1. Prüfe ob FCM Token registriert wurde (Console Log)
  2. Prüfe Firebase Console → Cloud Messaging Konfiguration
  3. iOS: Prüfe ob APNs Key korrekt konfiguriert ist
  4. Android: Prüfe ob google-services.json korrekt ist

Kamera funktioniert nicht

  1. iOS: Prüfe Info.plist Permissions
  2. Android: Prüfe AndroidManifest.xml Permissions
  3. Prüfe Browser Console für Fehler

App lädt nicht

  1. Prüfe Server-URL (muss https:// sein)
  2. Prüfe /api/health Endpoint
  3. Prüfe CORS Settings im Backend

📦 Projektstruktur

nuxbe-mobile/
├── src/
│   ├── app.js              # Hauptlogik & Capacitor Bridge
│   └── style.css           # Styling
├── index.html              # Setup-Screen & WebView
├── ios/                    # Native iOS Projekt (Xcode)
├── android/                # Native Android Projekt (Android Studio)
├── capacitor.config.ts     # Capacitor Konfiguration
├── vite.config.js          # Build Konfiguration
├── package.json            # Dependencies
└── README.md               # Diese Datei

🤝 Contributing

Dieses Projekt ist Teil des Flux ERP Monorepos.

📄 License

MIT License - siehe LICENSE

🆘 Support

Bei Fragen oder Problemen:

  • Erstelle ein Issue auf GitHub
  • Kontaktiere das Team Nifty Support-Team

About

Cross-platform mobile app for Flux ERP. Built with Capacitor, featuring FCM push notifications, deep linking, and native device capabilities for iOS & Android.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors