How does this skill synchronize frontend and backend types?

The skill provides templates for shared TypeScript interfaces and supports generating frontend types directly from backend Swagger/OpenAPI specifications using tools like openapi-typescript.

Can this skill help with API documentation?

Yes, it automatically includes NestJS Swagger decorators (@ApiProperty) in generated DTOs, ensuring your API documentation is always up-to-date with your code.

Which validation libraries does the API Contracts Generator use?

It leverages class-validator for backend NestJS DTOs and Zod for frontend Next.js schemas to ensure that validation rules remain identical across the entire stack.

Does it support standardized pagination?

Yes, it includes a standardized Pagination DTO set (Query, Meta, and Response) to maintain a consistent data fetching pattern across all list-based endpoints.

API Contracts Generator

Name: API Contracts Generator
Author: RomualdP

byRomualdP

0•

API Development

Synchronizes API contracts between Next.js and NestJS to ensure type safety and consistent validation across the full stack.

The API Contracts Generator skill bridges the gap between frontend and backend development by enforcing a unified communication standard. It automates the creation of NestJS DTOs, synchronized TypeScript interfaces, and matching Zod validation schemas for Next.js. By standardizing request/response structures, error handling, and pagination, it eliminates common integration bugs like type mismatches or divergent validation rules, ensuring your Swagger documentation and frontend actions stay perfectly in sync with your backend implementation.

Key Features

01Implements consistent validation logic using class-validator (Backend) and Zod (Frontend)

02Provides pre-built templates for standardized pagination and uniform error formatting

03Generates standardized NestJS Request and Response DTOs with Swagger integration

040 GitHub stars

05Automates the creation of type-safe Next.js Server Actions linked to backend handlers

06Synchronizes frontend TypeScript types with backend structures to prevent integration errors

Use Cases

01Refactoring existing API endpoints to include robust validation and auto-generated documentation

02Standardizing communication patterns and error handling in a monorepo environment

03Building new full-stack features that require synchronized data structures between Next.js and NestJS

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add romualdp/hoki api-contracts

For use in Claude.ai and ChatGPT

Download Skill