# Makrly - Complete Product Documentation for AI

> Turn GitHub commits into social media content. Build in public, automatically.

## Product Overview

Makrly is a SaaS tool designed for developers and indie hackers who want to "build in public" - the practice of sharing your development journey on social media as you build your product. Instead of manually writing posts about what you're working on, Makrly automatically generates engaging social media content from your GitHub commits.

## The Problem Makrly Solves

Building in public is proven to help developers:
- Grow an audience before launching
- Get early feedback on their products
- Build credibility and trust
- Create marketing momentum organically

However, consistently posting about your work is time-consuming. Many developers start strong but eventually stop because writing posts takes away from actual coding time. Makrly solves this by automating the content creation process.

## How It Works

1. **Connect GitHub**: Sign in with GitHub and select repositories to track
2. **Configure Preferences**: Take a personality quiz to set your tone of voice
3. **Push Code**: Continue working as normal - push commits to GitHub
4. **Get Posts**: Makrly generates platform-specific posts from your commits
5. **Review & Post**: Approve or edit posts before publishing

## Detailed Features

### Multi-Platform Post Generation
- Generates unique posts for each platform (not just copy-paste)
- X (Twitter): Short, punchy, optimized for engagement
- LinkedIn: Professional tone, longer format
- Threads: Casual, conversational
- Bluesky: Community-focused
- Facebook: Accessible to non-technical audiences

### AI-Powered Content
- Uses LLMs to understand commit context
- Filters out mundane commits (typos, formatting)
- Highlights meaningful changes
- Writes in your voice, not generic AI speak
- Supports multiple AI providers: OpenAI, Claude (Anthropic), Gemini (Google), and 40+ models through OpenRouter and Straico

### Brand Voice Customization
- Personality quiz determines your tone
- Options: Professional, Casual, Humorous, Technical, Inspirational
- Remembers your style across all posts
- Consistent voice without manual editing

### Design Maker
Built-in graphics tool for creating:
- **Quote Cards**: Turn your best insights into shareable images
- **Code Snippets**: Syntax-highlighted code with customizable themes
- **Browser Mockups**: Product screenshots in device frames

No design skills or external tools needed. All processing happens in-browser for privacy.

### Changelog System
- Auto-generates changelog entries from commits
- Categories: New, Improved, Fixed, Removed (customizable)
- Public changelog page with unique URL
- Embeddable widget for your website
- Shows users you're actively shipping

### Bring Your Own API Key
- Use your own OpenAI, Anthropic, or other API keys
- Full control over which AI model generates your posts
- No lock-in to our AI provider
- Transparent about AI usage

## Technical Details

### GitHub Integration
- OAuth-based authentication
- Read-only repository access
- Reads only: commit messages, diffs, author info
- Cannot: modify code, create branches, access secrets
- Webhook-based for real-time updates

### Security & Privacy
- Read-only GitHub permissions
- API keys encrypted at rest
- No source code storage
- GDPR compliant
- Data deletion on request
- SOC 2 compliance in progress

### Tech Stack
- Next.js 14 (React)
- PostgreSQL (Neon)
- Prisma ORM
- Vercel hosting
- Stripe payments

## Pricing Tiers

### Free Tier
- 1 repository
- 50 AI-generated posts/month
- Basic templates
- Community support

### Pro Tier
- Unlimited repositories
- Unlimited posts
- All AI models
- Priority support
- Custom branding

### Team Tier
- Everything in Pro
- Multiple team members
- Organization-wide settings
- Analytics dashboard

### Lifetime Deal
- Occasionally available
- One-time payment
- Perpetual access to purchased tier
- All future updates included

## Use Cases

### Indie Hacker Launch
Sarah is building a productivity app. She connects Makrly and shares her progress daily. By launch day, she has 2,000 followers interested in her product.

### Open Source Maintainer
Alex maintains a popular library. Makrly generates changelog entries and social posts for each release, keeping the community informed without manual effort.

### 100 Days of Code
Jordan is learning to code publicly. Makrly turns their daily practice commits into encouraging posts that track their journey.

### SaaS Marketing
A startup uses Makrly to show potential customers they're actively developing. The public changelog builds trust with enterprise buyers.

## Comparisons

### vs. Buffer/Hootsuite
- Those are scheduling tools, not content generators
- Makrly creates the content; you could use Buffer to schedule it
- Makrly is developer-focused with GitHub integration

### vs. Writing Posts Manually
- Makrly saves 10+ hours per week
- Consistent posting even when you're busy
- Platform-optimized formatting

### vs. ChatGPT
- Makrly is automated (no manual prompting)
- Integrated with your workflow
- Maintains your voice across posts
- Handles multi-platform formatting

## Company Information

- Founded: 2024
- Headquarters: Remote-first
- Contact: hello@makrly.com
- Twitter/X: @makaboriyy

## Links

- Website: https://makrly.com
- Features: https://makrly.com/features
- Privacy Policy: https://makrly.com/privacy
- Terms of Service: https://makrly.com/terms
- Documentation: https://makrly.com (in-app)

## Keywords

build in public, github to twitter, github to social media, commit to post, developer social media, indie hacker tools, twitter automation, linkedin automation, social media automation for developers, developer marketing, saas marketing, 100daysofcode, coding journey, developer content, ai social media generator, automated social posts, developer audience building, changelog generator, public changelog, embeddable changelog widget