mirror of
https://github.com/pezkuwichain/pwap.git
synced 2026-04-22 21:47:56 +00:00
pezkuwichain
f2e70a8150
BREAKING: Removed multi-language support (i18n) - will be re-added later Changes: - Removed i18n system (6 language files, LanguageContext) - Expanded WalletScreen, SettingsScreen, SwapScreen with more features - Added KurdistanSun component, HEZ/PEZ token icons - Added EditProfileScreen, WalletSetupScreen - Added button e2e tests (Profile, Settings, Wallet) - Updated plan: honest assessment - 42 nav buttons with mock data - Fixed terminology: Polkadot→Pezkuwi, Substrate→Bizinikiwi Reality check: UI complete with mock data, converting to production one-by-one
191 lines
5.0 KiB
Markdown
191 lines
5.0 KiB
Markdown
# 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
|
|
|
|
1. **WelcomeScreen** - Language selection with Kurdistan gradient
|
|
2. **SignInScreen** - Beautiful login form
|
|
3. **SignUpScreen** - Registration with validation
|
|
4. **DashboardScreen** - Main app hub
|
|
5. **SettingsScreen** - Full control including language change
|
|
|
|
## 🚀 Getting Started
|
|
|
|
### Installation
|
|
|
|
```bash
|
|
cd mobile
|
|
npm install
|
|
```
|
|
|
|
### Run on iOS
|
|
|
|
```bash
|
|
npm run ios
|
|
```
|
|
|
|
### Run on Android
|
|
|
|
```bash
|
|
npm run android
|
|
```
|
|
|
|
### Run on Web (for testing)
|
|
|
|
```bash
|
|
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:**
|
|
1. App starts → User sees Welcome screen
|
|
2. User selects language (EN/TR/KMR/CKB/AR/FA)
|
|
3. Language choice is saved to AsyncStorage
|
|
4. ALL app text uses `t('key')` from i18next
|
|
5. User can change language in Settings anytime
|
|
6. 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
|
|
|
|
1. **Polkadot.js Integration**
|
|
- Wallet connection
|
|
- Transaction signing
|
|
- Account management
|
|
|
|
2. **Live Blockchain Data**
|
|
- Connect to Pezkuwi RPC
|
|
- Real-time proposals
|
|
- Staking info
|
|
- Treasury data
|
|
|
|
3. **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**
|