# Docs

- [Introduction](/docs/introduction): Type-safe, validated Server Actions for Next.js.
- [Quick start](/docs/quick-start): Get up and running with next-safe-action in 5 minutes.
- Concepts
  - [How it works](/docs/concepts/how-it-works): Understand the action lifecycle, middleware pipeline, and entry points.
  - [Action client](/docs/concepts/action-client): Learn how to create and configure the safe action client.
  - [Input validation](/docs/concepts/input-validation): Standard Schema validation, error shapes, and type inference.
  - [Action result](/docs/concepts/action-result): Understand the structure and types of action execution results.
  - [Error handling](/docs/concepts/error-handling): A unified guide to validation errors, server errors, and framework errors.
- Guides
  - [Middleware](/docs/guides/middleware): Add logging, authentication, and context to your actions with middleware.
  - [Executing actions](/docs/guides/executing-actions): Choose the right execution method for your use case.
  - [Hooks](/docs/guides/hooks): Use useAction to execute actions from client components with full lifecycle control.
  - [Form actions](/docs/guides/form-actions): Use next-safe-action with HTML forms for progressive enhancement.
  - [Optimistic updates](/docs/guides/optimistic-updates): Update the UI instantly while the server processes your action.
- Advanced
  - [Output validation](/docs/advanced/output-validation): Validate action return values with outputSchema() for end-to-end type safety.
  - [Bind arguments](/docs/advanced/bind-arguments): Pass additional validated arguments to your actions using bindArgsSchemas().
  - [Extend schemas](/docs/advanced/extend-schemas): Build on previous input schemas to create action templates.
  - [Metadata](/docs/advanced/metadata): Attach type-checked metadata to actions for logging, permissions, and more.
  - [Custom validation errors](/docs/advanced/custom-validation-errors): Customize validation error shapes, formatting, and manual error returns.
  - [Standalone middleware](/docs/advanced/standalone-middleware): Create reusable middleware with createMiddleware() for sharing across clients.
  - [Framework navigation/errors](/docs/advanced/framework-errors): Handle redirect, notFound, unauthorized, and forbidden in your actions.
  - [Internationalization (i18n)](/docs/advanced/i18n): Use async schema functions to integrate next-safe-action with i18n solutions.
  - [File uploads](/docs/advanced/file-uploads): Upload files using next-safe-action with FormData and zod-form-data.
- Integrations
  - [React Hook Form](/docs/integrations/react-hook-form): Learn how to integrate next-safe-action with React Hook Form.
  - [TanStack Query](/docs/integrations/tanstack-query): Learn how to integrate next-safe-action with TanStack Query's useMutation.
  - [Better Auth](/docs/integrations/better-auth): Learn how to integrate next-safe-action with Better Auth for type-safe authentication in your server actions.
  - [Standard Schema](/docs/integrations/standard-schema): Use Zod, Valibot, ArkType, or any Standard Schema library with next-safe-action.
- [AI skills](/docs/ai-skills): Install next-safe-action skills for AI coding agents like Claude Code, Cursor, Codex, and more.
- API reference
  - [createSafeActionClient()](/docs/api/create-safe-action-client): API reference for the createSafeActionClient() function.
  - [SafeActionClient](/docs/api/safe-action-client): API reference for all chainable methods and action callbacks.
  - [createMiddleware()](/docs/api/create-middleware): API reference for the createMiddleware() function.
  - [createValidatedMiddleware()](/docs/api/create-validated-middleware): API reference for the createValidatedMiddleware() function.
  - [Validation utilities](/docs/api/validation-utilities): API reference for validation error utility functions and constants.
  - [Error classes](/docs/api/error-classes): API reference for all exported error classes.
  - [Hooks API](/docs/api/hooks-api): API reference for useAction, useOptimisticAction, and useStateAction hooks.
  - [Type utilities](/docs/api/type-utilities): API reference for type inference utilities.
  - [Types](/docs/api/types): Comprehensive reference for all exported TypeScript types.
- [Troubleshooting](/docs/troubleshooting): Troubleshoot common issues with next-safe-action.
- Migrations
  - [Migration from v3 to v4](/docs/migrations/v3-to-v4): Learn how to migrate from next-safe-action version 3 to version 4.
  - [Migration from v4 to v5](/docs/migrations/v4-to-v5): Learn how to migrate from next-safe-action version 4 to version 5.
  - [Migration from v5 to v6](/docs/migrations/v5-to-v6): Learn how to migrate from next-safe-action version 5 to version 6.
  - [Migration from v6 to v7](/docs/migrations/v6-to-v7): Learn how to migrate from next-safe-action version 6 to version 7.
  - [Migration from v7 to v8](/docs/migrations/v7-to-v8): Learn how to migrate from next-safe-action version 7 to version 8.
- [Playground](https://playground.next-safe-action.dev)
- [Contributing](/docs/contributing): Learn how to contribute to next-safe-action via GitHub.