mcpField
B
backend-type-bridger

backend-type-bridger

github.com/heyeddi-comDevelopment090 installsUpdated 1d ago
Repository

About backend-type-bridger

A development skill that generates TypeScript API types from a local OpenAPI file and can fetch Firebase schema information. It is intended for frontend work that needs accurate backend payload shapes instead of guessed field names.

Key features

  1. 01Generate TypeScript types from OpenAPI
  2. 02Read OpenAPI files from the project
  3. 03Fetch Firebase Firestore schema
  4. 04Support FastAPI type synchronization

Use cases

  1. 01Creating frontend types from a local API specification
  2. 02Checking payload shapes while implementing API calls
  3. 03Retrieving Firebase schema for frontend development

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/heyeddi-com/heyeddi-skills --skill backend-type-bridger

After installing, type/backend-type-bridgerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

manifest.json
context/
ANTI_PATTERNS.md
EXAMPLES.md
PROSE_ANTI_SLOP.md
VOCABULARY.md
scripts/
_skill_cli.py
fetch_firestore_schema.py
sync_openapi.py

Details

From the project README

Backend Type Bridger

When to use

  • Frontend agent needs accurate API payload shapes
  • Local openapi.json (or another OpenAPI file under the project root)
  • Firestore rules or schema file exists for Firebase projects

Instructions

  1. Ensure a local OpenAPI file at openapi.json (project root). Prefer the scaffolded file. If the API is running and the file is missing/stale, export to disk first (do not pass a URL into this skill):

    curl -fsS http://127.0.0.1:8090/openapi.json -o openapi.json

  2. FastAPI types: python scripts/sync_openapi.py --project-root <root>: writes src/types/api.ts from local openapi.json only (optional --openapi path/rel.json).

  3. Firebase: python scripts/fetch_firestore_schema.py --project-root <root>

  4. Import generated types in composables: never guess field names. Refine generated interfaces if OpenAPI uses $ref heavily.

Comments

Markdown supported