Skip to main content

User Guide

Complete guide to using AI content reporpuser for creating optimized social media content.

Table of Contents​

Getting Started​

Opening the Application​

After installation, launch the app:

Linux:

./build/linux/x64/release/bundle/ai_content_repurposer

macOS:

open build/macos/Build/Products/Release/ai_content_repurposer.app

Windows:

.\build\windows\runner\Release\ai_content_repurposer.exe

Or for development:

flutter run -d linux  # or your platform

First-Time Setup​

  1. Open Settings (gear icon in sidebar)
  2. Configure Backend URL
    • Default: http://localhost:3000
    • For remote: http://your-server:3000
  3. Click "Test Connection"
    • Should show "Active" with provider info
  4. Set Default Preferences
    • Choose default tone
    • Select favorite platforms
    • Enable/disable features

Creating Content​

Method 1: Text Input​

  1. Click "Create" in sidebar (if not already there)
  2. Select "Text" input mode
  3. Enter or paste your content
    • Can be article, blog post, or any text
    • No strict length limit (but be reasonable)
  4. Choose Tone
    • Professional: Formal, business-appropriate
    • Casual: Relaxed, conversational
    • Friendly: Warm, approachable
    • Formal: Very professional, academic
    • Humorous: Fun, lighthearted
    • Inspirational: Motivational, uplifting
  5. Select Platforms
    • Twitter (280 chars)
    • LinkedIn (3000 chars)
    • Facebook (63,206 chars)
    • Instagram (2,200 chars)
    • TikTok (2,200 chars)
    • YouTube (5,000 chars)
    • Pinterest (500 chars)
    • Reddit (40,000 chars)
    • Medium (unlimited)
    • Blog (unlimited)
  6. Enable "Include Key Points" (optional)
    • Adds 3-5 bullet points summarizing content
  7. Click "Generate"

Method 2: URL Input​

  1. Select "URL" input mode
  2. Paste a URL
    • Must start with http:// or https://
    • Works with: articles, blogs, news, documentation
  3. Follow same steps as text input above

The system will:

  • Fetch the webpage
  • Extract main content
  • Clean formatting
  • Generate for selected platforms

Understanding Generation​

What happens during generation:

  1. Content Analysis (2-5 seconds)

    • System analyzes your input
    • Identifies key themes
    • Determines content type

  2. Platform Adaptation (5-15 seconds per platform)

    • Rewrites for each platform
    • Applies character limits
    • Adds hashtags (if enabled)
    • Optimizes formatting

  3. Results Display

    • Shows all platform versions
    • Indicates success/failure per platform
    • Displays metadata (char count, hashtags, etc.)

Generation Logs:

Watch the log panel for progress:

✓ Starting content generation...
✓ Generating for 3 platform(s)...
✓ Generation complete: 3/3 successful
✓ Saving generation to server...
✓ Generation saved successfully

Managing Results​

Viewing Results​

Each platform card shows:

  • Platform logo and name
  • Status (Generated/Failed)
  • Generated content (fully selectable)
  • Metadata:
    • Character count with limit
    • Word count
    • Hashtags used
  • Action buttons:
    • Copy: Copy to clipboard
    • Share: System share dialog
    • Regenerate: Create new version

Copying Content​

Method 1: Copy Button

  1. Click the copy icon on platform card
  2. Content copied to clipboard
  3. Paste anywhere (Ctrl+V / Cmd+V)

Method 2: Text Selection

  1. Select text directly in the content box
  2. Right-click → Copy
  3. Or use Ctrl+C / Cmd+C

Regenerating Content​

If you're not happy with a result:

  1. Click the refresh icon on that platform card
  2. Watch for regeneration:
    • Button becomes loading spinner
    • Logs show progress
    • New content appears when done
  3. Original settings maintained (same tone, input)

Logs during regeneration:

✓ Starting regeneration for twitter...
✓ Generating new content for twitter...
✓ twitter regenerated successfully

Sharing Content​

Direct Share:

  1. Click share icon on platform card
  2. Choose app from system dialog
  3. Content is pasted into that app

Manual Share:

  1. Copy content
  2. Open target app/website
  3. Paste and post

History & Organization​

Viewing History​

  1. Click "History" in sidebar
  2. See all past generations
    • Newest first
    • Shows metadata for each
  3. View details:
    • Created date & time
    • Number of platforms
    • Tone used
    • Key points on/off
    • Success/failure status

History Metadata​

Each history entry shows:

  • 📅 Created: 2025-12-18 14:30
  • 🎯 Platforms: 3
  • 🎵 Tone: professional
  • 📝 Key points: On

Restoring Previous Generation​

  1. Find generation in history
  2. Click "View" button
  3. Returns to Create view with those results
  4. Can copy, share, or regenerate from there

Clearing History​

History is stored server-side (if Firebase configured) or locally. Currently no UI to clear specific items, but:

  • History automatically fetches on open
  • Limit can be configured server-side
  • Data can be cleared from Firebase console

Settings & Customization​

Backend Configuration​

API URL:

  • Set where backend is running
  • Default: http://localhost:3000
  • For remote: Use server IP/domain
  • Test Connection verifies it's working

Provider Info:

  • Shows AI provider (e.g., OpenAI)
  • Displays model being used
  • Shows capabilities
  • Indicates connection status

Default Settings​

Default Tone:

  • Pre-selects tone for new generations
  • Saves time on repeated use
  • Can override per generation

Default Platforms:

  • Pre-checks your favorite platforms
  • Speeds up workflow
  • Can modify each time

Content Rules​

Show character limit warnings:

  • Enables/disables warnings when near limit
  • Useful to stay within platform constraints

Enable hashtags:

  • Controls whether AI adds hashtags
  • Platform-appropriate hashtags
  • Can be edited after generation

History & Privacy​

Save generation history:

  • Stores generations locally
  • Syncs with server if Firebase configured
  • Disable for privacy

Appearance​

Dark mode:

  • Toggle between light/dark theme
  • Persists across sessions
  • Applied immediately

Saving Settings​

Important: Click "Save Settings" button at bottom after making changes!

Settings are stored locally and persist across app restarts.

Tips & Best Practices​

Content Input Tips​

For Best Results:

  1. Provide clear, well-written input

    • Grammar matters
    • Clear structure helps
    • Complete thoughts work better

  2. Length Guidelines:

    • Minimum: 100 words
    • Optimal: 200-500 words
    • Maximum: 2000 words (technically unlimited)

  3. Use URLs for:

    • Long articles
    • Complex formatting
    • External content you don't want to copy/paste

Platform Selection Tips​

Choose platforms based on:

  • Your actual social media presence
  • Content type (professional vs casual)
  • Audience differences

Common Combinations:

  • Business: LinkedIn + Twitter + Facebook
  • Personal Brand: Twitter + LinkedIn + Instagram
  • Content Creator: Instagram + TikTok + YouTube
  • Blogger: Medium + Twitter + LinkedIn

Tone Selection Tips​

ToneBest ForAvoid For
ProfessionalBusiness, B2B, CorporatePersonal stories, entertainment
CasualPersonal brand, Gen Z audienceLegal, medical, finance
FriendlyCustomer service, communitySerious topics, crisis communication
FormalAcademia, legal, governmentSocial media, youth marketing
HumorousEntertainment, lifestyleSerious topics, sensitive issues
InspirationalMotivation, coaching, personal growthTechnical, analytical content

Key Points Feature​

When to enable:

  • Long-form content (500+ words)
  • Complex topics
  • Educational content
  • Professional audiences

When to skip:

  • Short announcements
  • Personal updates
  • Already brief content

Workflow Optimization​

Fast Generation Flow:

  1. Set default tone + platforms in Settings
  2. Use text input for speed
  3. Generate → Review → Copy → Done

Quality-Focused Flow:

  1. Draft content externally
  2. Refine before input
  3. Generate one platform at a time
  4. Regenerate until perfect

Error Handling​

If generation fails:

  1. Check backend is running
  2. Verify API key is valid
  3. Check internet connection
  4. Try regenerating specific platform
  5. Check logs for specific error

Common errors:

  • "Network error": Backend not reachable
  • "API key invalid": Check backend .env
  • "Rate limit": Wait and try again

Performance Tips​

For faster generation:

  • Select fewer platforms at once
  • Use shorter input content
  • Ensure good internet connection
  • Backend on same machine = faster

For better quality:

  • Provide more context in input
  • Use appropriate tone
  • Let AI add hashtags
  • Review and regenerate if needed

Keyboard Shortcuts​

Currently, the app doesn't have custom shortcuts, but you can use:

  • Ctrl+C / Cmd+C: Copy selected text
  • Ctrl+V / Cmd+V: Paste
  • Ctrl+A / Cmd+A: Select all in text field

Troubleshooting​

Can't Generate Content​

  1. Check Settings → Test Connection
  2. Verify backend is running: curl http://localhost:3000/health
  3. Check backend logs for errors
  4. Restart backend if needed

Content Quality Issues​

  1. Try different tone
  2. Provide more detailed input
  3. Use regenerate button
  4. Check if prompt is clear and specific

Missing Features​

Some features may require:

  • Backend restart after config changes
  • Firebase setup for history persistence
  • Specific platform credentials

Need More Help?​

Ready to create? Start with simple text input and experiment!