GhostFund Mobile App

GhostFund is a private, production‑grade mobile application built with React Native and a flat‑file PHP backend. It enables agents, users, and businesses to interact seamlessly with GhostFund’s ecosystem: wallets, receipts, repayments, investments, cash‑outs, and support.

---

📱 Overview

GhostFund Mobile delivers a premium fintech experience with:

• QR‑based login using GhostCards
• Wallet management with instant balance refresh
• Send money between users
• Cash‑out requests via Ecocash, Telecash, PayPal, etc.
• Investments initiated through Paynow
• Scan‑to‑receive for businesses accepting in‑store investments
• Receipts & Repayments tracking with clear status badges
• Support center with FAQs, policies, and contact form

---

🛠️ Tech Stack

• Frontend: React Native (Expo, TypeScript)
• Navigation: React Navigation (Native Stack)
• UI Components: Custom GhostFund theme (THEME.bg, THEME.text, etc.)
• Backend: PHP (flat‑file API, one‑action simplicity)
• Database: MySQL (wallets, receipts, repayments, investments, cashouts, support_messages)
• Deep Linking: ghostfund://card_id=... scheme
• Payments: Paynow integration

---

📂 Project Structure

ghostfund-app/
├── src/
│   ├── api/              # API client (client.ts)
│   ├── components/       # GhostButton, Popup, etc.
│   ├── navigation/       # AppNavigator, RootStackParamList
│   ├── screens/          # Dashboard, Wallet, Receipts, Repayments, InvestOnline, Cashout, SendMoney, ScanReceive, Support
│   └── config/           # THEME constants
├── assets/               # Logos, icons, splash screen
├── App.tsx               # Entry point
└── README.md             # Project documentation

---

🚀 Features Implemented

• DashboardScreen: Central hub with wallet balance and navigation.
• SendMoneyScreen: Validates inputs, posts to backend, refreshes wallet, shows receipt.
• CashoutScreen: Requests cash‑out, refreshes wallet, confirms via popup.
• InvestOnlineScreen: Initiates Paynow investment, opens browser, updates wallet.
• ReceiptsScreen: Lists receipts with company, amount, date.
• RepaymentsScreen: Lists repayments with status (Pending, Completed, Overdue).
• SupportScreen: FAQs, policies, contact form wired to backend.

---

🔒 Repository Notes

• This repository is private.
• No external contributions are accepted.
• GhostFund team only: internal use for development, deployment, and maintenance.

---

📖 Usage

1. Clone the repository (private access required).
2. Install dependencies:

   npm install

3. Run in development:

   npx expo start

4. Build for production:

   eas build --platform android
   eas build --platform ios

---

🗂️ Backend API Endpoints

• ?action=login_with_card → Authenticate via card ID
• ?action=get_wallet → Fetch wallet balance
• ?action=send_money → Transfer funds
• ?action=cashout_request → Request cash‑out
• ?action=invest_paynow_init → Initiate Paynow investment
• ?action=get_receipts → List receipts
• ?action=get_repayments → List repayments
• ?action=scan_receive → Credit wallet via QR payload
• ?action=support_message → Submit support message
• ?action=get_support_messages → Admin view of support inbox

---

🎨 Branding

GhostFund Mobile enforces pixel‑perfect UI fidelity:

• Dark theme with accent highlights (#6EE7B7)
• Custom popups (no system alerts)
• Branded icons and splash screen
• Consistent typography and spacing

---

📌 Roadmap

• Expand Admin Dashboard (repayments, wallet adjustments, support inbox, analytics).
• Add analytics layer to mobile app (charts, stats).
• Enhance Paynow callback handling for completed investments.
• Improve fraud detection and overdue repayment alerts.

---

⚠️ Disclaimer

This repository is internal to GhostFund.
It is not open source and not available for public contribution.
All rights reserved by GhostFund.