# CSVJetty documentation

> Official developer documentation for the `csvjetty` React package and CSVJetty import workflow.

Use these Markdown files as the authoritative implementation context for CSVJetty. For generated code, prefer the framework-specific guide plus the exact component and payload reference. HTML equivalents use the same path without `.md` (the overview HTML page is `/docs`).

## Get started

- [Overview](https://www.csvjetty.com/docs/index.md): Start here for installation, the minimal React integration, delivery choices, and the CSVJetty workflow.
- [React](https://www.csvjetty.com/docs/react.md): Install and integrate CSVJetty in React, handle onData, and persist imported records.
- [Next.js](https://www.csvjetty.com/docs/nextjs.md): Use CSVJetty with Next.js App Router or Pages Router and save data through a server API.

## Concepts

- [How CSVJetty works](https://www.csvjetty.com/docs/concepts/how-it-works.md): Mental model for parsing, mapping, validation, correction, delivery, and application responsibilities.
- [Importers](https://www.csvjetty.com/docs/concepts/importers.md): Importer configuration, importer keys, reuse, and runtime overrides.
- [Column mapping](https://www.csvjetty.com/docs/concepts/column-mapping.md): How uploaded headers match configured destination fields, aliases, manual mapping, and unmatched data.
- [Validation and corrections](https://www.csvjetty.com/docs/concepts/validation.md): Built-in validation, user corrections, invalid-row behavior, and server-side validation boundaries.
- [Delivery modes](https://www.csvjetty.com/docs/concepts/delivery-modes.md): Compare browser callback delivery with signed server-to-server webhooks.

## Configure and receive data

- [Columns](https://www.csvjetty.com/docs/columns.md): Column schema, field types, aliases, examples, options, regex patterns, and custom validators.
- [Importer settings](https://www.csvjetty.com/docs/settings.md): Delivery, development mode, validation behavior, unmatched columns, presentation, language, and encoding.
- [Callbacks](https://www.csvjetty.com/docs/callbacks.md): onData delivery, saving batches, row-level errors, payload shape, and completion events.
- [Webhooks](https://www.csvjetty.com/docs/webhooks.md): Webhook configuration, signed requests, verification, responses, retries, and idempotency.

## Reference

- [Reference overview](https://www.csvjetty.com/docs/reference.md): Entry point for exact component, payload, and limit references.
- [Component props](https://www.csvjetty.com/docs/reference/component.md): Exact React component props and runtime overrides.
- [Import payload](https://www.csvjetty.com/docs/reference/import-payload.md): Exact callback/webhook payload fields and callback error response shape.
- [Limits and requirements](https://www.csvjetty.com/docs/reference/limits.md): File, column, plan, React, and webhook constraints.