🎯 Why DotShare?

Building in public shouldn't be hard. DotShare bridges the gap between your code editor and your audience, letting you share achievements, updates, and insights across 9 social and blogging platforms with AI-powered assistance—all without leaving VS Code.

The Problem We Solve

• ⏰ Time Drain: Manually crafting posts for multiple platforms
• 🎨 Writer's Block: Struggling to articulate technical achievements
• 🔄 Context Switching: Jumping between editor and social media
• 📅 Consistency: Forgetting to share progress regularly

Our Solution

A unified, intelligent posting experience that understands your code and speaks your audience's language.

✨ Features

🤖 AI-Powered Content Creation

Leverage cutting-edge AI to transform code updates into engaging narratives:

• Gemini AI: Google's latest language model for nuanced technical content
• OpenAI GPT: Industry-leading conversational AI
• xAI Grok: Innovative AI with real-time awareness
• Anthropic Claude: Advanced reasoning and long-form content generation

📱 Platform Integrations

Share seamlessly across your entire professional network:

📰 The Publishing Suite (v3.0 New!)

DotShare is no longer just a social poster — it's a full publishing suite:

• Blog Publish Page: Dedicated UI for long-form article publishing
• Active File Reader: Load your .md file directly from VS Code editor
• YAML Frontmatter Parser: Auto-fills title, tags, canonical URL from your markdown
• Draft vs. Publish Toggle: Per-platform — draft to Dev.to, publish live to Medium, simultaneously
• Platform-First Navigation: Click a platform icon → workspace adapts automatically

🖼️ Multi-Image Media Grid (New in v3.2)

Attach up to 4 images per post, just like native platform clients:

• Live Thumbnail Previews — See exactly what you're posting before you hit share
• Individual Remove Buttons — Remove a single image without clearing everything
• "Remove All" Bulk Action — One click resets the entire media selection
• Smart File Size Warning — Files over 2 MB get an inline warning; compression is handled automatically at post time
• Secure Webview URIs — Thumbnails load instantly using VS Code's sandboxed vscode-resource:// protocol

🧵 Thread Composer

Build and share threads natively:

• Multi-post thread builder for X and Bluesky
• Per-post character counters with platform limits
• Up to 4 images per thread post (New in v3.2)
• X Premium mode (25,000 chars)

⏰ Automation & Scheduling

Never miss your posting rhythm:

# Schedule posts for maximum engagement
dotshare schedule --time "09:00" --platforms "linkedin,twitter"

# Automated cross-posting
dotshare "New release v3.0.0 🎉" --all-platforms

🌐 Multilingual Support

• 🇬🇧 English
• 🇸🇦 Arabic
• 🇷🇺 Russian

📊 Analytics Dashboard

Track your reach and engagement across platforms:

• Post performance metrics per platform
• Per-platform success rates and share counts
• Post history with AI model and timestamp

#️⃣ Smart Hashtag Engine

Context-aware hashtags generated automatically:

• Reads your project name, type, and package.json keywords
• Scans recent git commit messages for intent
• Detects tech terms and frameworks in generated post
• Platform-aware: hashtags skipped for Reddit and Discord
• Add permanent tags via VS Code Settings → DotShare → Custom Hashtags

🚀 Quick Start

For VS Code Users

Step 1: Install the Extension

# Via VS Code Marketplace
1. Press Ctrl+Shift+X (Cmd+Shift+X on Mac)
2. Search "DotShare"
3. Click Install

# Or via command line
code --install-extension freerave.dotshare

Step 2: Configure Your Platforms

# Open Command Palette (Ctrl+Shift+P)
> DotShare: Open Platform Hub

# Navigate to Settings tab
# Add credentials for your platforms

Step 3: Share Your First Post

# Click a platform icon in the sidebar
# Compose your post or Generate with AI
# Hit Share!

For CLI Power Users

Step 1: Install Globally

npm install -g dotshare-cli

Step 2: Initialize & Authenticate

dotshare init
dotshare login linkedin
dotshare login telegram
dotshare login reddit
dotshare whoami

Step 3: Start Posting

# Simple text post
dotshare "🚀 Just deployed v3.0 with Dev.to + Medium support!"

# With media
dotshare "Check out our new UI! 🎨" --media ./screenshot.png

# Specific platforms
dotshare "Backend optimization complete ⚡" --platforms linkedin,twitter

📖 Documentation

Getting API Tokens

🤝 Contributing

We love contributions! Whether it's adding new platforms, fixing bugs, or improving documentation, we welcome your help. 👉 Read our Contributing Guidelines to get started.

📈 Roadmap

Our development roadmap and feature tracking has been moved to a dedicated file. 👉 View the full Roadmap here

📜 Changelog

A detailed history of all changes, features, and bug fixes can be found in our CHANGELOG file. 👉 Read the Full Changelog here

💝 Support the Project

DotShare is free and open source. Your support keeps it alive and helps fund the Cloud Scheduling Server.

If you can't donate, you can still help:

• ⭐ Star the repository
• 📢 Share with your network
• 🐛 Report bugs and suggest features

👏 Acknowledgments

• VS Code Extension API — Microsoft
• Gemini AI — Google DeepMind
• Anthropic Claude — Anthropic
• Dev.to / Forem API
• Medium API
• All our contributors ❤️

📄 License

DotShare is licensed under the Apache License, Version 2.0. See LICENSE for details.