# 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](/foundation/0.19.0/guides/first-api/). A console/cache integration
can start with [the independent consumer](/foundation/0.19.0/guides/getting-started/). 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](/foundation/0.19.0/guides/authentication-paths/) |
| Google/Apple/Microsoft sign-in | `Fabricators.Authentication.OpenIdConnect` | [BFF and OIDC](/foundation/0.19.0/guides/bff-authentication/) |
| Protected persisted secrets | `Fabricators.Security.DataProtection`, `Fabricators.Security.DataProtection.EntityFrameworkCore` | [Key ring and runtime secrets](/foundation/0.19.0/guides/secret-protection/) |
| Cache without EF | `Fabricators.Caching.FusionCache` | [Scope and invalidation](/foundation/0.19.0/guides/caching/) |
| Structured logs and OTLP | `Fabricators.Observability` | [Observability](/foundation/0.19.0/guides/observability/) |
| HTTP/EF timing | `Fabricators.Observability.AspNetCore`, `Fabricators.Observability.EntityFrameworkCore` | [Disclosure authorization](/foundation/0.19.0/guides/authorization/) |
| OpenAPI and Scalar | `Fabricators.OpenApi` | [First API](/foundation/0.19.0/guides/first-api/) |
| Realtime transport | `Fabricators.Realtime.SignalR` | [Reference](/foundation/0.19.0/reference/fabricators-realtime-signalr/) |
| Cron calculation | `Fabricators.Scheduling.Cronos` | [Background work](/foundation/0.19.0/guides/background-work/) |
| Connection dispatch and SMTP/Graph sending | `Fabricators.Mailing`, `Fabricators.Mailing.MailKit`, `Fabricators.Mailing.MicrosoftGraph` | [Outgoing mail](/foundation/0.19.0/guides/mail-setup/) |
| Reviewed JSON-data templates | `Fabricators.Templating.Scriban` | [Mail composition](/foundation/0.19.0/guides/connected-mail/) |
| Validators and handler decorators | `Fabricators.Validation` | [Authoring](/foundation/0.19.0/guides/authoring/) |
| Progressive application MCP | `Fabricators.Mcp.Contracts`, `Fabricators.Mcp`, `Fabricators.Mcp.AspNetCore` | [MCP boundaries](/foundation/0.19.0/guides/mcp/) |
| Developer documentation MCP | `Fabricators.DeveloperMcp` tool | [MCP setup](/foundation/0.19.0/guides/mcp/) |
| Source conventions | `Fabricators.Authoring`, `Fabricators.Authoring.Tool` | [Checks for contributors](/foundation/0.19.0/guides/authoring/) |
| Documentation export | `Fabricators.Documentation`, `Fabricators.Documentation.Tool` | [Content contract](/foundation/0.19.0/guides/documentation/) |

Consult the
[compiled reference](/foundation/0.19.0/reference/api-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](/foundation/0.19.0/guides/troubleshooting/#upgrading-a-consumer) covers the
verification sequence; the API reference and guides use the selected release.
