> [Agent navigation index](/llms.txt)

# Server foundations

Define and assemble Brix's server boundary, connect caching, and prepare the generated application for deployment.

## Define and assemble the server

```ts
// src/brix.server.ts
"use server";

import { defineBrixServer } from "brix/server";
import { brix } from "./brix.ts";

export const brixServer = defineBrixServer(brix);
export const { createApiRoute, createFragment, createMarkdownIndexRoute, createPageRoute } =
  brixServer;

```

```ts
// src/app.ts
import { createBrixApp } from "brix/server";
import { brixServer } from "./brix.server.ts";

export const app = createBrixApp(brixServer);

```

`createBrixApp` owns Hono construction, security and observability middleware, request IDs, assets, rendering, and safe errors. The generated production entry mounts discovered routes. Do not manually register conventional route modules.

`defineBrixServer` accepts application integrations including authentication, data cache, named edge cache policies, app state, global middleware, assets, renderer options, errors, security, service metadata, observability, locale resolution, translations, and Contentful preview.

## Declare caching, do not implement it in routes

```ts
export const brixServer = defineBrixServer(brix, {
  cachePolicies: ["publicPage", "sharedChrome"] as const,
  dataCache: { namespace: "booking-production", store },
});

```

`dataCache` owns native GET reuse. Named `cachePolicies` are only edge hints selected by pages and fragments. Omitted route policies are uncached, and Brix never stores edge responses. See [caching](/docs/caching) and [fragments](/docs/fragments).

Translated responses must partition by visible locale. Localized paths are safe automatically; host-selected locale requires `localePartition: "host"`; cookie/header selection fails closed to uncached. See [translations](/docs/translations).

## Deployment

For Lambda, configure `defineBrixConfig({ platform: "aws" })`. `brix build` emits the complete generated handler in `dist/app.mjs`; do not create a second source Lambda entry around `src/app.ts`.

Brix exposes supported Hono facades under `brix/hono` and related subpaths. Do not add another Hono dependency. Verify server changes with `brix doctor`, `brix inspect routes`, focused tests, and `brix build`. See [API routes](/docs/api-routes), [environment](/docs/environment), and [testing](/docs/testing).