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.