# Build a product with foundation

Start from your goal and understand the ownership boundaries.

foundation provides reusable .NET building blocks for product backends. Choose
the capabilities your host needs, retain ownership of your domain and deployment,
and upgrade through explicit NuGet versions. It does not install an ERP or own
your customer directory, tenant membership, database migrations or frontend.

## Choose your path

- First integration: [create a working API](/foundation/0.19.0/guides/first-api/).
- Package access: [configure NuGet and run a cache consumer](/foundation/0.19.0/guides/getting-started/).
- Identity: [choose browser, native or machine authentication](/foundation/0.19.0/guides/authentication-paths/).
- Outgoing email: [configure SMTP or Graph](/foundation/0.19.0/guides/mail-setup/).
- Product architect: [choose package boundaries](/foundation/0.19.0/guides/packages/).
- API author: [secure browser and machine requests](/foundation/0.19.0/guides/request-security/).
- Operator: [configure logs and request measurements](/foundation/0.19.0/guides/observability/).
- App developer: [use the authoring contract](/foundation/0.19.0/guides/authoring/).
- Documentation frontend author: [consume the content bundle](/foundation/0.19.0/guides/documentation/).

## Release and scope

This bundle describes **0.19.0**. It adds native OIDC token exchange and explicit
BFF transport, request-zone JSON output and presentation controls to the existing
host, authentication, mail, persistence, observability and integration adapters.
Consumers retain their explicitly selected release line. The exported version
must match compiled assemblies; select an explicit package version from the feed.
Page status distinguishes released capabilities from future integrations.

Strong authentication supplies backend integrations, while client bridges and
physical-device acceptance remain product-owned. [Read its boundaries](/foundation/0.19.0/guides/strong-authentication/)
before exposing any method in a product.

## What you get

The dependency-free Kernel contains results, errors and identity primitives.
Application defines provider-neutral ports. Optional adapters implement cache,
diagnostics, mail, templates, schedules, validation, realtime and MCP. The host
selects adapters explicitly; installing a package does not configure middleware,
credentials, persistence, access policies or remote services.

Start with a working integration, then follow the corresponding concept and API
reference. Generated signatures supplement authored guides; missing API summaries
are reported instead of guessed.

## Follow a complete integration path

For a browser product, continue from the first API through
[authentication selection](/foundation/0.19.0/guides/authentication-paths/), [the BFF](/foundation/0.19.0/guides/bff-authentication/),
[local sessions](/foundation/0.19.0/guides/mobile-authentication/) and [presentation](/foundation/0.19.0/guides/presentation-localization/).
For a worker, start with [mail setup](/foundation/0.19.0/guides/mail-setup/), [protected secrets](/foundation/0.19.0/guides/secret-protection/)
and [durable execution](/foundation/0.19.0/guides/background-work/). For modular applications, review
[persistence composition](/foundation/0.19.0/guides/module-persistence/) before adding shared mappings.

The [reference introduction](/foundation/0.19.0/reference/api-reference/) connects these tasks to the exact
package contracts. Use [troubleshooting](/foundation/0.19.0/guides/troubleshooting/) at the failing boundary.
