🚀 Postiz User Guide - Complete Setup & Features

# 🚀 Postiz User Guide - Complete Setup & Features

**Your Postiz Instance**: https://postiz-app-jet.vercel.app  
**Backend API**: https://postiz-backend-fbp3.onrender.com

---

## 🎯 Getting Started

### Step 1: First Login

1. **Visit Your Postiz**:
   ```
   https://postiz-app-jet.vercel.app
   ```

2. **Register Your Account**:
   - Click "Sign Up" or "Register"
   - Enter your email and password
   - Since RESEND email is not configured, you'll be **auto-activated**
   - You'll be logged in automatically

3. **Dashboard Overview**:
   - After login, you'll see the main dashboard
   - Left sidebar: Navigation menu
   - Main area: Your posts and calendar
   - Top right: Account settings

---

## 🔗 Connecting Social Media Accounts

### Supported Platforms (14+):

✅ **Currently Supported**:
1. **X (Twitter)** - Posts, threads, media
2. **LinkedIn** - Personal & Company pages
3. **Facebook** - Pages & Groups
4. **Instagram** - Feed posts, stories
5. **YouTube** - Videos, shorts
6. **TikTok** - Videos
7. **Pinterest** - Pins, boards
8. **Reddit** - Posts to subreddits
9. **Threads** - Meta's Twitter alternative
10. **Bluesky** - Decentralized social
11. **Mastodon** - Fediverse
12. **Discord** - Channels via webhooks
13. **Slack** - Channels via webhooks
14. **Dribbble** - Design posts

### How to Connect an Account:

#### Method 1: Via Dashboard

1. **Go to Integrations**:
   - Click "Integrations" in left sidebar
   - Or visit: `https://postiz-app-jet.vercel.app/integrations`

2. **Select Platform**:
   - Click on the social media icon you want to connect
   - Example: Click "X (Twitter)"

3. **Authenticate**:
   - You'll be redirected to the platform's OAuth page
   - Login to your social media account
   - Authorize Postiz to post on your behalf

4. **Confirmation**:
   - You'll be redirected back to Postiz
   - The account will appear in your integrations list
   - Green checkmark = connected successfully

#### Setting Up Social Media API Keys (Required First!)

Before connecting accounts, you need to add API keys to your Render backend:

**For X (Twitter)**:
1. Go to: https://developer.twitter.com/en/portal/dashboard
2. Create an app and get API Key & Secret
3. Add to Render Environment:
   ```
   X_API_KEY=your-key-here
   X_API_SECRET=your-secret-here
   ```

**For LinkedIn**:
1. Go to: https://www.linkedin.com/developers/apps
2. Create an app and get Client ID & Secret
3. Add to Render:
   ```
   LINKEDIN_CLIENT_ID=your-client-id
   LINKEDIN_CLIENT_SECRET=your-secret
   ```

**For other platforms**: See `SOCIAL_MEDIA_SETUP.md` in your project folder

---

## ✨ Key Features

### 1. **Post Scheduling** 📅

**Schedule Single Posts**:
- Click "Create Post" or "+" button
- Write your content
- Add media (images, videos)
- Select platforms to post to
- Choose date/time or "Post Now"
- Click "Schedule"

**Best Times Feature**:
- AI suggests optimal posting times
- Based on your audience engagement
- Maximizes reach and interactions

### 2. **Multi-Platform Posting** 🌐

**Cross-Post to Multiple Platforms**:
- Write once, post everywhere
- Select multiple platforms in post composer
- Platform-specific optimizations:
  - X: Thread support, character limits
  - Instagram: Hashtag optimization
  - LinkedIn: Professional formatting

**Platform Customization**:
- Customize content per platform
- Different images for different networks
- Platform-specific hashtags

### 3. **Content Calendar** 📆

**Visual Schedule Management**:
- See all scheduled posts in calendar view
- Drag & drop to reschedule
- Color-coded by platform
- Week/Month views

**Bulk Actions**:
- Select multiple posts
- Reschedule in bulk
- Delete or duplicate posts

### 4. **AI Content Assistant** 🤖

**AI-Powered Features**:
- **Content Generation**: Generate post ideas
- **Hashtag Suggestions**: Relevant hashtags for your niche
- **Caption Writing**: AI writes engaging captions
- **Image Generation**: Create images with AI (if configured)

**Using AI Assistant**:
- Click the ✨ AI button in post composer
- Select "Generate Content"
- Provide a topic or keywords
- AI generates suggestions
- Edit and customize

### 5. **Thread Creator** 🧵

**Create Twitter/X Threads**:
- Click "Create Thread" in post composer
- Add multiple tweet cards
- Reorder tweets with drag & drop
- Preview before scheduling
- Auto-numbering (1/5, 2/5, etc.)

### 6. **Media Management** 📸

**Upload & Manage Media**:
- Drag & drop images/videos
- Supports: JPG, PNG, GIF, MP4
- Image editing tools:
  - Crop, resize, rotate
  - Filters and adjustments
  - Text overlays

**Media Library**:
- Store frequently used media
- Organize in folders
- Quick access for reuse

### 7. **Analytics & Insights** 📊

**Track Performance**:
- Views, likes, shares, comments
- Engagement rate
- Best performing posts
- Platform comparison

**Reports**:
- Daily/Weekly/Monthly reports
- Export to PDF/CSV
- Custom date ranges

### 8. **Team Collaboration** 👥

**Multi-User Support**:
- Invite team members
- Role-based permissions:
  - **Admin**: Full access
  - **Editor**: Create & schedule posts
  - **Viewer**: View only

**Collaboration Features**:
- Internal comments on posts
- Approval workflows
- Activity log

### 9. **RSS Feed Integration** 📰

**Auto-Post from RSS**:
- Add RSS feed URLs
- Auto-schedule new articles
- Customize post format
- Set posting frequency

### 10. **URL Shortener** 🔗

**Built-in Link Shortening**:
- Shorten long URLs
- Track click-through rates
- Custom branded short links
- Integration with bit.ly, TinyURL

### 11. **Post Templates** 📝

**Reusable Content**:
- Save frequently used formats
- Quick template selection
- Variables for dynamic content
- Time-saving for recurring posts

### 12. **Hashtag Manager** #️⃣

**Organize Hashtags**:
- Create hashtag groups
- Save hashtag sets by topic
- One-click hashtag insertion
- Popular hashtag suggestions

### 13. **Best Time to Post** ⏰

**Optimal Scheduling**:
- AI analyzes your audience
- Suggests best posting times
- Platform-specific recommendations
- Timezone-aware

### 14. **Bulk Upload** 📤

**Mass Scheduling**:
- Upload CSV with posts
- Schedule multiple posts at once
- Batch processing
- Error handling & validation

---

## 🎨 Pro Tips & Best Practices

### Content Strategy

1. **Mix Content Types**:
   - 40% educational
   - 30% entertaining
   - 20% promotional
   - 10% personal

2. **Posting Frequency**:
   - X/Twitter: 3-5 times/day
   - LinkedIn: 1-2 times/day
   - Instagram: 1-2 times/day
   - Facebook: 1-2 times/day

3. **Best Times** (General):
   - B2C: 12pm-1pm, 5pm-6pm
   - B2B: 8am-10am, 12pm-1pm
   - Weekends: 9am-11am

### Engagement Tactics

1. **Use Questions**: Increase engagement
2. **Add CTAs**: Call-to-action in every post
3. **Visual Content**: Posts with images get 2x engagement
4. **Hashtags**: 3-5 relevant hashtags optimal
5. **Respond Quickly**: Reply to comments within 1 hour

### Productivity Hacks

1. **Batch Content**: Create a week's content in one session
2. **Use Templates**: Save time with reusable formats
3. **Schedule Ahead**: Always have 7 days queued
4. **Analyze & Optimize**: Review analytics weekly
5. **Repurpose Content**: Same content, different formats

---

## 🔧 Advanced Settings

### User Settings
- Profile information
- Notification preferences
- Timezone settings
- Language selection

### Organization Settings
- Team member management
- Billing & subscription
- API access keys
- Webhook integrations

### Integration Settings
- Connected accounts
- OAuth tokens
- Permissions management
- Reconnect accounts

---

## 🆘 Troubleshooting

### Common Issues

**Account Won't Connect**:
- Check API keys in Render environment variables
- Verify OAuth redirect URLs
- Re-authorize the connection
- Check platform API status

**Posts Not Publishing**:
- Verify account is still connected
- Check platform posting limits
- Verify media file sizes
- Review error logs in dashboard

**Media Upload Fails**:
- Check Cloudflare R2 is configured
- Verify file size (max 50MB)
- Check file format support
- Review browser console errors

**Analytics Not Showing**:
- Wait 24 hours for initial data
- Verify account permissions
- Check platform API access
- Refresh the page

---

## 📚 Additional Resources

### Documentation
- **Official Docs**: https://docs.postiz.com
- **API Reference**: https://docs.postiz.com/public-api
- **Video Tutorials**: https://youtube.com/@postizofficial

### Community
- **Discord**: https://discord.postiz.com
- **GitHub Issues**: https://github.com/gitroomhq/postiz-app/issues

### Updates
- **Changelog**: Check GitHub releases
- **Feature Requests**: Submit via GitHub discussions
- **Roadmap**: See project board

---

## 🎯 Quick Start Checklist

- [ ] Register account at https://postiz-app-jet.vercel.app
- [ ] Add social media API keys to Render
- [ ] Connect your first social media account
- [ ] Create your first post
- [ ] Schedule posts for the week
- [ ] Set up analytics tracking
- [ ] Invite team members (optional)
- [ ] Configure notification preferences
- [ ] Create post templates
- [ ] Set up RSS feeds (optional)

---

## 💡 Need Help?

**Your Instance URLs**:
- Frontend: https://postiz-app-jet.vercel.app
- Backend: https://postiz-backend-fbp3.onrender.com
- Render Dashboard: https://dashboard.render.com
- Vercel Dashboard: https://vercel.com/xyakuzapro8s-projects/postiz-app

**Support**:
- Check `DEPLOYMENT_STATUS.md` for deployment issues
- Check `SOCIAL_MEDIA_SETUP.md` for API setup
- Visit Postiz Discord for community help
- Check GitHub for bug reports

---

**Enjoy your fully deployed Postiz instance! 🚀**