zsa

zsa is a library for building typesafe server actions in Next.js. It provides a simple, scalable developer experience with features like validated inputs/outputs, procedures (middleware) for passing context to server actions, and React Query integration for querying server actions in client components.

Installation

Install zsa using your preferred package manager:

npm i zsa zsa-react zsa-react-query zsa-openapi zod

Features

• Validated inputs and outputs using Zod schemas
• Procedures for adding context and authorization to server actions
• Callbacks for running additional logic based on server action lifecycle
• Built-in loading states and error handling
• React Query integration for querying server actions on the client side
• Support for FormData as input type
• Retry functionality and timeouts for server actions
• TypeScript support for a fully typesafe experience

Documentation

View the full documentation and examples on zsa.vercel.app.

Support

If you need help with anything, feel free to DM (@ido_pesok) on X.

Disclaimer

This is a personal project and is not associated with any company or organization. While I strive to make this project as reliable and useful as possible, it is provided "as is" without any guarantees or warranties.

Use at your own risk. You are responsible for reviewing, testing, and validating the code to ensure it meets your requirements and for any consequences that may arise from its use.

I will do my best to maintain and improve this project, but please understand that as a personal project, support and updates may be limited.

Contributors