ObjectUI Development Roadmap

Last Updated: February 27, 2026 Current Version: v0.5.x Spec Version: @objectstack/spec v3.0.10 Client Version: @objectstack/client v3.0.10 Target UX Benchmark: 🎯 Airtable parity Current Priority: AppShell Navigation · Designer Interaction · View Config Live Preview Sync ✅ · Dashboard Config Panel · Airtable UX Polish · Flow Designer ✅ · App Creation & Editing Flow ✅ · System Settings & App Management ✅ · Right-Side Visual Editor Drawer ✅

📋 Executive Summary

ObjectUI is a universal Server-Driven UI (SDUI) engine built on React + Tailwind + Shadcn. It renders JSON metadata from the @objectstack/spec protocol into pixel-perfect, accessible, and interactive enterprise interfaces.

Where We Are: Foundation is solid and shipping — 35 packages, 99+ components, 6,700+ tests, 80 Storybook stories, 43/43 builds passing, ~85% protocol alignment. SpecBridge, Expression Engine, Action Engine, data binding, all view plugins (Grid/Kanban/Calendar/Gantt/Timeline/Map/Gallery), Record components, Report engine, Dashboard BI features, mobile UX, i18n (11 locales), WCAG AA accessibility, Console through Phase 20 (L3), AppShell Navigation Renderer (P0.1), Flow Designer (P2.4), Feed/Chatter UI (P1.5), App Creation & Editing Flow (P1.11), System Settings & App Management (P1.12), Page/Dashboard Editor Console Integration (P1.11), and Right-Side Visual Editor Drawer (P1.11) — all ✅ complete. ViewDesigner has been removed — its capabilities (drag-to-reorder, undo/redo) are now provided by the ViewConfigPanel (right-side config panel).

What Remains: The gap to Airtable-level UX is primarily in:

AppShell — No dynamic navigation renderer from spec JSON (last P0 blocker) ✅ Complete
Designer Interaction — DataModelDesigner has undo/redo, field type selectors, inline editing, Ctrl+S save. ViewDesigner has been removed; its capabilities (drag-to-reorder columns via @dnd-kit, undo/redo via useConfigDraft history) are now integrated into ViewConfigPanel (right-side config panel) ✅
View Config Live Preview Sync — Config panel changes sync in real-time for Grid, but showSort/showSearch/showFilters/striped/bordered not yet propagated to Kanban/Calendar/Timeline/Gallery/Map/Gantt (see P1.8.1) ✅ Complete — all 7 phases of P1.8.1 done, 100% coverage across all view types
Dashboard Config Panel — Airtable-style right-side configuration panel for dashboards (data source, layout, widget properties, sub-editors, type definitions). Widget config live preview sync and scatter chart type switch ✅ fixed (P1.10 Phase 10). Dashboard save/refresh metadata sync ✅ fixed (P1.10 Phase 11). Data provider field override for live preview ✅ fixed (P1.10 Phase 12).
Console Advanced Polish — Remaining upgrades for forms, import/export, automation, comments
PWA Sync — Background sync is simulated only

🔄 Spec v3.0.9 Upgrade Summary

Upgraded from @objectstack/spec v3.0.8 → v3.0.9 on February 22, 2026. UI sub-export is unchanged; changes are in Automation, Kernel, Data, and API layers.

New Protocol Capabilities (v3.0.9):

Area	What's New	Impact on ObjectUI
Workflow Nodes	`parallel_gateway`, `join_gateway`, `boundary_event` node types	ProcessDesigner (P2.1) & Automation builder (P1.6)
BPMN Interop	`BpmnImportOptions`, `BpmnExportOptions`, `BpmnInteropResult`, `BpmnElementMapping`	plugin-workflow BPMN import/export (P2.4)
Wait/Timer Executors	`WaitEventType` (condition/manual/webhook/timer/signal), `WaitExecutorConfig`, `WaitTimeoutBehavior`	Automation builder wait-step UI (P1.6)
Execution Tracking	`ExecutionLog`, `ExecutionStepLog`, `Checkpoint`, `ExecutionError`, `ExecutionStatus`	Automation execution history (P1.6)
Flow Edges	`conditional` edge type, `isDefault` flag	ProcessDesigner conditional routing (P2.1)
Retry Config	`backoffMultiplier`, `maxRetryDelayMs`, `jitter` on retry policy	Automation retry settings UI (P1.6)
Flow Versioning	`FlowVersionHistory`, `ConcurrencyPolicy`, `ScheduleState`	Flow version management & scheduling (P1.6)
Data Export	`ExportFormat`, `ExportJobStatus`, `CreateExportJobRequest` (export.zod)	Import/Export feature (P1.3)
App Engine	Optional `engine: { objectstack: string }` on App config	Version pinning support (P2.4)
Package Upgrade	`PackageArtifact`, `ArtifactChecksum`, `UpgradeContext`, `DependencyStatus`	Package management (P2.4)
Kernel Enhancements	`PluginBuildOptions`, `PluginPublishOptions`, `PluginValidateOptions`, `MetadataCategory`, `NamespaceConflictError`	Plugin development tooling (P2.4)

UI Sub-Export: No breaking changes — @objectstack/spec/ui types are identical between v3.0.8 and v3.0.9.

🔄 Spec v3.0.10 Upgrade Summary

Upgraded from @objectstack/spec v3.0.9 → v3.0.10 on February 25, 2026. UI sub-export adds new Zod schemas and ViewFilterRule type. Dashboard widgets now require id field. View filters must use object format.

New Protocol Capabilities (v3.0.10):

Area	What's New	Impact on ObjectUI
UI Schemas	`DensityModeSchema`, `ThemeModeSchema`, `WcagContrastLevelSchema` Zod schemas	Re-exported from `@object-ui/types` for runtime validation
View Filter Rules	`ViewFilterRule`, `ViewFilterRuleSchema` — structured filter format `{ field, operator, value }`	All view filters migrated from tuple `['field', '=', 'value']` to object format
Dashboard Widgets	`id` field now required on `DashboardWidgetSchema`	All example dashboard widgets updated with explicit `id`
Filter AST	`isFilterAST`, `parseFilterAST`, `VALID_AST_OPERATORS` in data sub-export	Filter engine utilities (P2.4)
Multi-Tenant	`TursoMultiTenantConfig`, `TenantResolverStrategy`, `TenantDatabaseLifecycle`	Cloud multi-tenancy (P2.4)
Contracts	`IAppLifecycleService`, `IDeployPipelineService`, `IProvisioningService`, `ITenantRouter`, `ISchemaDiffService`	Cloud deployment & lifecycle (P2.4)

Breaking Changes Applied:

All CRM view filters converted from ['field', '=', 'value'] to [{ field, operator: '=', value }]
All dashboard widgets (kitchen-sink, todo, CRM) given explicit id fields
Todo active filter converted from [['status', '!=', 'Done']] to [{ field: 'status', operator: '!=', value: 'Done' }]

🎯 P0 — Must Ship (v1.0 Blockers)

P0.1 AppShell & Navigation Renderer

Last remaining P0 blocker. Without this, Console cannot render a sidebar from AppSchema JSON.

Implement AppSchema renderer consuming spec JSON (name, label, icon, branding)
Build navigation tree renderer (7 nav item types: object, dashboard, page, url, report, action, group)
Implement NavigationAreaSchema support (business domain partitioning)
Implement mobile navigation modes (drawer/bottom_nav/hamburger)
Add permission guards (requiredPermissions, visible) on navigation items

🎯 P1 — UI-First: Airtable UX Parity

Priority #1. All items below directly affect end-user experience. Target: indistinguishable from Airtable for core CRUD workflows.

P1.1 Designer Interaction (DataModelDesigner)

Source: ROADMAP_DESIGNER Phase 2. ViewDesigner has been removed — its capabilities (column reorder, undo/redo) are now provided by ViewConfigPanel.

ViewDesigner: (Removed — replaced by ViewConfigPanel)

Column drag-to-reorder via @dnd-kit/core (replace up/down buttons with drag handles)
Add Ctrl+S/Cmd+S keyboard shortcut to save
Add field type selector dropdown with icons from DESIGNER_FIELD_TYPES
Column width validation (min/max/pattern check)
Removed: ViewDesigner replaced by ViewConfigPanel (right-side config panel)
ViewConfigPanel upgraded: undo/redo integrated into useConfigDraft hook
ViewConfigPanel upgraded: drag-and-drop column sorting via @dnd-kit/sortable

DataModelDesigner:

Entity drag-to-move on canvas
Inline editing for entity labels (click to edit)
Field type selector dropdown (replaces hardcoded 'text' type)
Confirmation dialogs for destructive actions (delete entity cascades to relationships)

Shared Infrastructure:

Implement useDesignerHistory hook (command pattern with undo/redo stacks)
Wire undo/redo to DataModelDesigner

P1.2 Console — Forms & Data Collection

P1.3 Console — Import/Export Excellence

Spec v3.0.9 introduces a formal Data Export/Import Protocol (export.zod) with streaming export, import validation, field mapping templates, and scheduled export jobs.

P1.4 Console — Undo/Redo & History

Cross-session undo stack persistence (survive page refresh)
Undo grouping (batch multiple field changes as one undo step)
Visual undo history panel (timeline of changes)
Undo/redo for bulk operations

P1.5 Console — Comments & Collaboration

P1.6 Console — Automation

Spec v3.0.9 significantly expanded the automation/workflow protocol. New node types, BPMN interop, execution tracking, and wait/timer executors are now available in the spec.

P1.7 Console — Navigation Enhancements

P1.8 Console — View Config Panel (Phase 20)

P1.8.1 Live Preview — Gap Analysis & Phased Remediation

Ref: Issue #711 — Right-side view config panel changes not syncing in real-time to all list types.

Current Config Property Propagation Matrix:

Property	Grid	Kanban	Calendar	Timeline	Gallery	Map	Gantt
`showSearch`	✅	✅	✅	✅	✅	✅	✅
`showSort`	✅	✅	✅	✅	✅	✅	✅
`showFilters`	✅	✅	✅	✅	✅	✅	✅
`showHideFields`	✅	✅	✅	✅	✅	✅	✅
`showGroup`	✅	✅	✅	✅	✅	✅	✅
`showColor`	✅	✅	✅	✅	✅	✅	✅
`showDensity`	✅	✅	✅	✅	✅	✅	✅
`allowExport`	✅	✅	✅	✅	✅	✅	✅
`rowHeight`	✅	✅	✅	✅	✅	✅	✅
`densityMode`	✅	✅	✅	✅	✅	✅	✅
`striped`	✅	✅	✅	✅	✅	✅	✅
`bordered`	✅	✅	✅	✅	✅	✅	✅
`groupBy`	N/A	✅	N/A	N/A	N/A	N/A	N/A
`color`	✅	✅	✅	✅	✅	✅	✅
`filter`/`sort`	✅	✅	✅	✅	✅	✅	✅
Type-specific options	✅	✅	✅	✅	✅	✅	✅

Root Causes (resolved):

generateViewSchema (plugin-view): Hardcodes showSearch: false for non-grid views → Now propagates from activeView
Console renderListView: Omits toolbar/display flags from fullSchema → Now passes all config properties
NamedListView type: Missing toolbar/display properties → Added as first-class properties
Plugin renderListView schema missing toolbar flags: renderContent → renderListView schema did not include showSearch/showFilters/showSort → Now propagated (PR #771)
ListView toolbar unconditionally rendered: Search/Filter/Sort buttons always visible regardless of schema flags → Now conditionally rendered based on schema.showSearch/showFilters/showSort (PR #771); userActions.sort/search/filter/rowHeight/addRecordForm now override toolbar flags (Issue #737)
Hide Fields/Group/Color/Density buttons always visible: No schema property to control visibility → Added showHideFields/showGroup/showColor/showDensity with conditional rendering (Issue #719)
Export toggle broken: ViewConfigPanel writes allowExport: boolean but ListView checks exportOptions object → Export now checks both exportOptions && allowExport !== false; Console clears exportOptions when allowExport === false (Issue #719)
hasExport logic bug: draft.allowExport !== false was always true when undefined → Fixed to draft.allowExport === true || draft.exportOptions != null (Issue #719)
No per-view-type integration tests: Pending — tests verify config reaches fullSchema, but per-renderer integration tests still needed
key={refreshKey} on PluginObjectView: Console wrapped PluginObjectView with key={refreshKey}, which only changed on save/create, preventing live preview of config changes → Removed key={refreshKey}; props changes now flow naturally without remounting (Issue #784)
Navigation overlay not consuming activeView.navigation: Detail overlay only read objectDef.navigation, ignoring view-level navigation config → Navigation now uses priority: activeView.navigation > objectDef.navigation > default drawer (Issue #784)

Phase 1 — Grid/Table View (baseline, already complete):

Phase 2 — Kanban Live Preview:

Propagate showSort/showSearch/showFilters through generateViewSchema kanban branch
Pass color/striped/bordered in renderContent → renderListView for kanban
Ensure groupBy config changes reflect immediately (currently ✅ via renderListView)
Add integration test: ViewConfigPanel kanban config change → Kanban renderer receives updated props

Phase 3 — Calendar Live Preview:

Propagate showSort/showSearch/showFilters through generateViewSchema calendar branch
Pass filter/sort/appearance properties to calendar renderer in real-time
Verify startDateField/endDateField config changes trigger re-render via useMemo deps
Add integration test: ViewConfigPanel calendar config change → Calendar renderer receives updated props

Phase 4 — Timeline/Gantt Live Preview:

Propagate showSort/showSearch/showFilters through generateViewSchema timeline/gantt branches
Pass appearance properties (color, striped, bordered) through renderListView schema
Ensure dateField/startDateField/endDateField config changes trigger re-render
Add integration tests for timeline and gantt config sync

Phase 5 — Gallery & Map Live Preview:

Propagate showSort/showSearch/showFilters through generateViewSchema gallery/map branches
Pass appearance properties through renderListView schema for gallery/map
Ensure gallery imageField/titleField and map locationField/zoom/center config changes trigger re-render
Add integration tests for gallery and map config sync

Phase 6 — Data Flow & Dependency Refactor:

Add showSearch/showSort/showFilters/striped/bordered/color to NamedListView type in @object-ui/types
Add showHideFields/showGroup/showColor/showDensity/allowExport to NamedListView and ListViewSchema types and Zod schema (Issue #719)
Add inlineEdit/wrapHeaders/clickIntoRecordDetails/addRecordViaForm/addDeleteRecordsInline/collapseAllByDefault/fieldTextColor/prefixField/showDescription to NamedListView and ListViewSchema types and Zod schema (Issue #719)
Update Console renderListView to pass all config properties in fullSchema
Audit all useMemo/useEffect dependency arrays in plugin-view/ObjectView.tsx for missing activeView sub-properties — all hooks correctly use whole activeView object reference; React shallow equality handles sub-property changes
Remove hardcoded showSearch: false from generateViewSchema — use activeView.showSearch ?? schema.showSearch instead

Phase 7 — End-to-End Integration Tests:

Per-view-type test: Grid config sync (showSort, showSearch, showFilters, striped, bordered)
Per-view-type test: Kanban config sync (groupBy, color, showSearch)
Per-view-type test: Calendar config sync (startDateField, endDateField, showFilters)
Per-view-type test: Timeline/Gantt config sync (dateField, appearance)
Per-view-type test: Gallery config sync (imageField, titleField, appearance)
Per-view-type test: Map config sync (locationField, zoom, center, appearance)
Cross-view-type test: Switch view type in ViewConfigPanel → verify config properties transfer correctly

P1.10 Console — Dashboard Config Panel

Airtable-style right-side configuration panel for dashboards. Phased rollout from shared infrastructure to full type-safe editing.

Phase 0 — Component Infrastructure:

Extract ConfigRow / SectionHeader from ViewConfigPanel into @object-ui/components as reusable primitives
Implement useConfigDraft generic hook for draft state management (dirty tracking, save/discard)
Define ConfigPanelSchema / ConfigSection / ConfigField types for schema-driven panel generation
Implement ConfigFieldRenderer supporting input/switch/select/checkbox/slider/color/icon-group/field-picker/filter/sort/custom
Implement ConfigPanelRenderer — schema-driven panel with header, breadcrumb, collapsible sections, sticky footer
Add configPanel i18n keys to all 10 locale files

Phase 1 — Dashboard-Level Config Panel:

Develop DashboardConfigPanel supporting layout (columns/gap/rowHeight), data (refreshInterval), appearance (title/description/theme)
Add Storybook stories for ConfigPanelRenderer and DashboardConfigPanel
Add Vitest tests (65 tests: useConfigDraft 10, ConfigFieldRenderer 22, ConfigPanelRenderer 21, DashboardConfigPanel 12)

Phase 2 — Widget-Level Configuration:

Support click-to-select widget → sidebar switches to widget property editor (title, type, data binding, layout)
Implement WidgetConfigPanel with schema-driven fields: general (title, description, type), data binding (object, categoryField, valueField, aggregate), layout (width, height), appearance (colorVariant, actionUrl)
Add Vitest tests (14 tests for WidgetConfigPanel)

Phase 3 — Sub-Editor Integration:

Integrate FilterBuilder for dashboard global filters (ConfigFieldRenderer filter type now renders inline FilterBuilder)
Integrate SortBuilder for sort configuration (ConfigFieldRenderer sort type now renders inline SortBuilder)
Add fields prop to ConfigField type for filter/sort field definitions
Dropdown filter selector and action button sub-panel visual editing

Phase 4 — Composition & Storybook:

Build DashboardWithConfig composite component (dashboard + config sidebar)
Support widget selection → WidgetConfigPanel switch with back navigation
Add Storybook stories for WidgetConfigPanel, DashboardWithConfig, and DashboardWithConfigClosed
Add Vitest tests (9 tests for DashboardWithConfig)

Phase 5 — Type Definitions & Validation:

Add DashboardConfig types to @object-ui/types
Add Zod schema validation for DashboardConfig

Phase 6 — Design Mode Preview Click-to-Select:

Add designMode, selectedWidgetId, onWidgetClick props to DashboardRenderer for preview-area widget selection
Implement click-to-select with primary ring highlight (light/dark theme compatible, a11y focus-visible ring)
Click empty space to deselect; Escape key to deselect
Keyboard navigation: ArrowRight/ArrowDown to next widget, ArrowLeft/ArrowUp to previous, Enter/Space to select, Tab/Shift+Tab for focus
Add selectedWidgetId and onWidgetSelect props to DashboardEditor for external controlled selection
Sync selection between DashboardRenderer (preview) and DashboardEditor (drawer) via shared state in DashboardView
Property changes in editor panel instantly reflected in preview (live preview path verified end-to-end)
Auto-save property changes to backend via DesignDrawer
Add Vitest tests (15 DashboardRenderer design mode + 9 DashboardEditor external selection + 8 DashboardView integration = 32 new tests)

Phase 7 — Non-Modal Drawer & Property Panel UX Fix:

SheetContent — added hideOverlay prop to conditionally skip the full-screen backdrop overlay
DesignDrawer — modal={false} + hideOverlay so preview widgets are clickable while drawer is open
DashboardEditor — property panel renders above widget grid (stacked flex-col layout) for immediate visibility in narrow drawer
DashboardEditor — property panel uses full width (removed fixed w-72) for better readability in drawer context
Preview click → editor property panel linkage now works end-to-end (select, switch, deselect)
Add 11 new tests (7 DashboardDesignInteraction integration + 4 DashboardEditor.propertyPanelLayout)

Phase 8 — Inline Config Panel Refactor (ListView Parity):

Phase 9 — Design Mode Widget Selection Click-Through Fix:

Fix: Widget content (charts, tables via SchemaRenderer) intercepted click events, preventing selection in edit mode
Defense layer 1: pointer-events-none on SchemaRenderer content wrappers disables chart/table hover and tooltip interactivity in design mode
Defense layer 2: Transparent click-capture overlay (absolute inset-0 z-10) renders on top of widget content in design mode — guarantees click reaches widget handler even if SVG children override pointer-events
Self-contained (metric) widgets: both pointer-events-none on SchemaRenderer + overlay inside relative wrapper
Card-based (chart/table) widgets: pointer-events-none on CardContent inner wrapper + overlay inside relative Card
No impact on non-design mode — widgets remain fully interactive when not editing
Updated SchemaRenderer mock to forward className and include interactive child button for more realistic testing
Add 9 new Vitest tests: pointer-events-none presence/absence, overlay presence/absence, relative positioning, click-to-select on Card-based widgets

Phase 10 — Widget Config Live Preview Sync & Type Switch Fix:

Phase 11 — Dashboard Save/Refresh Metadata Sync:

Fix: saveSchema in DashboardView did not call metadata.refresh() after PATCH — closing config panel showed stale data from cached metadata
Fix: previewSchema only used editSchema when configPanelOpen=true — changed to editSchema || dashboard so edits remain visible after panel close until metadata refreshes
Add useEffect to clear stale editSchema when metadata refreshes while config panel is closed (seamless transition)
Clear editSchema and config panel state on dashboard navigation (dashboardName change)
Fix: DashboardDesignPage.saveSchema did not call metadata.refresh() — other pages saw stale dashboard data after save
Add 5 new Vitest tests: metadata refresh after widget save (2), metadata refresh after widget delete (2), metadata refresh after DashboardDesignPage save (1)

Phase 12 — Data Provider Field Override for Live Preview:

Fix: Widget-level fields (categoryField, valueField, aggregate, object) did not override data provider config (widget.data.aggregate) — editing these fields in the config panel had no effect on the rendered chart when a data provider was present
getComponentSchema() in DashboardRenderer and DashboardGridLayout now merges widget-level fields with data provider aggregate config, with widget-level fields taking precedence
Fix: objectName for table/pivot widgets used widgetData.object || widget.object — reversed to widget.object || widgetData.object so config panel edits to data source are reflected immediately
Fix: DashboardWithConfig did not pass designMode, selectedWidgetId, or onWidgetClick to DashboardRenderer — widgets could not be selected or live-previewed in the plugin-level component
Add 10 new Vitest tests: widget-level field overrides for aggregate groupBy/field/function (3), objectName precedence for chart/table (2), simultaneous field overrides (1), DashboardWithConfig design mode and widget selection (2), existing live preview tests (2)

P1.11 Console — Schema-Driven View Config Panel Migration

Migrated the Console ViewConfigPanel from imperative implementation (~1655 lines) to Schema-Driven architecture using ConfigPanelRenderer + useConfigDraft + ConfigPanelSchema, reducing to ~170 lines declarative wrapper + schema factory.

Phase 1 — Infrastructure & Utils Extraction:

Extract operator mapping (SPEC_TO_BUILDER_OP, BUILDER_TO_SPEC_OP), normalizeFieldType, parseSpecFilter, toSpecFilter to shared view-config-utils.ts
Extract parseCommaSeparated, parseNumberList, VIEW_TYPE_LABELS, ROW_HEIGHT_OPTIONS to shared utils
Add deriveFieldOptions, toFilterGroup, toSortItems bridge helpers
Enhance ConfigPanelRenderer with accessibility props (panelRef, role, ariaLabel, tabIndex)
Enhance ConfigPanelRenderer with test ID override props (testId, closeTitle, footerTestId, saveTestId, discardTestId)

Phase 2 — Schema Factory (All Sections):

Page Config section: label, description, viewType, toolbar toggles (7 switches), navigation mode/width/openNewTab, selection, addRecord sub-editor, export + sub-config, showRecordCount, allowPrinting
Data section: source, sortBy (expandable), groupBy (grid/gallery), columns selector (expandable w/ reorder), filterBy (expandable), pagination, searchable/filterable/hidden fields (expandable), quickFilters (expandable), virtualScroll (grid only), type-specific options (kanban/calendar/map/gallery/timeline/gantt)
Appearance section: color (grid/calendar/timeline/gantt), rowHeight (icon group, grid only), wrapHeaders (grid only), showDescription, striped/bordered (grid only), resizable (grid only), conditionalFormatting (expandable, grid/kanban), emptyState (title/message/icon)
User Actions section: inlineEdit (grid only), addDeleteRecordsInline (grid only), rowActions/bulkActions (expandable, grid/kanban)
Sharing section: sharingEnabled, sharingVisibility (visibleWhen: sharing.enabled)
Accessibility section: ariaLabel, ariaDescribedBy, ariaLive
ExpandableWidget component for hook-safe expandable sub-sections within custom render functions

Phase 3 — ViewConfigPanel Wrapper:

Rewrite ViewConfigPanel as thin wrapper (~170 lines) using useConfigDraft + buildViewConfigSchema + ConfigPanelRenderer
Stabilize source reference with useMemo keyed to activeView.id (prevents draft reset on parent re-renders)
Create/edit mode support preserved (onCreate/onSave, discard behavior)
All spec format bridging preserved (filter/sort conversion)

Phase 4 — Testing & Validation:

All 122 existing ViewConfigPanel tests pass (test mock updated for ConfigPanelRenderer + useConfigDraft)
All 23 ObjectView integration tests pass (test ID and title props forwarded)
53 new schema-driven tests (utils + schema factory coverage)
14 new ObjectGrid rowHeight tests (all 5 enum values: initialization, cycle, label, toggle visibility)
Full affected test suite: 2457+ tests across 81+ files, all pass

Phase 5 — Spec Alignment Completion (Issue #745):

ObjectGrid rowHeight: full 5-enum rendering (cellClassName, cycleRowHeight, icon map) — was hardcoded to 3
18 new ViewConfigPanel interaction tests: collapseAllByDefault, showDescription, clickIntoRecordDetails, addDeleteRecordsInline toggles; sharing visibility conditional hide; navigation width/openNewTab conditional rendering; all 5 rowHeight button clicks; boundary tests (empty actions, long labels, special chars); pageSizeOptions input; densityMode/ARIA live enums; addRecord conditional sub-editor; sharing visibility select
8 new schema-driven spec tests: accessibility field ordering, emptyState compound field, switch field defaults, comprehensive visibleWhen predicates (sharing, navigation width, navigation openNewTab)
All spec fields verified: Appearance/UserActions/Sharing/Accessibility sections 100% covered with UI controls, defaults, ordering, and conditional visibility
Add description field to NamedListView protocol interface (spec alignment)
Add disabledWhen predicate to ConfigField type — grid-only fields (striped/bordered/wrapHeaders/resizable) disabled for non-grid views
Add expandedSections prop to ConfigPanelRenderer for external section collapse control (auto-focus/highlight)
Add helpText to navigation-dependent fields (width/openNewTab) with i18n hints (all 11 locales)
24 new tests: expandedSections override (3), disabledWhen evaluation (2), grid-only disabledWhen predicates (16), helpText validation (2), description spec alignment (1)

Phase 6 — Config Panel Cleanup (Invalid Items Fix):

Phase 7 — Section Restructure & Field Selector Upgrade (Airtable UX Parity):

Phase 8 — Tab Gear Icon, Panel Animation & UX Polish:

Add onConfigView prop to ViewTabBar with Settings2 gear icon on active tab
Wire gear icon in ObjectView: click opens ViewConfigPanel for that view's settings
Panel slide-in/slide-out animation: CSS transition on max-width + opacity (300ms ease-in-out)
Auto-sync panel content on view tab switch (ViewConfigPanel resets draft when activeView.id changes)
5 new ViewTabBar gear icon tests (show on active, hide on inactive, callback, event isolation)
3 new ViewConfigPanel tests (search input, Show All, Hide All)
49 ViewTabBar tests pass, 139 ViewConfigPanel tests pass, 31 ObjectView tests pass

Code Reduction: ~1655 lines imperative → ~170 lines declarative wrapper + ~1100 lines schema factory + ~180 lines shared utils = >50% net reduction in component code with significantly improved maintainability

P1.9 Console — Content Area Layout & Responsiveness

Add min-w-0 / overflow-hidden to flex layout chain (SidebarInset → AppShell → ObjectView → PluginObjectView) to prevent content overflow
Fix Gantt task list width — responsive sizing (120px mobile, 200px tablet, 300px desktop) instead of hardcoded 300px
Fix Kanban board overflow containment (min-w-0 on swimlane and flat containers)
Fix Calendar header responsive wrapping and date label sizing
Fix Map container overflow containment via cn() merge
Fix Timeline container min-w-0 to prevent overflow
Fix ListView container min-w-0 overflow-hidden to prevent overflow
Mobile/tablet end-to-end testing for all view types
Dynamic width calculation for Gantt task list and Kanban columns based on container width

P1.11 App Creation & Editing Flow (Airtable Interface Designer UX)

Full app creation & editing experience aligned with Airtable Interface Designer UX. Components live in @object-ui/plugin-designer, types in @object-ui/types.

Types & Interfaces:

AppWizardDraft / AppWizardStep / BrandingConfig / ObjectSelection / EditorMode types
isValidAppName() snake_case validator function
wizardDraftToAppSchema() draft-to-schema conversion function

App Creation Wizard (4-step):

Step 1: Basic Info — name (snake_case validated), title, description, icon, template, layout selector
Step 2: Object Selection — card grid with search, select all/none, toggle selection
Step 3: Navigation Builder — auto-generates NavigationItem[] from selected objects, add group/URL/separator, reorder up/down, remove
Step 4: Branding — logo URL, primary color, favicon, live preview card
Step indicator with connected progress dots
Step validation (step 1 requires valid snake_case name + title)
onComplete callback returns full AppWizardDraft

Navigation Designer:

Page Canvas Editor:

Dashboard Editor:

Object View Configurator:

7 view type switcher (Grid, Kanban, Calendar, Gallery, Timeline, Map, Gantt)
Column visibility toggle with visible count
Column reorder (up/down)
Toolbar toggles (showSearch, showFilters, showSort)
Appearance section (row height, striped, bordered)
Collapsible sections

Editor Mode Toggle:

Three-way toggle (Edit / Preview / Code)
Radio group accessibility (role="radiogroup", aria-checked)
Disabled state support

i18n:

appDesigner section with 133 keys added to all 10 locales (en, zh, ja, de, fr, es, ar, ru, pt, ko)
useDesignerTranslation safe wrapper hook with English fallback (no I18nProvider required)
AppCreationWizard fully i18n-integrated (all labels, buttons, step names, validation messages)
NavigationDesigner fully i18n-integrated (type badges, quick-add labels, aria-labels, preview, icon editing, visibility, export/import)
DashboardEditor fully i18n-integrated (toolbar labels, preview text)
PageCanvasEditor fully i18n-integrated (toolbar labels, mode tabs, preview text)
BrandingEditor fully i18n-integrated (14 new keys: editor title, export/import, preview, palette, font, light/dark, mobile preview, sample text)

UX Enhancements:

Cancel confirmation dialog with unsaved-changes detection
onSaveDraft callback for partial progress save
useConfirmDialog hook integration for cancel workflow

Testing:

11 type tests (isValidAppName, wizardDraftToAppSchema, type shapes)
41 AppCreationWizard tests (rendering, steps 1-4, navigation, callbacks, cancel confirm, save draft, i18n, read-only)
33 NavigationDesigner tests (rendering, add, remove, groups, badges, i18n, read-only, icon editing, visibility toggle, export/import, responsive)
7 EditorModeToggle tests (render, active mode, onChange, accessibility, disabled)
22 DashboardEditor tests (rendering, add/remove widgets, property panel, read-only, undo/redo, export/import, preview mode, widget layout)
23 PageCanvasEditor tests (rendering, add/remove components, property panel, read-only, mode tabs, undo/redo, export/import, preview mode)
12 ObjectViewConfigurator tests (rendering, view type switch, column visibility, toggles, read-only)
29 BrandingEditor tests (rendering, editing, light/dark preview, read-only, undo/redo, export/import, keyboard shortcuts, preview content)
Total: 238 tests across 10 files, all passing

ComponentRegistry:

Registered: app-creation-wizard, navigation-designer, dashboard-editor, page-canvas-editor, object-view-configurator, branding-editor

Branding Editor:

Console Integration:

P1.12 System Settings & App Management Center

Unified system settings hub, app management page, and permission management page.

System Hub Page (/system/):

Card-based overview linking to all system administration sections
Live statistics for each section (users, orgs, roles, permissions, audit logs, apps)
Navigation to Apps, Users, Organizations, Roles, Permissions, Audit Log, Profile

App Management Page (/system/apps):

Full app list with search/filter
Enable/disable toggle per app
Set default app
Delete app with confirmation
Bulk select with enable/disable operations
Navigate to Create App / Edit App pages
Navigate to app home

Permission Management Page (/system/permissions):

CRUD grid for sys_permission object
Search/filter permissions
Admin-only create/delete controls

Sidebar & Navigation Updates:

Settings button → /system/ hub (was /system/profile)
App switcher "Manage All Apps" link → /system/apps

Empty State & System Route Accessibility (P1.12.1):

"Create App" button always shown in empty state (even when config loading fails)
"System Settings" link always shown alongside "Create App" in empty state
Top-level /system/* routes accessible without any app context (promoted to main routes)
Top-level /create-app route accessible without any app context
Sidebar fallback navigation with system menu items when no apps are configured
System pages (SystemHubPage, AppManagementPage) handle missing appName gracefully
Login/Register/Forgot password pages remain always accessible regardless of app state

Routes:

/system/ → SystemHubPage
/system/apps → AppManagementPage
/system/permissions → PermissionManagementPage

Tests:

11 new tests (SystemHubPage, AppManagementPage, PermissionManagementPage)
Total: 20 system page tests passing

🧩 P2 — Polish & Advanced Features

P2.0 Flow Designer ✅

Status: Complete — FlowDesigner component shipped in @object-ui/plugin-workflow.

The FlowDesigner is a canvas-based flow editor that bridges the gap between the approval-focused WorkflowDesigner and the BPMN-heavyweight ProcessDesigner. It targets automation/integration flows with spec v3.0.9 types.

Core Canvas:

Drag-to-reposition nodes on SVG canvas
Undo/redo with keyboard shortcuts (Ctrl+Z / Ctrl+Y)
Ctrl+S save shortcut with onSave callback
Zoom in/out/reset controls
Edge creation by clicking source → target connection ports
Node deletion via delete button or Delete key

Node Types (spec v3.0.9):

Standard nodes: start, end, task, user_task, service_task, script_task, approval, condition
Gateway nodes: parallel_gateway, join_gateway
Event nodes: boundary_event, delay, notification, webhook

Edges (spec v3.0.9):

Edge types: default, conditional, timeout
Conditional edges with condition expression field
isDefault flag for default/fallthrough edge marking
Visual differentiation: dashed lines for conditional, dotted for default

Property Panel:

Node property editor: label, type, description
Node executor configuration: FlowNodeExecutorDescriptor (type, inputSchema, outputSchema, timeoutMs, retry policy)
Wait event config for delay nodes: FlowWaitEventType (condition/manual/webhook/timer/signal)
Boundary event config: FlowBoundaryConfig (attachedToNodeId, eventType, cancelActivity, timer, errorCode)
Edge property editor: label, type, condition expression, isDefault toggle

Spec v3.0.9 Protocol Features:

FlowVersionEntry[] version history panel with current/previous entries
FlowConcurrencyPolicy badge display (allow/forbid/replace/queue)
FlowExecutionStep[] execution monitoring overlay with per-node status icons
FlowBpmnInteropResult BPMN XML export with warning/error reporting

ComponentRegistry:

Registered as 'flow-designer' with all inputs documented

P2.1 Designer — Remaining Interaction (Post-v1.0)

P2.2 Designer — Advanced Features

Full property editors for all designers (PageDesigner, ProcessDesigner, ReportDesigner)
i18n integration: all hardcoded strings through resolveI18nLabel
Canvas pan/zoom with minimap
Auto-layout algorithms (force-directed for DataModel, Dagre for Process)
Copy/paste support (Ctrl+C/Ctrl+V) across all designers
Multi-select (Ctrl+Click, Shift+Click) and bulk operations
Responsive collapsible panels

P2.3 Designer — Collaboration Integration

Wire CollaborationProvider into each designer's state management
Live cursor positions (PresenceCursors component)
Operation-based undo/redo sync
Conflict resolution UI (merge dialog)
Version history browser with restore

P2.4 Spec Compliance Gaps (Low Priority)

P2.6 ListView Spec Protocol Gaps (Remaining) ✅

All items from the ListView Spec Protocol analysis have been implemented.

P0 — Core Protocol:

data (ViewDataSchema): ListView consumes schema.data — supports provider: value (inline items), provider: object (fetch from objectName), and plain array shorthand. Falls back to dataSource.find() when not set.
grouping rendering: Group button enabled with GroupBy field picker popover. Grouping config wired to ObjectGrid child view, which renders collapsible grouped sections via useGroupedData hook.
rowColor rendering: Color button enabled with color-field picker popover. Row color config wired to ObjectGrid child view, which applies row background colors via useRowColor hook.

P1 — Structural Alignment:

quickFilters structure reconciliation: Auto-normalizes spec { field, operator, value } format into ObjectUI { id, label, filters[] } format. Both formats supported simultaneously. Dual-format type union (QuickFilterItem = ObjectUIQuickFilterItem | SpecQuickFilterItem) exported from @object-ui/types. Standalone normalizeQuickFilter() / normalizeQuickFilters() adapter functions in @object-ui/core. Bridge (list-view.ts) normalizes at spec→SchemaNode transform time. Spec shorthand operators (eq, ne, gt, gte, lt, lte) mapped to ObjectStack AST operators. Mixed-format arrays handled transparently.
conditionalFormatting expression reconciliation: Supports spec { condition, style } format alongside ObjectUI field/operator/value rules. Dual-format type union (ConditionalFormattingRule = ObjectUIConditionalFormattingRule | SpecConditionalFormattingRule) exported from @object-ui/types. Zod validator updated with z.union() for both formats. evaluatePlainCondition() convenience function in @object-ui/core for safe plain/template expression evaluation with record context. Plain expressions (e.g., status == 'overdue') evaluated directly without ${} wrapper; record fields spread into evaluator context for direct field references alongside data. namespace. Mixed-format arrays handled transparently.
exportOptions schema reconciliation: Accepts both spec string[] format (e.g., ['csv', 'xlsx']) and ObjectUI object format { formats, maxRecords, includeHeaders, fileNamePrefix }.
Column pinned: pinned property added to ListViewSchema column type. Bridge passes through to ObjectGrid which supports frozenColumns. ObjectGrid reorders columns (left-pinned first, right-pinned last with sticky CSS). Zod schema updated with pinned field. useColumnSummary hook created.
Column summary: summary property added to ListViewSchema column type. Bridge passes through for aggregation rendering. ObjectGrid renders summary footer with count/sum/avg/min/max aggregations via useColumnSummary hook. Zod schema updated with summary field.
Column link: ObjectGrid renders click-to-navigate buttons on link-type columns with navigation.handleClick. Primary field auto-linked.
Column action: ObjectGrid renders action dispatch buttons via executeAction on action-type columns.
tabs (ViewTabSchema): TabBar component renders view tabs above the ListView toolbar. Supports icon (Lucide), pinned (always visible), isDefault (auto-selected), visible filtering, order sorting, and active tab state. Tab switch applies filter config. Extracted as reusable TabBar component in packages/plugin-list/src/components/TabBar.tsx. i18n keys added for all 10 locales.

P2 — Advanced Features:

rowActions: Row-level dropdown action menu per row in ObjectGrid. schema.rowActions string array items rendered as dropdown menu items, dispatched via executeAction.
bulkActions: Bulk action bar rendered in ListView when rows are selected and schema.bulkActions is configured. Fires onBulkAction callback with action name and selected rows.
sharing schema reconciliation: Supports both ObjectUI { visibility, enabled } and spec { type: personal/collaborative, lockedBy } models. Share button renders when either enabled: true or type is set. Zod validator updated with type and lockedBy fields. Bridge normalizes spec format: type: personal → visibility: private, type: collaborative → visibility: team, auto-sets enabled: true.
exportOptions schema reconciliation: Zod validator updated to accept both spec string[] format and ObjectUI object format via z.union(). ListView normalizes string[] to { formats } at render time.
pagination.pageSizeOptions backend integration: Page size selector is now a controlled component that dynamically updates effectivePageSize, triggering data re-fetch. onPageSizeChange callback fires on selection. Full test coverage for selector rendering, option enumeration, and data reload.
$expand auto-injection: buildExpandFields() utility in @object-ui/core scans schema fields for lookup/master_detail types and returns field names for $expand. Integrated into all data-fetching plugins (ListView, ObjectGrid, ObjectKanban, ObjectCalendar, ObjectGantt, ObjectMap, ObjectTimeline, ObjectGallery, ObjectView, ObjectAgGrid) so the backend (objectql) returns expanded objects instead of raw foreign-key IDs. Supports column-scoped expansion (ListColumn[] compatible) and graceful fallback when $expand is not supported. Cross-repo: objectql engine expand support required for multi-level nesting.

P2.7 Platform UI Consistency & Interaction Optimization ✅

All items from the UI consistency optimization (Issue #749) have been implemented.

Global Theme & Design Tokens:

Hardcoded gray colors in GridField.tsx, ReportRenderer.tsx, and ObjectGrid.tsx replaced with theme tokens (text-muted-foreground, bg-muted, border-border, border-foreground)
Global font-family (Inter, ui-sans-serif, system-ui) injected in index.css :root
--config-panel-width CSS custom property added for unified config panel sizing (updated to 320px in P2.8)
Border radius standardized to rounded-lg across report/grid components
transition-colors duration-150 added to all interactive elements (toolbar buttons, tab bar, sidebar menu buttons)
LayoutRenderer.tsx outer shell bg-slate-50/50 dark:bg-zinc-950 replaced with bg-background theme token

Sidebar Navigation:

SidebarMenuButton active state enhanced with 3px left indicator bar via before: pseudo-element
SidebarMenuButton transition expanded to include color, background-color with duration-150
SidebarGroupLabel visual separator added (border-t border-border/30 pt-3 mt-2)
Collapsed-mode tooltip support in SidebarNav via tooltip={item.title} prop
LayoutRenderer.tsx hand-written sidebar → SidebarNav unification (deferred: requires extending SidebarNav to support nested menus, logo, version footer)

ListView Toolbar:

Search changed from expandable button to always-visible inline <Input> (w-48)
Activated state (bg-primary/10 border border-primary/20) added to Filter/Sort/Group/Color buttons when active
Toolbar overflow improved with overflow-x-auto for responsive behavior
transition-colors duration-150 added to all toolbar buttons

ObjectGrid Cell Renderers:

formatRelativeDate() function added for relative time display ("Today", "2 days ago", "Yesterday")
DataTable/VirtualGrid header styling unified: text-[11px] font-semibold uppercase tracking-wider text-muted-foreground/70 bg-muted/30
Remaining hardcoded gray colors in ObjectGrid loading spinner and status badge fallback replaced with theme tokens
Select/status type Badge rendering — getCellRenderer() returns <Badge> with color mapping from field.options; auto-generated options from unique data values when type is inferred; priority semantic colors (Critical→red, High→orange, Medium→yellow, Low→gray); muted default style for unconfigured colors
Date type human-readable formatting — DateCellRenderer defaults to relative format ("Today", "Yesterday", "3 days ago"); overdue dates styled with red text; ISO timestamp shown as hover tooltip; formatRelativeDate() threshold tightened to 7 days
Boolean type visual rendering — BooleanCellRenderer renders <Checkbox disabled> for true/false; null/undefined values display as —

ConfigPanelRenderer:

<Separator> added between sections for visual clarity
Panel width uses --config-panel-width CSS custom property

View Tab Bar:

Tab spacing tightened (gap-0.5, px-3 py-1.5)
Active tab indicator changed to bottom border (border-b-2 border-primary font-medium text-foreground)
transition-colors duration-150 added to tab buttons

P2.8 Airtable Parity: Product View & Global UI Detail Optimization

Platform-level grid, toolbar, sidebar, and config panel optimizations for Airtable-level experience (Issue #768).

Platform: DataTable & ObjectGrid Enhancements:

rowStyle callback prop added to DataTableSchema type — enables inline CSSProperties per row
<TableRow> in data-table.tsx applies rowStyle callback for runtime row styling
ObjectGrid: conditionalFormatting rules wired to rowStyle — evaluates both spec-format (condition/style) and ObjectUI-format (field/operator/value) rules per row using evaluatePlainCondition from @object-ui/core
Row number (#) column: hover shows <Checkbox> for multi-select (when selectable mode is enabled), replacing expand icon

Platform: ListView Toolbar:

Visual <div> separators (h-4 w-px bg-border/60) between toolbar button groups: Search | Hide Fields | Filter/Sort/Group | Color/Density | Export
Separators conditionally rendered only when adjacent groups are visible
Inline search moved to toolbar left end (w-48, Airtable-style)
Density button: activated state highlight (bg-primary/10 border border-primary/20) when density is non-default
Merged UserFilters row and tool buttons row into single toolbar line — left: field filter badges, right: tool buttons with separator
Search changed from inline input to icon button + Popover — saves toolbar space, matches Airtable pattern
UserFilters maxVisible prop added — overflow badges collapse into "More" dropdown with Popover
Toolbar layout uses flex with min-w-0 overflow handling for responsive behavior

Platform: ViewTabBar:

Tab "•" dot indicator replaced with descriptive badge (F/S/FS) + tooltip showing "Active filters", "Active sort"

Platform: Console Sidebar:

Recent items section: default collapsed with chevron toggle (saves sidebar space)

Platform: ViewConfigPanel Advanced Sections:

userActions, sharing, and accessibility sections set to defaultCollapsed: true — common settings remain expanded, advanced settings folded by default

Platform: Config Panel Width:

--config-panel-width CSS variable increased from 280px to 320px for wider config panel

CRM Example: Product Grid Column Configs:

All columns upgraded from string[] to ListColumn[] with explicit field, label, width, type, align
IS ACTIVE: type: 'boolean' for <Checkbox disabled> rendering
Price: type: 'currency', align: 'right' for formatCurrency formatting
Default rowHeight: 'short' for compact density
Conditional formatting: stock=0 red, stock<5 yellow warning
Column widths: NAME 250, SKU 120, CATEGORY 110, PRICE 120, STOCK 80

Tests:

7 new CRM metadata tests validating column types, widths, rowHeight, conditionalFormatting
136 ViewConfigPanel tests updated for defaultCollapsed sections (expand before access)
411 ListView + ViewTabBar tests passing (255 plugin-list tests including 9 new toolbar/collapse tests)
11 AppSidebar tests passing

P2.9 Platform UI Navigation & Table Optimization ✅

Platform-level sidebar, navigation, and grid/table UX improvements (Issue #XX).

Sidebar Navigation:

Pin icons show-on-hover: SidebarMenuAction in NavigationRenderer now uses showOnHover={!item.pinned} — unpinned items show pin icon only on hover; pinned items always show unpin icon. Applied to both action and leaf navigation item types.
Search placeholder contrast: Search icon in AppSidebar improved from opacity-50 → opacity-70 for better readability.
Recent section position: Recent items section moved above Record Favorites in AppSidebar for quicker access to recently visited items.
Favorites section: Already hides automatically when no pinned items exist (verified).
Resizable sidebar width: SidebarRail enhanced with pointer-event drag-to-resize (min 200px, max 480px). Width persisted to localStorage. Click toggles sidebar, double-click resets to default. useSidebar() hook now exposes sidebarWidth and setSidebarWidth.

Grid/Table Field Inference:

Percent field auto-inference: inferColumnType() in ObjectGrid now detects fields with names containing probability, percent, percentage, completion, progress, rate and assigns PercentCellRenderer with progress bar display.
ISO datetime fallback: ObjectGrid inferColumnType() now detects ISO 8601 datetime strings (YYYY-MM-DDTHH:MM) in data values as a catch-all for fields whose names don't match date/datetime patterns.
Date/datetime human-friendly display: DateCellRenderer (relative format) and DateTimeCellRenderer (split date/time) already registered in field registry for all grid/table views.
Currency/status/boolean renderers: Already implemented with proper formatting (currency symbol, Badge colors, checkbox display).
accessorKey-format type inference: generateColumns() in ObjectGrid now applies inferColumnType() + getCellRenderer() to accessorKey-format columns that don't already have a cell renderer. Previously, accessorKey columns bypassed the entire inference pipeline, showing raw dates, plain text status/priority, and raw numbers for progress.
humanizeLabel() utility: New humanizeLabel() export in @object-ui/fields converts snake_case/kebab-case values to Title Case (e.g., in_progress → In Progress). Used as fallback in SelectCellRenderer when no explicit option.label exists.
PercentCellRenderer progress-field normalization: PercentCellRenderer now uses field name to disambiguate 0-1 fraction vs 0-100 whole number — fields matching /progress|completion/ treat values as already in 0-100 range (e.g., 75 → 75%), while other fields like probability still treat 0.75 → 75%.

Header & Breadcrumb i18n:

AppHeader breadcrumb labels (Dashboards, Pages, Reports, System) now use t() translation via useObjectTranslation.
console.breadcrumb i18n keys added to all 11 locales (en, zh, ja, ko, de, fr, es, pt, ru, ar).
header-bar renderer: resolveCrumbLabel() handles both string and I18nLabel objects for breadcrumb labels.
breadcrumb renderer: resolveItemLabel() handles both string and I18nLabel objects for item labels.

Tests:

46 NavigationRenderer tests passing (pin/favorites/search/reorder)
86 field cell renderer tests passing (date/datetime/select/boolean/percent/humanizeLabel/progress)
293 ObjectGrid tests passing (inference, rendering, accessibility, accessorKey-format inference)
28 DataTable tests passing
78 Layout tests passing (NavigationRenderer + AppSchemaRenderer)
11 AppSidebar tests passing
32 i18n tests passing

P2.5 PWA & Offline (Real Sync)

Background sync queue → real server sync (replace simulation)
Conflict resolution on reconnection wired into Console flow
Optimistic updates with TransactionManager state application

🔮 P3 — Future Vision (Deferred)

CRM Example Metadata Enhancement ✅

Comprehensive metadata expansion for the CRM reference implementation.

Ecosystem & Marketplace

Plugin marketplace website with search, ratings, and install count
Plugin publishing CLI (os ui publish) with automated validation
25+ official plugins

Community Growth

Official website (www.objectui.org) with interactive playground
Discord community, monthly webinars, technical blog, YouTube tutorials

ObjectUI Cloud (2027)

Project hosting, online editor, Database as a Service
One-click deployment, performance monitoring
Billing system (Free / Pro / Enterprise)

Industry Solutions (2027)

CRM, ERP, HRM, E-commerce, Project Management accelerators
AI-powered schema generation from natural language

📈 Success Metrics

v1.0 Release Criteria

Metric	Current	v1.0 Target	How Measured
Protocol Alignment	~85%	90%+ (UI-facing)	Protocol Consistency Assessment
AppShell Renderer	✅ Complete	Sidebar + nav tree from `AppSchema` JSON	Console renders from spec JSON
Designer Interaction	Phase 2 (most complete)	DataModelDesigner drag/undo; ViewDesigner removed (replaced by ViewConfigPanel)	Manual UX testing
Build Status	43/43 pass	43/43 pass	`pnpm build`
Test Count	6,700+	6,700+	`pnpm test` summary
Test Coverage	90%+	90%+	`pnpm test:coverage`
Storybook Stories	80	91+ (1 per component)	Story file count
Console i18n	100%	100%	No hardcoded strings

🐛 Bug Fixes

ListView Grouping Config Not Taking Effect (February 2026)

Root Cause: viewComponentSchema useMemo in ListView.tsx was missing groupingConfig, rowColorConfig, and navigation.handleClick in its dependency array. When users toggled grouping fields via the toolbar popover, the state changed but the memoized schema was not recomputed, so the child grid/kanban/gallery never received the updated grouping config.

Fix: Added groupingConfig, rowColorConfig, and navigation.handleClick to the useMemo dependency array at line 856 of ListView.tsx.

Tests: Added integration test in ListViewGroupingPropagation.test.tsx that verifies toggling a group field via the toolbar immediately updates the rendered schema. All 117 ListView tests pass.

List View Row Click Not Navigating to Record Detail (February 2026)

Root Cause: onRowClick in both PluginObjectView (line 772) and renderListView (line 599) of ObjectView.tsx fell back to onEdit / editHandler, which only opens an edit form. The navOverlay.handleClick from useNavigationOverlay — which handles drawer/modal/page navigation modes — was never connected to these click handlers. Additionally, the useNavigationOverlay hook was missing the onNavigate callback needed for mode: 'page' to update the URL.

Fix: Replaced onEdit/editHandler fallbacks with navOverlay.handleClick in both row click handlers, added onNavigate callback to useNavigationOverlay that sets the recordId URL search parameter, and added navOverlay to the renderListView useCallback dependency array.

Tests: All 32 ObjectView tests and 29 useNavigationOverlay tests pass.

ListView Multi-Navigation Mode Support — split/popover/page/new_window (February 2026)

Root Cause: While drawer/modal modes worked in the Console ObjectView, the remaining 4 navigation modes had gaps:

Console's onNavigate callback relied on implicit fallthrough for view action (page mode) — not explicit.
PluginObjectView's formLayout only mapped drawer/modal modes; split/popover fell through to the default layout (drawer), rendering the wrong overlay type.
PluginObjectView lacked NavigationOverlay integration for split (resizable side-by-side panels) and popover (compact dialog preview).

Fix:

Console onNavigate now explicitly checks for action === 'view' (page mode) alongside the existing 'new_window' check.
PluginObjectView formLayout now includes split and popover branches.
PluginObjectView imports and renders NavigationOverlay from @object-ui/components for both split mode (with mainContent wrapping the grid) and popover mode (Dialog fallback when no popoverTrigger).
Split mode close button properly resets form state via handleFormCancel.

Tests: Updated split/popover tests to verify NavigationOverlay rendering (close panel button for split, dialog role for popover). Added split close-and-return test. All 29 PluginObjectView tests and 37 Console ObjectView tests pass.

ListView Grouping Mode Empty Rows (February 2026)

Root Cause: When grouping is enabled in list view, buildGroupTableSchema in ObjectGrid.tsx sets pagination: false but inherits pageSize: 10 from the parent schema. The DataTableRenderer filler row logic (Array.from({ length: Math.max(0, pageSize - paginatedData.length) })) pads each group table with empty rows up to pageSize, creating many blank lines.

Fix: Added pagination && condition to filler row rendering in data-table.tsx. Filler rows only render when pagination is enabled, since their purpose is maintaining consistent page height during paginated views.

Tests: Added 2 tests in data-table-airtable-ux.test.tsx verifying filler rows are skipped when pagination is off and still rendered when pagination is on. All 59 related tests pass.

Metric Widget I18nLabel Render Crash (February 2026)

Root Cause: MetricWidget and MetricCard rendered I18nLabel objects ({key, defaultValue}) directly as React children. When CRM dashboard metadata used I18nLabel objects for trend.label (e.g. { key: 'crm.dashboard.trendLabel', defaultValue: 'vs last month' }), React threw error #31 ("Objects are not valid as a React child").

Fix: Added resolveLabel() helper to MetricWidget.tsx and MetricCard.tsx that converts I18nLabel objects to plain strings before rendering. Updated prop types to accept both string and I18nLabel objects for label, description, and trend.label.

Tests: Added 3 new tests: 1 in DashboardRenderer.widgetData.test.tsx verifying metric widgets with I18nLabel trend labels render correctly, and 2 in MetricCard.test.tsx verifying I18nLabel resolution for title and description. All 159 dashboard tests pass.

Field Type Display Issues — Lookup, User, Select, Status Renderers (February 2026)

Root Cause: Multiple renderer defects caused incorrect field value display across views:

LookupCellRenderer — Destructured only value, ignoring the field prop. When the API returned a raw primitive ID (e.g. customer: 2), the renderer fell through to String(value) and showed "2" instead of the related record's name. No attempt was made to resolve IDs via field.options.
UserCellRenderer — Did not guard against primitive values (number/string user IDs). Accessing .name / .username on a number returned undefined, silently falling through to "User" as the generic label.
getCellRenderer standardMap — lookup and master_detail were mapped to SelectCellRenderer instead of LookupCellRenderer in the fallback map. Although the fieldRegistry pre-registration shadowed this bug, it was semantically incorrect.
status, user, owner types — Not pre-registered in fieldRegistry. All went through the standardMap path, making their association with renderers implicit and invisible.

Fix:

LookupCellRenderer: now accepts the field prop and resolves primitive IDs against field.options (matching by String(opt.value) === String(val) for type-safe comparison). Arrays of primitive IDs are resolved via the same logic. Null/empty-string guard updated from !value to value == null || value === '' to handle 0 correctly.
UserCellRenderer: primitive values (typeof !== 'object') return a plain <span> with the string representation. Array items that are not objects are also handled gracefully.
getCellRenderer standardMap: lookup and master_detail now correctly reference LookupCellRenderer.
fieldRegistry now explicitly registers status → SelectCellRenderer, user → UserCellRenderer, and owner → UserCellRenderer alongside the existing lookup/master_detail/select registrations.

Tests: Added 36 new tests in cell-renderers.test.tsx:

getCellRenderer registry assertions for lookup, master_detail, status, user, owner types
TextCellRenderer: null, undefined, empty string, numeric zero (0 renders "0" not "-"), boolean false
LookupCellRenderer: null, empty-string, primitive ID (number), primitive ID (string), unresolved primitive, object with name/label/_id, array of objects, array of primitive IDs resolved via options
UserCellRenderer: null, primitive number ID, primitive string ID, object with name, object with username, array of user objects

TextCellRenderer — Used value || '-' which incorrectly rendered '-' for numeric 0 (falsy zero). Updated to (value != null && value !== '') ? String(value) : '-' for consistent null-only suppression.

All 313 @object-ui/fields tests pass.

ListView Airtable-Style Toolbar Opt-In & Duplicate Record Count (February 2026)

Root Cause (1 — Toolbar defaults): showHideFields, showColor, and showDensity in ListView.tsx used opt-out logic (!== false), making secondary toolbar buttons visible by default. Airtable hides these controls unless explicitly enabled.

Fix: Changed default logic from !== false (opt-out) to === true (opt-in) for showHideFields, showColor, and showDensity in the toolbarFlags computation. Updated @default JSDoc comments in NamedListView and ListViewSchema interfaces from @default true to @default false.

Root Cause (2 — Duplicate record count): Both ListView.tsx (record-count-bar) and ObjectView.tsx (record-count-footer) independently rendered the record count at the bottom, causing duplicate display.

Fix: Removed the record-count-footer from ObjectView.tsx since ListView already renders the authoritative record-count-bar.

Tests: Updated 11 tests across ListView.test.tsx and ObjectView.test.tsx. All 112 ListView tests and 32 ObjectView tests pass.

⚠️ Risk Management

Risk	Mitigation
AppShell complexity (7 nav types, areas, mobile)	Start with static nav tree, add mobile modes incrementally
Designer DnD integration time	Use `@dnd-kit/core` (already proven in Kanban/Dashboard)
Airtable UX bar is high	Focus on Grid + Kanban + Form triad first; defer Gallery/Timeline polish
PWA real sync complexity	Keep simulated sync as fallback; real sync behind feature flag
Performance regression	Performance budgets in CI, 10K-record benchmarks
View config live preview dependency chain breakage	`generateViewSchema` hardcodes non-grid defaults; per-view-type integration tests required (see P1.8.1)
Config property type gaps (`NamedListView` missing fields)	Add first-class properties to `@object-ui/types`; use Zod schema to validate at runtime

📚 Reference

CONTRIBUTING.md — Contribution guidelines
QUICK_REFERENCE.md — Developer quick reference
Plugin Development Guide

Roadmap Status: 🎯 Active — AppShell ✅ · Designer Interaction · View Config Live Preview Sync ✅ · Dashboard Config Panel ✅ · Schema-Driven View Config Panel ✅ · Right-Side Visual Editor Drawer ✅ · Feed/Chatter Documentation ✅ · Airtable UX Parity Next Review: March 15, 2026 Contact: hello@objectui.org | https://github.com/objectstack-ai/objectui

FilesExpand file tree

ROADMAP.md

Latest commit

History

ROADMAP.md

File metadata and controls

ObjectUI Development Roadmap

📋 Executive Summary

🔄 Spec v3.0.9 Upgrade Summary

🔄 Spec v3.0.10 Upgrade Summary

🎯 P0 — Must Ship (v1.0 Blockers)

P0.1 AppShell & Navigation Renderer

🎯 P1 — UI-First: Airtable UX Parity

P1.1 Designer Interaction (DataModelDesigner)

P1.2 Console — Forms & Data Collection

P1.3 Console — Import/Export Excellence

P1.4 Console — Undo/Redo & History

P1.5 Console — Comments & Collaboration

P1.6 Console — Automation

P1.7 Console — Navigation Enhancements

P1.8 Console — View Config Panel (Phase 20)

P1.8.1 Live Preview — Gap Analysis & Phased Remediation

P1.10 Console — Dashboard Config Panel

P1.11 Console — Schema-Driven View Config Panel Migration

P1.9 Console — Content Area Layout & Responsiveness

P1.11 App Creation & Editing Flow (Airtable Interface Designer UX)

P1.12 System Settings & App Management Center

🧩 P2 — Polish & Advanced Features

P2.0 Flow Designer ✅

P2.1 Designer — Remaining Interaction (Post-v1.0)

P2.2 Designer — Advanced Features

P2.3 Designer — Collaboration Integration

P2.4 Spec Compliance Gaps (Low Priority)

P2.6 ListView Spec Protocol Gaps (Remaining) ✅

P2.7 Platform UI Consistency & Interaction Optimization ✅

P2.8 Airtable Parity: Product View & Global UI Detail Optimization

P2.9 Platform UI Navigation & Table Optimization ✅

P2.5 PWA & Offline (Real Sync)

🔮 P3 — Future Vision (Deferred)

CRM Example Metadata Enhancement ✅

Ecosystem & Marketplace

Community Growth

ObjectUI Cloud (2027)

Industry Solutions (2027)

📈 Success Metrics

v1.0 Release Criteria

🐛 Bug Fixes

ListView Grouping Config Not Taking Effect (February 2026)

List View Row Click Not Navigating to Record Detail (February 2026)

ListView Multi-Navigation Mode Support — split/popover/page/new_window (February 2026)

ListView Grouping Mode Empty Rows (February 2026)

Metric Widget I18nLabel Render Crash (February 2026)

Field Type Display Issues — Lookup, User, Select, Status Renderers (February 2026)

ListView Airtable-Style Toolbar Opt-In & Duplicate Record Count (February 2026)

⚠️ Risk Management

📚 Reference