# Backend Type Bridger

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

- Skill: `heyeddi-com/backend-type-bridger-3` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add heyeddi-com/backend-type-bridger-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/heyeddi-com/backend-type-bridger-3/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-3

---



# Backend Type Bridger

## When to use

- Frontend agent needs accurate API payload shapes
- `openapi.json` or FastAPI server available locally
- Firestore rules or schema file exists for Firebase projects

## Instructions

1. FastAPI: `python scripts/sync_openapi.py --project-root <root>` — writes `src/types/api.ts` from `openapi.json` or `--url`
2. Firebase: `python scripts/fetch_firestore_schema.py --project-root <root>`
3. Import generated types in composables — never guess field names. Refine generated interfaces if OpenAPI uses `$ref` heavily.