Librechat-Mobile/.claude/skills/sync-upstream/reference/upstream-paths.md

1.7 KiB

Upstream Paths to Watch

These are the directories in the upstream/ submodule that matter for mobile parity. Use these paths when generating focused diffs between tags.

Path What It Contains Why It Matters
api/server/routes/ Express route definitions (REST endpoints) Defines the API contract the mobile app calls
api/server/controllers/ Request handlers and business logic Shows request/response shapes and validation
packages/data-provider/src/ Shared types, schemas, API client, config Canonical type definitions; Mobile models must match
packages/data-provider/src/types/ TypeScript type subdirectory (queries, mutations, agents, etc.) React Query hook types that define API shapes
packages/data-schemas/src/ Mongoose schemas and DB models Database schema changes that affect API responses
client/src/components/ React UI components by feature area Reference for Android UI feature parity
client/src/hooks/ Custom React hooks (data fetching, state) Shows how the web app consumes APIs — informs ViewModel design
client/src/store/ Recoil/Jotai state atoms Global state patterns — informs Android state management
client/src/Providers/ React Context providers Feature flags, config-driven UI — informs Android feature gating

Diff Command Template

cd upstream && git diff {old_tag}..{new_tag} --stat -- \
  api/server/routes/ \
  api/server/controllers/ \
  packages/data-provider/src/ \
  packages/data-schemas/src/ \
  client/src/components/ \
  client/src/hooks/ \
  client/src/store/

For detailed diffs, run each path separately to keep output manageable.