Smart estate management app for Nigeria - Manager, Tenant, and Service Staff portals
# 🏠EstateFlow
**Smart Estate Management for Nigeria** — A Progressive Web App for estate managers and tenants.
## ✨ Features
### For Estate Managers
- 🎨 **Full Customization** — Change colors, fonts, backgrounds, and logos
- 📊 **Management Dashboard** — Track dues, complaints, and spending with charts
- 📱 **QR Code Sharing** — Generate codes for tenants to join your estate
- 💰 **Subscription Plans** — Basic, Premium, and Platinum tiers
- 📢 **Announcements** — Post estate-wide notices with images
### For Tenants
- 🏠**Join Estates** — Enter QR code or PIN to access your estate
- 💳 **View Bills** — See estate dues and app subscription charges
- 🔧 **Maintenance** — Report issues (plumbing, electrical, security, etc.)
- 🚨 **Emergency Alerts** — Fire, robbery, medical, gas leak, flooding
- 👥 **Guest Access** — Generate codes for deliveries, Uber, and visitors
### Technical
- 📲 **Installable PWA** — Works on phone and PC like a native app
- 🔌 **Offline Support** — Service worker caches the app
- 🇳🇬 **Nigerian Payments** — Paystack integration (cards, bank, USSD)
- 🎠**Animated UI** — Drawing animation splash, smooth transitions
## 🚀 Quick Start
```bash
# Clone the repo
git clone
cd estateflow-app
# Install dependencies
pnpm install
# Start dev server
pnpm dev
```
Open `
localhost` in your browser.
## 📱 Install as App
### On Phone
1. Deploy to Vercel/Netlify (free)
2. Visit URL on phone → "Add to Home Screen"
### On Desktop
1. Visit deployed URL in Chrome/Edge
2. Click install icon in address bar
## 🏗️ Build for Production
```bash
pnpm build # Creates dist/ folder
pnpm preview # Preview production build
```
## 📦 Deploy
```bash
# Vercel
npx vercel --prod
# Netlify
npx netlify deploy --prod --dir=dist
# Cloudflare Pages
npx wrangler pages deploy dist
```
## đź’ł Payment Integration
See DEVELOPER-GUIDE.md for Paystack integration details.
## đź“‹ Subscription Plans
| Feature | Basic (₦2,500/mo) | Premium (₦5,000/mo) | Platinum (₦12,000/m …