Name: web-client-sync
Author: pierreclaverkoko

Instruction file imported from pierreclaverkoko/vaxiil (.cursor/rules/web-client-sync.mdc). Copyright stays with the author.

Web / mobile / backend sync

Before changing APIs or client models, read docs/web/implementation.md (Angular progress, shells, AI sync rules) and CONVENTIONS.md.

Client roles

Flutter (mobile/): primary mobile client; keep responsive Flutter web maintained.
Angular (web/ when present): dedicated full web product — consumer, business management shells, platform staff admin.
All clients use /api/v1/ + JWT. Do not invent parallel JSON shapes per client.

On any API or DTO change

Update backend serializers/views and run uv run pytest.
Update Flutter models/repos (and tests); run flutter test in mobile/.
Update Angular models/services (and tests) in web/; run yarn test:ci and yarn lint (Yarn only, not npm).
After any Angular (web/) code change, also run yarn ng build (or ng build in web/) and fix compile/template errors before considering the work complete.
Update checkboxes/percentages in docs/web/implementation.md and IMPLEMENTATION.md when behavior ships.

Contracts

Choice fields: { "value", "title", "css" } — semantic css tokens only; same mapping on Flutter and Angular; unknown css → safe fallback. title is localized by the backend via Accept-Language (en/fr); do not invent client title maps.
User-facing UI chrome must be translated (en/fr) — Flutter ARB, Angular assets/i18n. See .cursor/rules/i18n.mdc.
Breaking JSON changes require an API version bump or coordinated mobile and web releases.
Missing backend: mark UI blocked / empty-state — do not fake response shapes.

UI / design

New web UI starts from docs/design/ (copy Stitch exports there if needed). Open matching code.html + screen.png before implementing; do not invent alternate layouts.
Page vs modal: follow Flutter modalOnWide parity (see .cursor/rules/web-design.mdc and docs/web/implementation.md).
Business/staff features use management shells (BusinessManageShell / PlatformStaffShell), not consumer phone chrome.
Feature parity: new user-facing capability needs Backend / Flutter / Angular status (or explicit N/A with reason).

{ "ocm": "1", "id": "pierreclaverkoko-vaxiil-web-client-sync-rule", "kind": "skill", "name": "web-client-sync", "description": "Keep Angular web, Flutter mobile, and Django API contracts in sync", "publisher": "pierreclaverkoko", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-cursor-rules" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Keep Angular web, Flutter mobile, and Django API contracts in sync" ], "primary": false, "metadata": { "source": { "provider": "github-cursor-rules", "repository": "https://github.com/pierreclaverkoko/vaxiil", "path": ".cursor/rules/web-client-sync.mdc", "ref": "4581212b423f57d05f579107007377988a741c95", "url": "https://github.com/pierreclaverkoko/vaxiil/blob/4581212b423f57d05f579107007377988a741c95/.cursor/rules/web-client-sync.mdc", "key": "pierreclaverkoko/vaxiil/.cursor/rules/web-client-sync.mdc" } }, "instructions": "# Web / mobile / backend sync\n\nBefore changing APIs or client models, read **docs/web/implementation.md** (Angular progress, shells, AI sync rules) and **CONVENTIONS.md**.\n\n## Client roles\n\n- **Flutter** (`mobile/`): primary mobile client; keep responsive Flutter web maintained.\n- **Angular** (`web/` when present): dedicated full web product — consumer, business management shells, platform staff admin.\n- All clients use **`/api/v1/`** + JWT. Do not invent parallel JSON shapes per client.\n\n## On any API or DTO change\n\n1. Update backend serializers/views and run `uv run pytest`.\n2. Update Flutte", "cost": { "context_tokens": 549 } }

web-client-sync

About

Web / mobile / backend sync

Client roles

On any API or DTO change

Contracts

UI / design

Use it

Manifest

Reviews