Architecture

A modern, typed foundation for agency ERP.

Kovalyn is built around a modern TypeScript application architecture with a relational database, typed query layers, modular services, and integration-ready APIs.

Stack

Layered for maintainability and extensibility.

Frontend App
layer / 01
React · TypeScript · TanStack Router
API Layer
layer / 02
Typed RPC · Server functions · REST
Business Modules
layer / 03
Projects · Scope · Time · Ledger · Clients · Contractors
SQL Database + Kysely
layer / 04
Typed schema · Migrations · Audit logging
Integration Layer
layer / 05
Stripe · QuickBooks · Xero · GitHub · Slack · Google
Foundations

Architecture concepts

React frontend
TypeScript end-to-end
SQL database
Kysely typed query layer
Modular API services
Role-based access control
Multi-tenant ready
Integration services
Audit logging
Event-driven workflows
Cloud-deployable
Self-hosting path
Multi-app structure

Three connected surfaces.

Control plane
Kovalyn Corporate

Internal product used by Kordspace and SaaS operators to manage tenants, subscriptions, feature plans, billing, support, system analytics, integration health, and deployment settings.

Agency workspace
Kovalyn Enterprise

The subscription product sold to agencies. Projects, clients, scope, timecards, invoices, contractor operations, accounting integrations, client portal, reports, and permissions.

Client interface
Kovalyn Portal

The client-facing surface for approvals, invoices, documents, requests, and project visibility — scoped to what each client should see.

Deployment

Self-host, managed, or enterprise.

Self-host

Docker-based deployment to your own infrastructure. Postgres + Node runtime, nothing exotic.

Managed cloud

Kordspace-operated hosting with automatic updates, backups, and monitoring.

Private enterprise

Dedicated single-tenant deployments with custom SLAs, integrations, and migration support.