pwap/README.md

Pezkuwi Web App Projects

Unified repository for all Pezkuwi blockchain frontend applications and shared resources.

🏗️ Project Structure

pezkuwi-web-app-projects/
├── web/                    # Main web application
├── pezkuwi-sdk-ui/        # Polkadot SDK UI (branded clone)
├── mobile/                 # Mobile application
├── shared/                 # Shared code and utilities
└── README.md              # This file

📁 Directories

1. web/ - Main Web Application

Status: ✅ ~90% Complete - Production Ready

The primary web interface for Pezkuwi blockchain at pezkuwichain.app

Tech Stack:

• React 18 + TypeScript
• Vite build tool
• Polkadot.js API
• Supabase (Auth & Database)
• Tailwind CSS + shadcn/ui
• i18next (Multi-language support)

Features:

• ✅ Wallet integration (Polkadot.js extension)
• ✅ Live blockchain data
• ✅ Staking dashboard
• ✅ DEX/Swap interface
• ✅ Transaction history
• ✅ Multi-language support (EN, TR, KMR, CKB, AR, FA)
• ⏳ Governance dropdown (pending - live blockchain integration)

Get Started:

cd web
npm install
npm run dev

2. pezkuwi-sdk-ui/ - Polkadot SDK UI Clone

Status: 🚧 Planned - Not Yet Implemented

Branded version of Polkadot.js Apps for Pezkuwi blockchain.

Purpose:

• Provide comprehensive blockchain explorer
• Offer advanced developer tools
• Enable direct chain interaction
• Serve as official SDK interface

Planned Implementation:

1. Clone Polkadot.js Apps repository
2. Apply Pezkuwi branding
3. Configure chain endpoints
4. Deploy to pezkuwichain.app/sdk

Resources:

• See pezkuwi-sdk-ui/README.md for details

3. mobile/ - Mobile Application

Status: 🚧 In Development - Early Stage (~15% Complete)

Native mobile app for iOS and Android.

Current Progress:

• ✅ Welcome screen with language selection
• ✅ Human verification flow
• ✅ Authentication (Sign In/Up)
• ✅ Main dashboard navigation
• ⏳ Wallet integration
• ⏳ Full feature parity with web

Technology: TBD (React Native / Flutter / Ionic)

Get Started:

• See mobile/README.md for current status and plans

4. shared/ - Shared Code

Status: ✅ Foundation Ready

Common code, types, and utilities used across all platforms.

Structure:

shared/
├── types/          # TypeScript type definitions
├── utils/          # Helper functions (formatting, validation)
├── blockchain/     # Blockchain utilities (Polkadot API wrappers)
└── constants/      # App constants and configuration

Usage:

// In web or mobile projects
import { formatAddress } from '../shared/utils';
import { PEZKUWI_NETWORK } from '../shared/blockchain';
import type { WalletAccount } from '../shared/types';

🎯 Development Roadmap

Phase 1: Project Organization ✅

• Reorganize repository structure
• Create shared utilities foundation
• Set up placeholder directories

Phase 2: Polkadot SDK UI (Next)

• Clone and configure Polkadot.js Apps
• Apply Pezkuwi branding
• Set up deployment pipeline
• Integrate with main web app

Phase 3: Web App Completion

• Implement governance dropdown with live data
• Complete blockchain data integration
• Production optimization
• Security audit

Phase 4: Mobile Development

• Choose technology stack
• Implement wallet integration
• Achieve feature parity with web
• Beta testing and release

🚀 Quick Start

Prerequisites

• Node.js 18+
• npm or yarn
• Git

Clone Repository

git clone https://github.com/pezkuwichain/pezkuwi-web-app-projects.git
cd pezkuwi-web-app-projects

Run Web App

cd web
npm install
npm run dev

Build for Production

cd web
npm run build

🌐 Multi-Language Support

All applications support:

• 🇬🇧 English (EN)
• 🇹🇷 Türkçe (TR)
• Kurdistan Kurdish - Kurmanji (KMR)
• Kurdistan Kurdish - Sorani (CKB)
• 🇸🇦 العربية (AR)
• 🇮🇷 فارسی (FA)

📝 Documentation

• Web App: See web/README.md and inline documentation
• SDK UI: See pezkuwi-sdk-ui/README.md
• Mobile: See mobile/README.md
• Shared Code: See shared/README.md
• Architecture: See web/mimari.txt for detailed system architecture

🔐 Security

Security is our top priority. See web/SECURITY.md for:

• Security policies
• Vulnerability reporting
• Multi-signature wallet setup
• Best practices

📄 License

See LICENSE file for details.

🤝 Contributing

We welcome contributions! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

📞 Support

• Website: pezkuwichain.app
• Issues: GitHub Issues
• Documentation: Project README files

---

Note: This is a monorepo structure designed for production-level deployment of Pezkuwi blockchain applications across multiple platforms.