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.