ZakApp re-imagines the wealth purification experience by prioritizing user privacy, Fiqh precision, and modern design. Unlike other tools that send your Net Worth to a cloud server, ZakApp performs all calculations locally.
- Zero-Knowledge Encryption: Your payment data is encrypted with YOUR password before sync. Server literally cannot read it.
- Local-First Storage: Uses RxDB (IndexedDB/SQLite) for offline-first with optional encrypted sync.
- Client-Side Encryption: AES-256-GCM encryption powered by Web Crypto API (PBKDF2, 600k iterations).
- Migration Available: Existing users can upgrade historical data via in-app wizard.
Note: As of v0.10.0, payment recipients and notes are encrypted client-side. Even with full database access, the server cannot decrypt your data. Learn more
- Precision Hawl Tracking: Tracks Nisab thresholds based on Lunar Hijri calendar.
- Multi-Madhab Compliance: Toggle between Hanafi, Shafi'i, Maliki, and Hanbali rulings.
- Asset Portfolio Management: Detailed tracking for Gold, Crypto, 401k, and Real Estate.
- Offline-First & PWA: Installable as a native app with full offline capabilities.
- Responsive Design: Optimized for all device sizes with mobile-first UX.
The fastest way to get started with zero configuration:
# Clone and run the deployment script
git clone https://github.com/slimatic/zakapp.git && cd zakapp
./deploy-easy.shThat's it! The script will:
- ✅ Detect your environment (localhost/IP/domain)
- ✅ Auto-configure ports and avoid conflicts
- ✅ Generate secure secrets automatically
- ✅ Set up automatic HTTPS
- ✅ Start all services
Access your app:
- Localhost: http://localhost:3000
- Network: https://your-ip:3443 (accept the self-signed cert)
👉 See EASY-DEPLOY.md for detailed instructions and troubleshooting.
If you prefer manual control:
# Clone and deploy
git clone https://github.com/slimatic/zakapp.git && cd zakapp
# Copy and configure environment
cp .env.easy.example .env
# Edit .env with your settings
# Start services
docker compose up -dFor development with hot reload:
# Clone and install
git clone https://github.com/slimatic/zakapp.git && cd zakapp
npm run install-all
# Start development servers
npm start| Guide | Description |
|---|---|
| EASY-DEPLOY.md | Quick start guide - Complete easy deployment instructions |
| SELF-HOSTING.md | Production deployment with custom domains |
| QUICKSTART.md | Alternative deployment methods |
| FAQs.md | Islamic finance questions answered |
| Deployment Guide | Advanced deployment options |
| Troubleshooting | Common issues and solutions |
| API Reference | REST API documentation |
- Frontend: React 18, Vite, Tailwind CSS, shadcn/ui
- Backend: Node.js, Express, Prisma (SQLite)
- Sync: CouchDB for multi-device sync
- Security: Client-side AES-GCM (256-bit) powered by Web Crypto API
Detailed technical details can be found in our Architecture Guide.
We welcome contributions! Please read CONTRIBUTING.md for details.
This project is licensed under the GNU Affero General Public License v3.0 - see LICENSE.
- Open Source Islamic Finance Initiative
- RxDB for the incredible Local-First database engine