mirror of
https://github.com/pezkuwichain/pwap.git
synced 2026-04-22 09:07:55 +00:00
Claude
7b95b8a409
This commit reorganizes the codebase to eliminate duplication between web and mobile frontends by moving all commonly used files to the shared folder. Changes: - Moved lib files to shared/lib/: * wallet.ts, staking.ts, tiki.ts, identity.ts * multisig.ts, usdt.ts, scores.ts, citizenship-workflow.ts - Moved utils to shared/utils/: * auth.ts, dex.ts * Created format.ts (extracted formatNumber from web utils) - Created shared/theme/: * colors.ts (Kurdistan and App color definitions) - Updated web configuration: * Added @pezkuwi/* path aliases in tsconfig.json and vite.config.ts * Updated all imports to use @pezkuwi/lib/*, @pezkuwi/utils/*, @pezkuwi/theme/* * Removed duplicate files from web/src/lib and web/src/utils - Updated mobile configuration: * Added @pezkuwi/* path aliases in tsconfig.json * Updated theme/colors.ts to re-export from shared * Mobile already uses relative imports to shared (no changes needed) Architecture Benefits: - Single source of truth for common code - No duplication between frontends - Easier maintenance and consistency - Clear separation of shared vs platform-specific code Web-specific files kept: - web/src/lib/supabase.ts - web/src/lib/utils.ts (cn function for Tailwind, re-exports formatNumber from shared) All imports updated and tested. Both web and mobile now use the centralized shared folder.
Pezkuwi Mobile App
Status: ✅ Core Features Complete - Ready for Testing
World-class mobile application for Pezkuwi blockchain with advanced multi-language support.
🌟 Key Features
✅ Implemented
Multi-Language Support (6 Languages)
- EN - English
- TR - Türkçe (Turkish)
- KMR - Kurmancî (Kurdish - Kurmanji)
- CKB - سۆرانی (Kurdish - Sorani)
- AR - العربية (Arabic)
- FA - فارسی (Persian/Farsi)
Language System:
- User selects language on welcome screen
- Selected language is persistent across the entire app
- NO hard-coded language strings
- Settings screen allows language change anytime
- RTL support for Arabic, Sorani, and Persian
- All text dynamically translated using i18next
Authentication Flow
- ✅ Welcome screen with beautiful language picker
- ✅ Sign In screen (fully localized)
- ✅ Sign Up screen (fully localized)
- ✅ Smooth navigation between screens
- ✅ Kurdistan flag colors throughout
Main Dashboard
- ✅ Modern, professional UI
- ✅ Quick access to all features
- ✅ Balance display (0.00 HEZ)
- ✅ Staking stats
- ✅ Rewards tracking
- ✅ Active proposals counter
- ✅ Navigation to: Wallet, Staking, Governance, DEX, History, Settings
Settings Screen
- ✅ Language selection (change anytime)
- ✅ Theme settings
- ✅ Notification preferences
- ✅ Security settings
- ✅ About section
- ✅ Logout functionality
⏳ Pending Features
- Polkadot.js mobile wallet integration
- Live blockchain data (proposals, staking, treasury)
- Biometric authentication
- Push notifications
- Transaction history
- Governance voting
- DEX/Swap functionality
🛠 Technology Stack
- Framework: React Native with Expo
- Language: TypeScript
- Navigation: React Navigation v6
- i18n: react-i18next
- Storage: AsyncStorage (for language preference)
- UI: Custom components with Kurdistan colors
- State Management: React Context API
🎨 Design System
Kurdistan Flag Colors:
- Kesk (Green):
#00A94F- Primary color - Sor (Red):
#EE2A35- Accent color - Zer (Gold):
#FFD700- Secondary accent - Spi (White):
#FFFFFF- Backgrounds - Reş (Black):
#000000- Text
📱 Screens
- WelcomeScreen - Language selection with Kurdistan gradient
- SignInScreen - Beautiful login form
- SignUpScreen - Registration with validation
- DashboardScreen - Main app hub
- SettingsScreen - Full control including language change
🚀 Getting Started
Installation
cd mobile
npm install
Run on iOS
npm run ios
Run on Android
npm run android
Run on Web (for testing)
npm run web
📂 Project Structure
mobile/
├── src/
│ ├── i18n/
│ │ ├── index.ts # i18n configuration
│ │ └── locales/ # Translation files (6 languages)
│ ├── screens/
│ │ ├── WelcomeScreen.tsx
│ │ ├── SignInScreen.tsx
│ │ ├── SignUpScreen.tsx
│ │ ├── DashboardScreen.tsx
│ │ └── SettingsScreen.tsx
│ ├── navigation/
│ │ └── AppNavigator.tsx # Navigation logic
│ ├── contexts/
│ │ └── LanguageContext.tsx # Language management
│ ├── theme/
│ │ └── colors.ts # Kurdistan colors
│ └── types/
├── App.tsx # Main app entry
└── package.json
🌍 Language System Details
How It Works:
- App starts → User sees Welcome screen
- User selects language (EN/TR/KMR/CKB/AR/FA)
- Language choice is saved to AsyncStorage
- ALL app text uses
t('key')from i18next - User can change language in Settings anytime
- NO hard-coded strings anywhere
RTL Support:
- CKB (Sorani), AR (Arabic), FA (Persian) are RTL
- Layout automatically adapts for RTL languages
- App restart may be required for full RTL switch
🔮 Next Steps
-
Polkadot.js Integration
- Wallet connection
- Transaction signing
- Account management
-
Live Blockchain Data
- Connect to Pezkuwi RPC
- Real-time proposals
- Staking info
- Treasury data
-
Advanced Features
- Biometric login (Face ID/Touch ID)
- Push notifications
- QR code scanning
- Transaction history
📝 Development Notes
- Uses shared code from
../shared/directory - Maintains consistency with web app UX
- Follows mobile-first design principles
- Comprehensive error handling
- Professional logging
🎯 Mission Accomplished
This mobile app is built with ZERO hard-coded language. Every single text element is dynamically translated based on user's language selection. The app truly speaks the user's language - whether they're Turkish, Kurdish, Arab, Persian, or English speaker.
Kurdistan colors shine throughout - from the gradient welcome screen to every button and card.
Built with ❤️ for Pezkuwi Blockchain