# PostOracle

> AI-powered LinkedIn automation platform that helps professionals grow their presence effortlessly. Automatically researches trending topics, creates engaging posts matching your voice, schedules content for optimal engagement, and provides analytics to optimize your strategy.

PostOracle is a comprehensive LinkedIn content automation tool designed to save professionals 10+ hours per week on content creation. The platform uses advanced AI to understand your niche, research trending topics, generate authentic posts that match your unique voice, and schedule them automatically. Whether you're a job seeker, entrepreneur, thought leader, or B2B professional, PostOracle adapts to your purpose and helps you maintain a consistent, engaging LinkedIn presence.

## Key Features

- [AI Content Generation](https://postoracle.com/): Research-driven content creation that discovers trending topics in your niche and generates posts matching your unique voice and expertise level
- [Smart Scheduling](https://postoracle.com/scheduled-posts): Set-and-forget automation with visual content calendar showing your entire pipeline at a glance
- [Purpose-Driven Strategy](https://postoracle.com/profile-insights): Choose from 9 purpose types (job seeker, personal brand, B2B lead gen, networker, creator, recruiter, thought leader, entrepreneur, learner) with tailored content recommendations
- [Profile Insights](https://postoracle.com/profile-insights): Import LinkedIn data to analyze your profile, understand your audience, and get personalized content recommendations
- [Post Analytics](https://postoracle.com/): Track performance metrics including engagement rates, impressions, profile views, and identify winning content patterns
- [Automation Preferences](https://postoracle.com/automations): Configure posting frequency, content formats, approval modes (full automation, smart approval, or manual review), and niche targeting
- [LinkedIn Integration](https://postoracle.com/): Secure OAuth connection to LinkedIn with optional data import for enhanced personalization

## Getting Started

- [Landing Page](https://postoracle.com/): Overview of features, pricing, FAQ, and how it works
- [Login Page](https://postoracle.com/login): Sign up or sign in to get started (no credit card required for free plan)
- [Quick Post Creation](https://postoracle.com/quick-post): Step-by-step wizard to create and publish posts immediately with AI assistance
- [Automation Setup](https://postoracle.com/automations): Configure your content strategy, posting preferences, and automation settings

## User Workflows

### For New Users
1. Sign up at `/login` (free plan available, no credit card required)
2. Connect LinkedIn account via secure OAuth
3. Optional: Import LinkedIn profile data for enhanced personalization
4. Set your purpose (job seeker, entrepreneur, etc.) to get tailored recommendations
5. Configure automation preferences (niche, posting frequency, content formats)
6. Let AI generate and schedule posts automatically

### For Content Creation
- Use `/quick-post` for immediate post creation with AI assistance
- Select trending topics from your niche
- Choose content format (story, tip, question, etc.)
- Preview and edit before publishing
- Schedule for optimal times or publish immediately

### For Management
- View all scheduled posts at `/scheduled-posts`
- Monitor profile insights and analytics at `/profile-insights`
- Adjust automation preferences at `/automations`
- Manage subscription at `/subscription`

## Technical Architecture

- **Frontend**: React 18 with TypeScript, Vite build system
- **Styling**: Tailwind CSS with custom UI components
- **Authentication**: Supabase Auth with LinkedIn OAuth integration
- **Routing**: React Router DOM with protected routes
- **State Management**: React hooks and context
- **API Integration**: RESTful API for posts, scheduling, analytics, and preferences

## Content Types & Formats

PostOracle supports various content formats optimized for LinkedIn:
- Story-based posts (personal experiences and narratives)
- Tips and advice posts
- Question-based engagement posts
- Industry insights and analysis
- Thought leadership pieces
- Educational content
- Behind-the-scenes content

## Purpose Types

The platform supports 9 distinct purpose types, each with optimized settings:
- **Job Seeker**: Focus on showcasing skills and attracting recruiters
- **Personal Brand**: Build authority and thought leadership
- **B2B Lead Gen**: Generate business leads and connections
- **Networker**: Expand professional network and relationships
- **Creator**: Share creative work and build audience
- **Recruiter**: Attract top talent and showcase opportunities
- **Thought Leader**: Share insights and influence industry conversations
- **Entrepreneur**: Build business presence and attract customers
- **Learner**: Share learning journey and connect with educators

## Pricing & Plans

- **Free Plan**: Basic post scheduling, limited posts per month, community support, basic analytics
- **Pro Plan ($29/month)**: Unlimited scheduling, priority publishing, advanced analytics, AI content suggestions, advanced automation, priority support

## Legal & Policies

- [Privacy Policy](https://postoracle.com/privacy-policy.html): How user data is collected, used, and protected
- [Terms of Service](https://postoracle.com/terms-and-conditions.html): Legal terms governing platform usage
- [Return and Refund Policy](https://postoracle.com/return-and-refund.html): Cancellation and refund information

## API & Integration

PostOracle provides RESTful API endpoints for:
- Post creation and publishing
- Scheduling management
- Analytics and performance data
- Profile insights and LinkedIn data import
- User preferences and automation settings
- Subscription management

Authentication is handled via Supabase Auth tokens. All API requests require valid authentication tokens.

## Best Practices

1. **Complete Profile Setup**: Import LinkedIn data and set your purpose for best results
2. **Define Your Niche**: Be specific about your industry and target audience
3. **Review Before Publishing**: Use smart approval mode initially to learn what works
4. **Monitor Analytics**: Regularly check profile insights to understand what resonates
5. **Adjust Strategy**: Update preferences based on performance data
6. **Maintain Consistency**: Use automation to post regularly without manual effort

## Support & Resources

- FAQ section available on landing page
- Community support for free plan users
- Priority support for Pro plan subscribers
- Cancel anytime with no long-term contracts
- Data exportable for scheduled posts

## Optional

- [Sitemap](https://postoracle.com/sitemap.xml): Complete site structure and URLs
- [Robots.txt](https://postoracle.com/robots.txt): Crawler directives and sitemap reference