mirror of
https://github.com/pezkuwichain/pwap.git
synced 2026-10-20 18:56:16 +00:00
SatoshiQaziMuhammed
772cb72c73
Three changes, all pointing the same way: one published document, fed from one source. `web/public/Whitepaper.pdf` was a second copy of a document that also lives on pezkuwichain.io, in the landing tree, on three servers and in the repository the document describes. The copies had diverged; the one bundled here was built in June and still named a licence the project does not use and a pallet the tree does not contain. A copy in a bundle is the hardest kind to keep current, because nothing fails when it goes stale. It is removed, and the documentation card now links to the canonical URL, so this application shows whatever is published rather than whatever was bundled. The deployed hosts redirect `/Whitepaper.pdf` to the same place, so existing links keep working. The web build also began by cloning `pezkuwi-sdk`, first from the self-hosted GitLab and then from GitHub. Neither is reachable: the GitLab path answers 500 to both the browser and `git ls-remote`, and the GitHub repository is disabled. Nothing here changed -- the workflow had not run since the second of August and the sources rotted underneath it. The clone fed `generate-docs-structure.cjs`, which already treats the SDK as optional and completes without it, and whose output is not served: the in-app documentation route redirects to docs.pezkuwichain.io, which is why `.gitignore` leaves those artifacts untracked. Swapping in another URL would not have helped either, since the run is unauthenticated and the surviving repository is private. The step is removed. Finally, `npm audit` reported five advisories against production dependencies, one high. None arrived with this branch; a month of them surfaced at once on the first run. `npm audit fix` without `--force` clears the high one and leaves two moderate, below what the gate measures, and moves only `package-lock.json` -- no declared range changes. `--force` was not used: it has broken this workspace's Solana dependencies before. Verified: full pipeline green -- Web App, Backend Indexer, Migration test, Security Audit, CodeQL and the deploy-gate wiring check.
Pezkuwi Web App Projects (PWAP)
Monorepo for Pezkuwi blockchain frontend applications.
Project Structure
pwap/
├── web/ # Main web application
├── mobile/ # Mobile application (React Native + Expo)
├── backend/ # Backend API services
├── shared/ # Shared code and utilities
└── package.json # Root package with build scripts
Related Repositories
| Repository | Description | URL |
|---|---|---|
| pezkuwi-sdk-ui | Blockchain Explorer & Developer Tools | https://github.com/pezkuwichain/pezkuwi-sdk-ui |
| pezkuwi-extension | Browser Wallet Extension | https://github.com/pezkuwichain/pezkuwi-extension |
Projects
1. web/ - Main Web Application
Status: ✅ Production Ready
The primary web interface for Pezkuwi blockchain at app.pezkuwichain.io
Tech Stack:
- React 18 + TypeScript
- Vite
- @pezkuwi/api
- Supabase (Auth & Database)
- Tailwind CSS + shadcn/ui
- i18next
Features:
- Wallet integration (Pezkuwi Extension)
- Live blockchain data
- Staking dashboard
- DEX/Swap interface
- P2P Fiat Trading with atomic escrow
- Transaction history
- Multi-language support (EN, TR, KMR, CKB, AR, FA)
- Governance with live blockchain integration
cd web
npm install
npm run dev
2. mobile/ - Mobile Application
Status: 🚧 In Development
React Native Expo app for iOS and Android.
Features:
- Welcome screen with language selection
- Multi-language support (6 languages with RTL)
- Authentication (Sign In/Up)
- Main dashboard navigation (5-tab bottom nav)
- Wallet integration with @pezkuwi/api
- Live blockchain data (HEZ, PEZ, USDT)
- Send/receive transactions
- Biometric authentication
cd mobile
npm install
npm start
3. backend/ - Backend Services
API services for the applications.
cd backend
npm install
npm run dev
4. shared/ - Shared Code
Common code, types, and utilities used across all platforms.
shared/
├── types/ # TypeScript type definitions
├── utils/ # Helper functions
├── blockchain/ # Blockchain utilities
├── constants/ # App constants
├── images/ # Shared images and logos
└── i18n/ # Internationalization
Quick Start
Prerequisites
- Node.js 18+
- npm
Installation
# Clone repository
git clone https://github.com/pezkuwichain/pwap.git
cd pwap
# Install all dependencies
npm install
# Or install individually
npm run install:web
npm run install:mobile
npm run install:backend
Build All Projects
npm run build
This builds:
web- Vite production buildpezkuwi-sdk-ui- Full SDK UI build (separate repo)mobile- Expo web export
Development
# Run web and mobile in parallel
npm run dev
# Or run individually
npm run dev:web
npm run dev:mobile
Multi-Language Support
All applications support:
- 🇬🇧 English (EN)
- 🇹🇷 Türkçe (TR)
- ☀️ Kurmancî (KMR)
- ☀️ سۆرانی (CKB)
- 🇸🇦 العربية (AR)
- 🇮🇷 فارسی (FA)
RTL support for CKB, AR, FA.
Scripts
| Command | Description |
|---|---|
npm run build |
Build all projects |
npm run dev |
Start development servers |
npm run lint |
Run linters |
npm run test |
Run tests |
npm run install:all |
Install all dependencies |
Links
- Website: https://app.pezkuwichain.io
- Website (alt): https://pex.mom
- Exchange: https://pex.network
- Documentation: https://docs.pezkuwichain.io
License
Apache-2.0