Communitygithub.com

ovachiever/droid-tings

Git管理のTinaCMSを使用してコンテンツ中心のサイトを構築します。技術者でない編集者向けに、ビジュアル編集とコンテンツ管理機能をブログ、ドキュメント、マーケティングサイトに提供します。

droid-tings とは?

このスキルは、オープンソースのGit連携型ヘッドレスCMSであるTinaCMSを、Next.js、Vite+React、Astroなどのモダンなウェブアプリケーションフレームワークに統合するための包括的なガイドを提供します。TinaCMSはコンテンツをMarkdown、MDX、JSONファイルとしてGitリポジトリに保存し、完全なバージョン管理と変更履歴を提供するため、コンテンツの管理が安全で透明性の高いものになります。主な機能として、サイドバイサイドのビジュアル編集、スキーマ駆動のコンテンツモデリング、TinaCloud(マネージドサービス)またはCloudflare WorkersやVercel Functionsでのセルフホスティングによる柔軟なデプロイオプションがあります。このスキールは、ブログやドキュメントサイト、マーケティングページなど、コンテンツ中心のサイトで、技術者でない編集者がGitを使わずにコンテンツを管理できるようにする場合に最適です。リアルタイムコラボレーションが必要な場合や、頻繁に変更される動的データを扱う場合には推奨されません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ovachiever/droid-tings/tree/HEAD/skills/tinacms

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

TinaCMS スキル

TinaCMSをモダンなウェブアプリケーションに統合するための完全なスキルです。


TinaCMSとは?

TinaCMS は、オープンソースのGit連携型ヘッドレスコンテンツ管理システム (CMS) であり、開発者とコンテンツ作成者がコンテンツ中心のウェブサイトでシームレスに協力できるようにします。

主な機能

  1. Git管理ストレージ

    • コンテンツはGitリポジトリ内のMarkdown、MDX、JSONファイルとして保存
    • 完全なバージョン管理と変更履歴
    • ベンダーロックインなし - コンテンツは自分のリポジトリに存在
  2. ビジュアル / コンテキスト編集

    • サイドバイサイドの編集エクスペリエンス
    • 入力時に変更をライブプレビュー
    • MarkdownコンテンツのWYSIWYG風編集
  3. スキーマ駆動のコンテンツモデリング

    • コード (tina/config.ts) でコンテンツ構造を定義
    • スキーマから自動生成される型安全なGraphQL API
    • 整理されたコンテンツのためのコレクションとフィールドシステム
  4. 柔軟なデプロイメント

    • TinaCloud: マネージドサービス (最も簡単、無料枠あり)
    • セルフホスティング: Cloudflare Workers、Vercel Functions、Netlify Functions、AWS Lambda
    • 複数の認証オプション (Auth.js、カスタム、ローカル開発)
  5. フレームワークサポート

    • 最適: 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を使用すべき場合:

  1. コンテンツ中心のサイトを構築する場合

    • ブログや個人ウェブサイト
    • ドキュメントサイト
    • マーケティングウェブサイト
    • ポートフォリオサイト
  2. 技術者でない編集者がアクセスする必要がある場合

    • コーディング知識のないコンテンツチーム
    • ページを管理するマーケティングチーム
    • ブログ記事を執筆する著者
  3. Gitベースのワークフローが望ましい場合

    • Gitによるコンテンツのバージョン管理が必要
    • プルリクエストによるコンテンツレビューが必要
    • コードと一緒にコンテンツをリポジトリに保存したい
  4. ビジュアル編集が必要な場合

    • 編集者が変更をライブで確認したい
    • WYSIWYGエクスペリエンスが望ましい
    • サイドバイサイドの編集ワークフロー

❌ TinaCMSを使用すべきでない場合:

  1. リアルタイムコラボレーションが必要な場合

    • 複数のユーザーが同時に編集 (Google Docsスタイル)
    • 代わりにSanity、Contentful、Firebaseを使用
  2. 非常に動的なデータを扱う場合

    • 頻繁な在庫変更を伴うeコマース商品カタログ
    • リアルタイムダッシュボード
    • 代わりに従来のデータベース (D1、PostgreSQL) を使用
  3. コンテンツ管理が不要な場合

    • アプリケーションはデータ駆動型であり、コンテンツ駆動型ではない
    • ハードコードされたコンテンツで十分

フレームワーク別のセットアップパターン

フレームワークの選択に応じて、適切なセットアップパターンを使用してください。

1. Next.js セットアップ (推奨)

App Router (Next.js 13以降)

手順:

  1. TinaCMSを初期化:

    npx @tinacms/cli@latest init
    
    • 公共アセットディレクトリを求められたら、public と入力
  2. package.jsonのスクリプトを更新:

    {
      "scripts": {
        "dev": "tinacms dev -c \"next dev\"",
        "build": "tinacms build && next build",
        "start": "tinacms build && next start"
      }
    }
    
  3. 環境変数を設定:

    # .env.local
    NEXT_PUBLIC_TINA_CLIENT_ID=your_client_id
    TINA_TOKEN=your_read_only_token
    
  4. 開発サーバーを起動:

    npm run dev
    
  5. 管理インターフェースにアクセス:

    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 セットアップ

手順:

  1. 依存関係をインストール:

    npm install react@^19 react-dom@^19 tinacms
    
  2. TinaCMSを初期化:

    npx @tinacms/cli@latest init
    
    • 公共アセットディレクトリを public に設定
  3. vite.config.ts を更新:

    import { defineConfig } from 'vite'
    import react from '@vitejs/plugin-react'
    
    export default defineConfig({
      plugins: [react()],
      server: {
        port: 3000  // TinaCMSのデフォルト
      }
    })
    
  4. package.jsonのスクリプトを更新:

    {
      "scripts": {
        "dev": "tinacms dev -c \"vite\"",
        "build": "tinacms build && vite build",
        "preview": "vite preview"
      }
    }
    
  5. 管理インターフェースを作成:

    オプション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>
    
  6. ビジュアル編集に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>
      )
    }
    
  7. 環境変数を設定:

    # .env
    VITE_TINA_CLIENT_ID=your_client_id
    VITE_TINA_TOKEN=your_read_only_token
    

テンプレート: templates/vite-react/ を参照


3. Astro セットアップ

手順:

  1. 公式スターターを使用 (推奨):

    npx create-tina-app@latest --template tina-astro-starter
    

    または手動で初期化:

    npx @tinacms/cli@latest init
    
  2. package.jsonのスクリプトを更新:

    {
      "scripts": {
        "dev": "tinacms dev -c \"astro dev\"",
        "build": "tinacms build && astro build",
        "preview": "astro preview"
      }
    }
    
  3. Astroを設定:

    // astro.config.mjs
    import { defineConfig } from 'astro/config'
    import react from '@astro/react'
    
    export default defineConfig({
      integrations: [react()]  // Tina管理画面に必要
    })
    
  4. ビジュアル編集 (実験的):

    • Reactコンポーネントが必要
    • インタラクティブ編集に client:tinaDirective を使用
    • 完全なビジュアル編集は2025年10月時点で実験的
  5. 環境変数を設定:

    # .env
    PUBLIC_TINA_CLIENT_ID=your_client_id
    TINA_TOKEN=your_read_only_token
    

最適な用途: コンテンツ重視の静的サイト、ドキュメント、ブログ

テンプレート: templates/astro/ を参照


4. フレームワーク非依存セットアップ

対象: Hugo、Jekyll、Eleventy、Gatsby、Remix、または任意のフレームワーク

手順:

  1. TinaCMSを初期化:

    npx @tinacms/cli@latest init
    
  2. ビルドスクリプトを手動で設定:

    {
      "scripts": {
        "dev": "tinacms dev -c \"<あなたの開発コマンド>\"",
        "build": "tinacms build && <あなたのビルドコマンド>"
      }
    }
    
  3. 管理インターフェース:

    • http://localhost:<ポート>/admin/index.html に自動作成
    • ポートはフレームワークに依存
  4. データ取得:

    • ビジュアル編集なし (サイドバーのみ)
    • Git管理インターフェースを通じてコンテンツを編集
    • 変更はファイルに直接保存
  5. 環境変数を設定:

    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 を参照

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル