create-service

Scaffolding a TypeScript service creates a structured directory under src/services with separate api/, actions/, and service-specific folders for index and types files. This skill automates that layout following the Valra.gg convention.

The standard Valra.gg service structure organizes files into src/services/api/{service}/index.ts, src/services/actions/{service}/index.ts, and src/services/{service}/index.ts with a dedicated types.ts file for request and response definitions.

You do not need to manually define types, as the service scaffolding process automatically generates a types.ts file within the service directory to handle request and response typing under strict TypeScript conventions.

A POST schema is included in the service scaffold only when the endpoint requires it, adhering to the Valra.gg convention to maintain a strict and clear project structure for optional POST requests.

You can preview the service creation steps because this scaffolding tool presents a detailed plan-driven guide for creating and validating the service before executing the actual file generation.

The service scaffolding workflow enforces strict TypeScript usage and clear naming conventions for both api and actions components to ensure standardized endpoint creation across the project.