🚀 Transform mobile app development: Deploy sophisticated forms in minutes, not months
Metadata-driven mobile forms platform that eliminates custom development through JSON configuration
Traditional Problem: Every mobile form needs custom development, app store updates, and technical expertise
ADUI Solution: Pure JSON configuration creates enterprise-grade mobile forms instantly
JSON Tool: Handy CSV to JSON and a JSON model designer ready (see separate project JSONFormMaker under same author)
// This JSON creates a complete mobile inspection app
{
"fields": [
{"component": "GPSField", "autoCapture": true},
{"component": "CameraField", "maxPhotos": 5},
{"component": "QRScanField", "validation": "asset_id"}
]
}
Result: Professional mobile app with GPS, camera, and QR scanning - no coding required!
ADUI transforms mobile app development by implementing the Application Dictionary (AD) concept from enterprise ERP systems, creating complete separation between UI presentation, data processing, and backend storage. This architecture enables dynamic form generation without code changes and seamless integration across multiple data layers.
Frontend UI (React Native) ← JSON Metadata → Data Processor ← Multiple Backends
↑ ↑ ↑ ↑
User Interface Business Logic Integration Excel/DB/Email
1. UI Layer: Pure presentation driven entirely by JSON metadata
2. Processing Layer: Business rules, validation, and data transformation
3. Storage Layer: Excel export → Database integration → Real-time sync
Forms are defined purely through JSON configuration, eliminating custom development:
interface ADWindowDefinition {
id: string;
name: string;
tabs: ADTabDefinition[];
}
interface ADFieldDefinition {
id: string;
component: ComponentType; // StringField, QRScanField, etc.
displayName: string;
isMandatory: boolean;
displayLogic?: string; // Conditional visibility
validationRule?: string; // Cross-field validation
}- Zero Code Changes: New forms deployed via metadata updates
- Instant Deployment: No app store updates required
- Business User Control: Forms created by domain experts, not developers
- Consistent UX: Same components across all forms
- Enterprise Integration: Direct compatibility with iDempiere ERP
Phase 1: Excel Export
// Structured data output compatible with enterprise workflows
const exportData = {
formTemplate: "site_inspection",
submissionData: {
C_BPartner_ID: "CLIENT_001",
M_Product_ID: "ASSET_456",
GPS_Location: [lat, lng],
photos: ["photo1.jpg", "photo2.jpg"]
}
};Phase 2: Email Processing
- Email-based form distribution and collection
- Automated parsing of structured submissions
- Photo attachments with metadata correlation
- Integration with existing email workflows
Phase 3: Database Connectivity
- Direct integration with PostgreSQL, MySQL, SQL Server
- iDempiere Application Dictionary compatibility
- Real-time synchronization capabilities
- Enterprise audit trails and security
- JSON-driven dynamic form generation
- 20+ built-in field types (GPS, QR scanning, camera, signatures)
- Conditional logic and validation rules
- No-code form configuration
- React Native performance with native interactions
- Offline-first architecture with local storage
- Professional UI designed for field workers
- Cross-platform iOS/Android compatibility
- iDempiere Application Dictionary standards
- Multi-tenant architecture (AD_Client_ID support)
- Audit trail compatibility (Created, CreatedBy, Updated, UpdatedBy)
- Document workflow integration (DocStatus, Processed)
- Start with Excel export for immediate value
- Evolve to database integration without code changes
- Email-based distribution for universal access
- Cloud or on-premise deployment options
- Node.js 18+
- Expo CLI
- React Native development environment
# Clone the repository
git clone https://github.com/red1oon/ADUI.git
cd ADUI
# Install dependencies
npm install
# Start development server
npx expo startCreate a form by defining JSON metadata:
{
"windowName": "Site Inspection",
"tabs": [{
"name": "Basic Information",
"fields": [
{
"id": "client_lookup",
"component": "LookupField",
"displayName": "Client/Site",
"isMandatory": true,
"reference": "C_BPartner"
},
{
"id": "gps_location",
"component": "GPSField",
"displayName": "Location",
"autoCapture": true
},
{
"id": "inspection_photos",
"component": "CameraField",
"displayName": "Photos",
"maxPhotos": 5
}
]
}]
}const ComponentRegistry = {
'StringField': StringFieldComponent,
'QRScanField': QRScanFieldComponent,
'CameraField': CameraFieldComponent,
'GPSField': GPSFieldComponent,
// Extensible without code changes
};class MetadataAdapter {
convertToADUI(externalMetadata: any): ADUIFieldDefinition[] {
// Transform various metadata formats to ADUI standard
// Supports iDempiere, custom JSON, and legacy formats
}
processConditionalLogic(field: ADUIField, formData: any): boolean {
// Evaluate display logic and field dependencies
}
}interface DataProvider {
fetchMetadata(windowId: string): Promise<WindowDefinition>;
saveFormData(data: FormSubmission): Promise<void>;
syncOfflineData(): Promise<void>;
}
// Multiple implementations:
// - MockDataProvider (development)
// - ExcelDataProvider (Excel export)
// - DatabaseProvider (SQL databases)
// - iDempiereProvider (ERP integration)- ✅ JSON-driven form generation
- ✅ 15+ field components with validation
- ✅ Offline data storage
- ✅ Excel export functionality
- ✅ Email integration basics
- 🔄 Enhanced email processing workflows
- 🔄 Advanced conditional logic engine
- 🔄 Photo metadata correlation
- 🔄 Multi-template support
- 📋 Direct database connectivity
- 📋 iDempiere web service integration
- 📋 Real-time synchronization
- 📋 BIM/IFC integration for construction workflows
- 📋 Multi-language support
We welcome contributions! The metadata-driven architecture makes it easy to add new field types, validation rules, and data providers without affecting existing functionality.
// 1. Create component
export const CustomField: React.FC<FieldProps> = ({ field, value, onChange }) => {
// Implementation
};
// 2. Register component
ComponentRegistry.register('CustomField', CustomField);
// 3. Use in JSON metadata
{
"component": "CustomField",
"displayName": "My Custom Field"
}MIT License - see LICENSE file for details.
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Documentation: Wiki
ADUI enables any organization to deploy sophisticated mobile forms in minutes instead of months, with a clear evolution path from Excel exports to enterprise-grade ERP integration.