Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

68 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

LuxPH - Stellar-Powered Invoice & Payment Platform for the Philippines

Stellar React Firebase


🧩 Problem

MSMEs, OFWs, and unbanked Filipinos lack affordable, accessible payment and invoicing solutions that enable seamless cross-border transactions and local settlements. Traditional payment gateways charge high fees (2.5% - 3.5%), require complex KYC processes, and exclude those without access to traditional banking infrastructure. Small merchants struggle to issue professional invoices, track payments, manage cash flow efficiently, and settle instantly to their bank accounts.


🌟 Vision

To democratize financial services in the Philippines by leveraging Stellar blockchain technology, enabling millions of Filipinos to access affordable, instant, and borderless payment solutions. LuxPH aims to create an inclusive financial ecosystem where any merchantβ€”regardless of bank account statusβ€”can accept payments, issue invoices, and manage their business finances with confidence. Within 3 years, we envision LuxPH as the go-to platform for 100,000+ Filipino merchants to process payments at a fraction of traditional costs.


🎯 Purpose

LuxPH was built to empower Filipino merchants and individuals with blockchain-based financial tools that eliminate intermediaries, reduce transaction costs to <0.1%, and provide absolute transparency. The platform bridges the gap between traditional finance and Web3, making it easy for merchants to accept stablecoin payments (USDC, PHPC) and settle instantly to their preferred accounts or wallets.


πŸ‘₯ Target Users

  • OFWs (Overseas Filipino Workers) β€” Send remittances to family and businesses at lower costs with instant settlement.
  • MSMEs & Solo Entrepreneurs β€” Manage invoices, receive payments, track transactions, and access business analytics.
  • Unbanked & Underbanked Filipinos β€” Access financial services without a traditional bank account or complex KYC.
  • Freelancers & Service Providers β€” Invoice clients globally and receive payments without intermediaries.
  • Small Retailers & Online Sellers β€” Accept digital payments, manage inventory, and settle instantly.

✨ Features

  • Invoice Management β€” Create, track, and manage professional invoices with QR code support and PDF export.
  • Multi-Wallet Support β€” Accept payments from Stellar wallet holders (Freighter, Albedo, Stellar Wallets Kit).
  • Stablecoin Payments β€” Accept USDC and Philippine Peso (PHPC) stablecoins on Stellar with real-time conversion.
  • Instant Settlements β€” Direct peer-to-peer transactions via Soroban smart contracts.
  • Merchant Dashboard β€” Real-time analytics, transaction history, revenue tracking, and business metrics.
  • Admin Panel β€” Platform management, merchant verification, transaction monitoring, and system configuration.
  • Subscription Tiers β€” Free and Pro plans with flexible rate limits and feature access.
  • Cashout Management β€” Convert crypto to fiat with integrated anchor support (PDAX integration).
  • Contingency Vault β€” Automated ledger-locked savings engine utilizing Time-Bound Claimable Balances on Stellar.

πŸ› οΈ Tech Stack

React TypeScript Vite Tailwind Framer Motion Firebase Stellar

Layer Technology
Frontend React 19.2, TypeScript 6.0, Vite 8.0, Tailwind CSS 4.3, Framer Motion 12.38
Backend Firebase (Authentication, Firestore Database, Cloud Functions, Hosting)
Blockchain Horizon API, Stellar SDK v15
Wallets Freighter API v6.0, Stellar Wallets Kit v2.2, Albedo v0.1
UI & Utilities Lucide React, React QR Scanner, jsPDF, html2canvas

πŸš€ How to Run Locally

1. Clone the repository

git clone https://github.com/zneright/LuxPH.git
cd LuxPH

2. Install dependencies

npm install

3. Set up environment variables

Create a .env file in the project root with your Firebase credentials and Stellar network configuration. See .env.example for required keys.

4. Run the development server

npm run dev

Other commands

# Build for production
npm run build

# Preview production build
npm run preview

Prerequisites:

  • Firebase credentials (.env file required)
  • Stellar network configuration (Testnet / Mainnet)
  • Freighter wallet extension installed in your browser

🌐 Deployment

Testnet (Stellar Futurenet)

πŸ“Έ Testnet Screenshot:

Testnet Screenshot Testnet Screenshot 2


Mainnet (Stellar Public Network)

πŸ“Έ Mainnet Screenshot:

Mainnet Screenshot


πŸŽ₯ Demo & Resources

Resource Link
πŸ“ Google Drive (Video + Pitch Deck) Open Folder
🎬 Demo Video Watch on Google Drive
πŸ–ΌοΈ Pitch Deck View on Google Drive

πŸ‘¨β€πŸ’» Team

Name Role GitHub
Renz Jericho Buday Full-Stack Developer & Product Lead @zneright
Nishia Pinlac Front End Lead @nsh15-cmd
Liezl Casabuena UI Designer β€”

🎯 Stellar Philippines Hackathon 2026 Submission

Hackathon: Stellar Philippines Hackathon 2026 Theme: Real-World Financial Solutions for Filipinos Focus Area: MSME & Commerce Tools, Payments & Remittances, Financial Inclusion Submission Date: May 23, 2026

βœ… Submission Checklist

  • GitHub Repository with complete documentation
  • README.md following required format
  • Testnet deployment β€” Stellar Expert (Testnet)
  • Mainnet deployment β€” Stellar Expert (Mainnet)
  • Testnet screenshots (public/images/testnet.png, public/images/testnet2.png)
  • Mainnet screenshot (public/images/mainnet.png)
  • Demo video β€” Google Drive
  • Pitch deck β€” Google Drive
  • Working MVP with Stellar integration

πŸ”— Additional Resources


πŸ“œ License

MIT


Last Updated: May 2026 Status: πŸš€ Submitted β€” Stellar Philippines Hackathon 2026

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages