Publishing team

A React block (a whole screen) in Beamline's CMS & media app.

A social team's settings in three places. Tags: posts with their status (scheduled, draft, sent) and tags in their own series hue, the same hue in the tag list; a post's tags chosen in multi-select up to a limit that is said (never silently dropped), cleared without touching the post, a refused save putting them back; the tag list with post counts, a report opened with the tag's exact query, a tag deleted after the posts it comes off are listed (they stay scheduled), new tags with a colour and a name that must be new; read only for people who can't manage tags (they can still tag posts). Invite: an email and name, publishing (full, needs approval, none) and community (full, none) chosen apart, the same on every channel or per channel with custom rows marked; Admin overrides without overwriting the per-channel choices; what they'll be able to do said in sentences before sending; a send that fails keeps the form; invitations pending until accepted, a resend making the earlier link stop working, revoked ones said. My access: read only, per organisation (switching never shows the last one's channels), your role, each channel's publishing and community in words with where each comes from, search, no channels and no match said, a change made after loading said with Refresh.

Use it for

A social publishing tool's team settings: tags on posts, inviting teammates with per-channel access, and each member's own access.
Any tool where people publish to several accounts with separate posting and community rights.

Not for

Planning posts on a calendar (social-scheduler).
A role matrix of many permissions (roles-permissions).
Seats, roles and removal across a workspace (team-members).

Anatomy

head: the organisation's name; Tags, Invite, My access
tags: the chosen post's tags (multi-select, limit, Clear all tags), posts with status, channel, time, text and tag chips; the tag list with swatch, name, post count, Report and Delete, a new tag with colours
invite: email, name, Admin, access on every channel or per channel (two selects a channel, Custom marked), the summary sentences, Send invitation; invitations with state, link version, Resend and Revoke
my access: organisation, role, loaded time, search, the channel table (publishing, community, comes from), ask an admin

States

tags: post untagged, tagged, at the limit, save refused, tag deleted, report opened, read only, name taken
invite: same everywhere, per channel, admin, email invalid, sending, sent, send failed, pending, resent, revoked, accepted
my access: loading, loaded, no channels, no match, organisation changed, stale with Refresh, load failed with Retry

Keyboard

Posts are buttons; the tag picker, selects and switches are their own controls with labels naming the channel and right
Colour swatches for a new tag are a radio group

Motion

Only the parts' own motion (the picker opening, the switch). Nothing runs at rest.

Props

Prop	Type	Default	Description
`organizations` (required)	`Organization[]`	—	The organisations you belong to; the first (or defaultOrgId) is the one in use.
`defaultOrgId`	`string`	—
`channels` (required)	`Channel[]`	—
`tags` (required)	`Tag[]`	—
`posts` (required)	`Post[]`	—
`tagLimit`	`number`	—	Most tags one post takes. Default 3.
`canManageTags`	`boolean`	—	Whether you may add and delete tags; anyone may tag posts. Default true.
`onSavePostTags`	`((postId: string, tagIds: string[]) => Promise<unknown>)`	—	Saves a post's tags; reject to put them back.
`onDeleteTag`	`((tagId: string) => Promise<unknown>)`	—	Deletes a tag; its posts keep everything else.
`onOpenReport`	`((query: string) => void)`	—	Opens reporting with the tag's exact query (`tag:"Spring launch"`).
`invitations`	`Invitation[]`	—
`onInvite`	`((draft: InvitationDraft) => Promise<Invitation>)`	—	Sends an invitation; resolve with it as pending, reject to keep the form.
`onResend`	`((id: string) => Promise<number>)`	—	Sends the invitation again; resolve with the new link version (the earlier link stops working).
`onRevoke`	`((id: string) => Promise<unknown>)`	—
`loadAccess` (required)	`(orgId: string) => Promise<MyAccess>`	—	Your access in an organisation.
`accessChangedAt`	`Record<string, string>`	—	When each organisation's access last changed (ISO).
`defaultView`	`PublishingTeamView`	—
`defaultPost`	`string \| null`	—
`defaultInvite`	`Partial<InvitationDraft>`	—
`defaultPerChannel`	`boolean`	—
`locale`	`string`	—
`className`	`string`	—	Classes on the documented visual root; no override by default.
`style`	`CSSProperties`	—	Inline styles on the documented visual root; no overrides by default.
`ref`	`Ref<HTMLDivElement>`	—	Receives the documented native target or imperative handle; omitted by default.

Built from

segmented-control
multi-select
select
switch
input
search-field
badge
dialog
button
skeleton

Dependencies

lucide-react

Import

import { PublishingTeam } from "@beamline/publishing-team";

Get it

Publishing team is part of Beamline UI. Install the parts you need in your React app as compiled packages or editable source. Get Beamline · Connect your agent