# Backend Type Bridger

> Syncs a local FastAPI OpenAPI file to TypeScript types and reads Firestore schema hints. Use when writing Vue composables against FastAPI or Firebase backends.

- Skill: `heyeddi-com/backend-type-bridger` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add heyeddi-com/backend-type-bridger`
- Raw SKILL.md: https://api.skillmd.com/api/skills/heyeddi-com/backend-type-bridger/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: HeyEddi-com (https://skillmd.com/u/heyeddi-com)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/heyeddi-com/backend-type-bridger

---


# 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):

   ```bash
   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.