Skip to content
fabricators docs
On this page

Choose packages by responsibility

Select provider-neutral ports and optional host adapters.

Use the smallest dependency surface needed by each layer. The current family is 0.19.0; pin an explicit release and keep its packages aligned. Installing an adapter does not configure middleware, credentials, data, jobs or access policy.

Start with the code's role

Layer Package Boundary
Domain/shared values Fabricators.Kernel Results/errors and identity primitives; no DI, EF or ASP.NET dependency
Use cases/contracts Fabricators.Application CQRS and provider-neutral ports; product orchestration remains yours
HTTP host Fabricators.Kernel.AspNetCore Explicit HTTP/session-adjacent security bindings, endpoints, module composition and presentation
Relational integration Fabricators.Infrastructure EF repositories/model contributions/factories and existing compatibility adapters

For a first host, use the API tutorial. A console/cache integration can start with the independent consumer. Add an EF provider only in the integration layer that actually needs it.

Add a capability

Capability Package(s) Integration path
Strong authentication and local sessions Fabricators.Authentication, Fabricators.Authentication.AspNetCore, Fabricators.Authentication.EntityFrameworkCore Choose authentication
Google/Apple/Microsoft sign-in Fabricators.Authentication.OpenIdConnect BFF and OIDC
Protected persisted secrets Fabricators.Security.DataProtection, Fabricators.Security.DataProtection.EntityFrameworkCore Key ring and runtime secrets
Cache without EF Fabricators.Caching.FusionCache Scope and invalidation
Structured logs and OTLP Fabricators.Observability Observability
HTTP/EF timing Fabricators.Observability.AspNetCore, Fabricators.Observability.EntityFrameworkCore Disclosure authorization
OpenAPI and Scalar Fabricators.OpenApi First API
Realtime transport Fabricators.Realtime.SignalR Reference
Cron calculation Fabricators.Scheduling.Cronos Background work
Connection dispatch and SMTP/Graph sending Fabricators.Mailing, Fabricators.Mailing.MailKit, Fabricators.Mailing.MicrosoftGraph Outgoing mail
Reviewed JSON-data templates Fabricators.Templating.Scriban Mail composition
Validators and handler decorators Fabricators.Validation Authoring
Progressive application MCP Fabricators.Mcp.Contracts, Fabricators.Mcp, Fabricators.Mcp.AspNetCore MCP boundaries
Developer documentation MCP Fabricators.DeveloperMcp tool MCP setup
Source conventions Fabricators.Authoring, Fabricators.Authoring.Tool Checks for contributors
Documentation export Fabricators.Documentation, Fabricators.Documentation.Tool Content contract

Consult the compiled reference for exact public contracts.

Keep product ownership visible

Foundation does not own your customer directory, Company/Party model, accounting, licenses, tenant provisioning or business recurrence. User registration, linking, mail OAuth storage/refresh, outbox orchestration and effective tenant permissions remain product integrations behind explicit ports.

Incoming Graph/IMAP reader contracts do not include a polling/webhook engine. Cron calculation does not include durable scheduling. Generic confirmation DTOs do not enforce a destructive action. These are deliberate boundaries, not services enabled merely by adding a package.

Upgrade deliberately

Read the changelog, update central versions/lockfiles and run your consumer's build, real-provider/database tests and runtime acceptance checks. Do not rewrite applied migrations or assume unchanged app bytes/receipts after a dependency upgrade. Troubleshooting covers the verification sequence; the API reference and guides use the selected release.

↑ ↓ to move↵ to openSearching fabricators .NET foundation v0.19.0