fix: remove Git LFS tracking for docs images - #446
Merged
Conversation
Mintlify deploys docs by cloning the repo but does not run `git lfs pull`. The `.gitattributes` rule `docs/images/** filter=lfs` caused all doc images to be stored as ~130-byte LFS pointer files, which Mintlify served as-is — breaking every image on the site. Removing the LFS rule and re-adding the files as regular git blobs fixes all images without changing any paths or MDX files. Also fixes broken Slack link placeholder in troubleshooting page. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Contributor
Greptile SummaryRemoves Git LFS tracking for
Confidence Score: 5/5
Important Files Changed
Flowchart%%{init: {'theme': 'neutral'}}%%
flowchart TD
A[Git Push to Main] --> B[Mintlify clones repo]
B --> C{Image in LFS?}
C -->|Yes - Before fix| D[Serves 130-byte LFS pointer]
D --> E[Broken image on docs site]
C -->|No - After fix| F[Serves actual image blob]
F --> G[Image renders correctly]
Last reviewed commit: 00a6b78 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
.gitattributeshaddocs/images/** filter=lfswhich stored all doc images as ~130-byte LFS pointer filesgit lfs pull, so it served the raw pointer files instead of actual images — breaking every image on docs.browseros.comdocs/images/(e.g.features/workflow/,features/cowork/) were never LFS-tracked, so Mintlify got the real filesTest plan
🤖 Generated with Claude Code