What is build in public and why should I do it?

Building in public means sharing your development journey on social media as you build your product. It helps you grow an audience, get early feedback, build credibility, and create marketing momentum before you even launch.

How does Makrly generate posts from my commits?

When you push code to GitHub, Makrly reads your commit messages and code changes. Our AI analyzes what you built, filters out mundane commits, and generates engaging social media posts tailored for each platform.

Is my code safe? What permissions do you need?

Yes, your code is safe. We only request read-only access to your repositories. We can't modify your code, create branches, or make any changes. We only read commit messages and diffs to understand what you're building.

Can I use my own AI API key?

Yes! You can bring your own API key from OpenAI, Anthropic Claude, Google Gemini, or other providers through OpenRouter. This gives you full control over which AI model generates your posts.

Which platforms are supported?

Currently, Makrly generates posts optimized for X (Twitter), LinkedIn, and Facebook. Each platform gets a different version tailored to its audience and format.

What does 'bring your own API key' mean and why do I need it?

Makrly allows you to connect your own AI provider API key (OpenAI, OpenRouter, Straico) to: - Choose from 40+ AI models including GPT-4o, Claude, Llama - Control usage and billing independently - Avoid vendor lock-in with Makrly's AI - Pay per post at your own rates Set your key in dashboard under Settings → API to enable AI-powered post generation.

How do I obtain an OpenAI API key for Makrly?

To get an OpenAI API key: 1. Visit https://platform.openai.com/signup and create an account. 2. Complete identity verification if required. 3. Navigate to the API keys section. 4. Generate a new secret key. 5. Copy the key and paste it into Makrly dashboard under Settings → API. This enables AI content generation using OpenAI models via Makrly.

Why is my AI API key showing as invalid in Makrly?

If your API key is invalid: - Verify you entered the full key correctly with no extra spaces. - Confirm the key is active and has required permissions on your AI provider's dashboard. - Ensure you are using supported providers: OpenAI, OpenRouter, or Straico. - Check that the key prefix matches expected format (e.g., OpenAI keys usually start with `sk-`). - If the problem persists, regenerate a key or contact Makrly support.

How do I export my data from Makrly?

To export your data: 1. Go to Settings → Data in your dashboard. 2. Request a data export. 3. You will receive a download link via email within 24 hours. This includes your posts, changelogs, and account-related information for backup or migration.

How do I delete my Makrly account?

To delete your account: 1. Navigate to Settings → Account in your dashboard. 2. Choose the delete account option. 3. Confirm the deletion. All your personal data, repositories, and generated content will be permanently removed. Contact support if you need assistance.

Is my AI API key stored securely by Makrly?

Yes, Makrly encrypts all AI API keys at rest to protect your credentials. - Keys are not shared with third parties. - Only used to generate content on your behalf. - You can revoke or update keys anytime via the dashboard. Security and privacy are top priorities.

Can I use Makrly with a team or multiple users?

Makrly supports team usage on higher-tier plans: - Pro and Business plans allow multiple repositories and collaborators. - Business plan includes organization-wide settings and analytics dashboard. For team onboarding, refer to the onboarding guide available in the documentation or contact support for custom solutions.

How do I set up a changelog for my product with Makrly?

To set up a changelog: 1. Connect your GitHub repository to Makrly. 2. Enable the auto-changelog feature in your dashboard. 3. Makrly will generate changelog entries from notable commits automatically. 4. Customize categories (New, Improved, Fixed, Removed) as needed. 5. Embed the changelog widget on your website using provided code snippet. This keeps your users informed about updates without manual effort.

Can I customize the appearance of the changelog widget?

Yes, Makrly's changelog widget supports customization: - Choose themes (light, dark, custom colors) - Set widget position on your website (bottom-right, top-left, etc.) - Customize primary color to match your brand - Configure categories and user reaction options Update settings via the API or dashboard to tailor the widget look and feel.

How do I embed the changelog widget on my website?

To embed the changelog widget: 1. Go to your Makrly dashboard and configure the widget appearance. 2. Copy the provided embed code snippet. 3. Paste the snippet into your website's HTML where you want the widget to appear. The widget will load dynamically and display your changelog entries with categories and user reactions.

Does Makrly support RSS feeds for changelogs?

Yes, Makrly provides RSS feed support for your changelog entries. - The RSS feed automatically updates with new changelog items. - You can share the RSS URL with users or integrate it with other services. - This helps users subscribe and stay informed about your product updates.

How do I authenticate API requests to Makrly?

Authenticate all API requests using a Bearer token in the HTTP header: ```http Authorization: Bearer mk_live_your_key_here ``` - Get your API key from your Makrly dashboard under Settings → API. - API keys start with `mk_live_` and are shown only once on creation. - Do not expose API keys in client-side code; use server-to-server calls. Ensure your API key has correct scopes for requested operations.

What are the main API endpoints available in Makrly?

Key Makrly API endpoints include: - `/repos`: List and get repository info - `/repos/{repoId}/posts`: List posts for a repo - `/posts/generate`: Generate posts from custom text - `/changelog/entries`: Manage changelog entries - `/changelog/settings`: Get and update widget settings - `/repos/{repoId}/commits`: List commits Use appropriate HTTP methods (GET, POST, PATCH, DELETE) with required scopes.

How do I generate social media posts programmatically with the API?

To generate posts from custom text: 1. Make a POST request to `/api/v1/posts/generate` with JSON body: ```json { "content": "Your commit message or update text", "repoId": 1, "provider": "openai", "model": "gpt-4o" } ``` 2. Include your Bearer token in the Authorization header. 3. The response returns platform-specific posts (short, thread, LinkedIn, Facebook profiles/pages). This lets you automate content creation outside the dashboard.

What are the rate limits for Makrly API usage?

Makrly enforces these rate limits: - Free tier: 100 requests per hour - Paid tiers: 1,000 requests per hour Rate limit info is included in response headers: - `X-RateLimit-Limit`: max requests allowed - `X-RateLimit-Remaining`: requests left in window - `X-RateLimit-Reset`: Unix timestamp when limit resets Plan accordingly to avoid hitting limits.

What are Makrly's key features for building in public?

Makrly offers: - GitHub integration with one-click OAuth and read-only access - AI-powered generation of posts tailored for X, LinkedIn, Threads, Bluesky, and Facebook - Personality quiz for voice and tone matching - Smart filtering that hides trivial commits - Bring your own AI key support with 40+ models - Auto-generated changelogs with embeddable widgets - Built-in design maker for quote cards, code snippets, and browser mockups - Public idea board and roadmap for user engagement All design

How does Makrly filter out unimportant commits?

Makrly uses AI smart filtering to: - Automatically identify and hide trivial commits like typo fixes and readme updates - Surface only notable commits worth sharing - Allow manual resync with stricter or looser filtering This reduces noise and focuses your social content on meaningful updates.

What design tools does Makrly provide for social posts?

Makrly includes an in-browser design maker to create: - Quote cards from your best insights - Syntax-highlighted code snippets with theme customization - Browser mockups to showcase product screenshots No external design skills required. Export images as PNGs for social sharing to boost engagement.

How do I get started with Makrly?

To get started with Makrly: 1. Sign in with your GitHub account using OAuth. 2. Select repositories you want to track (public repos are free). 3. Take the 2-minute personality quiz to set your writing style. 4. Push commits to your GitHub repo as usual. 5. Visit your Makrly dashboard to view AI-generated social media posts from your commits. You can review, edit, and share posts easily across multiple platforms.

Is Makrly free to use?

Yes, Makrly offers a free tier with: - Unlimited public repositories - Posts generated for all supported social platforms - Auto changelogs, FAQ builder, and idea board - Bring your own AI key feature You do not need a credit card to start with the free plan. Paid plans unlock private repository support and additional features.

What permissions does Makrly need from GitHub and is my code safe?

Makrly requests **read-only access** to your GitHub account, specifically: - Only access to commit messages and metadata - No access to source code, files, or secrets - Cannot push changes or modify your repositories You can revoke Makrly's access anytime from your GitHub settings to ensure your code stays secure.

Why are some commits not showing up in my Makrly dashboard?

Makrly uses AI-powered smart filtering to hide trivial commits such as: - Typo fixes - Readme updates - Minor formatting changes Only notable commits worth sharing are surfaced. You can resync or adjust filtering settings if needed to see different commits.

How often does Makrly sync commits from my GitHub repositories?

Makrly syncs commits automatically through GitHub webhooks and periodic polling. - New commits usually appear in your Makrly dashboard within minutes. - You can manually resync from your dashboard if commits do not show up. - Sync frequency depends on repository activity and webhook reliability. This ensures your posts stay up to date with your latest development work.

Why can't I see my private repositories in Makrly?

To access private repositories: - Your Makrly plan must include private repo support (Indie plan or higher). - When authorizing via GitHub OAuth, ensure you grant Makrly permission to access private repos. - If permissions were not granted initially, reauthorize Makrly from GitHub settings. Without these, private repos will not appear or sync in Makrly.

What plans does Makrly offer and what features do they include?

Makrly has four main plans: - Free ($0/month): Unlimited public repos, posts for all platforms, auto changelog, FAQ builder, idea board, voice quiz, bring your own AI key. - Indie ($12/month): Everything in Free + 1 private repo + 1 public repo. - Pro ($39/month): Everything in Indie + unlimited private and public repos. - Business ($79/month): Everything in Pro + no Makrly branding (white-label). Choose based on your need for private repo support and branding.

How do I upgrade or cancel my Makrly subscription?

To upgrade your plan: 1. Log into your Makrly dashboard. 2. Navigate to Settings → Subscription. 3. Select the desired plan and follow the payment prompts. To cancel: 1. Go to Settings → Subscription. 2. Choose the cancel subscription option. 3. Confirm cancellation; you retain access until the period ends. Contact support for refunds or other billing inquiries.

Can I use Makrly without a credit card?

Yes, Makrly's free plan requires no credit card and is free forever for public repositories. Paid plans require payment via major credit cards processed through Stripe. PayPal is available on annual plans. You can start using the core features immediately without entering payment information.

How do I make posts sound more like me?

Makrly personalizes posts to match your style by: - Taking a quick 2-minute personality quiz about tone and voice (casual, formal, technical, etc.) - Allowing custom prompts per repository to fine-tune AI writing - Using your own AI API key to choose preferred models This ensures posts sound authentic and not like generic marketing copy.

Can I edit posts before sharing them?

Yes, you have full control: - Review all generated posts in your dashboard - Edit content before copying or sharing - Regenerate posts anytime if you want a different version Makrly never auto-publishes; you always approve posts before sharing.

Which social media platforms does Makrly support?

Makrly generates posts tailored for these platforms: - X (formerly Twitter): Short, punchy posts - LinkedIn: Professional tone - Threads: Casual and conversational - Bluesky: Community-focused - Facebook: Accessible for broader audiences One commit produces unique posts optimized for each platform.

How do I regenerate a post I don't like?

To regenerate a post: 1. Open the post in your dashboard. 2. Use the regenerate option to create a new version based on the same commit. 3. Review the new post and edit if needed. This lets you get fresh content without changing your commit message.

What's New - Makrly