Librechat-Mobile/.claude/skills/sync-upstream/reference/upstream-paths.md
Garfie 34ddeb9789 Add sync-upstream skill and upstream submodule
- Add official LibreChat repo as git submodule at upstream/ (pinned to v0.8.2)
- Create UPSTREAM_VERSION file to track which release the app targets
- Create /sync-upstream skill with Agent Teams workflow
- Add reference files for API, model, UI, and architecture mappings
- Update CLAUDE.md with upstream sync documentation
2026-03-26 16:50:18 -05:00

1.7 KiB

Upstream Paths to Watch

These are the directories in the upstream/ submodule that matter for Android 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 Android 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; Android 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.