ishistory

CMS Guide

How to use Sveltia CMS to manage your content.

Accessing the CMS

Visit /admin on your deployed site (e.g., https://your-site.pages.dev/admin).

You will be prompted to authenticate with your GitHub account. Make sure you are a collaborator on the repository configured in public/admin/config.yml.

Creating Blog Posts

  1. Click Blog in the left sidebar
  2. Click New Blog
  3. Fill in the title, description, publish date, author, tags, and body
  4. Click Publish to save and commit to GitHub

Creating Documentation Pages

  1. Click Documentation in the left sidebar
  2. Click New Documentation
  3. Fill in the title, description, section, order, and body
  4. Click Publish

Uploading Media

Images are stored in public/images/. Use the media browser in the CMS to upload images and insert them into your content.

Editorial Workflow

Sveltia CMS supports draft and review states. Posts saved as Draft are committed to a cms/posts/<post-name> branch. When ready, click Publish to merge to main.

Local Development

To test the CMS locally, use the Sveltia CMS proxy server:

npx @sveltia/cms-local-proxy

Then set the backend in your config to local for development:

local_backend: true
← Documentation Home