Skip to content

Publishing Progress

SkyCMS uses SignalR to provide real-time progress updates during bulk publishing operations. Editors and administrators see live feedback as pages are generated and deployed.

Audience: Editors, Administrators, Developers

How It Works

When you trigger a bulk publish operation (e.g., regenerating static pages for the entire site or publishing a template change that affects multiple pages), the system:

  1. Starts processing pages in parallel.
  2. Sends real-time progress updates to your browser via SignalR.
  3. Displays a progress indicator showing the current status.
  4. Sends a completion notification when all pages are processed.

Using Bulk Publish

From the Editor

  1. Navigate to the publish interface.
  2. Select the pages you want to regenerate, or leave the selection empty to process all published pages.
  3. Click Publish Static Pages.
  4. The progress indicator appears, showing:
  5. Current page being processed
  6. Completed count / total count
  7. Status of each page (success or error)
  8. A completion message appears when the operation finishes.

Template Publish Cascade

When you publish a template (page design) version, the system automatically:

  1. Updates all pages that use the template.
  2. Republishes any previously published pages.
  3. Reports progress for each page as it's processed.

This can affect many pages — the progress indicator helps you track the operation.

Technical Architecture

SignalR Hub

The PublishingProgressHub provides the real-time communication channel:

  • Authorization: Only Editors and Administrators can connect.
  • Connection: Established automatically when you open the publish interface.
  • Messages: Progress updates and completion notifications are pushed from server to client.

Progress Messages

The hub broadcasts:

Message Payload When
PublishProgress Article ID, status, completed count, total count After each page is processed
PublishComplete Final count, success/failure summary When all pages are done

Bulk Publish Endpoint

POST /Editor/PublishStaticPages

  • Request body: Array of article IDs (GUIDs). Empty array = process all published pages.
  • Response: { IsSuccess: bool, Count: int, Message: string }
  • Authorization: Editors and Administrators.

Multi-Tenancy

  • SignalR connections are scoped to the current tenant.
  • Progress updates are only sent to clients connected from the same tenant.
  • The hub captures tenant context from the HTTP request.

See Also