sveltia-cms

# Sveltia CMS Skill

Complete skill for integrating Sveltia CMS into static site projects.

---

## Current Versions

- **@sveltia/cms**: 0.128.5 (verified January 2026)
- **Status**: Public Beta (v1.0 expected early 2026)
- **Maturity**: Production-ready (270+ issues solved from predecessor)

---

## When to Use This Skill

### ✅ Use Sveltia CMS When:

- Git-based workflow desired (content as Markdown/YAML/TOML/JSON in repository)
- Lightweight solution required (<500 KB vs 1.5-2.6 MB for competitors)
- Migrating from Decap/Netlify CMS (drop-in replacement, change 1 line)
- Non-technical editors need access without Git knowledge

### ❌ Don't Use Sveltia CMS When:

- Real-time collaboration needed (multiple users editing simultaneously) - Use Sanity, Contentful, or TinaCMS instead
- Visual page building required (drag-and-drop) - Use Webflow, Builder.io instead
- React-specific visual editing needed - Use TinaCMS instead

---

## Breaking Changes & Updates (v0.105.0+)

### v0.127.0 (December 29, 2025) - slug_length Deprecation

**DEPRECATION**: The `slug_length` collection option is deprecated and will be removed in v1.0.

**Migration**:
```yaml
# ❌ Deprecated (pre-v0.127.0)
collections:
  - name: posts
    slug_length: 50

# ✅ New (v0.127.0+)
slug:
  maxlength: 50
```

**Timeline**: Will be removed in Sveltia CMS 1.0 (expected early 2026).

**Source**: [Release v0.127.0](https://github.com/sveltia/sveltia-cms/releases/tag/v0.127.0)

---

### v0.120.0 (November 24, 2025) - Author Template Tags

**New Feature**: Hidden widget now supports author template tags:
- `{{author-email}}` - Signed-in user's email
- `{{author-login}}` - Signed-in user's login name
- `{{author-name}}` - Signed-in user's display name

**Usage**:
```yaml
fields:
  - label: Author Email
    name: author_email
    widget: hidden
    default: '{{author-email}}'
```

**Commit message templates** also support `{{author-email}}` tag.

---

### v0.119.0 (November 16, 2025) - TOML Config Support

**New