Getting started

From zero to a booting tenant in 15 minutes. Covers install, seed data, and first login.

The platform is designed to be runnable on a developer laptop in under fifteen minutes. The minimum requirements are a machine with Docker (for the database and object store), Node 22+, and pnpm 10+. Everything else is handled by the installer.

Clone the repository and run `pnpm install` from the root. This installs the entire workspace — the Django-style Python backend, the Next.js frontend, and the shared TypeScript types. If this is your first time, allow a few extra minutes for the initial build.

The seed data includes realistic Pakistani, UAE, Saudi, UK, Australian, and New Zealand tenants with pre-populated chart of accounts, invoices, bills, journal entries, and bank transactions. You can switch between tenants from the top bar once you are signed in.

For first login, use any of the demo personas. The Quick-Demo panel on the login page auto-fills a credential set and lands you at the persona's default page. Fatima (accountant) is the recommended first stop if you want to see the ledger-heavy workflows in action.