Skip to content

Known limitations (GitMCloud)

Honest list of GitMCloud's gaps and rough edges, for internal use.

By design

  • Read-mostly. GitMCloud can view everything and write a small set of metadata (freeze, part-number allocation, milestones, lock release, team changes). Anything needing SolidWorks or local Git — check in/out, generate a BOM, stamp a part number into a file, create or merge branches — is not possible and shows as disabled.
  • No backend or database. All data comes from the GitHub API plus four thin Vercel functions (check-access, device-code, device-poll, lfs-url). State (token, connection) lives in the browser's localStorage.
  • GitHub only. Like GitM, it's tied to GitHub.
  • Desktop web only. Mobile is not a target.

Access and auth

  • Allowlist is fail-closed and env-var based. Empty ALLOWED_OWNERS locks everyone out, and updates need a ~30s redeploy. A Vercel KV upgrade for instant updates is planned, not shipped.
  • Allowlist is per owner, not per individual user under that owner.
  • "Sign in with GitHub" requires an OAuth client ID (VITE_GITHUB_CLIENT_ID). Without it, only PAT sign-in is available.

File viewer

  • ShareCAD preview is unreliable for private-repo LFS files — it often renders blank. The planned replacement (APS/Autodesk viewer) is deferred / not shipped. Workaround: download the file (e.g. via the Exchange page) or open it in SolidWorks.

Data contracts with GitM

  • The BOM schema and the part-number registry (schema, prefixes, padding, allocation algorithm) are shared contracts with GitM. Changing one side without the other breaks the display or causes number collisions. Coordinate any change across both projects.

Sharing

  • The Exchange page is public and unauthenticated. Any link you share is effectively public — treat it accordingly.

Versioning / docs

  • This documentation reflects GitMCloud's shipped state as of 2026-06-13. Features shipped since initial docs (2026-05-31): read-only Cx pill per file row (distinct cloud-version count, identical to the GitM add-in's computation), and the Versions view renamed to Snapshots. The app auto-deploys from main, so features may move ahead of these pages — verify against the live app if something looks off.