Tina Cloud

What Is TinaCMS?

TinaCMS is an open-source, Git-backed headless CMS that adds a visual editing layer directly on top of your Markdown, MDX, and JSON files. Unlike database-driven CMS platforms, Tina does not lock your content into a proprietary system — your content stays as plain files in your Git repository, and Tina provides the editing interface.

The core philosophy is “Content as Code”: every save becomes a Git commit, inheriting the same version history, review, and rollback capabilities as your source code.

How Tina Works with Astro Docus

TinaCMS is designed to work on top of static site generators like Astro. The integration adds a /admin route to your deployed site, where editors can log in and manage content through a visual interface.

Key characteristics for Astro Docus:

Content stays in Git — Markdown and MDX files remain the source of truth
Visual editing mode — for React-based sites, editors can click directly on page elements and edit them in real time
GraphQL Content API — Tina provides a typed GraphQL layer for querying your content at build time
No database required — content is read from files, not a separate data store

Tina is one of the better pairings available for Astro. It edits the Markdown and MDX files your Astro content collections already read, so nothing about the build changes and the site still deploys as static output.

Local Mode vs Production Mode

TinaCMS operates in two distinct modes, and understanding the difference is essential.

Local Mode

When running your site locally with tinacms dev, Tina enters local mode. In this mode:

Content is loaded from and saved to your local filesystem
No login is required to enter edit mode
Changes are written directly to your local Markdown/MDX files
The local GraphQL server runs at localhost:4001

Local mode is designed for development only. It will not work on a production site, because the underlying filesystem is not available and the local server is not running.

Production Mode

For a deployed site, Tina needs a hosted backend to handle authentication and Git operations. This is where TinaCloud comes in.

In production mode:

Editors access the CMS via /admin on your deployed site
Authentication is required — users log in before editing
Changes are committed directly to your Git repository via the backend
TinaCloud provides a hosted GraphQL endpoint and Git integration

What Is TinaCloud?

TinaCloud is TinaCMS’s managed backend service — the easiest way to run Tina in production. It provides:

Hosted GraphQL endpoint for your content
Git integration with GitHub
User management and authentication
Editorial workflow features (drafts, review states) on paid plans

The key benefit: editors can log in and edit content without needing direct access to your GitHub repository. TinaCloud handles the authentication layer, so non-technical team members can update content through the CMS interface.

Self-Hosted Alternative

Tina can also be self-hosted on your own infrastructure. This gives you complete control over data, custom authentication providers, and support for Git providers other than GitHub.

However, self-hosting has trade-offs. Some TinaCloud features are not available in self-hosted mode, including Git-backed media management, runtime branch switching, and search endpoints.

Visual Editing

The headline feature of TinaCMS is visual in-context editing. Editors can click directly on text, images, or fields on the live page and edit them in a sidebar, watching changes appear in real time.

This is Tina’s strongest differentiator in the Git-based CMS category. The experience is comparable to Sanity’s Presentation tool, but built directly into a Git-based workflow.

Limitation: Visual editing requires React-based pages. For non-React frameworks, Tina still provides a standalone editor, but without the visual preview.

Is Tina CMS Right for Astro Docus?

TinaCMS is a good fit if you:

Want a Git-backed CMS with visual editing capabilities
Need a hosted backend (TinaCloud) for easy production setup
Have non-technical content editors who prefer a visual interface
Want content versioning through Git commits
Are comfortable with a React-based editing layer on top of your Astro site

It may not be ideal if you:

Have no need for a CMS — Astro Docus works perfectly with plain Markdown
Want a database-backed CMS for highly relational content
Need enterprise compliance or field-level permission control
Want zero backend to operate (self-hosting requires infrastructure management)

For most Astro Docus users, Tina is only relevant if you need a visual editing experience for non-technical team members. If your team edits Markdown in VS Code, you do not need a CMS at all.

Important Note

TinaCMS and TinaCloud integration is a service, not a built-in feature of Astro Docus. The template ships with the content structure ready for CMS integration, but the setup requires configuration specific to your repository, hosting, and authentication method.

If you need help setting up TinaCMS for your Astro Docus site — including local development, TinaCloud project creation, schema configuration, and production deployment — professional setup services are available.

👉 Contact for Basic Setup TinaCMS integration assistance: https://www.fiverr.com/creativitas/convert-your-figma-and-ui-design-to-flatfile-cms-or-ssg