/ projectpublic

Tinacms

A fully open-source headless CMS that supports Markdown and Visual Editing

activepackages/tinacms/src/toolkit/git-client/git-file.ts

The legacy filesystem-mutation API (GitFile/GitClient/GitMediaStore) was deprecated in PR #5715 (June 2025). The editor now issues all content changes through the TinaCMS GraphQL mutation pipeline, so direct file reads/writes through GitFile are no longer needed and the API was judged clunky.

411d until removal

deprecated June 9, 2025removal June 9, 2027

/ deprecated code

/**
 * @deprecated as the API is clunky and hard to use. Mutations should now be
 * done via Graphql. This will be removed by July 2025.
 */
export class GitFile {

/ recommended alternative

Use GraphQL mutations via the TinaCMS client (e.g. client.request(...)) instead of instantiating GitFile.

/ migration steps

Remove constructor usages of GitFile and any useGitFile hook call sites.
Replace reads (show) with a TinaCMS GraphQL query.
Replace writes (commit/write) with a TinaCMS GraphQL mutation submitted through the form submit flow.

/ history

JackDevAUadded packages/tinacms/src/toolkit/git-client/git-file.ts3h ago