Object UI

<div align="center">

# Object UI

**The Universal Schema-Driven UI Engine**

*From JSON to world-class UI in minutes*

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![CI](https://github.com/objectstack-ai/objectui/workflows/CI/badge.svg)](https://github.com/objectstack-ai/objectui/actions/workflows/ci.yml)
[![CodeQL](https://github.com/objectstack-ai/objectui/workflows/CodeQL%20Security%20Scan/badge.svg)](https://github.com/objectstack-ai/objectui/actions/workflows/codeql.yml)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
[![React](https://img.shields.io/badge/React-18+-61dafb.svg)](https://reactjs.org/)
[![Tailwind CSS](https://img.shields.io/badge/Tailwind-3.0+-38bdf8.svg)](https://tailwindcss.com/)

[**Documentation**](https://www.objectui.org) | [**Quick Start**](#quick-start) | [**Changelog**](./CHANGELOG.md) | [**Roadmap**](./ROADMAP.md)

</div>

---

## 🎉 What's New (v3.3.x line)

**v3.3.0 was the first official release** — all 39 packages under `packages/*` are published to npm. The current published patch is **v3.3.2** and the workspace now consumes **`@objectstack/spec` ^4.0.4** and **`@objectstack/client` ^4.0.4** (the UI sub-export remains backward compatible with the 3.3.x renderer).

> Unreleased work is queued in `.changeset/` and visible in `CHANGELOG.md`'s
> `[Unreleased]` section — see "Recent Highlights" below.

### Recent Highlights (post-3.3.2, queued for next release)

- 📱 **Mobile UX rounds 1 & 2** — kanban readability, calendar default view on phones, timeline marker clipping, list/sidebar/record-detail polish (`apps/console`, `plugin-kanban`, `plugin-calendar`, `plugin-timeline`).
- 🪟 **Manage Views dialog** (`@object-ui/plugin-view`) replaces inline tab drag for view CRUD.
- 🧭 **App-shell view-tab strip** now renders for single-view objects too; broken DropdownMenu propagation fixed.
- ⚡ **View metadata merging + request coalescing** — duplicate `find()` queries from concurrent renderers are deduped.
- 🌐 **Convention-based i18n for sidebars, breadcrumbs, charts, tables, dashboards** — translation packs can localize every label without editing metadata.
- 🛠️ **MetadataProvider lazy loading** — Console no longer fetches the entire `app/object/dashboard/report/page` graph on boot.

### Highlights

- 📦 **39 published packages** with complete release metadata, per-package `LICENSE` and `CHANGELOG.md`
- 📚 **Refreshed documentation** across every package README and the [objectui.org docs site](https://www.objectui.org)
- 🏗️ **Thin integration packages** — `@object-ui/app-shell` and `@object-ui/providers` enable third-party integration in ~50KB instead of pulling the full console
- 🔌 **Spec v4 alignment** — plain-string `label` types across Navigation schemas, Protocol bridges updated
- 🧠 **Unified Agent Skill** — `npx skills add objectstack-ai/objectui` installs a consolidated skill (works with Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini, Cline). See [`skills/objectui/`](./skills/objectui/) and [skills.sh](https://skills.sh/objectstack-ai/objectui).

### Component Namespaces
Organize components into namespaces to prevent naming conflicts:
```typescript
ComponentRegistry.register('button', ButtonComponent, {
  namespace: 'ui'  // Prevent conflicts across plugins
});
```

### Lazy Field Registration
Load only the fields you need for 30-50% smaller bundles:
```typescript
import { registerField } from '@object-ui/fields';

// Only load what you use
registerField('text');
registerField('number');
```

### Build Performance
- **3-5x faster CI builds** with Turbo v2
- **Parallel package builds** with intelligent caching
- **Instant rebuilds** for unchanged packages

👉 See [CHANGELOG.md](./CHANGELOG.md) for the full 3.3.x release notes and the `[Unreleased]` section.

---

## 🚀 Quick Start (Development Mode)

Since this package is not yet published to NPM, here is how to play with the source code:

1.  **Clone & Install**

    ```bash
    git clone https://github.com/objectstack-ai/objectui.git
    cd objectui
    pnpm install
    # Build the core engine
    pnpm build
    ```

2.  **Run the ObjectStack Console**

    Start the unified development console to preview your apps and objects:

    ```bash
    pnpm dev
    # Opens http://localhost:5173
    ```

3.  **Try the BYO-Backend Console Example** (New!)

    See how to integrate ObjectUI in your own app:

    ```bash
    cd examples/byo-backend-console
    pnpm dev
    # Opens http://localhost:5174
    ```

4.  **Edit & Reload**

    Edit the JSON schema files and the changes will be instantly reflected in the browser.

## Examples

ObjectStack examples that demonstrate different features and use cases:

- **[examples/crm](examples/crm)** - Full-featured CRM application with dashboards, multiple views (Grid, Kanban, Map, Gantt), and custom server implementation.
- **[examples/todo](examples/todo)** - Simple task management app d

... (truncated)