# hulla.dev documentation

> Official documentation for the @hulla/* TypeScript package ecosystem.

Use the focused Markdown pages below for retrieval. Use the full corpus only when a tool needs all documentation in one context.

## Complete documentation

- [Full documentation corpus](https://hulla.dev/llms-full.txt): Every documentation page combined into one Markdown document
- [Documentation home](https://hulla.dev/docs.md): Package-level documentation index

## Start here

- [@hulla/api](https://hulla.dev/docs/api.md): Declare an HTTP contract once, then bind typed clients and exhaustive server implementations to the transports and frameworks your application already uses.
- [Installation](https://hulla.dev/docs/api/installation.md): Install the 2.0 core, one Standard Schema validator, and only the transport or host packages your deployment needs.
- [Quick start](https://hulla.dev/docs/api/quick-start.md): Declare one route, implement it exhaustively, and call it through a typed in-process client before adding framework or network concerns.
- [Mental model](https://hulla.dev/docs/api/mental-model.md): Separate declarations, implementations, adapters, clients, and transports so each runtime owns only the work it can perform correctly.
- [Migration guide](https://hulla.dev/docs/api/start/migration.md): Move from procedure and builder APIs to contract selections, direct clients, exhaustive servers, and explicit transports.

## Core API

- [Contracts](https://hulla.dev/docs/api/core/contracts.md): Declare paths, request representations, response statuses, and shared schemas without server implementation code.
- [Server implementations](https://hulla.dev/docs/api/core/servers.md): Implement a contract exhaustively, scope middleware and context, then expose a complete server or deployable fragment.
- [Typed clients](https://hulla.dev/docs/api/core/clients.md): Create a contract-shaped client, choose a transport, narrow declared responses, and add request middleware.
- [Request representations](https://hulla.dev/docs/api/core/request-transport.md): Understand how parameters, query values, headers, bodies, and native JSON cross a transport boundary.
- [Values across boundaries](https://hulla.dev/docs/api/core/value-round-trips.md): Choose native JSON, one-way schemas, transforms, or codecs based on the value each side should receive.
- [Errors](https://hulla.dev/docs/api/core/errors.md): Model declared application failures separately from validation, transport, implementation, and runtime failures.

## Transports

- [Fetch](https://hulla.dev/docs/api/transports/fetch.md): Use Web-standard Request, Response, Headers, AbortSignal, and fetch as either a client transport or server adapter.
- [In-process](https://hulla.dev/docs/api/transports/in-process.md): Call a completed server implementation without a URL match or network hop while preserving the contract lifecycle.
- [MessagePort](https://hulla.dev/docs/api/transports/message-port.md): Run the same contract across workers, Electron, or another ordered IPC endpoint with cancellation and streaming.
- [WebSocket](https://hulla.dev/docs/api/transports/websocket.md): Carry contract calls and response streams over a WebSocket while preserving typed responses and cancellation.
- [Desktop bridges](https://hulla.dev/docs/api/transports/desktop-bridges.md): Connect MessagePort semantics to Electron, Tauri, Dioxus, or a JSON-only desktop bridge.

## Server frameworks

- [Node.js HTTP](https://hulla.dev/docs/api/servers/node-http.md): Mount a contract on the native Node HTTP server with streaming backpressure and native request context.
- [Express](https://hulla.dev/docs/api/servers/express.md): Register compiled contract routes in Express while retaining Express request and response context.
- [Fastify](https://hulla.dev/docs/api/servers/fastify.md): Register native Fastify routes with typed request, reply, hooks, and plugin encapsulation.
- [Hono](https://hulla.dev/docs/api/servers/hono.md): Mount native Hono routes and make bindings, variables, and context available to server handlers.
- [H3](https://hulla.dev/docs/api/servers/h3.md): Mount native H3 routes with event context and middleware across H3-supported runtimes.
- [Elysia](https://hulla.dev/docs/api/servers/elysia.md): Register native Elysia routes while preserving lifecycle state, decorators, and stores.
- [Koa](https://hulla.dev/docs/api/servers/koa.md): Mount an exhaustive implementation as Koa middleware with native context and streaming responses.
- [NestJS](https://hulla.dev/docs/api/servers/nestjs.md): Integrate a contract with Nest controllers, dependency injection, and either Express or Fastify platforms.

## Full-stack frameworks

- [Hybrid rendering](https://hulla.dev/docs/api/full-stack/hybrid-rendering.md): Keep server-only implementations out of browser bundles while choosing zero-hop or Fetch clients per render boundary.
- [Next.js](https://hulla.dev/docs/api/full-stack/next.md): Use App Router handlers, server-side clients, Data Cache policies, Server Actions, and browser Fetch clients.
- [TanStack Start](https://hulla.dev/docs/api/full-stack/tanstack-start.md): Mount contract-backed server routes and call them through loaders, server functions, or browser clients.
- [React Router](https://hulla.dev/docs/api/full-stack/react-router.md): Serve a contract through Framework Mode resource routes and consume it from loaders and actions.
- [SolidStart](https://hulla.dev/docs/api/full-stack/solid-start.md): Mount a catch-all API route and consume the same contract through server queries or browser Fetch.
- [SvelteKit](https://hulla.dev/docs/api/full-stack/sveltekit.md): Use catch-all endpoints, enhanced Fetch, or zero-hop remote functions with native RequestEvent context.
- [Nuxt](https://hulla.dev/docs/api/full-stack/nuxt.md): Mount a Nitro route and build a request-aware client for useAsyncData, events, and server handlers.
- [Astro](https://hulla.dev/docs/api/full-stack/astro.md): Serve a contract from an Astro endpoint and choose in-process or Fetch calls for components and islands.

## Serverless & runtimes

- [Cloudflare](https://hulla.dev/docs/api/runtimes/cloudflare.md): Deploy to Module Workers or Pages Functions with native bindings, execution context, and asset fallback.
- [AWS Lambda](https://hulla.dev/docs/api/runtimes/aws-lambda.md): Serve a contract through API Gateway HTTP API v2 or a Lambda Function URL.
- [Azure Functions](https://hulla.dev/docs/api/runtimes/azure-functions.md): Register an Azure Functions v4 HTTP trigger while preserving invocation context and native response values.
- [Google Cloud Run functions](https://hulla.dev/docs/api/runtimes/google-cloud-functions.md): Register a Functions Framework HTTP function with native context and streaming response support.
- [Netlify Functions](https://hulla.dev/docs/api/runtimes/netlify-functions.md): Expose a contract as a Web-native Netlify Function with platform context and deployment configuration.
- [Bun, Deno & Vercel](https://hulla.dev/docs/api/runtimes/runtime-hosts.md): Choose the Fetch or Node boundary that fits Bun, Deno, and Vercel runtime deployments.

## Integrations

- [TanStack Query & SWR](https://hulla.dev/docs/api/integrations/query-libraries.md): Derive cache keys and executable query or mutation options from an existing typed client.
- [OpenAPI](https://hulla.dev/docs/api/integrations/openapi.md): Export contracts to OpenAPI or generate a runtime contract and typed documentation sidecar from an existing document.

## Architecture & exports

- [Architecture](https://hulla.dev/docs/api/reference/architecture.md): Trace a contract from declaration through client transport, server execution, and response decoding.
- [Adapter behavior](https://hulla.dev/docs/api/reference/adapter-conformance.md): Compare routing, parsing, streaming, context, and lifecycle ownership across every supported host adapter.
- [Package exports](https://hulla.dev/docs/api/reference/exports.md): Find the public core entrypoints and integration packages without importing server or host code into the wrong runtime.

## hulla CLI

- [hulla CLI](https://hulla.dev/docs/cli.md): Generate, synchronize, and maintain source-owned integrations across the @hulla/* package ecosystem.

## @hulla/ui

- [Components & styling](https://hulla.dev/docs/ui.md): Composable components for Astro, React, and Solid, with shared design tokens and source you own.