PracManager — Case Study

PracManager — Practice Management Platform for South African Accounting FirmsClient: PracManager
Industry: Accounting & Tax Practice Management
Location: South Africa
Live URL: www.pracmanager.co.za
Built by: Monthos
Project type: Multi-tenant SaaS · Custom web applicationAt a glance

Problem

Accounting practices juggle Xero, SARS deadlines, client communication, and team coordination across spreadsheets, email, and disconnected tools.

Solution

A purpose-built practice management platform that syncs Xero data, centralises client records, and runs structured compliance workflows with automated client communication.

Stack

React · Vite · TypeScript · Supabase · Netlify · Xero API

Scope

Multi-tenant architecture, 40+ serverless functions, 14+ structured task workflows, full Xero integration

Project impact

Monthos built the practice-management layer Xero never had, turning spreadsheets and email chains into structured, deadline-aware compliance workflows.

One client view, synced from Xero. Contacts, invoices, payments and credit notes flow into a single practice-wide workspace—no re-keying.

Compliance runs to a process, not memory. 14+ structured workflows (EMP201, VAT201, ITR12, SARS requests and more) with phase-based checklists and clear ownership.

Clients are chased automatically. Phase-triggered emails request documents and confirm sign-off at the right moment, cutting manual follow-up.

Built to grow with the practice. A spec-driven Task Factory lets new compliance workflows ship without architectural rework, with strict per-practice data isolation.

Who this is for: South African accounting and tax practices—from owner-run firms to multi-team practices—that already run on Xero and need to manage SARS deadlines at scale.The challengeSouth African accounting and tax practices operate under constant regulatory pressure. PAYE, VAT, income tax, WCA, CIPC, and SARS correspondence all carry hard deadlines — and missing one can mean penalties for the client and reputational damage for the firm.Most practices already run their books in Xero, but Xero was never designed to be a practice management system. Teams end up managing compliance in spreadsheets, chasing documents over email, and relying on institutional knowledge to know what stage each client is at.PracManager needed a platform that could:

Unify client data from Xero into a single practice-wide view

Standardise compliance workflows so every team member follows the same process

Automate client communication at the right stage of each task

Support multiple practices on one platform with strict data isolation

Scale as new service lines and task types are added over time

The solutionMonthos designed and built PracManager — a multi-tenant SaaS platform that gives accounting practices a collaborative workspace built around their existing Xero data.Rather than replacing Xero, PracManager sits alongside it: contacts, invoices, payments, and credit notes sync from Xero into Supabase, while PracManager adds the layers Xero lacks — structured task boards, phase-based checklists, client notes, SARS correspondence tracking, email templates, and role-based team management.Each practice gets its own isolated environment. Practice admins connect their Xero organisation, invite staff, assign services to clients, and work through compliance tasks from a single dashboard.Key featuresXero integration & client hub

OAuth connection flow with encrypted token storage and multi-tenant support

One-click sync of contacts, invoices, payments, and credit notes

Entity management for individuals and companies, with manual entity-type overrides where Xero classification differs from tax treatment

Financial views per client: aging balances, transaction history, invoices, payments, and credit notes

Extended client profiles beyond Xero's default fields — tax references, service assignments, and assigned team members

Structured compliance task workflowsPracManager implements a Task Factory pattern: each service line is defined as a JSON specification that scaffolds database tables, UI pages, checklist items, and email triggers. This makes new task types repeatable to build and consistent to use.Live task workflows include:

Category

Task types

Payroll & employer compliance

EMP201 monthly submissions, PAYE/SDL/UIF registration, WCA registration, WCA annual returns

VAT

VAT registration, VAT201 (non-bookkeeping), VAT refunds, VAT assessment review, VAT audit/verification

Income tax

ITR12 returns, individual income tax registration

SARS compliance

TCC/TCS requests, tender/good standing certificates

Compliance monitoring

Monthly company monitoring, annual individual monitoring

Each task follows a phase-based workflow:

Defined phases with sort order and completion status

Checklist items per phase, with optional requirements for files, notes, and dates

Task assignment, due dates, and status tracking (not started → in progress → complete)

Phase-triggered emails to clients — e.g. document requests, sign-off confirmations, registration certificates

File attachments linked to specific checklist items and task phases

SARS correspondence managementA dedicated module for tracking SARS correspondence dumps: searchable, sortable, filterable lists with resolution status, assignee tracking, and audit logging. Teams can mark items resolved, attach context, and maintain a clear record of what has and hasn't been actioned.Collaboration & communication

Rich-text notes on contacts with @mentions and real-time notifications

Configurable email templates per practice, with sender mappings and CC/BCC defaults

Client sign-off flows with tokenised approval links

Document request emails — single and bulk send

In-app notifications bell with unread counts

Multi-tenant administration

Super Admin layer for platform operators: create and manage practices, impersonate users for support

Practice Admin controls: user invitations (single and bulk CSV import), service catalogue configuration, tax settings, Xero connection management

Staff roles with scoped access to contacts, tasks, and settings

Row-level security (RLS) on every database table — practices never see each other's data

Audit log of significant actions across the platform

Service catalogue & client assignmentPractices enable only the service categories they offer. The sidebar dynamically shows relevant task boards based on enabled services. Clients are assigned services individually, so the task system knows which workflows apply to which entity.Technical approachArchitecture┌─────────────────────────────────────────────────────────┐ │ Netlify CDN │ │ (React SPA · Static assets) │ └─────────────────────┬───────────────────────────────────┘ │ ┌─────────────┼─────────────┐ ▼ ▼ ▼ Supabase Auth Supabase DB Edge Functions (Email/OAuth) (PostgreSQL (44 serverless + RLS) endpoints) │ │ └──────┬──────┘ ▼ Xero API · SendGrid · Netcash webhooksFrontend

Vite 6 + React 18 with TypeScript strict mode

React Router 6 for client-side routing

Tailwind CSS 4 with Radix UI component primitives

TipTap rich-text editor for notes

React Hook Form + Zod for validated forms

Responsive dashboard with collapsible sidebar, pinned pages, and keyboard shortcuts

Backend

Supabase PostgreSQL with 80+ migrations defining the full schema

Row-level security policies enforcing tenant isolation and role-based access

44 Supabase Edge Functions (Deno) handling:

Xero OAuth and data sync
Practice and user lifecycle
Task phase actions and attachment management
12+ task-type-specific email senders
Client sign-off token generation and verification
SARS correspondence clearing
Bulk user invitations and extended client imports

Encrypted Xero token storage (AES-256-GCM)

Real-time subscriptions for live updates

Deployment & security

Hosted on Netlify with SPA routing, security headers, and asset caching

Environment secrets managed via Supabase Edge Function secrets and Netlify env vars

OAuth via Supabase Auth (email/password and Google)

Session invalidation for deactivated users

Audit logging on all sensitive operations

The Task FactoryOne of the most distinctive engineering decisions is the Task Factory — a spec-driven code generation system. Each task type is defined in a JSON file covering:

Service category, display name, and entity type

Status lifecycle and period rules (monthly, annual, one-off)

Phases with email triggers and attachment kinds

Checklist validation rules (require file, require note, require date)

Automation hooks for cron-based task creation

This pattern means adding a new compliance workflow — say, a new SARS submission type — follows a repeatable pipeline: write the spec, run the factory, deploy migrations, and ship a new task board. The service catalogue documents 9 top-level categories and hundreds of individual service steps, giving the platform room to grow without architectural rework.What we deliveredFor practice teams

A single source of truth for every client — financial data from Xero plus tax profiles, notes, services, and compliance status

Structured workflows that replace ad-hoc spreadsheets with phase-based checklists and clear ownership

Automated client emails at the right moment in each workflow, reducing manual follow-up

Visibility into overdue tasks, in-progress work, and team workload from the dashboard

For platform operators

Multi-tenant SaaS ready to onboard new practices without code changes

Super Admin tooling for practice creation, user impersonation, and platform-wide audit

Extensible task system that supports new South African compliance workflows as regulations evolve

Production deployment on Netlify with security headers, caching, and environment isolation

By the numbers

Metric

Count

Database migrations

80+

Supabase Edge Functions

Structured task workflows

14+

Service catalogue categories

Navigation task boards

20+

User roles

3 (Super Admin, Practice Admin, Staff)

Tech stack summary

Layer

Technology

Frontend

React 18, Vite 6, TypeScript, Tailwind CSS 4, Radix UI

Routing

React Router 6

Backend

Supabase (PostgreSQL, Auth, Edge Functions, Realtime)

Integrations

Xero API, SendGrid (email), Netcash (webhooks)

Hosting

Netlify

Testing

Playwright (E2E)

Validation

Zod, React Hook Form

Why this project mattersPracManager is not a generic project management tool adapted for accountants. It is built from the ground up around South African tax and compliance reality — the actual service catalogue of a modern accounting practice, the actual SARS deadlines, and the actual workflow steps teams follow when processing an EMP201, a VAT audit, or an ITR12.By syncing with Xero rather than competing with it, and by encoding compliance knowledge into structured, repeatable task workflows, PracManager gives practices a platform that grows with their service offering — without the overhead of custom spreadsheets or one-size-fits-all software that doesn't understand local regulation.About MonthosMonthos builds custom software for businesses that have outgrown off-the-shelf tools. From multi-tenant SaaS platforms to workflow automation and third-party integrations, we design and ship production-grade applications that fit how your team actually works.Interested in a similar project? Get in touch →Case study prepared for Monthos.com · Project: PracManagerMonthos Group — Cheltondale, Johannesburg, SA. Email info@monthos.com, phone +27 (68) 750 7313.Case studies · Privacy Policy · Terms of Service