Settings & branding
Everything you can tune at /admin/settings, from the colour palette to dues policy to reminder schedules.
Branding
/admin/settings → Branding.
- Community name— how your community shows up in headers, emails, and WhatsApp messages. Change anytime; existing messages aren't affected.
- Brand color — drives buttons, links, gradient backgrounds, and email accents. Picker shows a curated palette plus a custom hex input.
- Logo URL— direct URL to your community's logo image (PNG/SVG/WebP, ≥200×200 recommended, square). Shown on the login page, in the portal sidebar, and at the top of HTML emails.
- Login background image — optional photo (estate gate, club house, etc.) shown behind a brand-color tint on the login, password-reset and invite-acceptance pages. JPG/PNG/WebP, landscape, ≥1600px wide for crisp display. Uploaded directly through the form.
- Currency — 3-letter ISO code (GHS, NGN, USD, ZAR). Drives every money formatter in the portal.
- Default monthly dues — suggested value when adding a new household. Can be overridden per household.
Late payment penalty
/admin/settings → Late payment penalty. Optional. When enabled, residents who haven't paid past the grace period get an extra charge on each affected month.
- Type: Flat (fixed amount per month overdue) or Percent (percentage of unpaid dues per month overdue).
- Rate: the amount or percent.
- Grace months: how many months of leniency before the penalty kicks in. e.g. 3 means penalty starts on month 4 of an unpaid period.
Penalties show up on each affected month's statement row, marked overdue. They recompute live, so changing the policy reflects immediately on every statement.
For one-off forgiveness, use the Penalty waiverbutton on the resident's profile — log a reason, target one specific month, and the penalty for that month is suppressed without disabling the policy community-wide.
Automated dues reminders
/admin/settings → Automated dues reminders. The system fires reminders on the days you list, on the channels you tick.
- Days of the month — comma-separated, 1–28 (avoid 29–31 since not every month has them). E.g.
5,15,25fires three times a month. - Channels — email, WhatsApp, SMS in any combination. A resident with email + phone on file and all three channels ticked gets up to 3 messages per fire day. With per-channel-per-day dedupe, no double-sends.
- Minimum balance — skip residents whose balance is below this amount. Set to 0 to remind everyone behind by any margin.
For an off-schedule push, use the Send reminders button on /admin/payments — fires right now using the same channel config.
Monthly dues rate
/admin/settings → Monthly dues rate. For changing the rate for many households at once. Three ways:
- Set all to a new amount — useful at the start of a new financial year when the AGM votes a new community-wide rate.
- Bump everyone by an absolute amount (e.g. +GHS 50).
- Bump everyone by a percentage (e.g. +10%).
Each option previews the new distribution before applying. Past statements are not retroactively changed — the new rate applies to the current and future periods only.
Email (SMTP)
See Communications for the full setup. Quick summary: paste host / port / user / password from your provider, click test, you're done.
SMS (mNotify)
Also covered in Communications. Get the API key from your mNotify dashboard, paste in, send a test.
Data export
/admin/settings → Data export. Download a full copy of your community's data anytime — JSON (machine-readable, full structure) or CSV (Excel-friendly, one file per table). Passwords and other secrets are excluded. Useful for accounting, audit, or just peace of mind.