A comprehensive React Native inventory management application with OCR support for Myanmar fonts, multi-language support, and local data storage.

Please read our Privacy Policy for information about how we handle your data.

• ✅ Daily inventory tracking with date navigation
• ✅ Add, edit, and delete inventory items
• ✅ Search and filter items by category
• ✅ Sort items by name, price, or total amount
• ✅ Expandable item details view
• ✅ Real-time daily total calculation
• ✅ Persistent bottom navigation bar

• 🌍 Multi-language: Dynamic labels with built-in English and Myanmar translations
• 📱 100% Local Storage: All data stored locally using AsyncStorage
• 🗄️ Data Management: Automatic cleanup of data older than 30 days
• 📊 Category Management: Customizable item categories
• ⚡ Unit Types: Support for various measurement units (lb, oz, kg, g, pieces, liters, ml)

• Node.js (v14 or later)
• npm or yarn
• Expo CLI
• Android Studio (for Android development)
• Xcode (for iOS development)

1. Clone the repository

git clone <repository-url> cd inventory-management-app

2. Install dependencies

npm install # or yarn install

3. Start the development server

npm start # or yarn start

4. Run on device/simulator

# Android npm run android # iOS npm run ios # Web npm run web

inventory-management-app/ ├── src/ │ ├── components/ │ │ ├── InventoryApp.js # Main app component │ │ └── LoadingScreen.js # Loading component │ ├── services/ │ │ ├── DataService.js # Local storage management │ │ ├── LanguageService.js # Multi-language support │ │ ├── OCRService.js # OCR service (disabled stub) │ │ └── LocalStorage.js # Storage utilities │ └── styles/ │ └── styles.js # Shared styles ├── assets/ # Images, fonts, icons ├── App.js # App entry point ├── app.json # Expo configuration ├── package.json # Dependencies ├── babel.config.js # Babel configuration ├── metro.config.js # Metro bundler config └── README.md # This file 

1. Tap the "+" button to open the add item modal
2. Fill in item details:
   • Item Name: Product name
   • Price: Unit price
   • Units Sold: Quantity sold
   • Category: Select from available categories
   • Unit Type: Choose measurement unit
3. Save the item

• Date Selection: Tap the calendar icon to view different dates
• Search: Use the search bar to find specific items
• Filter: Filter items by category
• Sort: Sort items by name, price, or total amount

• Data is automatically stored locally on your device
• Items older than 30 days are automatically cleaned up
• Each day maintains its own inventory list
• Daily totals are calculated in real-time

• English (en)
• Myanmar (my)
• Spanish (es) - Extensible
• French (fr) - Extensible
• Chinese (zh) - Extensible
• Hindi (hi) - Extensible
• Arabic (ar) - Extensible

1. Open src/services/LanguageService.js
2. Add your language code to SUPPORTED_LANGUAGES
3. Add translations to DEFAULT_TRANSLATIONS
4. The app will automatically support the new language

Use the LanguageService to update any label:

import LanguageService from './src/services/LanguageService'; // Update a single translation await LanguageService.updateTranslation('appTitle', 'My Inventory App'); // Update multiple translations await LanguageService.updateTranslations({ 'addItem': 'Add New Item', 'save': 'Save Item' });

{ "inventory_2024-01-15": [ { "id": "1642234567890", "name": "Fresh Apples", "price": "2.50", "unitsSold": "10", "category": "Food", "unitType": "lb", "totalAmount": "25.00", "timestamp": "2024-01-15T10:30:00.000Z" } ], "language_config": { "currentLanguage": "en", "customTranslations": {...} }, "categories": ["Food", "Beverages", "Electronics"], "unit_types": ["lb", "oz", "kg", "g", "pieces"] }

import DataService from './src/services/DataService'; // Get items for a date const items = await DataService.getItemsByDate(new Date()); // Save items for a date await DataService.saveItemsByDate(new Date(), items); // Export all data const exportData = await DataService.exportData(); // Import data await DataService.importData(importData); // Get sales statistics const stats = await DataService.getSalesStatistics(30); // Last 30 days

import DataService from './src/services/DataService'; const newCategories = ['Food', 'Beverages', 'Electronics', 'Books', 'Clothing']; await DataService.saveCategories(newCategories);

const newUnits = ['lb', 'oz', 'kg', 'g', 'pieces', 'liters', 'ml', 'dozen']; await DataService.saveUnitTypes(newUnits);

The app uses a consistent design system. Main colors:

• Primary: #2196f3 (Blue)
• Success: #4caf50 (Green)
• Warning: #ff9800 (Orange)
• Error: #f44336 (Red)
• Background: #f5f5f5 (Light Gray)
• Text: #333333 (Dark Gray)

// Get items by date DataService.getItemsByDate(date) // Save items by date DataService.saveItemsByDate(date, items) // Clean old data DataService.cleanOldData() // Get sales statistics DataService.getSalesStatistics(days) // Export/Import data DataService.exportData() DataService.importData(data)

// Get translated text LanguageService.t(key, defaultValue) // Set language LanguageService.setCurrentLanguage(languageCode) // Update translations LanguageService.updateTranslation(key, value) LanguageService.updateTranslations(translations) // Format numbers/currency/dates LanguageService.formatNumber(number) LanguageService.formatCurrency(amount) LanguageService.formatDate(date)

// Note: OCR functionality has been removed // OCRService is now a stub for backward compatibility

1. Create components in src/components/
2. Add services in src/services/
3. Update language files for new text
4. Add tests for new functionality

# Run tests npm test # Run tests in watch mode npm run test:watch

# Build for Android expo build:android # Build for iOS expo build:ios # Create standalone app expo build:web

1. Check AsyncStorage permissions
2. Verify data format is correct JSON
3. Check device storage space
4. Clear app cache and restart

1. Verify language code exists in SUPPORTED_LANGUAGES
2. Check if translations are properly loaded
3. Restart the app after language change

Enable debug logging by setting:

// In App.js console.disableYellowBox = false; // Show warnings

• Use FlatList for large item lists
• Lazy load language translations
• Optimize AsyncStorage operations
• Use React.memo for expensive components

• Implement data pagination for large datasets
• Optimize local storage operations

• All data stored locally (no cloud storage)
• No personal data transmitted
• No camera or microphone access

• No analytics or tracking
• No internet connection required
• User data never leaves device
• Optional data export only

1. Fork the repository
2. Create a feature branch
3. Make changes with tests
4. Update documentation
5. Submit a pull request

• Use ESLint configuration
• Follow React Native best practices
• Add JSDoc comments for functions
• Use TypeScript for type safety (optional)

This project is licensed under the MIT License - see the LICENSE file for details.

For support and questions:

1. Check the troubleshooting section
2. Review the API reference
3. Create an issue in the repository
4. Contact the development team

• Data synchronization across devices
• Advanced reporting and analytics
• Barcode scanning support
• Inventory alerts and notifications
• Multi-store management
• Voice input support
• Offline maps for delivery tracking

• Web dashboard companion
• API integration capabilities
• Advanced analytics and ML insights
• Multi-user support
• Cloud backup options (optional)

Made with ❤️ for inventory management efficiency