# gitroomhq/postiz-app architecture

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

- Interactive diagram: https://gitdiagram.com/gitroomhq/postiz-app
- Repository: https://github.com/gitroomhq/postiz-app

## Overview

Postiz is a social-media management platform for composing, scheduling, automating, and analyzing content, with team collaboration and API access. The main user journey is to authenticate, connect social accounts, create and schedule posts, then review performance; the README also documents billing, AI features, and automation integrations. The graph includes the sampled backend, upload, and orchestration layers, plus major product capabilities visible in the tree. Unsampled product links are shown only where documented or marked unverified; the excerpts do not establish most UI-to-backend calls.

Main entry points: [`apps/frontend/src/components/launches/launches.component.tsx`](https://github.com/gitroomhq/postiz-app/blob/main/apps/frontend/src/components/launches/launches.component.tsx) (Web application), [`apps/backend/src/api/routes/posts.controller.ts`](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/posts.controller.ts) (Post routes), [`libraries/nestjs-libraries/src/upload/upload.factory.ts`](https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/upload/upload.factory.ts) (Upload provider factory), [`apps/backend/src/services/auth/auth.service.ts`](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/services/auth/auth.service.ts) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Product experience"]
  node_webapp["Web application"]
  node_composer["Post composer<br/>[editor.tsx]"]
  node_analytics_ui["Analytics dashboard"]
  node_billing_ui["Billing"]
end

subgraph group_backend["Backend services"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_users["User routes"]
  node_integrations["Social integrations"]
  node_public_api["Public API"]
  node_posts["Post routes"]
  node_analytics_api["Analytics routes"]
  node_billing_api["Billing routes"]
  node_clipping["Content clipping"]
  node_copilot["AI copilot"]
  node_oauth["OAuth services<br/>[oauth.service.ts]"]
  node_admin_integrations["Unauthenticated integrations"]
  node_permission_policy["Permission policy"]
end

subgraph group_runtime["Publishing runtime"]
  node_temporal["Temporal workflows"]
  node_post_activity["Post activity<br/>[post.activity.ts]"]
  node_orchestrator_module["Orchestrator module<br/>[app.module.ts]"]
end

subgraph group_shared["Shared capabilities"]
  node_post_data["Post data service<br/>[posts.service.ts]"]
  node_upload_api["Upload endpoint<br/>[route.ts]"]
  node_upload_factory["Upload provider factory<br/>[upload.factory.ts]"]
  node_upload_contract["Upload contract"]
  node_local_storage[("Local storage<br/>[local.storage.ts]")]
  node_cloud_storage[("Cloud storage")]
  node_validation["Upload validation"]
end

subgraph group_client["Extensions and automation"]
  node_commands["Command tasks<br/>[configuration.ts]"]
  node_command_module["Command application<br/>[command.module.ts]"]
  node_browser_extension["Browser extension<br/>[background.ts]"]
  node_extension_messages["Extension messages<br/>[messages.ts]"]
  node_cookie_provider["Cookie provider"]
  node_sdk["Node SDK<br/>[index.ts]"]
end

node_user(("Postiz user"))
node_social_platforms(("Social platforms"))

node_user -->|"manages content"| node_webapp
node_webapp -.->|"composes posts"| node_composer
node_user -->|"reviews results"| node_analytics_ui
node_user -.->|"manages billing"| node_billing_ui
node_webapp -.->|"authenticates via"| node_auth
node_auth -.->|"supports account access"| node_users
node_webapp -.->|"connects accounts"| node_integrations
node_integrations -.->|"connects to"| node_social_platforms
node_composer -.->|"submits posts"| node_posts
node_posts -.->|"uses post data"| node_post_data
node_posts -.->|"schedules publishing"| node_temporal
node_temporal -.->|"runs activity"| node_post_activity
node_orchestrator_module -->|"registers activity"| node_post_activity
node_orchestrator_module -->|"loads workflows"| node_temporal
node_analytics_ui -.->|"requests metrics"| node_analytics_api
node_billing_ui -.->|"requests billing"| node_billing_api
node_webapp -.->|"uses API"| node_public_api
node_webapp -.->|"clips content"| node_clipping
node_webapp -.->|"uses AI assistance"| node_copilot
node_upload_api -.->|"selects storage"| node_upload_factory
node_upload_factory -.->|"provides storage"| node_local_storage
node_upload_factory -.->|"provides storage"| node_cloud_storage
node_local_storage -->|"implements"| node_upload_contract
node_cloud_storage -->|"implements"| node_upload_contract
node_validation -.->|"validates uploads"| node_upload_contract
node_commands -->|"registered by"| node_command_module
node_browser_extension -->|"uses messages"| node_extension_messages
node_browser_extension -->|"uses provider"| node_cookie_provider
node_sdk -.->|"calls API"| node_public_api
node_admin_integrations -.->|"supports account setup"| node_integrations
node_permission_policy -.->|"enforces access"| node_auth

click node_webapp "https://github.com/gitroomhq/postiz-app/blob/main/apps/frontend/src/components/launches/launches.component.tsx"
click node_composer "https://github.com/gitroomhq/postiz-app/blob/main/apps/frontend/src/components/new-launch/editor.tsx"
click node_analytics_ui "https://github.com/gitroomhq/postiz-app/blob/main/apps/frontend/src/components/analytics/analytics.component.tsx"
click node_billing_ui "https://github.com/gitroomhq/postiz-app/blob/main/apps/frontend/src/components/billing/main.billing.component.tsx"
click node_auth "https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/services/auth/auth.service.ts"
click node_users "https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/users.controller.ts"
click node_integrations "https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/integrations.controller.ts"
click node_public_api "https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/public-api/routes/v1/public.integrations.controller.ts"
click node_posts "https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/posts.controller.ts"
click node_analytics_api "https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/analytics.controller.ts"
click node_billing_api "https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/billing.controller.ts"
click node_clipping "https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/clipping.controller.ts"
click node_copilot "https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/copilot.controller.ts"
click node_oauth "https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/database/prisma/oauth/oauth.service.ts"
click node_post_data "https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/database/prisma/posts/posts.service.ts"
click node_upload_api "https://github.com/gitroomhq/postiz-app/blob/main/apps/frontend/src/app/(app)/api/uploads/%5B%5B...path%5D%5D/route.ts"
click node_upload_factory "https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/upload/upload.factory.ts"
click node_upload_contract "https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/upload/upload.interface.ts"
click node_local_storage "https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/upload/local.storage.ts"
click node_cloud_storage "https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/upload/cloudflare.storage.ts"
click node_validation "https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/upload/custom.upload.validation.ts"
click node_temporal "https://github.com/gitroomhq/postiz-app/blob/main/apps/orchestrator/src/workflows/post-workflows/post.workflow.v1.1.2.ts"
click node_post_activity "https://github.com/gitroomhq/postiz-app/blob/main/apps/orchestrator/src/activities/post.activity.ts"
click node_orchestrator_module "https://github.com/gitroomhq/postiz-app/blob/main/apps/orchestrator/src/app.module.ts"
click node_admin_integrations "https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/no.auth.integrations.controller.ts"
click node_permission_policy "https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/services/auth/permissions/permission.exception.class.ts"
click node_commands "https://github.com/gitroomhq/postiz-app/blob/main/apps/commands/src/tasks/configuration.ts"
click node_command_module "https://github.com/gitroomhq/postiz-app/blob/main/apps/commands/src/command.module.ts"
click node_browser_extension "https://github.com/gitroomhq/postiz-app/blob/main/apps/extension/src/background.ts"
click node_extension_messages "https://github.com/gitroomhq/postiz-app/blob/main/apps/extension/src/types/messages.ts"
click node_cookie_provider "https://github.com/gitroomhq/postiz-app/blob/main/apps/extension/src/providers/cookie-provider.interface.ts"
click node_sdk "https://github.com/gitroomhq/postiz-app/blob/main/apps/sdk/src/index.ts"

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_webapp,node_composer,node_analytics_ui,node_billing_ui,node_user toneBlue
class node_auth,node_users,node_integrations,node_public_api,node_posts,node_analytics_api,node_billing_api,node_clipping,node_copilot,node_oauth,node_admin_integrations,node_permission_policy toneAmber
class node_temporal,node_post_activity,node_orchestrator_module toneMint
class node_post_data,node_upload_api,node_upload_factory,node_upload_contract,node_local_storage,node_cloud_storage,node_validation toneRose
class node_commands,node_command_module,node_browser_extension,node_extension_messages,node_cookie_provider,node_sdk,node_social_platforms toneIndigo
```

## Components

### Product experience

- [Web application](https://github.com/gitroomhq/postiz-app/blob/main/apps/frontend/src/components/launches/launches.component.tsx): `apps/frontend/src/components/launches/launches.component.tsx`
- [Post composer](https://github.com/gitroomhq/postiz-app/blob/main/apps/frontend/src/components/new-launch/editor.tsx): `apps/frontend/src/components/new-launch/editor.tsx`
- [Analytics dashboard](https://github.com/gitroomhq/postiz-app/blob/main/apps/frontend/src/components/analytics/analytics.component.tsx): `apps/frontend/src/components/analytics/analytics.component.tsx`
- [Billing](https://github.com/gitroomhq/postiz-app/blob/main/apps/frontend/src/components/billing/main.billing.component.tsx): `apps/frontend/src/components/billing/main.billing.component.tsx`

### Backend services

- [Authentication](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/services/auth/auth.service.ts): `apps/backend/src/services/auth/auth.service.ts`
- [User routes](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/users.controller.ts): `apps/backend/src/api/routes/users.controller.ts`
- [Social integrations](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/integrations.controller.ts): `apps/backend/src/api/routes/integrations.controller.ts`
- [Public API](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/public-api/routes/v1/public.integrations.controller.ts): `apps/backend/src/public-api/routes/v1/public.integrations.controller.ts`
- [Post routes](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/posts.controller.ts): `apps/backend/src/api/routes/posts.controller.ts`
- [Analytics routes](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/analytics.controller.ts): `apps/backend/src/api/routes/analytics.controller.ts`
- [Billing routes](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/billing.controller.ts): `apps/backend/src/api/routes/billing.controller.ts`
- [Content clipping](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/clipping.controller.ts): `apps/backend/src/api/routes/clipping.controller.ts`
- [AI copilot](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/copilot.controller.ts): `apps/backend/src/api/routes/copilot.controller.ts`
- [OAuth services](https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/database/prisma/oauth/oauth.service.ts): `libraries/nestjs-libraries/src/database/prisma/oauth/oauth.service.ts`
- [Unauthenticated integrations](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/api/routes/no.auth.integrations.controller.ts): `apps/backend/src/api/routes/no.auth.integrations.controller.ts`
- [Permission policy](https://github.com/gitroomhq/postiz-app/blob/main/apps/backend/src/services/auth/permissions/permission.exception.class.ts): `apps/backend/src/services/auth/permissions/permission.exception.class.ts`

### Publishing runtime

- [Temporal workflows](https://github.com/gitroomhq/postiz-app/blob/main/apps/orchestrator/src/workflows/post-workflows/post.workflow.v1.1.2.ts): `apps/orchestrator/src/workflows/post-workflows/post.workflow.v1.1.2.ts`
- [Post activity](https://github.com/gitroomhq/postiz-app/blob/main/apps/orchestrator/src/activities/post.activity.ts): `apps/orchestrator/src/activities/post.activity.ts`
- [Orchestrator module](https://github.com/gitroomhq/postiz-app/blob/main/apps/orchestrator/src/app.module.ts): `apps/orchestrator/src/app.module.ts`

### Shared capabilities

- [Post data service](https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/database/prisma/posts/posts.service.ts): `libraries/nestjs-libraries/src/database/prisma/posts/posts.service.ts`
- [Upload endpoint](https://github.com/gitroomhq/postiz-app/blob/main/apps/frontend/src/app/(app)/api/uploads/%5B%5B...path%5D%5D/route.ts): `apps/frontend/src/app/(app)/api/uploads/[[...path]]/route.ts`
- [Upload provider factory](https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/upload/upload.factory.ts): `libraries/nestjs-libraries/src/upload/upload.factory.ts`
- [Upload contract](https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/upload/upload.interface.ts): `libraries/nestjs-libraries/src/upload/upload.interface.ts`
- [Local storage](https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/upload/local.storage.ts): `libraries/nestjs-libraries/src/upload/local.storage.ts`
- [Cloud storage](https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/upload/cloudflare.storage.ts): `libraries/nestjs-libraries/src/upload/cloudflare.storage.ts`
- [Upload validation](https://github.com/gitroomhq/postiz-app/blob/main/libraries/nestjs-libraries/src/upload/custom.upload.validation.ts): `libraries/nestjs-libraries/src/upload/custom.upload.validation.ts`

### Extensions and automation

- [Command tasks](https://github.com/gitroomhq/postiz-app/blob/main/apps/commands/src/tasks/configuration.ts): `apps/commands/src/tasks/configuration.ts`
- [Command application](https://github.com/gitroomhq/postiz-app/blob/main/apps/commands/src/command.module.ts): `apps/commands/src/command.module.ts`
- [Browser extension](https://github.com/gitroomhq/postiz-app/blob/main/apps/extension/src/background.ts): `apps/extension/src/background.ts`
- [Extension messages](https://github.com/gitroomhq/postiz-app/blob/main/apps/extension/src/types/messages.ts): `apps/extension/src/types/messages.ts`
- [Cookie provider](https://github.com/gitroomhq/postiz-app/blob/main/apps/extension/src/providers/cookie-provider.interface.ts): `apps/extension/src/providers/cookie-provider.interface.ts`
- [Node SDK](https://github.com/gitroomhq/postiz-app/blob/main/apps/sdk/src/index.ts): `apps/sdk/src/index.ts`

### Other components

- **Postiz user**
- **Social platforms**

## Connections

- Postiz user → Web application: manages content (evidence: `README.md`)
- Web application → Post composer: composes posts
- Postiz user → Analytics dashboard: reviews results (evidence: `README.md`)
- Postiz user → Billing: manages billing
- Web application → Authentication: authenticates via
- Authentication → User routes: supports account access
- Web application → Social integrations: connects accounts
- Social integrations → Social platforms: connects to
- Post composer → Post routes: submits posts
- Post routes → Post data service: uses post data
- Post routes → Temporal workflows: schedules publishing
- Temporal workflows → Post activity: runs activity
- Orchestrator module → Post activity: registers activity (evidence: `apps/orchestrator/src/app.module.ts`)
- Orchestrator module → Temporal workflows: loads workflows (evidence: `apps/orchestrator/src/app.module.ts`)
- Analytics dashboard → Analytics routes: requests metrics
- Billing → Billing routes: requests billing
- Web application → Public API: uses API
- Web application → Content clipping: clips content
- Web application → AI copilot: uses AI assistance
- Upload endpoint → Upload provider factory: selects storage
- Upload provider factory → Local storage: provides storage
- Upload provider factory → Cloud storage: provides storage
- Local storage → Upload contract: implements (evidence: `libraries/nestjs-libraries/src/upload/local.storage.ts`)
- Cloud storage → Upload contract: implements (evidence: `libraries/nestjs-libraries/src/upload/cloudflare.storage.ts`)
- Upload validation → Upload contract: validates uploads
- Command tasks → Command application: registered by (evidence: `apps/commands/src/command.module.ts`)
- Browser extension → Extension messages: uses messages (evidence: `apps/extension/src/background.ts`)
- Browser extension → Cookie provider: uses provider (evidence: `apps/extension/src/background.ts`)
- Node SDK → Public API: calls API
- Unauthenticated integrations → Social integrations: supports account setup
- Permission policy → Authentication: enforces access
