Overview

Product Tour

Using a starter

Adding Tina to existing NextJS site

Getting Started

Using the Tina editor

The JavaScript toolkit for building content management interfaces

Content Modeling

Data Fetching

Contextual Editing

Writing custom queries

Querying content

Markdown

Rich Text with MDX

Block-based editing

Active Field Indicator

Editing

Validation

Custom field components

Custom List Rendering

Format and parse input

Extending Tina

Powerful Git-based content management for teams

Registration

Projects

Users

Tina Cloud Dashboard

Connecting the site

API Versioning

Branching

Querying Tina Content in NextJS

Adding Internationalization to Tina

NextJS

Querying Tina Content at Runtime

Non-React-based SSG support

Collections

Fields

Templates

string

number

datetime

boolean

image

reference

object

rich-text

Field Types

Schema

".tina" folder

The TinaCMS CLI

Repo-based Media

Cloudinary

Media

Running the Local GraphQL API

Getting a Single Document

Querying a Collection

Updating a Document

Adding a Document

Querying the API

Using Curl & Fetch

Data Layer

Content API

Tina's edit state

The CMS

Forms

Text

Text Area

Number

Image

Color

Toggle

Radio Group

Select

List

Group

Group List

Blocks

Date & Time

HTML

Field Plugins

CMS Toolkit


## Available Commands

```sh
> yarn run tinacms

Usage: @tinacms/cli command [options]

Options:
  -V, --version           output the version number
  -h, --help              display help for command

Commands:
  server:start [options]  Start Filesystem Graphql Server
  build [options]         Build Tina.
  init [options]          Add Tina Cloud to an existing project
  audit [options]         Audit your schema and the files to check for errors
  help [command]          display help for command

You can get help on any command with "-h" or "--help".
e.g: "tinacms server:start --help"
```

## Basic Usage:

### `tinacms server:start`

> To run this command, you must have a valid `.tina/schema.ts` file.

`server:start` will compile the schema into static files, generate typescript types for use in your project and start a graphQL server on http://localhost:4001

This command takes the following arguments:

| Argument        | Description                                                                                                                                                             |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-c`            | `-c` allows you to optionally run a command as a child process. For example, you could run your Next.js project alongside the graphQL server `yarn tinacms server:start -c next dev`. |
| `--port <port>` | Specify a port to run the server on. (default 4001)                                                                                                                     |
| `--noWatch`     | Don't regenerate config on file changes. This option is good to add when building in CI or if you do not want to watch the file system for changes.                     |
| `--noSDK`       | Don't generate the generated client SDK. [Read here](/docs/graphql/client/) for more details about the SDK.                                                             |

### `tinacms build`

This command compiles and validates the schema and generates the client and types. It will also ensure your content has finished indexing.

| Argument         | Description                                                                                             |
| ---------------- | ------------------------------------------------------------------------------------------------------- |
| `--noTelemetry`  | Disables Open Source Telemetry                                                                          |
| `--local`        | If the local flag is passed it will setup the client with the local URL (http://localhost:4001/graphql) |
| `-v`,`--verbose` | increase verbosity of logged output (default: false)                                                    |

### `npx @tinacms/cli@latest init`

> The init command must be run inside of a Next.js project

```bash,copy
npx @tinacms/cli init
```

This will,

1. Install all required dependencies for Tina.
2. Define a basic content schema in the `.tina` directory.
3. Add some Tina boilerplate components.
4. Create example content in the demo directory.
5. Edit the `package.json` to have the `dev`, `build`, and `start` scripts run the tina GraphQL API.

#### Optional parameters

| Argument           | Description                                                                             |
| ------------------ | --------------------------------------------------------------------------------------- |
| `--noTelemetry`    | Disables Open Source Telemetry                                                          |
| `--schemaFileType` | Overrides default Tina schema file type. Valid values are: `.ts`, `.tsx`, `.js`, `.jsx` |

## Advanced Usage:

### `tinacms schema:compile`

`schema:compile` is used to compile and transpile the schema files into static file(s) ready to be used with the server. The compilation can be found in the `.tina/__generated__/config` directory.

### `tinacms schema:types`

`schema:types` will generate a GraphQL query for your site's schema and typescript files. You will find the generated files in the `.tina/__generated__/` directory.

### `tinacms audit` (Experimental)

`audit` is used for checking for errors in your in your files. It currently does two things.

1. Checks to see if the files have the correct extension
2. Submits each file as a Graphql mutation and checks for Graphql errors

By default the mutation will not change the content of the files.

Takes the following options,

| Argument  | Description                                                                                                                                                                                                                                                             |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--clean` | When this flag is used, it really submits the Graphql mutations to the file system. This means that it will clean out any fields that are not defined in your `schema.ts`. It is a good practice to do a `git commit` before doing this so one can undo changes easily. |
|           |


Docs

The TinaCMS CLI