Skip to content

secondsky/claude-skills / plugins/hugo/skills/hugo

Hugo static site generator with Tailwind v4, headless CMS (Sveltia/Tina), Cloudflare deployment. Use for blogs, docs sites, or encountering theme installation, frontmatter, baseURL errors.

FileKindSize
SKILL.mdskill md15.7 KB
references/advanced-topics.mdmarkdown11.5 KB
references/cms-integration.mdmarkdown10.5 KB
references/common-patterns.mdmarkdown10.5 KB
references/error-catalog.mdmarkdown11.6 KB
references/setup-guide.mdmarkdown11.0 KB
references/tailwind-integration.mdmarkdown12.4 KB
templates/hugo-blog/.github/workflows/deploy.ymlconfig621 B
templates/hugo-blog/.gitmodulesother112 B
templates/hugo-blog/.hugo_build.lockother0 B
templates/hugo-blog/README.mdmarkdown4.0 KB
templates/hugo-blog/archetypes/default.mdmarkdown101 B
templates/hugo-blog/content/posts/first-post.mdmarkdown504 B
templates/hugo-blog/hugo.yamlconfig643 B
templates/hugo-blog/static/admin/config.ymlconfig1.2 KB
templates/hugo-blog/static/admin/index.htmlother310 B
templates/hugo-blog/themes/PaperMod/.github/ISSUE_TEMPLATE/bug.yamlconfig3.9 KB
templates/hugo-blog/themes/PaperMod/.github/ISSUE_TEMPLATE/config.ymlconfig234 B
templates/hugo-blog/themes/PaperMod/.github/ISSUE_TEMPLATE/enhancement.yamlconfig1.5 KB
templates/hugo-blog/themes/PaperMod/.github/PULL_REQUEST_TEMPLATE.mdmarkdown1.7 KB
templates/hugo-blog/themes/PaperMod/.github/workflows/gh-pages.ymlconfig1.9 KB
templates/hugo-blog/themes/PaperMod/LICENSEother1.1 KB
templates/hugo-blog/themes/PaperMod/README.mdmarkdown4.7 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/404.cssother200 B
templates/hugo-blog/themes/PaperMod/assets/css/common/archive.cssother651 B
templates/hugo-blog/themes/PaperMod/assets/css/common/footer.cssother1.0 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/header.cssother1.3 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/main.cssother1.0 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/post-entry.cssother1.7 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/post-single.cssother6.4 KB
templates/hugo-blog/themes/PaperMod/assets/css/common/profile-mode.cssother689 B
templates/hugo-blog/themes/PaperMod/assets/css/common/search.cssother782 B
templates/hugo-blog/themes/PaperMod/assets/css/common/terms.cssother324 B
templates/hugo-blog/themes/PaperMod/assets/css/core/license.cssother193 B
templates/hugo-blog/themes/PaperMod/assets/css/core/reset.cssother1.3 KB
templates/hugo-blog/themes/PaperMod/assets/css/core/theme-vars.cssother969 B
templates/hugo-blog/themes/PaperMod/assets/css/core/zmedia.cssother1023 B
templates/hugo-blog/themes/PaperMod/assets/css/extended/blank.cssother239 B
templates/hugo-blog/themes/PaperMod/assets/css/includes/chroma-mod.cssother303 B
templates/hugo-blog/themes/PaperMod/assets/css/includes/chroma-styles.cssother4.9 KB
templates/hugo-blog/themes/PaperMod/assets/css/includes/scroll-bar.cssother1.2 KB
templates/hugo-blog/themes/PaperMod/assets/js/fastsearch.jsscript5.6 KB
templates/hugo-blog/themes/PaperMod/assets/js/fuse.basic.min.jsscript15.0 KB
templates/hugo-blog/themes/PaperMod/assets/js/license.jsscript193 B
templates/hugo-blog/themes/PaperMod/go.modmanifest55 B
templates/hugo-blog/themes/PaperMod/i18n/ar.yamlconfig546 B
templates/hugo-blog/themes/PaperMod/i18n/be.yamlconfig805 B
templates/hugo-blog/themes/PaperMod/i18n/bg.yamlconfig322 B
templates/hugo-blog/themes/PaperMod/i18n/bn.yamlconfig695 B
templates/hugo-blog/themes/PaperMod/i18n/ca.yamlconfig313 B
templates/hugo-blog/themes/PaperMod/i18n/ckb.yamlconfig473 B
templates/hugo-blog/themes/PaperMod/i18n/cs.yamlconfig498 B
templates/hugo-blog/themes/PaperMod/i18n/da.yamlconfig435 B
templates/hugo-blog/themes/PaperMod/i18n/de.yamlconfig517 B
templates/hugo-blog/themes/PaperMod/i18n/el.yamlconfig624 B
templates/hugo-blog/themes/PaperMod/i18n/en.yamlconfig486 B
templates/hugo-blog/themes/PaperMod/i18n/eo.yamlconfig378 B
templates/hugo-blog/themes/PaperMod/i18n/es.yamlconfig512 B
templates/hugo-blog/themes/PaperMod/i18n/fa.yamlconfig474 B
templates/hugo-blog/themes/PaperMod/i18n/fi.yamlconfig512 B
templates/hugo-blog/themes/PaperMod/i18n/fr.yamlconfig505 B
templates/hugo-blog/themes/PaperMod/i18n/he.yamlconfig543 B
templates/hugo-blog/themes/PaperMod/i18n/hi.yamlconfig367 B
templates/hugo-blog/themes/PaperMod/i18n/hr.yamlconfig543 B
templates/hugo-blog/themes/PaperMod/i18n/hu.yamlconfig275 B
templates/hugo-blog/themes/PaperMod/i18n/id.yamlconfig500 B
templates/hugo-blog/themes/PaperMod/i18n/it.yamlconfig509 B
templates/hugo-blog/themes/PaperMod/i18n/ja.yamlconfig505 B
templates/hugo-blog/themes/PaperMod/i18n/ko.yamlconfig506 B
templates/hugo-blog/themes/PaperMod/i18n/ku.yamlconfig391 B
templates/hugo-blog/themes/PaperMod/i18n/mn.yamlconfig411 B
templates/hugo-blog/themes/PaperMod/i18n/ms.yamlconfig439 B
templates/hugo-blog/themes/PaperMod/i18n/nl.yamlconfig509 B
templates/hugo-blog/themes/PaperMod/i18n/no.yamlconfig504 B
templates/hugo-blog/themes/PaperMod/i18n/oc.yamlconfig497 B
templates/hugo-blog/themes/PaperMod/i18n/pa.yamlconfig582 B
templates/hugo-blog/themes/PaperMod/i18n/pl.yamlconfig517 B
templates/hugo-blog/themes/PaperMod/i18n/pnb.yamlconfig533 B
templates/hugo-blog/themes/PaperMod/i18n/pt.yamlconfig523 B
templates/hugo-blog/themes/PaperMod/i18n/ro.yamlconfig499 B
templates/hugo-blog/themes/PaperMod/i18n/ru.yamlconfig805 B
templates/hugo-blog/themes/PaperMod/i18n/sk.yamlconfig496 B
templates/hugo-blog/themes/PaperMod/i18n/sv.yamlconfig440 B
templates/hugo-blog/themes/PaperMod/i18n/sw.yamlconfig502 B
templates/hugo-blog/themes/PaperMod/i18n/th.yamlconfig614 B
templates/hugo-blog/themes/PaperMod/i18n/tr.yamlconfig508 B
templates/hugo-blog/themes/PaperMod/i18n/uk.yamlconfig454 B
templates/hugo-blog/themes/PaperMod/i18n/uz.yamlconfig335 B
templates/hugo-blog/themes/PaperMod/i18n/vi.yamlconfig533 B
templates/hugo-blog/themes/PaperMod/i18n/zh-tw.yamlconfig525 B
templates/hugo-blog/themes/PaperMod/i18n/zh.yamlconfig493 B
templates/hugo-blog/themes/PaperMod/images/screenshot.pngbinary138.2 KB
templates/hugo-blog/themes/PaperMod/images/tn.pngbinary15.5 KB
templates/hugo-blog/themes/PaperMod/layouts/404.htmlother85 B
templates/hugo-blog/themes/PaperMod/layouts/_default/_markup/render-image.htmlother730 B
templates/hugo-blog/themes/PaperMod/layouts/_default/archives.htmlother2.7 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/baseof.htmlother1.0 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/index.jsonconfig341 B
templates/hugo-blog/themes/PaperMod/layouts/_default/list.htmlother4.0 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/rss.xmlconfig3.4 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/search.htmlother1.0 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/single.htmlother2.2 KB
templates/hugo-blog/themes/PaperMod/layouts/_default/terms.htmlother643 B
templates/hugo-blog/themes/PaperMod/layouts/partials/anchored_headings.htmlother212 B
templates/hugo-blog/themes/PaperMod/layouts/partials/author.htmlother316 B
templates/hugo-blog/themes/PaperMod/layouts/partials/breadcrumbs.htmlother692 B
templates/hugo-blog/themes/PaperMod/layouts/partials/comments.htmlother151 B
templates/hugo-blog/themes/PaperMod/layouts/partials/cover.htmlother3.0 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/edit_post.htmlother692 B
templates/hugo-blog/themes/PaperMod/layouts/partials/extend_footer.htmlother169 B
templates/hugo-blog/themes/PaperMod/layouts/partials/extend_head.htmlother313 B
templates/hugo-blog/themes/PaperMod/layouts/partials/footer.htmlother5.1 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/head.htmlother8.7 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/header.htmlother6.1 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/home_info.htmlother425 B
templates/hugo-blog/themes/PaperMod/layouts/partials/index_profile.htmlother2.8 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/post_canonical.htmlother599 B
templates/hugo-blog/themes/PaperMod/layouts/partials/post_meta.htmlother836 B
templates/hugo-blog/themes/PaperMod/layouts/partials/post_nav_links.htmlother543 B
templates/hugo-blog/themes/PaperMod/layouts/partials/share_icons.htmlother9.9 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/social_icons.htmlother320 B
templates/hugo-blog/themes/PaperMod/layouts/partials/svg.htmlother177.0 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/templates/_funcs/get-page-images.htmlother1.4 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/templates/opengraph.htmlother2.6 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/templates/schema_json.htmlother3.9 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/templates/twitter_cards.htmlother1.2 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/toc.htmlother4.3 KB
templates/hugo-blog/themes/PaperMod/layouts/partials/translation_list.htmlother627 B
templates/hugo-blog/themes/PaperMod/layouts/robots.txtmarkdown164 B
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/collapse.htmlother298 B
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/figure.htmlother1.4 KB
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/inTextImg.htmlother181 B
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/ltr.htmlother286 B
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/rawhtml.htmlother32 B
templates/hugo-blog/themes/PaperMod/layouts/shortcodes/rtl.htmlother286 B
templates/hugo-blog/themes/PaperMod/theme.tomlconfig1.1 KB
templates/hugo-blog/wrangler.jsoncother198 B
templates/hugo-docs/README.mdmarkdown8.5 KB
templates/hugo-docs/archetypes/default.mdmarkdown104 B
templates/hugo-docs/content/_index.mdmarkdown568 B
templates/hugo-docs/content/docs/_index.mdmarkdown164 B
templates/hugo-docs/content/docs/advanced/_index.mdmarkdown136 B
templates/hugo-docs/content/docs/advanced/customization.mdmarkdown2.3 KB
templates/hugo-docs/content/docs/configuration.mdmarkdown1.5 KB
templates/hugo-docs/content/docs/getting-started.mdmarkdown1.2 KB
templates/hugo-docs/hugo.yamlconfig1.3 KB
templates/hugo-docs/resources/_gen/assets/book.scss_b807c86e8030af4cdc30edccea379f5f.contentother17.0 KB
templates/hugo-docs/resources/_gen/assets/book.scss_b807c86e8030af4cdc30edccea379f5f.jsonconfig188 B
templates/hugo-docs/themes/hugo-book/.github/workflows/deploy.ymlconfig987 B
templates/hugo-docs/themes/hugo-book/.github/workflows/main.ymlconfig640 B
templates/hugo-docs/themes/hugo-book/.gitignoreother66 B
templates/hugo-docs/themes/hugo-book/LICENSEother1.1 KB
templates/hugo-docs/themes/hugo-book/README.mdmarkdown12.9 KB
templates/hugo-docs/themes/hugo-book/archetypes/docs.mdmarkdown227 B
templates/hugo-docs/themes/hugo-book/archetypes/posts.mdmarkdown148 B
templates/hugo-docs/themes/hugo-book/assets/_custom.scssother310 B
templates/hugo-docs/themes/hugo-book/assets/_defaults.scssother2.2 KB
templates/hugo-docs/themes/hugo-book/assets/_fonts.scssother130 B
templates/hugo-docs/themes/hugo-book/assets/_main.scssother6.3 KB
templates/hugo-docs/themes/hugo-book/assets/_markdown.scssother3.9 KB
templates/hugo-docs/themes/hugo-book/assets/_print.scssother260 B
templates/hugo-docs/themes/hugo-book/assets/_shortcodes.scssother5.1 KB
templates/hugo-docs/themes/hugo-book/assets/_utils.scssother1.0 KB
templates/hugo-docs/themes/hugo-book/assets/_variables.scssother44 B
templates/hugo-docs/themes/hugo-book/assets/book.scssother370 B
templates/hugo-docs/themes/hugo-book/assets/clipboard.jsscript396 B
templates/hugo-docs/themes/hugo-book/assets/icons/backward.svgother347 B
templates/hugo-docs/themes/hugo-book/assets/icons/calendar.svgother411 B
templates/hugo-docs/themes/hugo-book/assets/icons/chevron-right.svgother178 B
templates/hugo-docs/themes/hugo-book/assets/icons/edit.svgother659 B
templates/hugo-docs/themes/hugo-book/assets/icons/forward.svgother349 B
templates/hugo-docs/themes/hugo-book/assets/icons/menu.svgother451 B
templates/hugo-docs/themes/hugo-book/assets/icons/toc.svgother753 B
templates/hugo-docs/themes/hugo-book/assets/icons/translate.svgother650 B
templates/hugo-docs/themes/hugo-book/assets/katex.jsonconfig185 B
templates/hugo-docs/themes/hugo-book/assets/manifest.jsonconfig333 B
templates/hugo-docs/themes/hugo-book/assets/menu-reset.jsscript265 B
templates/hugo-docs/themes/hugo-book/assets/mermaid.jsonconfig70 B
templates/hugo-docs/themes/hugo-book/assets/normalize.cssother3.3 KB
templates/hugo-docs/themes/hugo-book/assets/plugins/_numbered.scssother618 B
templates/hugo-docs/themes/hugo-book/assets/plugins/_scrollbars.scssother394 B
templates/hugo-docs/themes/hugo-book/assets/search-data.jsonconfig706 B
templates/hugo-docs/themes/hugo-book/assets/search.jsscript2.7 KB
templates/hugo-docs/themes/hugo-book/assets/sw-register.jsscript223 B
templates/hugo-docs/themes/hugo-book/assets/sw.jsscript1.3 KB
templates/hugo-docs/themes/hugo-book/exampleSite/assets/_custom.scssother103 B
templates/hugo-docs/themes/hugo-book/exampleSite/assets/_variables.scssother44 B
templates/hugo-docs/themes/hugo-book/exampleSite/assets/asciinema-627097.castother60.5 KB
templates/hugo-docs/themes/hugo-book/exampleSite/assets/book-starter.castother33.8 KB
templates/hugo-docs/themes/hugo-book/exampleSite/assets/placeholder.svgother585 B
templates/hugo-docs/themes/hugo-book/exampleSite/assets/thumbnail.svgother585 B
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/_index.mdmarkdown2.2 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/_index.mdmarkdown2.7 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/collapsed/3rd-level/4th-level.mdmarkdown551 B
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/collapsed/3rd-level/_index.mdmarkdown1.4 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/collapsed/_index.mdmarkdown45 B
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/hidden.mdmarkdown1.7 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/table-of-contents/_index.mdmarkdown3.5 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/table-of-contents/with-toc.mdmarkdown2.7 KB
templates/hugo-docs/themes/hugo-book/exampleSite/content.en/docs/example/table-of-contents/without-toc.mdmarkdown2.4 KB

references/cms-integration.md

View on GitHub
# Hugo CMS Integration Guide

Complete guide for integrating headless CMS systems with Hugo (Sveltia CMS recommended, TinaCMS not recommended).

---

## Sveltia CMS Integration (Recommended)

### Why Sveltia CMS for Hugo?

✅ **Hugo is Sveltia's primary use case** - designed specifically for Hugo
✅ **Simple setup** - 2 static files, no build step required
✅ **No npm dependencies** - single CDN script
✅ **Local backend** - test CMS locally without Git
✅ **YAML frontmatter** - fully compatible
✅ **No security vulnerabilities** - lightweight, maintained
✅ **Active development** - focused on static site generators

---

### Setup (5 Minutes)

**1. Create admin interface** - `static/admin/index.html`:

```html
<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width,initial-scale=1" />
    <title>Content Manager</title>
  </head>
  <body>
    <script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script>
  </body>
</html>
```

**2. Create CMS config** - `static/admin/config.yml`:

```yaml
backend:
  name: git-gateway
  branch: main

local_backend: true  # Enable local testing

media_folder: "static/images/uploads"
public_folder: "/images/uploads"

collections:
  - name: "blog"
    label: "Blog Posts"
    folder: "content/posts"
    create: true
    slug: "{{slug}}"
    fields:
      - {label: "Title", name: "title", widget: "string"}
      - {label: "Description", name: "description", widget: "string", required: false}
      - {label: "Date", name: "date", widget: "datetime"}
      - {label: "Draft", name: "draft", widget: "boolean", default: false}
      - {label: "Tags", name: "tags", widget: "list", required: false}
      - {label: "Categories", name: "categories", widget: "list", required: false}
      - {label: "Cover Image", name: "cover", widget: "object", required: false, fields: [
          {label: "Image", name: "image", widget: "image", required: false},
          {label: "Alt Text", name: "alt", widget: "string", required: false}
        ]}
      - {label: "Body", name: "body", widget: "markdown"}

  - name: "pages"
    label: "Pages"
    folder: "content"
    create: true
    slug: "{{slug}}"
    filter: {field: "type", value: "page"}
    fields:
      - {label: "Title", name: "title", widget: "string"}
      - {label: "Date", name: "date", widget: "datetime"}
      - {label: "Type", name: "type", widget: "hidden", default: "page"}
      - {label: "Draft", name: "draft", widget: "boolean", default: false}
      - {label: "Body", name: "body", widget: "markdown"}
```

**3. Rebuild site**:
```bash
hugo
# Admin interface now at: http://localhost:1313/admin
```

---

### Production OAuth Setup

Sveltia CMS needs OAuth for GitHub/GitLab authentication in production. Use Cloudflare Workers for OAuth proxy.

#### Option 1: Cloudflare Workers OAuth Proxy

**Create `oauth-proxy/` directory:**

```bash
mkdir oauth-proxy
cd oauth-proxy
npm init -y
npm install hono
```

**Create `oauth-proxy/src/index.ts`:**

```typescript
import { Hono } from 'hono';
import { cors } from 'hono/cors';

type Bindings = {
  GITHUB_CLIENT_ID: string;
  GITHUB_CLIENT_SECRET: string;
};

const app = new Hono<{ Bindings: Bindings }>();

app.use('/*', cors());

app.get('/auth', (c) => {
  const githubAuthUrl = `https://github.com/login/oauth/authorize?client_id=${c.env.GITHUB_CLIENT_ID}&scope=repo,user`;
  return c.redirect(githubAuthUrl);
});

app.get('/callback', async (c) => {
  const code = c.req.query('code');

  if (!code) {
    return c.text('No code provided', 400);
  }

  const tokenResponse = await fetch('https://github.com/login/oauth/access_token', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json',
    },
    body: JSON.stringify({
      client_id: c.env.GITHUB_CLIENT_ID,
      client_secret: c.env.GITHUB_CLIENT_SECRET,
      code,
    }),
  });

  const data = await tokenResponse.json();

  // Send token back to admin window
  return c.html(`
    <script>
      if (window.opener) {
        window.opener.postMessage(
          'authorization:github:success:${JSON.stringify(data)}',
          window.location.origin
        );
        window.close();
      }
    </script>
  `);
});

app.get('/success', (c) => {
  return c.html(`
    <html>
      <body>
        <h1>Success!</h1>
        <p>You can close this window.</p>
        <script>
          if (window.opener) {
            window.close();
          }
        </script>
      </body>
    </html>
  `);
});

export default app;
```

**Create `oauth-proxy/wrangler.jsonc`:**

```jsonc
{
  "name": "hugo-oauth-proxy",
  "main": "src/index.ts",
  "compatibility_date": "2025-01-29"
}
```

**Deploy OAuth proxy:**

```bash
# Set secrets
npx wrangler secret put GITHUB_CLIENT_ID
npx wrangler secret put GITHUB_CLIENT_SECRET

# Deploy
npx wrangler deploy
```

**Update Sveltia config** (`static/admin/config.yml`):

```yaml
backend:
  name: github
  repo: username/repo
  branch: main
  base_url: https://hugo-oauth-proxy.yourname.workers.dev
  auth_endpoint: /auth
```

#### Option 2: GitHub App (Simpler)

1. Create GitHub App: https://github.com/settings/apps/new
   - Homepage URL: `https://your-site.com`
   - Callback URL: `https://api.netlify.com/auth/done`
   - Webhook: Disabled
   - Permissions: Contents (Read & Write)

2. Update `static/admin/config.yml`:
```yaml
backend:
  name: github
  repo: username/repo
  branch: main
```

3. Use Netlify Identity (free tier) or similar service for OAuth

---

### Key Points

- Admin accessible at `/admin` after build
- `local_backend: true` allows local testing without Git
- YAML frontmatter format required
- Collections map to Hugo content directories
- Media files saved to `static/images/uploads`
- OAuth required for production Git backend
- Sveltia CMS is Git-based (no database needed)

---

### Advanced Configuration

**Multiple content types:**

```yaml
collections:
  - name: "blog"
    label: "Blog Posts"
    folder: "content/posts"
    create: true
    slug: "{{year}}-{{month}}-{{day}}-{{slug}}"
    fields:
      - {label: "Title", name: "title", widget: "string"}
      - {label: "Date", name: "date", widget: "datetime"}
      - {label: "Body", name: "body", widget: "markdown"}

  - name: "docs"
    label: "Documentation"
    folder: "content/docs"
    create: true
    nested:
      depth: 3  # Allow nested folders
    fields:
      - {label: "Title", name: "title", widget: "string"}
      - {label: "Weight", name: "weight", widget: "number"}
      - {label: "Body", name: "body", widget: "markdown"}

  - name: "config"
    label: "Site Config"
    files:
      - label: "Site Settings"
        name: "site"
        file: "hugo.yaml"
        fields:
          - {label: "Title", name: "title", widget: "string"}
          - {label: "Base URL", name: "baseURL", widget: "string"}
          - {label: "Language", name: "languageCode", widget: "string"}
```

---

## TinaCMS Integration (Not Recommended)

⚠️ **Use Sveltia CMS instead**. TinaCMS has significant limitations for Hugo.

### Why Not TinaCMS?

❌ **React-only visual editing** - Hugo is Go-templated, visual editing won't work
❌ **Complex setup** - requires Node.js server or Tina Cloud
❌ **692 npm packages** - vs Sveltia's 1 CDN script
❌ **7 security vulnerabilities** - (4 high, 3 critical as of 2025-11-04)
❌ **React/Next.js focused** - Hugo is secondary use case
❌ **YAML only** - same limitation as Sveltia, without benefits

### If You Must Use TinaCMS

Only consider TinaCMS if:
- Already using Tina Cloud
- Have React expertise available
- Need Tina-specific features (team collaboration, approval workflows)

#### Basic TinaCMS Setup (Not Recommended)

**1. Install TinaCMS:**

```bash
npm install tinacms
```

**2. Create `tina/config.ts`:**

```typescript
import { defineConfig } from "tinacms";

export default defineConfig({
  branch: "main",
  clientId: process.env.TINA_CLIENT_ID!,
  token: process.env.TINA_TOKEN!,

  build: {
    outputFolder: "admin",
    publicFolder: "static",
  },

  media: {
    tina: {
      mediaRoot: "images",
      publicFolder: "static",
    },
  },

  schema: {
    collections: [
      {
        name: "post",
        label: "Posts",
        path: "content/posts",
        fields: [
          {
            type: "string",
            name: "title",
            label: "Title",
            isTitle: true,
            required: true,
          },
          {
            type: "datetime",
            name: "date",
            label: "Date",
            required: true,
          },
          {
            type: "boolean",
            name: "draft",
            label: "Draft",
          },
          {
            type: "rich-text",
            name: "body",
            label: "Body",
            isBody: true,
          },
        ],
      },
    ],
  },
});
```

**3. Add build scripts:**

```json
{
  "scripts": {
    "dev": "tinacms dev -c \"hugo server\"",
    "build": "tinacms build && hugo --minify"
  }
}
```

**4. Create Tina Cloud account and get credentials**

This setup requires:
- Tina Cloud account ($29/month for production)
- Node.js runtime
- Complex build process
- React knowledge for customization

**Again: Use Sveltia CMS instead for Hugo projects.**

---

## Comparison: Sveltia vs TinaCMS

| Feature | Sveltia CMS | TinaCMS |
|---------|-------------|---------|
| **Setup Time** | 5 minutes | 1-2 hours |
| **Dependencies** | 1 CDN script | 692 npm packages |
| **Security Issues** | 0 | 7 (4 high, 3 critical) |
| **Local Testing** | ✅ Built-in | ⚠️ Requires config |
| **Hugo Support** | ✅ Primary use case | ⚠️ Secondary |
| **Visual Editing** | ❌ No | ❌ No (Hugo limitation) |
| **Git Backend** | ✅ Native | ✅ Via Tina Cloud |
| **Cost** | Free | $29/month (production) |
| **Maintenance** | Low | High |

---

## Troubleshooting

### Sveltia CMS Issues

**Problem: CMS not loading at /admin**
- Rebuild site: `hugo`
- Check `/admin` exists in `public/`
- Verify browser console for errors

**Problem: Can't authenticate**
- Check OAuth proxy is deployed and running
- Verify GitHub App credentials
- Check callback URL matches

**Problem: Can't save changes**
- Verify Git backend configuration
- Check repository permissions
- Test local backend first (`local_backend: true`)

**Problem: Media uploads not working**
- Check `media_folder` path exists
- Verify `public_folder` is correct
- Ensure Git LFS is configured (if using large files)

---

## Official Documentation

- **Sveltia CMS**: https://github.com/sveltia/sveltia-cms
- **TinaCMS**: https://tina.io/docs/
- **Hugo Content Management**: https://gohugo.io/content-management/
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall