PlatformPackagesFrontend
Frontend Packages
Prox OS frontend packages are OS-native primitives, not business monoliths. They
Prox OS frontend packages are OS-native primitives, not business monoliths. They
provide contracts, adapters, UI shells, Storybook examples, and integration
policy that many apps can reuse without deep importing apps/os-shell.
Package Map
| Package | Role | Storybook focus |
|---|---|---|
@prox-os/actions | Shared action intent contract and React primitives for context menus, toolbars, resource cards, command previews, and AI action previews. | Buttons, menus, toolbars, action lists, AI cards, states, and media/map/command integration previews. |
@prox-os/command | Shared command contract and palette primitives for app search, action search, route jumps, docs jumps, recent commands, and AI command entry. | Command palette, input, list, items, shortcuts, previews, recent commands, and action/app/AI/developer integrations. |
@prox-os/forms | Shared form contract, validation adapters, field primitives, schema form renderer, and form action surface for app input/editing flows. | Basic forms, schema forms, field types, validation summaries, settings, filters, AI config, and destructive confirmation. |
@prox-os/editor | Shared editor contract, rich text/markdown/code/prompt adapters, toolbar actions, status, preview, and read-only primitives. | Rich text, markdown, code, prompt, comments, read-only previews, editor actions, forms integration, and AI placeholders. |
@prox-os/collaboration | Shared collaboration contracts and primitives for presence, comments, threads, mentions, sharing, review, approval, and resource collaboration panels. | Overview, presence, comments, threads, mentions, share panels, review approval, resource collaboration, editor anchors, and action intents. |
@prox-os/notifications | Shared notification contracts and primitives for badges, bells, toasts, notification center, digests, preferences, and action refs. | Overview, badge and bell, items, lists, center, toasts, preferences, digest, collaboration mapping, action intents, and system/security/AI examples. |
@prox-os/search | Shared search contracts, local adapter, filters, facets, ranking, highlights, previews, saved searches, and OS-native search UI primitives. | Overview, input, results, filters and facets, panel, preview, recent/saved searches, index stats, app/resource search, collaboration/notification search, AI/security/workspace search, and action refs. |
@prox-os/files | Shared file, folder, storage provider, preview, transfer-state, file picker, file browser, and file adapter primitives. | Overview, icons and badges, list/grid, folder tree, picker, dropzone, upload queue, preview, metadata, storage usage, action intents, and search/notification/collaboration adapters. |
@prox-os/ai-ui | Shared AI interaction contracts and primitives for sessions, messages, tool calls, approvals, artifacts, context sources, citations, model selection, agent status, usage, and risk display. | Overview, chat shell, messages, composer suggestions, model selector, context/citations, tool calls, approval flow, artifacts, run progress, agent status, and cross-package AI handoffs. |
@prox-os/security-ui | Shared security UI contracts and primitives for principals, resources, permissions, access levels, risk, trust, sensitivity, policy notices, audit events, sessions, tokens, and access reviews. | Overview, badges, risk alerts, permission/access panels, public links, sensitive context, security events, audit logs, sessions/devices, token scopes, integrations, access reviews, policies, and cross-package security handoffs. |
@prox-os/workspace-ui | Shared workspace UI contracts and primitives for workspaces, spaces, members, roles, resources, projects, milestones, settings, onboarding, integrations, stats, and workspace-aware adapters. | Overview, switcher, cards/header/sidebar, dashboard, spaces/resources, projects/milestones, members/roles/invites, settings/onboarding, integrations, creator/community/founder/developer workspaces, and cross-package workspace handoffs. |
@prox-os/activity | Shared activity timeline contracts and primitives for actors, targets, objects, events, feeds, groups, digests, stats, redaction, related resources, and cross-domain activity adapters. | Overview, items, timeline, feed panel, filters/groups, digest/summary/stats, details, related resources, workspace/file/AI activity, collaboration/notification/security activity, developer/founder/community activity, and cross-package handoffs. |
@prox-os/data-contract | Structured dataset, field, record, view, source, permission, and chart spec types. No React. | Demo dataset definitions and schema preview. |
@prox-os/data-table | Table and grid primitives using TanStack Table and a Glide Data Grid evaluation preview. | Business table, high-density grid, detail panel, empty/loading/error states. |
@prox-os/data-viz | Chart primitives and adapters using Apache ECharts, Vega-Lite, and Recharts. | Chart cards, ECharts panels, Vega-Lite specs, Recharts mini charts, states. |
@prox-os/media | Media resource contract and UI primitives for images, avatars, covers, embeds, links, actions, and transforms. | Images, avatars, covers, galleries, embeds, external previews, action intents. |
@prox-os/maps | Map and geospatial surface primitives using MapLibre GL JS. | Map preview, markers, popups, layers, attribution, provider badges, action intents. |
Reuse Rules
- Apps import packages through public package exports.
- Packages must not import OS Shell private state, window manager internals, or app registry implementation files.
- Storybook is the visual acceptance surface for primitive package states.
- Package docs describe scope, boundaries, and future integration paths.
- Heavy external systems stay behind adapters, iframes, connectors, or future package protocols.
Stewardship
The human role is Frontend Package Steward: one reviewer for frontend
platform packages across data, tables, charts, media, maps, Storybook examples,
docs, license notes, performance notes, and integration policies.
AI agent hats can be narrower:
- Data Contract Agent.
- Data Table Agent.
- Visualization Agent.
- Media Package Agent.
- Maps Package Agent.
- Actions Package Agent.
- Command Package Agent.
- Forms Package Agent.
- Editor Package Agent.
- Collaboration Package Agent.
- Notifications Package Agent.
- Search Package Agent.
- Files Package Agent.
- AI UI Package Agent.
- Security UI Package Agent.
- Workspace UI Package Agent.
- Activity Package Agent.
- Frontend Package Docs Agent.
- Storybook Coverage Agent.
- License & Policy Watch Agent.
This keeps early human organization simple while allowing focused AI maintenance runs later.