Introduction

[ AxiomCore · Documentation ]

What is AxiomCore?

What AxiomCore is, why it uses contracts, who it is for, and which of its products are available today.

AxiomCore gives an application's frontend, backend and data model a shared contract: a typed, versioned description of the operations, data, validation and behavior one part offers another. You can review the contract, generate a client from it, test against it and see what a change affects before you ship.

Use it in two ways, or mix them:

  • Connect existing software. Keep a supported FastAPI or Go service and a web, React, Flutter or Swift client. Extract or write the contract between them.
  • Build with Acore. Write API operations, managed backend logic, a user interface and a database schema in Acore.

How it works

Source becomes a contract that is checked before clients and releases use it
Source becomes a contract that is checked before clients and releases use it
Diagram source
flowchart TD
  A[Existing backend or Acore source] --> B[Versioned .axiom contract]
  B --> C[Inspect, diff and test]
  C --> D[Existing client or Acore UI]
  C --> E[Release and delivery]
LayerWhat you doResult
Authoring and extractionWrite Acore or extract a supported backendReviewable source
Contracts and packagesBuild, pin dependencies, compare versions.axiom artifact and dependency lock
Development and executionRun an API, connect a client, test or mock behaviorA working application; a .axiomapp when you package an Acore UI
CoordinationUse Cloud project and release workflowsShared, versioned releases

Your database and executable backend stay explicit parts of the application.

Acore is the language. AxiomCore is the platform around it: the Axiom CLI, packages, client SDKs, runtime tools, testing, Inspector and Cloud workflows.

Why contracts

Teams coordinate more than endpoint shapes: retry and cache policy, validation, authentication expectations, streaming, projections, UI contracts and compatibility decisions. When those rules live in glue code or prose, each client reads them differently, and one backend change needs separate edits in web, mobile, mocks, tests, docs and release automation. Generated clients save typing, but generated code alone is not one auditable boundary.

AxiomCore builds one versioned artifact that tools can inspect, lock, compare, test, mock and consume. Thin framework integrations delegate supported behavior to a shared runtime. Semantic diffs show important contract and package changes before an upgrade.

Adoption is incremental: keep FastAPI or Go, consume contracts from web, React, Flutter or a qualified Swift integration, and add Acore where it helps. Theme and component packages have their own typed contracts; their metadata does not grant permission to run package code.

What a contract does not do

  • It does not replace application design, backend enforcement, target testing or operations. Backend code stays responsible for trusted authorization and business effects.
  • A successful build does not prove the application works on every target or that a deployment is production-ready.
  • It does not require you to leave Flutter, React, Swift, Python or Go.

Who it is for

RoleWhat you get
Application developersLocked service contracts in a web, React, Flutter or Swift app, or the Alpha Acore UI path
Backend developersExtract FastAPI or Go, then add contract-level behavior, validation, variants, domain semantics and security declarations in Acore
Platform and architecture teamsPackage boundaries, dependency locks, semantic diffs, and separately versioned service, theme, component, database schema, extension and policy artifacts
QA and reliability teamsContract-driven mocks, tests, fault definitions, inspection and benchmarks
Security and governance teamsReviewable authentication, authorization relations, sensitive-data classes, effects, integrity metadata and release approvals; not a replacement for runtime enforcement or a security assessment
Humans and AI agentsReadable source, packages, locks, diagnostics and semantic diffs that narrow the change surface

Products and status

ProductStatusScope
AcoreAlphaLanguage, evaluator, standard library, diagnostics, language server foundations
Axiom CLIAlphaAuthoring, build, inspection, diff, testing, mocking, packages, UI and app builds, security, connected Cloud commands
Axiom contracts and runtimeAlphaCanonical packages, resolution locks, semantic checks, native and web runtime paths, framework integrations
Acore UI and application artifactsAlphaDeclarative frontend authoring; .axiomapp builds validated on browser, Android Emulator and iOS Simulator paths
Axiom InspectorAlphaCLI and secure local dashboard: relationships, authority, runtime sessions, impact, optional bounded Jev question planning
Axiom Cloud DashboardAlphaAccount, project and release control plane; not yet the collaborative workspace planned below

These planned products cannot be installed or used today:

The direction is for Studio and Acode to work beside the CLI and Inspector on the same Acore source and packages, with the Cloud Dashboard coordinating releases and Marketplace supplying packages. This is direction, not current interoperability. The support matrix lists what runs today.

Next steps