# Astro Utils

> Server-first forms, validation, state, request context, and Express-style endpoints for Astro.

Use the Markdown links below; no browser or JavaScript is needed. Examples include filenames and setup code. Browser previews simulate server behavior. Consult the API reference for exact imports and limitations.

## Build a feature

- [Agent getting started](https://withastro-utils.github.io/docs/agents/getting-started.md): Complete setup, product filter, collection search, and verification steps.

## Start

- [Examples](https://withastro-utils.github.io/docs/examples/index.md): Explore complete Astro Utils source with interactive previews for accounts, tasks, settings, uploads, and service requests.
- [Server-first forms for Astro](https://withastro-utils.github.io/docs/index.md): Build Astro forms with server-side validation, data binding, state, and server actions. Explore examples, request context, and Express-style endpoints.

## Guides

- [Context quickstart](https://withastro-utils.github.io/docs/guides/context/index.md): Share a value between a layout and a nested component.
- [Express Endpoints quickstart](https://withastro-utils.github.io/docs/guides/express-endpoints/index.md): Create and call an Astro API route with Express-style request and response helpers.
- [Binding & Validation](https://withastro-utils.github.io/docs/guides/forms/data-binding/index.md): Using data binding with Astro Forms
- [Getting Started](https://withastro-utils.github.io/docs/guides/forms/getting-started/index.md): Install Astro Utils Forms and run a complete server action without an external service.
- [Server Helpers](https://withastro-utils.github.io/docs/guides/forms/js-helpers/index.md): Redirect after a form action, refresh a parent form, and update the browser.
- [Loops & Reusable Components](https://withastro-utils.github.io/docs/guides/forms/loops-and-components/index.md): Keep each repeated form attached to the right item when a list changes.

## API reference

- [Context API](https://withastro-utils.github.io/docs/reference/context/index.md): Context component, getContext, and asyncContext contracts for Astro Utils Context.
- [Request API](https://withastro-utils.github.io/docs/reference/express/request/index.md): Parsed values and content-negotiation helpers available on ExpressRequest.
- [Response API](https://withastro-utils.github.io/docs/reference/express/response/index.md): Status, headers, bodies, redirects, files, cookies, and streaming with ExpressResponse.
- [Router and errors](https://withastro-utils.github.io/docs/reference/express/router-and-errors/index.md): ExpressRoute middleware, body parsing, validation, route creation, and error classes.
- [Advanced responses](https://withastro-utils.github.io/docs/reference/forms/advanced-responses/index.md): Return a custom response from a nested Forms operation.
- [Basic Form Components](https://withastro-utils.github.io/docs/reference/forms/basic-form-components/index.md): Bound inputs, select controls, buttons, and validation feedback.
- [Forms configuration](https://withastro-utils.github.io/docs/reference/forms/configuration/index.md): Middleware settings for sessions, large uploads, secrets, and logging.
- [Data binding API](https://withastro-utils.github.io/docs/reference/forms/data-binding/index.md): Bind defaults, persisted state, validation results, and lifecycle hooks.
- [Client-side events & triggers](https://withastro-utils.github.io/docs/reference/forms/events-and-triggers/index.md): Observe submission and choose which bound button handles a browser event.
- [Forms imports](https://withastro-utils.github.io/docs/reference/forms/index.md): Choose the right Astro Utils Forms entrypoint for middleware, components, and Astro configuration.
- [Session](https://withastro-utils.github.io/docs/reference/forms/session/index.md): Configure a signed session cookie and share small values between Forms pages.
- [Large file upload API](https://withastro-utils.github.io/docs/reference/forms/upload-big-file/index.md): Configure chunked uploads, match progress controls, and handle failures.

## Examples

- [Submit a service request](https://withastro-utils.github.io/docs/examples/government-form/index.md): Grouped fields, draft saving, and final validation.
- [Log in with feedback](https://withastro-utils.github.io/docs/examples/login/index.md): Success, error feedback, and session updates.
- [Filter a product catalog](https://withastro-utils.github.io/docs/examples/products/index.md): Bound input, server-side filtering, and updated results in one Astro component.
- [Edit profile settings](https://withastro-utils.github.io/docs/examples/settings/index.md): Text, select, and textarea fields in one form.
- [Create an account](https://withastro-utils.github.io/docs/examples/signup/index.md): Account fields and valid-only actions.
- [Manage a task list](https://withastro-utils.github.io/docs/examples/todo/index.md): Adding and removing repeated items.
- [Upload a large file](https://withastro-utils.github.io/docs/examples/upload/index.md): Chunked transfer, progress, and completion feedback.

## Optional

- [Complete documentation](https://withastro-utils.github.io/docs/llms-full.txt): All guides, API references, and expanded examples in one download.