TinaCMS スキル
TinaCMSをモダンなウェブアプリケーションに統合するための完全なスキルです。
TinaCMSとは?
TinaCMS は、オープンソースのGit連携型ヘッドレスコンテンツ管理システム (CMS) であり、開発者とコンテンツ作成者がコンテンツ中心のウェブサイトでシームレスに協力できるようにします。
主な機能
-
Git管理ストレージ
- コンテンツはGitリポジトリ内のMarkdown、MDX、JSONファイルとして保存
- 完全なバージョン管理と変更履歴
- ベンダーロックインなし - コンテンツは自分のリポジトリに存在
-
ビジュアル / コンテキスト編集
- サイドバイサイドの編集エクスペリエンス
- 入力時に変更をライブプレビュー
- MarkdownコンテンツのWYSIWYG風編集
-
スキーマ駆動のコンテンツモデリング
- コード (
tina/config.ts) でコンテンツ構造を定義 - スキーマから自動生成される型安全なGraphQL API
- 整理されたコンテンツのためのコレクションとフィールドシステム
- コード (
-
柔軟なデプロイメント
- TinaCloud: マネージドサービス (最も簡単、無料枠あり)
- セルフホスティング: Cloudflare Workers、Vercel Functions、Netlify Functions、AWS Lambda
- 複数の認証オプション (Auth.js、カスタム、ローカル開発)
-
フレームワークサポート
- 最適: Next.js (App Router + Pages Router)
- 良好: React、Astro (実験的なビジュアル編集)、Gatsby、Hugo、Jekyll、Remix、11ty
- フレームワーク非依存: どのフレームワークでも動作 (ビジュアル編集はReactに限定)
現在のバージョン
- tinacms: 2.9.0 (2025年9月)
- @tinacms/cli: 1.11.0 (2025年10月)
- Reactサポート: 19.x (>=18.3.1 <20.0.0)
このスキルを使用するタイミング
✅ TinaCMSを使用すべき場合:
-
コンテンツ中心のサイトを構築する場合
- ブログや個人ウェブサイト
- ドキュメントサイト
- マーケティングウェブサイト
- ポートフォリオサイト
-
技術者でない編集者がアクセスする必要がある場合
- コーディング知識のないコンテンツチーム
- ページを管理するマーケティングチーム
- ブログ記事を執筆する著者
-
Gitベースのワークフローが望ましい場合
- Gitによるコンテンツのバージョン管理が必要
- プルリクエストによるコンテンツレビューが必要
- コードと一緒にコンテンツをリポジトリに保存したい
-
ビジュアル編集が必要な場合
- 編集者が変更をライブで確認したい
- WYSIWYGエクスペリエンスが望ましい
- サイドバイサイドの編集ワークフロー
❌ TinaCMSを使用すべきでない場合:
-
リアルタイムコラボレーションが必要な場合
- 複数のユーザーが同時に編集 (Google Docsスタイル)
- 代わりにSanity、Contentful、Firebaseを使用
-
非常に動的なデータを扱う場合
- 頻繁な在庫変更を伴うeコマース商品カタログ
- リアルタイムダッシュボード
- 代わりに従来のデータベース (D1、PostgreSQL) を使用
-
コンテンツ管理が不要な場合
- アプリケーションはデータ駆動型であり、コンテンツ駆動型ではない
- ハードコードされたコンテンツで十分
フレームワーク別のセットアップパターン
フレームワークの選択に応じて、適切なセットアップパターンを使用してください。
1. Next.js セットアップ (推奨)
App Router (Next.js 13以降)
手順:
-
TinaCMSを初期化:
npx @tinacms/cli@latest init- 公共アセットディレクトリを求められたら、
publicと入力
- 公共アセットディレクトリを求められたら、
-
package.jsonのスクリプトを更新:
{ "scripts": { "dev": "tinacms dev -c \"next dev\"", "build": "tinacms build && next build", "start": "tinacms build && next start" } } -
環境変数を設定:
# .env.local NEXT_PUBLIC_TINA_CLIENT_ID=your_client_id TINA_TOKEN=your_read_only_token -
開発サーバーを起動:
npm run dev -
管理インターフェースにアクセス:
http://localhost:3000/admin/index.html
作成される主要ファイル:
tina/config.ts- スキーマ設定app/admin/[[...index]]/page.tsx- 管理UIルート (App Router使用時)
テンプレート: templates/nextjs/tina-config-app-router.ts を参照
Pages Router (Next.js 12以下)
セットアップは同一ですが、管理ルートは以下になります:
pages/admin/[[...index]].tsx(appディレクトリの代わり)
データ取得パターン:
// pages/posts/[slug].tsx
import { client } from '../../tina/__generated__/client'
import { useTina } from 'tinacms/dist/react'
export default function BlogPost(props) {
// ビジュアル編集のためにハイドレート
const { data } = useTina({
query: props.query,
variables: props.variables,
data: props.data
})
return (
<article>
<h1>{data.post.title}</h1>
<div dangerouslySetInnerHTML={{ __html: data.post.body }} />
</article>
)
}
export async function getStaticProps({ params }) {
const response = await client.queries.post({
relativePath: `${params.slug}.md`
})
return {
props: {
data: response.data,
query: response.query,
variables: response.variables
}
}
}
export async function getStaticPaths() {
const response = await client.queries.postConnection()
const paths = response.data.postConnection.edges.map((edge) => ({
params: { slug: edge.node._sys.filename }
}))
return { paths, fallback: 'blocking' }
}
テンプレート: templates/nextjs/tina-config-pages-router.ts を参照
2. Vite + React セットアップ
手順:
-
依存関係をインストール:
npm install react@^19 react-dom@^19 tinacms -
TinaCMSを初期化:
npx @tinacms/cli@latest init- 公共アセットディレクトリを
publicに設定
- 公共アセットディレクトリを
-
vite.config.ts を更新:
import { defineConfig } from 'vite' import react from '@vitejs/plugin-react' export default defineConfig({ plugins: [react()], server: { port: 3000 // TinaCMSのデフォルト } }) -
package.jsonのスクリプトを更新:
{ "scripts": { "dev": "tinacms dev -c \"vite\"", "build": "tinacms build && vite build", "preview": "vite preview" } } -
管理インターフェースを作成:
オプションA: 手動ルート (React Router)
// src/pages/Admin.tsx import TinaCMS from 'tinacms' export default function Admin() { return <div id="tina-admin" /> }オプションB: 直接HTML
<!-- public/admin/index.html --> <!DOCTYPE html> <html> <head> <meta charset="utf-8" /> <title>Tina CMS</title> <meta name="viewport" content="width=device-width, initial-scale=1" /> </head> <body> <div id="root"></div> <script type="module" src="/@fs/[path-to-tina-admin]"></script> </body> </html> -
ビジュアル編集にuseTinaフックを使用:
import { useTina } from 'tinacms/dist/react' import { client } from '../tina/__generated__/client' function BlogPost({ initialData }) { const { data } = useTina({ query: initialData.query, variables: initialData.variables, data: initialData.data }) return ( <article> <h1>{data.post.title}</h1> <div>{/* bodyをレンダリング */}</div> </article> ) } -
環境変数を設定:
# .env VITE_TINA_CLIENT_ID=your_client_id VITE_TINA_TOKEN=your_read_only_token
テンプレート: templates/vite-react/ を参照
3. Astro セットアップ
手順:
-
公式スターターを使用 (推奨):
npx create-tina-app@latest --template tina-astro-starterまたは手動で初期化:
npx @tinacms/cli@latest init -
package.jsonのスクリプトを更新:
{ "scripts": { "dev": "tinacms dev -c \"astro dev\"", "build": "tinacms build && astro build", "preview": "astro preview" } } -
Astroを設定:
// astro.config.mjs import { defineConfig } from 'astro/config' import react from '@astro/react' export default defineConfig({ integrations: [react()] // Tina管理画面に必要 }) -
ビジュアル編集 (実験的):
- Reactコンポーネントが必要
- インタラクティブ編集に
client:tinaDirectiveを使用 - 完全なビジュアル編集は2025年10月時点で実験的
-
環境変数を設定:
# .env PUBLIC_TINA_CLIENT_ID=your_client_id TINA_TOKEN=your_read_only_token
最適な用途: コンテンツ重視の静的サイト、ドキュメント、ブログ
テンプレート: templates/astro/ を参照
4. フレームワーク非依存セットアップ
対象: Hugo、Jekyll、Eleventy、Gatsby、Remix、または任意のフレームワーク
手順:
-
TinaCMSを初期化:
npx @tinacms/cli@latest init -
ビルドスクリプトを手動で設定:
{ "scripts": { "dev": "tinacms dev -c \"<あなたの開発コマンド>\"", "build": "tinacms build && <あなたのビルドコマンド>" } } -
管理インターフェース:
http://localhost:<ポート>/admin/index.htmlに自動作成- ポートはフレームワークに依存
-
データ取得:
- ビジュアル編集なし (サイドバーのみ)
- Git管理インターフェースを通じてコンテンツを編集
- 変更はファイルに直接保存
-
環境変数を設定:
TINA_CLIENT_ID=your_client_id TINA_TOKEN=your_read_only_token
制限事項:
- ビジュアル編集なし (Reactのみの機能)
- 手動統合が必要
- サイドバーベースの編集のみ
スキーマモデリングのベストプラクティス
コンテンツ構造を tina/config.ts で定義します。
基本設定構造
import { defineConfig } from 'tinacms'
export default defineConfig({
// ブランチ設定
branch: process.env.GITHUB_BRANCH ||
process.env.VERCEL_GIT_COMMIT_REF ||
'main',
// TinaCloud認証情報 (マネージドサービス使用時)
clientId: process.env.NEXT_PUBLIC_TINA_CLIENT_ID,
token: process.env.TINA_TOKEN,
// ビルド設定
build: {
outputFolder: 'admin',
publicFolder: 'public',
},
// メディア設定
media: {
tina: {
mediaRoot: '',
publicFolder: 'public',
},
},
// コンテンツスキーマ
schema: {
collections: [
// ここにコレクションを定義
],
},
})
コレクション
コレクション = コンテンツタイプ + ディレクトリマッピング
{
name: 'post', // 単数形、内部名 (APIで使用)
label: 'ブログ記事', // 複数形、表示名 (管理画面に表示)
path: 'content/posts', // ファイルが保存されるディレクトリ
format: 'mdx', // ファイル形式: md, mdx, markdown, json, yaml, toml
fields: [/* ... */] // フィールド定義の配列
}
主要プロパティ:
name: 内部識別子 (英数字とアンダースコアのみ)label: 管理画面用の人間が読める名前path: プロジェクトルートからのファイルパスformat: ファイル拡張子 (デフォルトは 'md')fields: コンテンツ構造の定義
フィールドタイプリファレンス
| タイプ | ユースケース | 例 |
|---|---|---|
string | 短いテキスト (1行) | タイトル、スラッグ、著者名 |
rich-text | 長いフォーマット済みコンテンツ | ブログ本文、ページコンテンツ |
number | 数値 | 価格、数量、評価 |
datetime | 日付/時刻値 | 公開日、イベント時間 |
boolean | 真/偽のトグル | 下書きステータス、おすすめフラグ |
image | 画像アップロード | ヒーロー画像、サムネイル、アバター |
reference | 別のドキュメントへのリンク | 著者、カテゴリ、関連記事 |
object | ネストされたフィールドグループ | SEOメタデータ、ソーシャルリンク |
完全なリファレンス: references/field-types-reference.md を参照
コレクションテンプレート
ブログ記事コレクション
{
name: 'post',
label: 'ブログ記事',
path: 'content/posts',
format: 'mdx',
fields: [
{
type: 'string',
name: 'title',
label: 'タイトル',
isTitle: true, // コンテンツリストに表示
required: true
},
{
type: 'string',
name: 'excerpt',
label: '抜粋',
ui: {
component: 'textarea' // 複数行入力
}
},
{
type: 'image',
name: 'coverImage',
label: 'カバー画像'
},
{
type: 'datetime',
name: 'date',
label: '公開日',
required: true
},
{
type: 'reference',
name: 'author',
label: '著者',
collections: ['author'] // 著者コレクションを参照
},
{
type: 'boolean',
name: 'draft',
label: '下書き',
description: 'チェックすると、記事は公開されません',
required: true
},
{
type: 'rich-text',
name: 'body',
label: '本文',
isBody: true // メインコンテンツ領域
}
],
ui: {
router: ({ document }) => `/blog/${document._sys.filename}`
}
}
テンプレート: templates/collections/blog-post.ts を参照
ドキュメントページコレクション
{
name: 'doc',
label: 'ドキュメント',
path: 'content/docs',
format: 'mdx',
fields: [
{
type: 'string',
name: 'title',
label: 'タイトル',
isTitle: true,
required: true
},
{
type: 'string',
name: 'description',
label: '説明',
ui: {
component: 'textarea'
}
},
{
type: 'number',
name: 'order',
label: '順序',
description: 'サイドバーの並び順'
},
{
type: 'rich-text',
name: 'body',
label: '本文',
isBody: true,
templates: [
// MDXコンポーネントをここで定義
]
}
],
ui: {
router: ({ document }) => {
const breadcrumbs = document._sys.breadcrumbs.join('/')
return `/docs/${breadcrumbs}`
}
}
}
テンプレート: templates/collections/doc-page.ts を参照
著者コレクション (参照先)
{
name: 'author',
label: '著者',
path: 'content/authors',
format: 'json', // 構造化データにはJSONを使用
fields: [
{
type: 'string',
name: 'name',
label: '名前',
isTitle: true,
required: true
},
{
type: 'string',
name: 'email',
label: 'メールアドレス',
ui: {
validate: (value) => {
if (!value?.includes('@')) {
return '無効なメールアドレスです'
}
}
}
},
{
type: 'image',
name: 'avatar',
label: 'アバター画像'
},
{
type: 'string',
name: 'bio',
label: '経歴',
ui: {
component: 'textarea'
}
},
{
type: 'object',
name: 'social',
label: 'ソーシャルリンク',
fields: [
{
type: 'string',
name: 'twitter',
label: 'Twitter'
},
{
type: 'string',
name: 'github',
label: 'GitHub'
},
{
type: 'string',
name: 'website',
label: 'ウェブサイト'
}
]
}
]
}
テンプレート: templates/collections/author.ts を参照