codegen

Regenerate TypeScript models and API services from backend API definitions.

6|1|Updated Dec 13, 2017
One-click install
npx skills add https://github.com/esassoc/neptune --skill codegen-esassoc
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: codegen
Source: https://github.com/esassoc/neptune/tree/main/.claude/skills/codegen
Command: npx skills add https://github.com/esassoc/neptune --skill codegen-esassoc

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures your frontend code accurately reflects the latest backend API structure, preventing integration issues and saving development time.

Core Features & Use Cases

  • Automatic Model Regeneration: Updates TypeScript models based on backend API definitions.
  • API Service Sync: Regenerates API service clients to match new or modified endpoints.
  • Use Case: After a backend developer adds a new endpoint for user profiles, running this Skill updates the frontend's generated code so that the frontend application can immediately start using the new endpoint.

Quick Start

Run the full code generation pipeline to sync the Angular frontend with backend API changes.

Frequently Asked Questions about codegen

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync TypeScript frontend models with backend API changes?β–Ό

To sync TypeScript frontend models with backend API changes, this Skill regenerates TypeScript models and API service clients from backend API definitions. It ensures your frontend accurately reflects the latest backend API structure.

What do I need to generate TypeScript models from swagger.json?β–Ό

Generating TypeScript models from swagger.json requires a .NET build in Debug configuration to generate the swagger.json file. You also need npm installed to execute the model generation script and sync the Angular frontend.

When should I run API service sync for my Angular frontend?β–Ό

You should run API service sync after any backend API modification, including endpoint, DTO, route, or controller changes. This regenerates API service clients so your frontend application can immediately use the updated endpoints.

Does codegen work with backend API definitions from .NET?β–Ό

Yes, this codegen Skill works with .NET backend API definitions. It requires a .NET build in Debug configuration to produce the swagger.json file, which is then used to regenerate TypeScript models and API services for the frontend.

Why does my TypeScript codegen not working after backend updates?β–Ό

TypeScript codegen may not work if the .NET backend was not built in Debug configuration to generate swagger.json, or if npm failed to execute the model generation script. Ensure both prerequisites run successfully to sync frontend code.