Skip to content

Packages

Every non-private package in this repository is published to npm at version 1.0.0. They ship ES modules only.

  • In your own project. Run npm install @cratis/arc.core plus the adapter or integration you need, and the peers each package’s manifest lists.
  • Inside the clone. The samples under Samples/ reference the packages with the workspace:^ protocol, as Samples/Tasks/package.json does; workspace:^ resolves only inside this repository’s Yarn workspace. Samples/README.md lists the samples and their run.sh scripts. yarn check:consumers packs the packages and installs them outside the workspace to check NodeNext and Bundler consumers.

Create an application walks through the npm install path, from an empty folder to a running command and query.

Package Folder Exports Peer dependencies
@cratis/arc.core Source/Core ArcApplication, the artifact, field, authorization, and service decorators, validators, ArcServer, define*, results, authentication, identity, tenancy, introspection, exportClientManifest, runArc, createArcNodeHandler; @cratis/arc.core/hosting for WebSocket hosting primitives; Node builder loads appsettings.json and Cratis__... environment keys @cratis/fundamentals ^7.19.6, @opentelemetry/api ^1.9.0; depends on zod 4
@cratis/arc.express Source/Express cratisArc middleware with .injectWebSocket express ^5.0.0
@cratis/arc.fastify Source/Fastify cratisArc plugin fastify ^5.0.0
@cratis/arc.hono Source/Hono cratisArc middleware, serveCratisArc Node helper, createHonoWebSockets for shared Node helpers hono ^4.0.0; optional @hono/node-server ^1.19.11
@cratis/arc.testing Source/Testing CommandScenario, QueryScenario, ObservableQueryScenario, ArcScenario, given, shouldHaveRuleFailure
@cratis/arc.mongodb Source/MongoDB withMongoDB, mongoCollection, MongoCollection, naming policies, MongoReadModels @cratis/arc.core, @cratis/fundamentals, mongodb ^6.21.0
@cratis/arc.drizzle Source/Drizzle withDrizzle, drizzleReadModel, drizzleDatabase, DrizzleReadModels, column codecs @cratis/arc.core, @cratis/fundamentals, drizzle-orm ^0.45.0
@cratis/arc.chronicle Source/Chronicle withChronicle, commandAggregate, reactorCommandResultHandler, executeCommandsAsSystem, eventForEventSourceId, eventSourceIdResponse, eventsWithConcurrencyScopes, routing decorators, notAudited, ChronicleReadModels; @cratis/arc.chronicle/testing for ChronicleCommandScenario and ChronicleKernelScenario @cratis/arc.core, @cratis/arc.testing, @cratis/chronicle ^6.29.0 (peer-floor exports checked against 6.29.0), @cratis/fundamentals, zod
@cratis/platform Source/Cratis Composition, the counterpart of the C# Cratis package: CratisApplication.createBuilder, builder.addCratis; re-exports Arc, Chronicle and testing (./testing); no implicit authentication handler Arc core, Arc Chronicle, Arc testing, Chronicle SDK, Fundamentals, zod

@cratis/platform is published to npm. Unlike C# AddCratis, the TS composition does not install Microsoft identity automatically: for protected routes, explicitly choose an authentication handler (such as microsoftIdentityPlatform()) or your own trusted host principal; public routes need neither. It composes the client, not the event-store engine. See The Cratis package.

Package Folder Exports
@cratis/arc.proxygenerator Source/Tools/ProxyGenerator The arc-proxygenerator CLI, analyzeSource, renderSource, generateFromSource, renderGeneratedMetadata, and the manifest path’s renderClientManifest and generateClient
@cratis/eslint-plugin-arc-core Source/CodeAnalysis ESLint 10 rules and the recommended and recommended-type-checked presets; peers eslint ^10.0.0 and @typescript-eslint/parser ^8.70.0

Core, adapter, MongoDB, and Drizzle package manifests declare Node.js 22 or later. Building the workspace needs Node.js 22.19 or later, because it installs the Chronicle SDK; Node.js 24 LTS is recommended.

The workspace pins @cratis/arc and @cratis/arc.react to 22.45.0, @cratis/components to 4.23.0, and @cratis/fundamentals to 7.22.0 (peer range ^7.19.6). Chronicle development and sample dependencies use 6.49.0; the Chronicle peer floor remains ^6.29.0.

@cratis/arc, @cratis/arc.react, and @cratis/arc.react.mvvm are Arc’s existing TypeScript client packages, built and published from the Arc repository. This repository does not replace, rename, or republish them. They are the compatibility target for this server’s wire behavior, and generated proxies import them in your frontend. The server packages never depend on them.