Skip to content

Creating and Publishing Articles

import { Steps } from ‘@astrojs/starlight/components’;

This guide walks through the day-to-day workflow for writing documentation in Sveltia CMS.

The Publishing Workflow

  1. Access the Admin Portal
    Navigate to the /admin/ path on the documentation site and sign in using your GitHub Personal Access Token.

  2. Create or Edit Content
    Select Help Articles in the sidebar. Click New Help Article or choose an existing article to edit.

  3. Fill Out Frontmatter Metadata

    • Title: The primary H1 heading for the page.
    • Description: A 1-2 sentence overview used in search indexing and SEO previews.
    • Sidebar Settings: Optionally provide a shorter label or specify numerical sort order.
  4. Write the Body Content
    Use the rich text editor or write standard Markdown directly.

  5. Save & Deploy
    Click Save in the top right. Sveltia commits the file to GitHub, triggering an automated rebuild that publishes live within ~60 seconds.