No description
Find a file
Matteo Martini a33ff5d00f
fix: keep post drafts unscheduled by default (#209)
* fix: keep post drafts unscheduled by default

* Align schedule validation and keep drafts unscheduled.

Require scheduled_at only when status is scheduled and the post has no
usable future schedule. Share that rule across web, API, and MCP, keep
create without a date as null, and preserve the legacy date → 09:00 UTC
fallback.

* Polish schedule validation typing and tests.

Type requiresExplicitSchedule status as ?string, reuse a local status
variable in request/tool validation, tighten the web reject assertion,
and collapse overlapping MCP unscheduled-create cases.

* Centralize status helper in post update validation.

Reuse the typed status() helper across FormRequests and the already-parsed
$status in UpdatePostTool so schedule checks stay consistent and less noisy.

* Share scheduled_at update rules across web, API, and MCP.

Centralize schedule validation in PostStatusRules, normalize status parsing
in one place, and align past-schedule coverage across entry points.

* Cover the full unscheduled-draft checklist in Pest.

Add feature coverage for null/past schedule rejection, explicit scheduling,
draft saves, publish-now without a schedule, calendar exclusion, and
09:00 UTC date defaults across web, API, and MCP.

* Remove normalizeStatus helper.

Keep the inline is_string check at the few call sites that read raw
request status before validation — no shared wrapper needed.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Drop is_string status guards from schedule validation.

Accept mixed status in PostStatusRules and rely on strict comparisons
with Rule::requiredIf / Rule::when — malformed input simply does not match.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Paulo Castellano <paulo@castellanos.llc>
2026-08-01 17:39:18 -03:00
.agents/skills Upgrade Pest from v4 to v5 (PHPUnit 13). 2026-07-31 01:40:50 +00:00
.claude Upgrade Pest from v4 to v5 (PHPUnit 13). 2026-07-31 01:40:50 +00:00
.codex refactor: update documentation to remove Sail references and improve command usage 2026-07-23 12:44:14 -03:00
.cursor Upgrade Pest from v4 to v5 (PHPUnit 13). 2026-07-31 01:40:50 +00:00
.github Upgrade Pest from v4 to v5 (PHPUnit 13). 2026-07-31 01:40:50 +00:00
app fix: keep post drafts unscheduled by default (#209) 2026-08-01 17:39:18 -03:00
bootstrap Add Telegram connection flow (controller + webhook) 2026-06-13 21:39:03 -03:00
config Clamp media byte caps to upload limits and surface truncated board lists. 2026-07-24 22:49:04 -03:00
database chore: added strict types 2026-07-24 11:22:28 -03:00
docker Make webhook host configurable via WEBHOOK_URL (sendkit-style domain group) 2026-06-14 09:31:00 -03:00
lang Allow account owners to delete workspaces (#208) 2026-08-01 13:00:38 -04:00
maizzle fix(security): resolve npm audit in maizzle email toolchain 2026-05-21 20:29:32 -03:00
public docs(readme): update logo link, enhance feature descriptions, and improve layout 2026-06-26 10:39:34 -03:00
releases feat(release): render a branded changelog thumbnail in the release ritual 2026-07-18 16:56:38 -03:00
resources Allow account owners to delete workspaces (#208) 2026-08-01 13:00:38 -04:00
routes Clamp media byte caps to upload limits and surface truncated board lists. 2026-07-24 22:49:04 -03:00
storage chore: first commit 2026-01-14 22:13:44 -03:00
stubs feat: implement MCP server with tools, Post API tests, auth middleware 2026-03-29 20:30:36 -03:00
templates refactor: reorganize settings UI, migrate post templates to a file-based registry, and remove legacy video generation features 2026-05-03 13:44:13 -03:00
tests fix: keep post drafts unscheduled by default (#209) 2026-08-01 17:39:18 -03:00
.dockerignore chore: add .dockerignore 2026-05-12 23:44:55 -03:00
.editorconfig chore: first commit 2026-01-14 22:13:44 -03:00
.env.ci feat: adding tests.. 2026-01-18 22:01:55 -03:00
.env.example Charge $1 for the first month instead of a free trial at checkout 2026-07-09 15:18:00 -03:00
.env.testing feat: improvements on ui 2026-01-21 20:50:57 -03:00
.gitattributes chore: first commit 2026-01-14 22:13:44 -03:00
.gitignore Crop the avatar/logo before upload with a dependency-free cropper 2026-07-03 21:46:19 -03:00
.mcp.json refactor: update documentation to remove Sail references and improve command usage 2026-07-23 12:44:14 -03:00
.prettierignore chore: first commit 2026-01-14 22:13:44 -03:00
.prettierrc chore: first commit 2026-01-14 22:13:44 -03:00
AGENTS.md Upgrade Pest from v4 to v5 (PHPUnit 13). 2026-07-31 01:40:50 +00:00
artisan chore: first commit 2026-01-14 22:13:44 -03:00
boost.json refactor: update documentation to remove Sail references and improve command usage 2026-07-23 12:44:14 -03:00
Caddyfile feat(docker): add Caddy reverse proxy and domain-portable Reverb config 2026-05-27 14:53:46 -03:00
CLAUDE.md Upgrade Pest from v4 to v5 (PHPUnit 13). 2026-07-31 01:40:50 +00:00
components.json chore: first commit 2026-01-14 22:13:44 -03:00
compose.override.yaml.example feat(docker): replace stale Sail compose with self-contained stack 2026-05-12 23:44:55 -03:00
compose.prod.yaml refactor(docker): align echo.ts with the shared sendkit config 2026-05-27 15:17:47 -03:00
compose.yaml feat(docker): replace stale Sail compose with self-contained stack 2026-05-12 23:44:55 -03:00
composer.json Upgrade Pest from v4 to v5 (PHPUnit 13). 2026-07-31 01:40:50 +00:00
composer.lock Upgrade Pest from v4 to v5 (PHPUnit 13). 2026-07-31 01:40:50 +00:00
eslint.config.js fix: address PR review findings — publish, REST store, SSRF, race 2026-05-04 12:16:39 -03:00
GEMINI.md Upgrade Pest from v4 to v5 (PHPUnit 13). 2026-07-31 01:40:50 +00:00
LICENSE.md chore: update project license from FSL to AGPL-3.0-only 2026-05-04 15:46:56 -03:00
package-lock.json Remove the Vitest frontend unit-test layer 2026-07-04 10:53:08 -03:00
package.json Remove the Vitest frontend unit-test layer 2026-07-04 10:53:08 -03:00
phpunit.xml feat: adding tests 2026-01-18 22:04:34 -03:00
pint.json chore: first commit 2026-01-14 22:13:44 -03:00
README.md docs(readme): reposition around product value, fix self-host and mcp links 2026-06-26 10:46:38 -03:00
tsconfig.json chore: first commit 2026-01-14 22:13:44 -03:00
vite.config.ts chore: add resources/css/app.css to vite build input 2026-05-03 20:30:34 -03:00

TryPost

Run your whole social presence from one calendar

An open-source social media scheduler with an AI copilot, native publishing to 12 networks,
and an MCP server so your AI assistant can post for you. Self-host it, or skip the setup on cloud.

Stars License Release Discussions

Try on Cloud  •  Documentation  •  Community

TryPost — plan, write, and publish from one calendar


What you get

📅  One calendar, every network Plan a month at a glance, drag any post to a new slot, and publish natively to 12 platforms. No redirects, no "finish in the mobile app."
  An AI copilot that knows your brand Captions, hooks, full drafts, and multi-slide carousels in your tone, voice, and colors. It reads your brand profile on every generation.
🤖  Built for AI agents A first-class MCP server and REST API. Claude, Cursor, ChatGPT, or your own scripts can draft, schedule, and publish for you.
⚙️  Automations that run themselves A visual workflow builder: triggers, conditions, RSS, webhooks, and AI generation, all server-side. Set it once, let it post.
🗂️  Made for many clients Workspaces, roles, and approval flows so an agency or freelancer can run a roster of brands without the spreadsheets.

Features

Visual calendar Month, week, and day views. Drag and drop to reschedule across networks.
Multi-platform composer Write once, then tailor the preview per network in parallel.
AI generate & review Draft from a prompt, get inline feedback before you publish.
AI carousel builder Prompt to a multi-slide carousel with images, on-brand.
Brand profile Tone, voice, language, and colors applied to every AI call.
Automations Schedule / RSS triggers, conditions, publish steps, and webhooks.
Asset library Reusable workspace media, plus Unsplash and Giphy search built in.
Signatures & labels Reusable hashtag and CTA blocks, color-coded post tags.
Team collaboration Owner / Admin / Member roles, comments with @mentions on drafts.
Workspaces Isolate each brand, client, or project in its own space.
REST API + MCP Full programmatic control; AI assistants integrate natively.
Native analytics Per-account reach and engagement across every connected platform.
Multi-language English, Spanish, and Portuguese.

Supported platforms

Posts publish natively through each platform's official API.


Instagram

Facebook

LinkedIn

X (Twitter)

TikTok

YouTube

Pinterest

Threads

Bluesky

Mastodon

Telegram

Discord

Get started

☁️  Cloud The fastest way in. We host, update, and scale it for you. Start at trypost.it →
🛠️  Self-host Free forever, your servers, your data. Installation guide →
🤖  Drive it with AI Connect Claude, Cursor, or ChatGPT over MCP. MCP setup →

Own your stack

TryPost is open source on purpose. Self-host it and your posts, drafts, and metrics stay on your infrastructure, under a license that is yours to keep. No seat tax, no feature gates, no vendor deciding when to lock you out. Read every line, fork it, and ship it. When you would rather not run servers, the same product is one click away on cloud.

Contributing

Contributions of any size are welcome. Pick an issue, say hi in Discussions, or open a PR with what you would like to see.

Short on time? A star is the most valuable thing you can give. It helps more people find the project.

License

GNU Affero General Public License v3.0. Use, modify, fork, self-host, and redistribute, including commercially. If you run a modified version as a network service, make your changes available to its users (AGPL §13).


Built in the open. Star TryPost on GitHub and tell a friend.

Star History

Star History Chart