Developer Docs

POSTHIVE capabilities

Detailed documentation for the product surface area: web app, review flows, collaboration tools, and the Electron desktop workflow for transfers and file cataloging.

Overview

POSTHIVE is built around deliverables and versions. Teams use projects to organize work, deliverables to define output, and versions to track every iteration. Review links keep feedback centralized while notifications, calendar views, transcripts, and todos keep production moving. The web app handles review, approvals, transcripts, and translations while the Electron desktop app focuses on transfers, cataloging, and local file workflows.

Core concepts

Workspaces

The top-level container for your team, billing tier, and overall permissions. All projects, assets, and notifications live inside a workspace.

Projects

Project-level organization for campaigns, episodes, or client engagements. Projects group deliverables, timelines, and team members.

Deliverables

The actual outputs you ship: final videos, ads, graphics, or audio files. Each deliverable has its own versions, review state, and due dates.

Versions

Each upload is preserved as a version. Versions keep history, comments, and approvals intact so nothing is lost between iterations.

Projects

  • Create projects to group deliverables, assets, and collaborators.
  • Track project status, key milestones, and high-level overview from the dashboard.
  • Share progress with clients while keeping internal team workflows private.
  • Project views centralize activity, recent uploads, and upcoming deadlines.

Versioning

  • Upload new versions with consistent naming, timestamps, and status changes.
  • Preserve review history across versions so context never resets.
  • Keep full auditability of when versions were created, approved, or superseded.
  • Version-specific metadata, files, and review status remain accessible at any time.

Reviews and approvals

  • Time-based feedback on audio, video, and assets with threaded comments.
  • Client review links can be shared externally with scoped access.
  • Approval state is tracked per deliverable to keep sign-off explicit.
  • Review interfaces support frame-accurate markers and clear resolution state.

Comments and markup

Comments are the primary feedback layer in POSTHIVE. They are tied to a version and optionally to an exact timestamp, making review notes precise and reusable.

  • Time-stamped comments anchor feedback to specific moments in playback.
  • Threaded replies keep reviewer discussion in one place.
  • Use and strike actions let reviewers signal intent: keep a note active or mark it as addressed without losing history.
  • Comment status is visible across versions so teams can confirm what changed.

Transcription

Generate transcripts for video and audio assets directly inside POSTHIVE. Transcripts are stored with the deliverable and version they belong to, making them searchable and reusable across workflows.

  • Automatic speech-to-text processing for uploads, with per-version transcript history.
  • Speaker-aware segmentation where supported, keeping dialogue organized by speaker.
  • Phrase-level timing data to align text with playback for review and captions.
  • Manual edits and corrections preserved alongside the original transcript output.

Translation

Translate transcripts into multiple languages and keep translations linked to the source transcript. Translations inherit timing data so they can be reused for subtitles.

  • Generate translated transcripts from approved source transcripts.
  • Maintain language metadata for each translation so teams can manage localization.
  • Keep translations version-aware so updates to the source can trigger refreshes.

Captions and subtitles

  • Build captions directly from transcript timing data so reviewers always see readable, time-aligned text during playback. Timing anchors are derived from the transcription process, which means captions remain accurate to the exact spoken moments instead of being approximate or manually aligned.
  • Use translated transcripts to generate localized subtitle tracks without redoing timing work. The translation stays connected to the original transcript, allowing teams to deliver multiple languages while keeping the same frame-accurate timing and consistent formatting.
  • Keep captions synchronized with version updates so reviewers see accurate text as edits evolve. When a version changes, caption sources can be refreshed and reviewed again, preventing stale subtitle files or mismatched playback text.

Calendar

  • Deliverable due dates appear in workspace calendars automatically, giving teams a shared view of what is due and when. This reduces manual tracking and ensures every deliverable deadline is visible alongside production schedules.
  • Visual day and week views make it easy to spot overlaps between projects, find congested deadlines, and rebalance workloads before issues arise. It is a clear operational view for producers and editors planning production cycles.
  • Calendar entries stay in sync with project status, so shifts in delivery phases and approvals are reflected in timeline views. Teams can trust the calendar as the current source of truth rather than a static plan.
  • Deadline notifications and reminders keep teams aligned on schedule changes, preventing missed reviews and last-minute surprises. When timelines move, the calendar and notifications update together, keeping everyone in sync.

Notifications

  • Unread counts and the notification center keep teams aware of comments, approvals, and changes without opening each deliverable. This gives a quick pulse on what needs attention across the workspace.
  • Notifications are contextual and tied to versions, deadlines, and review updates, so the team sees why an alert exists and where to act. Each notice links back to the specific deliverable or version that triggered it.
  • Stay focused with centralized updates instead of email threads. Teams can keep workflow communication inside POSTHIVE, reducing context switching and missed feedback.
  • Notification feeds surface the latest actions across the workspace, including uploads, approvals, and comment activity. This creates a lightweight activity stream for producers and stakeholders to monitor progress.

Todos

  • Track actionable tasks per deliverable and assign ownership.
  • Keep production steps visible alongside versions and reviews.
  • Mark tasks complete to keep delivery workflows transparent.
  • Todos stay linked to the project so everyone sees current priorities.

Files and storage

  • Upload source files and review-ready versions with structured storage paths.
  • Stream playback uses optimized previews while originals remain intact.
  • Storage stays organized by workspace, project, and deliverable.
  • Download flows support secure delivery of approved assets.

AI tools

  • AI-assisted workflows for transcription, translation, and content analysis.
  • Generate structured outputs that feed directly into review and caption systems.
  • Automation features reduce manual prep time for editors and producers.

Collaboration and roles

  • Invite teammates with role-based access to keep client views scoped.
  • Centralize feedback, approvals, and project visibility in one workspace.
  • Track who uploaded, reviewed, and approved every version.

Electron desktop app

The desktop app is optimized for on-set ingestion and local file management. It focuses on moving large media safely and keeping a searchable catalog of everything synced to POSTHIVE.

Transfer workflow

  • Queue large uploads with background transfer support.
  • Resume interrupted uploads and monitor progress.
  • Route footage to the correct project and deliverable from the desktop.
  • Track transfer history and statuses for accountability.

File catalog

  • Browse synced files by project, deliverable, and version.
  • Inspect metadata and file history without leaving the desktop app.
  • Use catalog search to locate assets quickly.
  • Maintain a local index for fast browsing even with slow connections.