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 β¦