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.
Install zsa
using your preferred package manager:
npm i zsa zsa-react zsa-react-query zsa-openapi zod
- 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
View the full documentation and examples on zsa.vercel.app. The documentation includes:
- Getting started guide
- In-depth explanations of core concepts
- Examples for building fully typesafe server actions
If you're looking to learn how to get the most out of zsa
, the documentation is the best place to start.
We welcome contributions from the community! If you have an idea for a new feature, a bug fix, or any other improvement, please open an issue or submit a pull request, but be sure to read the contributing guidelines first.
If you encounter any issues or have questions, feel free to reach out via:
- Discussions: Visit the Github discussions page to ask questions, share ideas, or discuss anything related to
zsa
. - Direct support: For direct inquiries, you can DM (@ido_pesok).
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.
Here's a shoutout to all the amazing contributors who are helping to make zsa
better. Thank you for your hard work and dedication!
Made with contrib.rocks.