# trypostit/trypost architecture

> Architecture diagram of the GitHub repository trypostit/trypost, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/trypostit/trypost
- Repository: https://github.com/trypostit/trypost

## Overview

TryPost is a multi-workspace social publishing product for both human teams and AI agents. Its central workflow is to compose or create posts through the web app, REST API, or MCP; schedule them in channel queues, apply review when needed, and publish natively to connected networks. The graph also preserves the documented analytics, media, ideas, repurposing, RSS, and webhook capabilities. Relationship evidence is limited to the README and the supplied excerpts/index; unsampled integrations are represented only where documented.

Main entry points: [`app/Http/Controllers/App`](https://github.com/trypostit/trypost/tree/main/app/Http/Controllers/App) (Web app), [`app/Actions/Post`](https://github.com/trypostit/trypost/tree/main/app/Actions/Post) (Post management), [`app/Mcp`](https://github.com/trypostit/trypost/tree/main/app/Mcp) (MCP tools), [`app/Models/Post.php`](https://github.com/trypostit/trypost/blob/main/app/Models/Post.php) (Post records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Ways In"]
  node_web["Web app"]
  node_rest["REST API"]
  node_mcp["MCP tools"]
end

subgraph group_publishing["Publishing Workflow"]
  node_posts["Post management"]
  node_queue["Channel queues"]
  node_review["Post approvals"]
  node_postmodel[("Post records<br/>[Post.php]")]
  node_channels[("Connected channels<br/>[SocialAccount.php]")]
  node_networks(("Social networks"))
  node_workspace[("Workspaces<br/>[Workspace.php]")]
end

subgraph group_content["Content Tools"]
  node_media[("Media library<br/>[Media.php]")]
  node_ideas[("Ideas board<br/>[Idea.php]")]
  node_repurpose[("Repurposing<br/>[Repurpose.php]")]
  node_rss[("RSS feeds<br/>[RssFeed.php]")]
end

subgraph group_insights["Insights and Events"]
  node_analytics["Analytics"]
  node_webhooks["Webhook delivery<br/>[WebhookService.php]"]
  node_webhookmodel[("Webhook records<br/>[Webhook.php]")]
end

node_teams(("Teams and agents"))

node_teams -->|"compose in"| node_web
node_teams -->|"automate with"| node_rest
node_teams -->|"request through"| node_mcp
node_web -->|"manage posts"| node_posts
node_rest -->|"create posts"| node_posts
node_mcp -->|"create posts"| node_posts
node_posts -.->|"store posts"| node_postmodel
node_posts -.->|"attach media"| node_media
node_posts -->|"schedule posts"| node_queue
node_queue -.->|"schedule posts"| node_postmodel
node_posts -->|"request approval"| node_review
node_review -.->|"record decisions"| node_postmodel
node_postmodel -.->|"target channels"| node_channels
node_channels -->|"publish natively"| node_networks
node_web -->|"manage ideas"| node_ideas
node_mcp -->|"manage ideas"| node_ideas
node_web -->|"configure repurposing"| node_repurpose
node_web -.->|"manage feeds"| node_rss
node_web -->|"view insights"| node_analytics
node_mcp -->|"read metrics"| node_analytics
node_workspace -.->|"organize channels"| node_channels
node_workspace -->|"own webhooks"| node_webhookmodel
node_web -->|"configure webhooks"| node_webhooks
node_webhookmodel -->|"deliver events"| node_webhooks

click node_web "https://github.com/trypostit/trypost/tree/main/app/Http/Controllers/App"
click node_rest "https://github.com/trypostit/trypost/tree/main/app/Http/Controllers/Api"
click node_mcp "https://github.com/trypostit/trypost/tree/main/app/Mcp"
click node_posts "https://github.com/trypostit/trypost/tree/main/app/Actions/Post"
click node_queue "https://github.com/trypostit/trypost/tree/main/app/Actions/Post/Queue"
click node_review "https://github.com/trypostit/trypost/tree/main/app/Actions/Post/Approval"
click node_postmodel "https://github.com/trypostit/trypost/blob/main/app/Models/Post.php"
click node_channels "https://github.com/trypostit/trypost/blob/main/app/Models/SocialAccount.php"
click node_workspace "https://github.com/trypostit/trypost/blob/main/app/Models/Workspace.php"
click node_media "https://github.com/trypostit/trypost/blob/main/app/Models/Media.php"
click node_ideas "https://github.com/trypostit/trypost/blob/main/app/Models/Idea.php"
click node_repurpose "https://github.com/trypostit/trypost/blob/main/app/Models/Repurpose.php"
click node_rss "https://github.com/trypostit/trypost/blob/main/app/Models/RssFeed.php"
click node_analytics "https://github.com/trypostit/trypost/tree/main/app/Actions/Analytics"
click node_webhooks "https://github.com/trypostit/trypost/blob/main/app/Services/WebhookService.php"
click node_webhookmodel "https://github.com/trypostit/trypost/blob/main/app/Models/Webhook.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_rest,node_mcp toneBlue
class node_posts,node_queue,node_review,node_postmodel,node_channels,node_networks,node_workspace toneAmber
class node_media,node_ideas,node_repurpose,node_rss toneMint
class node_analytics,node_webhooks,node_webhookmodel toneRose
class node_teams toneIndigo
```

## Components

### Ways In

- [Web app](https://github.com/trypostit/trypost/tree/main/app/Http/Controllers/App): `app/Http/Controllers/App`
- [REST API](https://github.com/trypostit/trypost/tree/main/app/Http/Controllers/Api): `app/Http/Controllers/Api`
- [MCP tools](https://github.com/trypostit/trypost/tree/main/app/Mcp): `app/Mcp`

### Publishing Workflow

- [Post management](https://github.com/trypostit/trypost/tree/main/app/Actions/Post): `app/Actions/Post`
- [Channel queues](https://github.com/trypostit/trypost/tree/main/app/Actions/Post/Queue): `app/Actions/Post/Queue`
- [Post approvals](https://github.com/trypostit/trypost/tree/main/app/Actions/Post/Approval): `app/Actions/Post/Approval`
- [Post records](https://github.com/trypostit/trypost/blob/main/app/Models/Post.php): `app/Models/Post.php`
- [Connected channels](https://github.com/trypostit/trypost/blob/main/app/Models/SocialAccount.php): `app/Models/SocialAccount.php`
- **Social networks**
- [Workspaces](https://github.com/trypostit/trypost/blob/main/app/Models/Workspace.php): `app/Models/Workspace.php`

### Content Tools

- [Media library](https://github.com/trypostit/trypost/blob/main/app/Models/Media.php): `app/Models/Media.php`
- [Ideas board](https://github.com/trypostit/trypost/blob/main/app/Models/Idea.php): `app/Models/Idea.php`
- [Repurposing](https://github.com/trypostit/trypost/blob/main/app/Models/Repurpose.php): `app/Models/Repurpose.php`
- [RSS feeds](https://github.com/trypostit/trypost/blob/main/app/Models/RssFeed.php): `app/Models/RssFeed.php`

### Insights and Events

- [Analytics](https://github.com/trypostit/trypost/tree/main/app/Actions/Analytics): `app/Actions/Analytics`
- [Webhook delivery](https://github.com/trypostit/trypost/blob/main/app/Services/WebhookService.php): `app/Services/WebhookService.php`
- [Webhook records](https://github.com/trypostit/trypost/blob/main/app/Models/Webhook.php): `app/Models/Webhook.php`

### Other components

- **Teams and agents**

## Connections

- Teams and agents → Web app: compose in (evidence: `README.md`)
- Teams and agents → REST API: automate with (evidence: `README.md`)
- Teams and agents → MCP tools: request through (evidence: `README.md`)
- Web app → Post management: manage posts (evidence: `README.md`)
- REST API → Post management: create posts (evidence: `README.md`)
- MCP tools → Post management: create posts (evidence: `README.md`)
- Post management → Post records: store posts (evidence: `app/Actions/Post/DeleteChannelPosts.php`)
- Post management → Media library: attach media (evidence: `app/Actions/Post/DeleteChannelPosts.php`)
- Post management → Channel queues: schedule posts (evidence: `README.md`)
- Channel queues → Post records: schedule posts
- Post management → Post approvals: request approval (evidence: `README.md`)
- Post approvals → Post records: record decisions
- Post records → Connected channels: target channels (evidence: `app/Models/Post.php`)
- Connected channels → Social networks: publish natively (evidence: `README.md`)
- Web app → Ideas board: manage ideas (evidence: `README.md`)
- MCP tools → Ideas board: manage ideas (evidence: `README.md`)
- Web app → Repurposing: configure repurposing (evidence: `README.md`)
- Web app → RSS feeds: manage feeds
- Web app → Analytics: view insights (evidence: `README.md`)
- MCP tools → Analytics: read metrics (evidence: `README.md`)
- Workspaces → Connected channels: organize channels (evidence: `app/Models/Workspace.php`)
- Workspaces → Webhook records: own webhooks (evidence: `app/Models/Webhook.php`)
- Web app → Webhook delivery: configure webhooks (evidence: `README.md`)
- Webhook records → Webhook delivery: deliver events (evidence: `app/Services/WebhookService.php`)
