Skip to main content

User Flow

This diagram shows the complete journey from content creation to publishing.

Flow Diagram​

Process Steps​

1. Content Creation​

  • Author creates a new branch or checks out an existing one
  • Writes content in Markdown with YAML frontmatter
  • Chooses single-platform or cross-platform publishing
  • Adds media assets as needed

2. Validation​

  • Opening a PR triggers automated validation
  • Validates frontmatter schema, platform rules, and media constraints
  • Reports any errors back to the author

3. Review​

  • Generates preview for reviewers
  • Reviewers can request changes or approve
  • Iterative feedback loop until approved

4. Scheduling​

  • After merge, content is either queued immediately or scheduled
  • Schedule is parsed from frontmatter
  • Queue manager handles timing

5. Publishing​

  • Platform adapters handle the actual publishing
  • Automatic retry with exponential backoff on failure
  • Results are recorded

6. Notifications​

  • Success or failure notifications sent via configured channels
  • Status updated in the repository