Premium personal finance management (PFM) platform for African users — budgets, savings goals, financial health scoring, and AI-powered coaching.
# SmartCash Africa
Premium personal finance management (PFM) platform for African users — budgets, savings goals, financial health scoring, and AI-powered coaching.
This repository is a **monorepo** with separate front-end apps today and reserved folders for backend and mobile clients.
## Projects
| Folder | Status | Role | Dev URL |
| --------------------------------------------- | ------- | ----------------------------- | --------------------- |
| `smartcashafrica-lp` | Active | Public marketing landing page |
localhost |
| `smartcashafrica-fe` | Active | Authenticated web application |
localhost |
| `smartcashafrica-be` | Planned | API / backend services | — |
| `smartcashafrica-mb` | Planned | Mobile app (Flutter) | — |
## Quick start
Install dependencies in each active project, then run both apps from the repo root:
```bash
cd smartcashafrica-lp && npm install && cd ..
cd smartcashafrica-fe && npm install && cd ..
npm run dev
```
| Command | Description |
| ------------------- | ---------------------------------------- |
| `npm run dev` | Landing page + app (ports 5174 and 5173) |
| `npm run dev:lp` | Landing page only |
| `npm run dev:app` | App only |
| `npm run build` | Production build for both front-ends |
| `npm run build:lp` | Build landing page |
| `npm run build:app` | Build app |
## Architecture
```
Visitor
│
▼
smartcashafrica-lp ──CTA──► smartcashafrica-fe
(marketing site) (authenticated PFM app)
▲ │
└──────── logged-out / ──────────┘
```
- **Landing page** drives acquisition: hero, pricing, features, FAQ.
- **Web app** handles auth, onboarding, and day-to-day money man …