sveltia-cms

# Sveltia CMS Skill

Complete skill for integrating Sveltia CMS into static site projects.

---

## Current Versions

- **@sveltia/cms**: 0.127.0 (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.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 Feature**: Configuration files can now be written in TOML format (previously YAML-only).

**Migration**:
```toml
# admin/config.toml (NEW)
[backend]
name = "github"
repo = "owner/repo"
branch = "main"

media_folder = "static/images/uploads"
public_folder = "/images/uploads"
```

**Recommendation**: YAML is still preferred for better tooling support.

---

### v0.118.0 (November 15, 2025) - TypeScript Breaking Change

**BREAKING**: Renamed `SiteConfig` export to `CmsConfig` f