Publishing Studio

Package docs status

This page is generated from package source documentation in the Capell packages repository and the checked-in manifest. Source documentation is not distribution status. Before running a Composer command, verify that the exact package and compatible 1.x release are available through public Packagist or the authenticated marketplace account.

Field	Value
Composer package	`capell-app/publishing-studio`
Package slug	`publishing-studio`
Product group	Capell Publishing
Tier	premium
Bundle	`publishing`
Runtime contexts	`admin`, `console`
Capell version	`^1.0`
Catalogue role	extension
Release channel	Beta
Source repository	`capell-app/packages`
Source path	`packages/publishing-studio`
Docs source	`packages/publishing-studio/docs`
Manifest	`capell.json`

What This Plugin Adds

Publishing Studio is an Available, Schema-owning Capell package in the Capell Publishing product group. It ships as capell-app/publishing-studio and extends these surfaces: admin, console.

Publishing Studio adds a review-first release workflow for Capell Pages: isolated workspaces, reviewer assignment, approval, scheduled or atomic publishing, activity history, and release recovery. Capell Pages are the supported launch scope; custom draftable models use an extension contract and are not part of the supported launch scope.

Editors prepare Capell Page changes away from the live record, assign and request review, inspect approval history, schedule or publish atomically, inspect activity, and recover a previous release.

Status details:

Status: Available
Tier: premium
Bundle: publishing
Composer package: capell-app/publishing-studio
Namespace: Capell\PublishingStudio
Theme key: not applicable

Why It Matters

For developers: Custom draftable models plug into the same Actions through an extension contract; they remain outside the supported launch scope.

For teams: Teams can separate drafting from live content, require review before release, and recover a previous version when a publication needs to be reversed.

Screens And Workflow

Screenshot contract: docs/screenshots.json.

Watch the captioned 20-second workflow proof, read its captions, or inspect the proof manifest.

Editorial timeline dashboard

Editor draft responsibility in Publishing Studio

Editorial timeline dashboard (admin, required evidence).
Editor draft responsibility in Publishing Studio (admin, required evidence).
Reviewer responsibility (admin, supplementary evidence).
Live preview (frontend, required evidence).
Preview link management (admin, required evidence).
Compare and publish readiness (admin, required evidence).
Approval history (admin, required evidence).
Scheduled publishing (admin, required evidence).
Scheduler metadata (admin, supplementary evidence).
Stale drafts (admin, required evidence).
Activity history (admin, required evidence).
Rollback and restore (admin, required evidence).
Preview banner (frontend, supplementary evidence).
Editorial workspaces with the admin sidebar open (admin, supplementary evidence).

Technical Shape

Service providers

Capell\PublishingStudio\Providers\ConsoleServiceProvider
Capell\PublishingStudio\Providers\PublishingStudioServiceProvider
Capell\PublishingStudio\Providers\AdminServiceProvider

Config files

packages/publishing-studio/config/publishing-studio.php

Migrations

packages/publishing-studio/database/migrations/2026_05_10_190866_01_create_preview_links_table.php
packages/publishing-studio/database/migrations/2026_05_10_190866_02_create_publishing-studio_table.php
packages/publishing-studio/database/migrations/2026_05_10_190866_03_create_versions_table.php
packages/publishing-studio/database/migrations/2026_05_10_190866_04_create_workspace_approvals_table.php
packages/publishing-studio/database/migrations/2026_05_10_190866_05_create_workspace_field_comments_table.php
packages/publishing-studio/database/migrations/2026_05_10_190866_06_create_workspace_review_assignments_table.php
packages/publishing-studio/database/migrations/2026_05_10_190866_07_seed_bootstrap_workspace_version.php
packages/publishing-studio/database/migrations/2026_05_10_190866_08_z_add_workspace_columns_to_core_tables.php
packages/publishing-studio/database/migrations/2026_05_10_190866_09_z_add_workspace_id_to_external_tables.php
packages/publishing-studio/database/migrations/2026_05_10_190866_10_z_add_workspace_id_to_import_sessions_table.php
packages/publishing-studio/database/migrations/2026_05_10_190866_11_create_publishing_revisions_table.php
packages/publishing-studio/database/migrations/2026_05_10_190866_12_create_publishing_scheduler_tables.php
packages/publishing-studio/database/migrations/2026_07_10_000003_add_retry_schedule_to_publishing_scheduler_events.php
packages/publishing-studio/database/migrations/2026_07_12_000000_widen_preview_link_token_before_encryption.php
packages/publishing-studio/database/migrations/2026_07_12_000001_protect_preview_link_tokens.php
packages/publishing-studio/database/migrations/2026_07_12_000002_widen_preview_link_token_storage.php
packages/publishing-studio/database/migrations/2026_09_29_120000_remove_implicit_timestamp_updates_from_publishing_studio.php

Settings migrations

packages/publishing-studio/database/settings/2026_05_10_190867_01_add_publishing_studio_settings.php

Settings classes

PublishingStudioSettings

Models

PreviewLink
PublishingRevision
SchedulerDelivery
SchedulerEvent
SchedulerIcalToken
Version
Workspace
WorkspaceApproval
WorkspaceFieldComment
WorkspaceReviewAssignment

Filament classes

PublishingRevisionsHeaderAction
ActivityTrailPage
PublishingWorkflowPage
ScheduledPublishingPage
StaleDraftsPage
ActivityTrailTable
ScheduledPublishingTable
StaleDraftsTable
DiscardDraftsBulkAction
PublishPageAction
RequestReviewBulkAction
ResubmitForReviewAction
SaveAsDraftFormAction
PageVersionHistoryPage
ManagePreviewLinks
PreviewLinkResource
PreviewLinksTable
ApproveAction
CompareAction
PreviewAction
PublishAction
RejectAction
RequestChangesAction
RollbackAction
SaveAsDraftAction
ScheduleAction
SchedulerMetadataAction
SubmitForApprovalAction
UnscheduleAction
ValidateAction
WorkspacePeekPreviewAction
CompareVersionPage
ManagePublishingStudio
WorkspaceForm
PublishingStudioTable
WorkspaceResource
ScopesPublishingStudioRecordsToUser
PreviewLinksRelationManager
VersionsRelationManager
WorkspaceApprovalsRelationManager
WorkspaceFieldCommentsRelationManager
WorkspaceReviewAssignmentsRelationManager
WorkspacesRelationManager
DefaultDashboardSettingsContributor
SystemHealthSettingsContributor
PublishingStudioSettingsSchema
ContentSchedulerCalendarFilamentWidget
ContentSchedulerOverviewFilamentWidget
PageAlertsFilamentWidget
WorkspaceActivityFilamentWidget
WorkspaceMergeHistoryFilamentWidget

Livewire components

DiffPanel
EditorialTimeline
FieldCommentThread
PageApprovalStatus
PublishStatusPanel
ReleaseWorkspaceSummaryPanel
WorkspaceApprovalHistory
WorkspaceContextBanner
WorkspaceSwitcher

Route files

packages/publishing-studio/routes/web.php

Policies

WorkspacePolicy

Extension contracts

CountableReleaseWorkspaceItemContributor
EditorialCalendarEventContributor
ReleaseWorkspaceItemContributor
WorkspaceTableActionContributor

Events

WorkspaceEventSubscriber
VersionRolledBack
WorkspaceEventDispatcher
WorkspaceStateChanged

Listeners

SendWorkspaceStateNotification
StampWorkspaceOnActivity

Actions

BuildEditorialCalendarEventsAction
BuildEditorialTimelineAction
BuildPublishReadinessAction
BuildPublishingRevisionChangeSetAction
BuildReleaseWorkspaceReadinessAction
BuildReleaseWorkspaceSummaryAction
BuildSchedulerIcalFeedAction
BuildSchedulerRecoveryStatusAction
CancelSchedulerEventAction
ComparePublishingRevisionAction
CopyOnWriteAction
CreatePageDraftWorkspaceAction
CreateRecordDraftWorkspaceAction
CreateSchedulerIcalTokenAction
BuildContentHealthAction
BuildMyWorkQueueAction
BuildRecentlyPublishedAction
BuildSiteStatsAction
BuildWorkspaceActivityAction
BuildWorkspaceMergeHistoryAction
BuildActivityTrailQueryAction
BuildContentSchedulerEventsAction
BuildScheduledPublishingQueryAction
BuildStaleDraftsQueryAction
BuildVisibleContentSchedulerEventsAction
BuildVisibleEditorialCalendarEventsAction
DeletePageDraftAction
DiscardPublishingStudioAction
EnsurePublishingStudioPermissionsAction
ExecuteSchedulerEventAction
ExpireWorkspacePublicVisibilityAction
ExtendPreviewLinkAction
GenerateWorkspacePreviewUrlAction
InstallPublishingStudioPackageAction
InstallWorkspaceRolesAction
InvalidatePublishedWorkspaceFrontendCacheAction
ListPublishingRevisionsAction
PreparePublishingWorkflowScreenshotAction
ReauthorizeScheduledPublishAction
RecordPublishingRevisionAction
RequestReviewBulkAction
ResolveLatestPublishingRevisionAction
ResolveSchedulerIcalFeedAction
RevokePreviewLinkAction
RollbackPublishingReleaseAction
RunDueSchedulerEventsAction
SaveRecordDraftAction
SendWorkspaceReviewReminderAction
SetWorkspaceSchedulerMetadataAction
SyncWorkspaceSchedulerEventsAction
ValidateWorkspaceSchedulerMetadataAction
BuildPublishingWorkflowAttentionItemsAction
BuildPublishingWorkflowCommandCenterAction

Data objects

MergeHistoryEntryData
WorkspaceActivityData
WorkspaceMergeData
WorkspaceMergeHistoryData
EditorialCalendarEventData
EditorialCalendarQueryData
EditorialTimelineEntryData
PublishReadinessData
ReleaseWorkspaceItemData
ReleaseWorkspaceReadinessData
ReleaseWorkspaceSummaryData
SavedRecordDraftData
SchedulerEventData
SchedulerIcalFeedData
SchedulerRecoveryStatusData
PublishingWorkflowActionData
PublishingWorkflowPanelData
WorkspaceSchedulerMetadataData
WorkspaceSettingsData

Command signatures

capell:publishing-studio-install
capell:publishing-studio:load-test
capell:publishing-studio:prune

Manifest action API

buildContentSchedulerEvents: Capell\PublishingStudio\Actions\DashboardReports\BuildContentSchedulerEventsAction
buildEditorialCalendarEvents: Capell\PublishingStudio\Actions\BuildEditorialCalendarEventsAction
buildSchedulerIcalFeed: Capell\PublishingStudio\Actions\BuildSchedulerIcalFeedAction
buildVisibleContentSchedulerEvents: Capell\PublishingStudio\Actions\DashboardReports\BuildVisibleContentSchedulerEventsAction
buildVisibleEditorialCalendarEvents: Capell\PublishingStudio\Actions\DashboardReports\BuildVisibleEditorialCalendarEventsAction
cancelSchedulerEvent: Capell\PublishingStudio\Actions\CancelSchedulerEventAction
createSchedulerIcalToken: Capell\PublishingStudio\Actions\CreateSchedulerIcalTokenAction
executeSchedulerEvent: Capell\PublishingStudio\Actions\ExecuteSchedulerEventAction
install: Capell\PublishingStudio\Actions\InstallPublishingStudioPackageAction
runDueSchedulerEvents: Capell\PublishingStudio\Actions\RunDueSchedulerEventsAction
setWorkspaceSchedulerMetadata: Capell\PublishingStudio\Actions\SetWorkspaceSchedulerMetadataAction
syncWorkspaceSchedulerEvents: Capell\PublishingStudio\Actions\SyncWorkspaceSchedulerEventsAction
validateWorkspaceSchedulerMetadata: Capell\PublishingStudio\Actions\ValidateWorkspaceSchedulerMetadataAction

Scheduled commands

Capell\PublishingStudio\Manifest\ScheduledPublishingJobContribution (everyMinute; manifest declared)
capell:publishing-studio:prune (manifest declared)

Console command classes

InstallCommand
LoadTestPublishingStudioCommand
PruneAbandonedPublishingStudioCommand

Manifest contributions

admin-page: Capell\PublishingStudio\Manifest\ActivityTrailPageContribution
admin-page: Capell\PublishingStudio\Manifest\PublishingWorkflowPageContribution
admin-page: Capell\PublishingStudio\Manifest\ScheduledPublishingPageContribution
admin-page: Capell\PublishingStudio\Manifest\StaleDraftsPageContribution
admin-resource: Capell\PublishingStudio\Manifest\PublishingStudioAdminResourcesContribution
console-command: Capell\PublishingStudio\Manifest\PublishingStudioConsoleCommandsContribution
dashboard-widget: Capell\PublishingStudio\Manifest\PublishingStudioDashboardFilamentWidgetsContribution
health-check: Capell\PublishingStudio\Manifest\PublishingStudioHealthContribution
migration: Capell\PublishingStudio\Manifest\PublishingStudioMigrationsContribution
model: Capell\PublishingStudio\Manifest\PublishingStudioModelsContribution
overview-stat: Capell\PublishingStudio\Manifest\ContentSchedulerOverviewStatsContribution
route: Capell\PublishingStudio\Manifest\PublishingStudioRoutesContribution
scheduled-job: Capell\PublishingStudio\Manifest\PublishingStudioPruneScheduleContribution
scheduled-job: Capell\PublishingStudio\Manifest\ScheduledPublishingJobContribution
setting: Capell\PublishingStudio\Manifest\PublishingStudioSettingsContribution
workflow-attention: Capell\PublishingStudio\Actions\Workflow\BuildPublishingWorkflowAttentionItemsAction

Health checks

Capell\PublishingStudio\Health\PublishingStudioHealthCheck

Blade views

packages/publishing-studio/resources/views/components/pages/publishing-studio/compare.blade.php
packages/publishing-studio/resources/views/components/publishing-studio/approval-history.blade.php
packages/publishing-studio/resources/views/components/publishing-studio/diff-panel.blade.php
packages/publishing-studio/resources/views/components/publishing-studio/field-comment-thread.blade.php
packages/publishing-studio/resources/views/components/workspace-preview-pill.blade.php
packages/publishing-studio/resources/views/filament/actions/publishing-revisions.blade.php
packages/publishing-studio/resources/views/filament/pages/publishing-workflow.blade.php
packages/publishing-studio/resources/views/filament/resources/pages/revisions-table.blade.php
packages/publishing-studio/resources/views/filament/resources/pages/version-history.blade.php
packages/publishing-studio/resources/views/livewire/editorial-timeline.blade.php
packages/publishing-studio/resources/views/livewire/header/workspace-context-banner.blade.php
packages/publishing-studio/resources/views/livewire/header/workspace-switcher.blade.php
packages/publishing-studio/resources/views/livewire/publish-status-panel.blade.php
packages/publishing-studio/resources/views/livewire/release-workspace-summary-panel.blade.php
packages/publishing-studio/resources/views/widgets/content-scheduler-calendar.blade.php
packages/publishing-studio/resources/views/widgets/workspace-activity.blade.php
packages/publishing-studio/resources/views/widgets/workspace-merge-history.blade.php

Data Model

Required tables: preview_links, workspaces, versions, workspace_approvals, workspace_field_comments, workspace_review_assignments, publishing_revisions, publishing_scheduler_events, publishing_scheduler_deliveries, publishing_scheduler_ical_tokens.
Models: PreviewLink, PublishingRevision, SchedulerDelivery, SchedulerEvent, SchedulerIcalToken, Version, Workspace, WorkspaceApproval, WorkspaceFieldComment, WorkspaceReviewAssignment.
Core record references in migrations: sites via site_id, languages via language_id.
Migration files: 2026_05_10_190866_01_create_preview_links_table.php, 2026_05_10_190866_02_create_publishing-studio_table.php, 2026_05_10_190866_03_create_versions_table.php, 2026_05_10_190866_04_create_workspace_approvals_table.php, 2026_05_10_190866_05_create_workspace_field_comments_table.php, 2026_05_10_190866_06_create_workspace_review_assignments_table.php, 2026_05_10_190866_07_seed_bootstrap_workspace_version.php, 2026_05_10_190866_08_z_add_workspace_columns_to_core_tables.php, 2026_05_10_190866_09_z_add_workspace_id_to_external_tables.php, 2026_05_10_190866_10_z_add_workspace_id_to_import_sessions_table.php, 2026_05_10_190866_11_create_publishing_revisions_table.php, 2026_05_10_190866_12_create_publishing_scheduler_tables.php, 2026_07_10_000003_add_retry_schedule_to_publishing_scheduler_events.php, 2026_07_12_000000_widen_preview_link_token_before_encryption.php, 2026_07_12_000001_protect_preview_link_tokens.php, 2026_07_12_000002_widen_preview_link_token_storage.php, 2026_09_29_120000_remove_implicit_timestamp_updates_from_publishing_studio.php.
Migration impact: run host migrations through the package install flow before opening package surfaces.
Deletion/retention behaviour: migrations declare cascade-on-delete relationships and null-on-delete relationships; retention is scheduled through capell:publishing-studio:prune (declared in the manifest).

Install Impact

Required packages: capell-app/admin, capell-app/core, capell-app/html-cache, capell-app/migration-assistant, capell-app/navigation.
Admin navigation: declares admin-page: ActivityTrailPageContribution, admin-page: PublishingWorkflowPageContribution, admin-page: ScheduledPublishingPageContribution, admin-page: StaleDraftsPageContribution, admin-resource: PublishingStudioAdminResourcesContribution; each Filament page or resource controls its own navigation visibility.
Admin/editor extensions: dashboard-widget: PublishingStudioDashboardFilamentWidgetsContribution, overview-stat: ContentSchedulerOverviewStatsContribution, workflow-attention: BuildPublishingWorkflowAttentionItemsAction.
Permissions: submit_workspace_for_approval, approve_workspace, publish_workspace, rollback_workspace, publish_outside_release_window, View:ActivityTrailPage, View:PublishingWorkflowPage, View:ScheduledPublishingPage, View:StaleDraftsPage; Shield-generated page permissions for Capell\PublishingStudio\Filament\Pages\PublishingWorkflowPage, Capell\PublishingStudio\Filament\Pages\ScheduledPublishingPage, Capell\PublishingStudio\Filament\Pages\StaleDraftsPage (names and grants depend on host Shield configuration); access also governed by package policies: WorkspacePolicy.
Public routes: loads routes/web.php; registers PublishingStudioRoutesContribution.
Database changes: package migrations are declared.
Config: config/publishing-studio.php.
Settings: Capell\PublishingStudio\Settings\PublishingStudioSettings.
Queues or schedules: scheduled commands Capell\PublishingStudio\Manifest\ScheduledPublishingJobContribution (everyMinute; manifest declared), capell:publishing-studio:prune (manifest declared).
Cache tags: none declared.
Commands: capell:publishing-studio-install, capell:publishing-studio:load-test, capell:publishing-studio:prune.

Common Pitfalls

Keep required Capell packages on compatible v4 releases: capell-app/admin, capell-app/core, capell-app/html-cache, capell-app/migration-assistant, capell-app/navigation.
Run migrations before opening package resources or public routes.
Review package configuration before production-like verification: config/publishing-studio.php, Capell\PublishingStudio\Settings\PublishingStudioSettings.
Review middleware, throttling, signatures, and public-output safety in routes/web.php before exposing routes.
Keep the host Laravel scheduler running so package-registered schedules can execute: Capell\PublishingStudio\Manifest\ScheduledPublishingJobContribution (everyMinute; manifest declared), capell:publishing-studio:prune (manifest declared).

Troubleshooting

Symptom	Likely cause	Check	Fix
Package surface is missing after install	Provider or manifest is not loaded	Confirm `capell.json`, package `composer.json`, and provider registration	Reinstall the package, refresh Composer autoload, and clear host caches
Admin screen or command fails on missing table	Package migrations have not run	Check the tables listed in `Data Model`	Run host migrations and rerun the focused package test
Route returns unexpected output	Route cache, middleware, or signed URL setup does not match the package route file	Check the route files listed in `Technical Shape`	Clear route cache and verify middleware before exposing public routes
Background work does not run	Queue worker or declared schedule is not active	Check the jobs and scheduled commands listed in `Technical Shape`	Start the queue worker or host scheduler, then run the focused command or package test

Quick Start

Install the package: composer require capell-app/publishing-studio.
Run the package setup: php artisan capell:publishing-studio-install.
Open the package admin surface at /admin/publishing-studio/preview-links and confirm Publishing Studio is available.

Next Steps

Package docs
Overview
Worked extension examples
Admin guide
Configuration files: config/publishing-studio.php.
Troubleshooting
Screenshot contract
Marketplace assets
Capell content language plan
Capell documentation design system
Capell and package ERD notes
Related packages: Html Cache, Migration Assistant, Navigation, Blog, Campaign Studio, Events, Frontend Authoring, Newsletter.