Avyro

The open-source operating system for business.

Avyro is an open-source business platform that brings accounting, invoicing, expenses, banking, payroll, compliance, projects, and everyday operations into one connected system. Built for small businesses that want simplicity without sacrificing proper financial foundations.

Invoice customers, record expenses, reconcile the bank, run payroll, and stay Mushak-ready. Avyro pairs a Wave-inspired simple mode with a structured double-entry ledger underneath. It works globally (multi-currency, configurable fiscal year) and ships first-class Bangladesh compliance — BDT, Jul–Jun fiscal year, e-TIN/BIN, VAT/TDS/VDS registers.

Who it's for

Audience	What you get
Small business owners	Simple UI — customers, invoices, expenses, cash snapshot without learning debits and credits
Accountants & bookkeepers	Accountant mode — chart of accounts, journals, trial balance, month-end checklist
Bangladesh businesses	Mushak-oriented registers, TDS/VDS tracking, VAT worksheets, e-return evidence exports
Developers & operators	Self-hostable monorepo — NestJS API, Next.js web, PostgreSQL, Redis worker

Beta status

Avyro is in public beta. The core ledger, sales/purchases workflows, banking, payroll, multi-currency, payment gateways (test + SSLCommerz sandbox), and Bangladesh compliance exports are implemented and covered by integration tests.

What to expect in beta:

Self-host and evaluate the full stack locally or on your own infrastructure
Run real books for a single organisation with owner + team roles
Export compliance worksheets — not automated NBR portal filing
Payment integrations beyond test checkout and SSLCommerz sandbox are stubs (bKash/Nagad)
Portable org backups and restore-from-upload (Settings → Backups)
Dark mode by default with per-user theme in Settings → Display
Object storage is local filesystem for documents; backup archives can use S3 when configured
Receipt OCR and per-bank PDF parsers are not yet built

See RELEASE.md for release notes (latest: v0.1.0-beta.2).

We welcome feedback, issues, and contributions. See CONTRIBUTING.md and SECURITY.md.

GitHub repo topics (suggested): accounting, open-source, invoicing, nestjs, nextjs, bangladesh, payroll, small-business

Area	Status
Auth, org, RBAC, audit	Solid foundation
Ledger, journals, periods, trial balance	Core complete, tested
Sales (invoices, quotes, payments, PDFs)	Functional
Purchases (expenses, bills, suppliers)	Functional
Banking (CSV/PDF import, match, transfer)	Functional; PDF parser is heuristic
FX (rates, foreign invoices/payments)	Functional
Gateways (test + SSLCommerz sandbox)	Functional; bKash/Nagad are stubs
Bangladesh compliance (Mushak registers, TDS/VDS)	Export layer; no auto-submit
Payroll, people, assets, time	Functional
Web UI	Broad coverage; dark mode default
Backups	Portable org archives; schedule, download, upload restore
Tests	Ledger + API integration; no web E2E yet

Features

Platform & security

Multi-tenant data model — workspace → organization; every query scoped by organization_id
Authentication — email/password via Better Auth; session cookies
RBAC — OWNER, ACCOUNTANT, MANAGER, EMPLOYEE, AUDITOR with route-level gating
UI modes — Simple (owner-friendly) and Accountant (journals, CoA, trial balance, month-end)
Appearance — dark (default), light, or system; per-user in Settings → Display
Audit log — immutable action trail for sensitive operations
Document storage — upload receipts, contracts, tax IDs; link to entities
Review queue — drafts, unmatched bank lines, unsettled gateway captures, overdue AR/AP
Business setup wizard — onboarding for business profile, IDs, bank, opening capital, invoice defaults
Command palette — keyboard-first navigation (⌘K / Ctrl+K)
Backups — portable org archives (no host pg_dump); schedule, download, restore from upload; optional S3 storage

Accounting core

Chart of accounts — seeded with VAT, TDS, VDS, FX, ERQ, gateway clearing accounts
Double-entry journals — all postings through AccountingPostingService; Decimal money (no floats)
Accounting periods — open / soft-close / lock
Opening balances & starting capital
Journal reversal
Trial balance, general ledger, month-end checklist
Owner money — capital contributions and drawings with automatic equity postings

Sales & purchases

Customers & suppliers — business/individual/government types; TIN/BIN fields
Quotes → invoices → payments — automatic AR/revenue/VAT postings; credit notes
Invoice PDFs — Wave / classic / minimal templates; custom colors, logo, footer
Quick expenses & bills (AP) — VAT, reverse-charge, ITC status, TDS/VDS withholding
Online checkout — hosted pay page (/pay/:token); test gateway + SSLCommerz sandbox
Contracts & projects — link commercial agreements and project codes to invoices

Banking & FX

Bank accounts — link to ledger cash/bank accounts
CSV import — date, description, amount[, balance][, externalId]
PDF statement import — text extraction + heuristic row parser
Transaction matching — suggest and match to invoices, bills, expenses
Inter-account transfers & reconciliation summary
Multi-currency — dated exchange rates, foreign invoices/payments, FX gain/loss posting

Bangladesh compliance

Disclaimer: Avyro stores identifiers, calculates from configured rules, and exports Mushak-oriented registers. It is not legal or tax advice and does not auto-file with NBR or other government portals.

Compliance profile — VAT registration flag, e-TIN, BIN, trade licence
Effective-dated tax codes — VAT standard/reduced/zero, TDS, VDS
VAT documents — Mushak 6.1 / 6.3 / 9.1 oriented records
Withholding entries & challans — TDS/VDS deposit tracking
Registers & exports — CSV/PDF for Mushak 6.1, 6.2.1, 6.3, 6.6, 6.7, 6.8, 6.10, 9.1; e-return evidence pack
Compliance reminders — expiring licences and IDs

See docs/COMPLIANCE_BD.md for implementation notes.

Reports, payroll & operations

Dashboard — revenue/expense/profit trend, cash, AR/AP aging buckets
Profit & loss, balance sheet, cash flow, AR/AP aging
Excel export — key reports downloadable as .xlsx
People / HR — employee records, compensation, TDS %
Payroll — periods, runs, journal posting, payslip PDFs
Assets — register, straight-line depreciation
Time entries — billable hours linked to projects

Tech stack

Layer	Technology
Monorepo	pnpm workspaces
Web	Next.js 16, React 19, TypeScript, Tailwind CSS 4
API	NestJS 12, TypeScript
Worker	BullMQ + Redis (email jobs)
Database	PostgreSQL 16, Prisma 7
Auth	Better Auth
PDF	PDFKit (invoices, payslips, Mushak registers), pdf-parse (bank statements)
Money	`decimal.js`

Quick start

Prerequisites

Node.js ≥ 20
pnpm 9.15 (corepack enable && corepack prepare pnpm@9.15.0 --activate)
Docker (recommended) for PostgreSQL and Redis

1. Clone and install

git clone git@github.com:MiriyamCore/Avyro.git
cd Avyro
pnpm install

2. Environment

cp .env.example .env

Edit .env — set a strong BETTER_AUTH_SECRET for anything beyond local dev. See Configuration.

3. Database

docker compose up -d
pnpm db:generate
pnpm db:migrate
pnpm db:seed    # dev only — creates demo org + owner user

4. Run

pnpm dev

For API + web + worker together:

pnpm dev:all

Service	URL
Web	http://localhost:3000
API	http://localhost:3001

Default seed login (change before any shared environment):

Field	Value
Email	`owner@demo.local` (or `SEED_OWNER_EMAIL`)
Password	`ChangeMeNow1!` (or `SEED_OWNER_PASSWORD`)

Production (Docker)

Local docker compose is Postgres + Redis only. To self-host the full stack in production, see docs/DEPLOYMENT.md:

cp .env.production.example .env   # on the server, fill in secrets
./infra/scripts/deploy.sh --seed  # first boot
./infra/scripts/deploy.sh         # later updates

5. Worker (optional)

Email notifications are queued from the API and processed by the worker. SMTP is optional — without it, the worker logs a stub.

pnpm --filter @avyro/worker dev

Other commands

Command	Description
`pnpm build`	Build all packages and apps
`pnpm test`	Run unit + integration tests (requires `DATABASE_URL`)
`pnpm typecheck`	TypeScript check across workspace
`pnpm lint`	Lint
`pnpm db:studio`	Open Prisma Studio
`pnpm db:migrate:deploy`	Apply migrations (production)
`pnpm dev:all`	API + web + worker
`pnpm --filter @avyro/api dev`	API only
`pnpm --filter @avyro/web dev`	Web only
`pnpm --filter @avyro/accounting build`	Ledger package
`pnpm --filter @avyro/api exec vitest run`	API integration tests

Project structure

avyro/
├── apps/
│   ├── api/              NestJS REST API
│   ├── web/              Next.js frontend (Simple + Accountant UI)
│   └── worker/           BullMQ worker (outbound email)
├── packages/
│   ├── accounting/       AccountingPostingService, ledger invariants
│   ├── database/         Prisma schema, migrations, seed
│   ├── validation/       Shared Zod schemas
│   ├── types/            Shared TypeScript types
│   └── ui/               Shared UI primitives
├── docs/                 Architecture, compliance, API, deployment guides
├── docker-compose.yml    PostgreSQL + Redis for local dev
├── docker-compose.prod.yml  Full production stack
├── Dockerfile            Production image (web, API, worker)
└── .github/workflows/    CI (typecheck, test, build)

Configuration

All variables are documented in .env.example.

Variable	Required	Description
`DATABASE_URL`	Yes	PostgreSQL connection string
`REDIS_URL`	Yes*	Redis for BullMQ (*required if using email queue)
`BETTER_AUTH_SECRET`	Yes	Session signing secret — use a long random string in production
`BETTER_AUTH_URL`	Yes	Public URL the browser uses
`API_URL`	Yes	API base URL
`WEB_URL`	Yes	Web app URL
`STORAGE_ROOT`	No	Local document storage path
`BACKUP_ROOT`	No	Local backup archive path (when S3 not configured)
`S3_BUCKET` + AWS creds	No	Remote backup storage (optional)
`BACKUP_USE_QUEUE`	No	`true` to queue backups via worker (default: inline in API)
`SMTP_*`	No	Outbound email
`SSLCOMMERZ_*`	No	SSLCommerz sandbox credentials
`SEED_*`	No	Dev seed user credentials

Never commit .env or real secrets.

Roadmap

Near term

Per-bank PDF parsers (BRAC, EBL, City, DBBL, etc.)
Receipt OCR — auto-fill expense fields from uploaded images
Live bKash / Nagad wallet checkout adapters
S3/R2 object storage adapter
Web E2E tests (Playwright)
Worker in dev script — pnpm dev:all

Compliance depth

Deeper Mushak 6.3 tax-invoice PDF field mapping
Credit/debit note workflows wired end-to-end in UI
Automated VAT period reminders and filing calendar

Platform (future)

Public registration and workspace onboarding
Subscription billing and usage limits
Public API and webhooks
Data importers and accountant portal

See avyro-SPEC.md and docs/PRODUCT.md for the full plan.

Development principles

Scope all tenant data by organization_id
Post journals only through AccountingPostingService
Never use floating-point for money — use Decimal / db.Decimal
Never hard-code tax rates or organisation-specific IDs — use effective-dated tax_codes

Additional docs:

avyro-SPEC.md — product & engineering spec
docs/COMPLIANCE_BD.md — Bangladesh compliance guide
docs/ARCHITECTURE.md — system architecture
docs/API.md — API overview
docs/TESTING.md — how to run tests

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a PR.

Security

Report vulnerabilities privately — see SECURITY.md. Do not commit secrets or production data.

License

MIT License — Copyright (c) Miriyam Core.

Author

Maintained by Miriyam Core — hello@miriyamcore.com

Acknowledgements

UX inspiration from Wave (simplicity for owners) and Stripe (structured money movement and reconciliation). Not affiliated with Wave Financial or Stripe, Inc.

Navigation Menu

Uh oh!

Repository files navigation

Avyro

Who it's for

Beta status

Features

Tech stack

Quick start

Prerequisites

1. Clone and install

2. Environment

3. Database

4. Run

Production (Docker)

5. Worker (optional)

Other commands

Project structure

Configuration

Roadmap

Near term

Compliance depth

Platform (future)

Development principles

Contributing

Security

License

Author

Acknowledgements

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
apps		apps
docs		docs
infra		infra
packages		packages
.dockerignore		.dockerignore
.env.example		.env.example
.env.production.example		.env.production.example
.gitignore		.gitignore
.npmrc		.npmrc
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
RELEASE.md		RELEASE.md
SECURITY.md		SECURITY.md
SPEC.md		SPEC.md
avyro-SPEC.md		avyro-SPEC.md
docker-compose.prod.yml		docker-compose.prod.yml
docker-compose.yml		docker-compose.yml
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

Avyro

Who it's for

Beta status

Features

Tech stack

Quick start

Prerequisites

1. Clone and install

2. Environment

3. Database

4. Run

Production (Docker)

5. Worker (optional)

Other commands

Project structure

Configuration

Roadmap

Near term

Compliance depth

Platform (future)

Development principles

Contributing

Security

License

Author

Acknowledgements

About

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages