close
Skip to content

kareem2099/DotShare

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

🚀 DotShare

Share Your Code Journey, Amplify Your Voice

Version Codename License: Apache 2.0 VS Code Node Buy Me A Coffee

Transform your development updates into compelling social media content—right from your IDE.

InstallationFeaturesQuick StartDocumentationSupport


🎯 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:

Platform Type Features Status
🔗 LinkedIn Social Profile posts, rich media ✅ Full Support
📱 Telegram Social Channels, groups, scheduling ✅ Full Support
𝕏 X (Twitter) Social Tweets, threads, X Premium (25K chars), up to 4 images ✅ Full Support
📘 Facebook Social Profiles, pages ✅ Full Support
💬 Discord Social Webhooks, embeds ✅ Full Support
🟠 Reddit Social Subreddits, profiles (r/, u/) ✅ Full Support
🦋 BlueSky Social Threads, facets, up to 4 images, JIT compression ✅ Full Support
👨‍💻 Dev.to Blog Articles, series, drafts New in v3.0
Ⓜ️ Medium Blog Articles, draft/publish/unlisted New in v3.0

📰 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

👨‍💻 Dev.to API Key
  1. Go to Dev.to Settings → Extensions
  2. Under "DEV API Keys", generate a new key
  3. Add to DotShare Settings

Note: Dev.to does not support image file uploads via API. Use publicly hosted image URLs (Cloudinary, GitHub, Imgur) in your markdown or as cover image.

Ⓜ️ Medium Integration Token
  1. Go to Medium Settings
  2. Under "Integration tokens", generate a new token
  3. Add to DotShare Settings

Note: Medium does not support local image uploads via API. Use publicly hosted URLs.

🔗 LinkedIn Access Token
  1. Create an app at LinkedIn Developers
  2. Request access to Sign In with LinkedIn
  3. Generate token with w_member_social scope
  4. Add to DotShare settings
📱 Telegram Bot Setup
  1. Message @BotFather on Telegram
  2. Create new bot with /newbot
  3. Copy the bot token
  4. Get your chat ID from @FreeID
  5. Add both to DotShare settings
𝕏 X (Twitter) Authentication
  1. Apply for developer access at Twitter Developers
  2. Create an app with Read & Write permissions
  3. Generate OAuth 2.0 access token
  4. Add to DotShare settings
🟠 Reddit App Creation
  1. Go to Reddit Apps
  2. Create app (select "script" type)
  3. Note your client ID and secret
  4. Use the DotShare UI to generate tokens automatically
  5. Set your target subreddit in Settings

🤝 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:


👏 Acknowledgments


📄 License

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

Made with ❤️ by developers, for developers

⬆ Back to Top

About

A VS Code extension that helps you share your project updates to social media using AI-powered content generation.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages