Documentation

Campaigns

Campaigns let you group related posts around a theme, product launch, event, or goal. They help you plan content in batches, track progress, and keep everything organized.

Campaigns let you group related posts around a theme, product
launch, event, or goal. They help you plan content in batches,
track progress, and keep everything organized.

Click "Campaigns" under Content in the sidebar, or navigate
to /campaigns.

Desktop: A sidebar on the left lists all campaigns. The right
panel shows the selected campaign's details.

Mobile: You see either the campaign list or the detail view,
with a back button to return to the list.

1. Click "+ New" in the sidebar header.
2. Fill in the form:
   - Campaign Name (required)
   - Description
   - Goals / KPIs
   - Start and end dates
   - Number of planned content pieces (a recommendation is
     calculated based on your date range)
   - Initial status
3. Click "Create" to save.

The recommendation system suggests how many posts to plan:
  - 7 days or less: ~4 posts/week
  - Up to 30 days: ~3.5 posts/week
  - Up to 90 days: ~3 posts/week
  - Over 90 days: ~2.5 posts/week

You can use the recommended count or adjust manually with the
spinner control.

1. Click "From Events" in the sidebar header.
2. Select one or more events from the checklist (upcoming and
   past events are listed separately).
3. A campaign is created with:
   - Name generated from selected event titles
   - Date range pulled from the events
   - Events automatically linked

When you select a campaign, the detail panel shows:

HEADER
  - Editable campaign name (click to edit, saves on blur)
  - Status dropdown: Planning, Active, Completed, Paused
  - Delete button with two-step confirmation

METADATA
  - Start and end date pickers
  - Stats tiles: Total Posts, Published, Remaining, Events
  - Progress bar with completion percentage

DESCRIPTION
  - Editable text area for campaign description (saves on blur)

GOALS / KPIs
  - Editable text area for goals
  - Quick-add suggestion tags below:
    Grow Followers, Boost Engagement, Drive Traffic, Launch Product,
    Build Awareness, Generate Leads, and more
  - Click a tag to add it; already-added tags are highlighted

LINKED EVENTS
  - Shows cards for each linked event with icon, title, date,
    and event type
  - Click the X to unlink an event
  - Click "+ Link Events" to open the event picker and add more

ASSIGNED POSTS
  - Shows all posts assigned to this campaign
  - Each post row displays: status dot, title, date badge,
    platform icons, status text
  - Actions per post:
    - Post: Copy caption and mark as posted (if eligible)
    - Suggest Date: AI finds the best date based on gaps in
      your campaign schedule
    - Edit: Open the Post Wizard to edit the post
    - Unassign: Remove the post from this campaign
  - "+ Assign" to add existing posts
  - "+ New Post" to create a new post pre-filled with the
    campaign name
  - "Clear Dates" to unschedule all posts for manual placement

CAMPAIGN CALENDAR
  - Mini calendar showing the campaign's date range
  - Unscheduled posts appear in a shelf above the calendar
    (dashed border, draggable)
  - Planned items appear in a separate shelf (accent border)
  - Drag posts or planned items onto calendar dates to schedule
  - On mobile, tap an item to select it, then tap a date to
    assign it
  - Out-of-range dates are faded
  - Existing posts appear as chips on their scheduled dates

PLANNED CONTENT
  - A list of planned content items for the campaign
  - Each item has: editable title, content type badge, category,
    description preview, tags, and status
  - Click "Create Post" on any unscheduled item to open the
    Post Wizard pre-filled with that item's details
  - Click the X to delete a planned item
  - Click "+ Add" to create a new blank planned item

EMAIL CAMPAIGN
  - Generate an email series tied to the campaign
  - Configure: Number of emails (2-12) and cadence (even spread,
    front-loaded, back-loaded, weekly, 2x per week)
  - Click "Generate Email Series" and wait for AI to create them
  - Each email shows: send date, subject, preview text, body
    preview, and CTA
  - Edit any email inline (date, subject, preview, body, CTA)
  - Copy All: copies all emails to clipboard
  - Regenerate: clears and creates a new series

CAMPAIGN IDEAS
  - Click "Generate 10 Campaign Ideas" to get AI-powered content
    suggestions tailored to the campaign's goals
  - Each idea shows: content type icon, title, description
  - Click "Create" on any idea to open the Post Wizard pre-filled

When you click "Suggest Date" on an unassigned post:
1. The algorithm looks at all existing post dates within the
   campaign range.
2. It finds the largest gap between posts.
3. It places the new post at the midpoint of that gap.
4. You are asked to confirm before the date is assigned.

  Planning   -- Campaign is being set up
  Active     -- Campaign is running
  Completed  -- Campaign has finished
  Paused     -- Campaign is on hold

- Use planned content items to sketch out your campaign before
  creating actual posts. Drag them onto the calendar when ready.
- The AI date suggestion saves time when you have many posts to
  schedule -- it evenly spaces them across your campaign range.
- Link events to campaigns to keep product launches, holidays,
  and deadlines visible alongside your content.
- Generate campaign ideas when you need inspiration. The AI uses
  your brand profile and campaign goals to create relevant
  suggestions.
- The email series generator creates a complete email campaign
  with subject lines, preview text, and body copy in one click.

- 05-posts.txt (creating and editing individual posts)
- 06-content-calendar.txt (calendar view of all content)
- 10-emails.txt (managing individual emails)