Cogsend

Abstract

1. Introduction

Self-hosted social scheduler for Mastodon, Bluesky, LinkedIn, Threads and X. Write a draft, customize it per platform, then publish it now or schedule it. Single-tenant: one admin account, on your own Cloudflare account, with your own provider credentials.

selected, counted each platform's own way (graphemes, Mastodon's URL weighting)

deploy:release runs the tests, applies migrations, builds and deploys. Your data is in D1 and R2, not in the checkout, so a pull cannot touch it. Settings → Instance and npm run doctor both report the running version and say when a newer release is out; docs/deploy.md → Updating covers release tags and rolling back.

2. Objective

Self-hosted social media scheduler. Write once, publish to any connected platform. Runs on your own Cloudflare account.

This project demonstrates how TypeScript can be applied to a real-world Digital Marketing & SEO problem.

3. Key Features / Modules

• Thread editor: one card per post, images with alt text, a Global tab plus a tab per platform
• Pasting a long draft splits it into a thread that fits the tightest platform you
• Link preview cards for URLs in a post
• Publish now with per-destination results, or schedule; cancel, reschedule and retry from Posts
• Retryable failures back off on their own — five attempts, then they park in Failed
• Insights: published against failed over 7, 30 or 90 days, per-account stats and why posts failed
• Disconnecting an account removes its scheduled posts, returns drafts that were still waiting, and keeps published history
• Credentials encrypted at rest (AES-256-GCM), with 2FA on the single admin account
• Personal API key for scripts and Shortcuts (Settings → API access)

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm / yarn / pnpm
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/deepakness/cogsend.git
cd cogsend

git clone --depth 1 https://github.com/deepakness/cogsend.git cogsend
cd cogsend && npm install && npm run setup

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Export reports to Google Sheets or PDF
• Schedule weekly automated reports
• Add competitor comparison

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which marketing or SEO problem does this tool solve?
2. Which data sources or APIs does it use (Search Console, Analytics, social platforms)?
3. Which metrics or KPIs does it report and how are they calculated?
4. How could the output help a business make decisions?
5. How would you schedule it to run automatically?

9. Source Code & License

This project is developed by deepakness and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.