zod-schemas

Name: zod-schemas
Author: jucandrade

Use when creating or editing Zod schemas for form validation. Covers mask stripping, optional fields, and DTO mirroring patterns.

by jucandrade(0) 0 installs

Free

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Instruction file imported from jucandrade/gestao-de-frotas-frontend (.github/instructions/zod-schemas.instructions.md). Copyright stays with the author.

Zod Schema Guidelines

Structure

One schema file per entity: <entity>.schema.ts
Schema must mirror the backend DTO exactly (same field names)
Export the schema and the inferred type: export type <Entity>FormData = z.infer<typeof <entity>Schema>

Field Patterns

Required string

z.string().min(1, "Mensagem de erro em português")

Optional string (accepts empty string)

z.string().optional().or(z.literal(""))

Masked field (strip mask before validation)

z.string()
  .min(1, "Campo obrigatório")
  .transform((val) => val.replace(/\D/g, ""))
  .pipe(z.string().regex(/^\d{14}$/, "Deve conter 14 dígitos"))

Conventions

Error messages in Portuguese (pt-BR)
Use z.object() with all fields — no partial schemas
Define a reusable optionalString helper when many optional fields exist

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot
curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jucandrade-gestao-de-frotas-frontend-zod-schemas-instructions.ocm.jsonjson

{
  "ocm": "1",
  "id": "jucandrade-gestao-de-frotas-frontend-zod-schemas-instructions",
  "kind": "skill",
  "name": "zod-schemas",
  "description": "Use when creating or editing Zod schemas for form validation. Covers mask stripping, optional fields, and DTO mirroring patterns.",
  "publisher": "jucandrade",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "github-instructions"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Use when creating or editing Zod schemas for form validation. Covers mask stripping, optional fields, and DTO mirroring patterns."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github-instructions",
      "repository": "https://github.com/jucandrade/gestao-de-frotas-frontend",
      "path": ".github/instructions/zod-schemas.instructions.md",
      "ref": "9b0f89f482fe183d345dcf7592f613730c6e80e2",
      "url": "https://github.com/jucandrade/gestao-de-frotas-frontend/blob/9b0f89f482fe183d345dcf7592f613730c6e80e2/.github/instructions/zod-schemas.instructions.md",
      "key": "jucandrade/gestao-de-frotas-frontend/.github/instructions/zod-schemas.instructions.md"
    },
    "applies_to": "src/**/schemas/*.ts"
  },
  "instructions": "# Zod Schema Guidelines\n\n## Structure\n- One schema file per entity: `<entity>.schema.ts`\n- Schema must mirror the backend DTO exactly (same field names)\n- Export the schema and the inferred type: `export type <Entity>FormData = z.infer<typeof <entity>Schema>`\n\n## Field Patterns\n\n### Required string\n```typescript\nz.string().min(1, \"Mensagem de erro em português\")\n```\n\n### Optional string (accepts empty string)\n```typescript\nz.string().optional().or(z.literal(\"\"))\n```\n\n### Masked field (strip mask before validation)\n```typescript\nz.string()\n  .min(1, \"Campo obrigatório\")\n  .transform((val) => va",
  "cost": {
    "context_tokens": 219
  }
}

Fetch it by URL: GET /api/v1/registry/jucandrade-gestao-de-frotas-frontend-zod-schemas-instructions/manifest?version=1.0.0