Overview

Repository-level architecture for Universo Platformo React.

This section documents the current repository architecture as it exists today.

The repository is now best understood as a PNPM monorepo that assembles a shared platform runtime, feature packages, migration tooling, documentation packages, and a React frontend shell around a SQL-first backend.

Core Principles

• Keep business domains in focused packages.

• Use Supabase (PostgreSQL) with shared Knex-based runtime services.

• Prefer SQL-first stores and neutral executor contracts.

• Keep frontend features modular and assembled by the core shell.

• Treat migrations, schema evolution, and docs as first-class platform concerns.

Read Fixed System-App Convergence for the converged fixed-schema model used by admin, profiles, metahubs, and applications.

Read Optional Global Catalog for the disabled-by-default registry mode, release-bundle workflow, and operator recovery boundaries.

Read System App Migration Lifecycle for how system app schemas are generated, upgraded, and tracked at runtime.

Read the pages below for structure, backend, frontend, database, and auth details.