{"slug": "announcing-nocobase-2-2-beta", "title": "Announcing NocoBase 2.2-beta", "summary": "NocoBase released version 2.2-beta, introducing a new /v/ branch as a dedicated front-end entry for V2 with improved performance and removal of V1 legacy content. The update also adds Multi Portal, a new mobile client, and a comment block, while enhancing AI knowledge base and workflow capabilities.", "body_md": "This is a major upgrade **centered on the V2 experience**. This release brings **Multi Portal**, a **new mobile client**, and a **new comment block**, while continuing to enhance the AI knowledge base and workflow capabilities. For teams already using V2, the more noteworthy addition is the brand-new `/v/`\n\nbranch—it will serve as a dedicated front-end entry for V2 and carry forward all future feature development.\n\n## New Features\n\n### The new `/v/`\n\nbranch\n\n`/v/`\n\nis a brand-new, standalone front-end entry that is built independently. In the 2.0 release we carried out a very large refactor of the front end, and at the time, for compatibility reasons, we kept support for V1 modules, pages, and so on. The `/v/`\n\nbranch, however, completely removes the V1 legacy content—you can no longer create or render V1 pages and blocks, and it keeps only V2-oriented capabilities. At the same time, the `/v/`\n\nbranch has been significantly optimized in terms of performance, and it will be the main branch that the NocoBase team iterates on going forward.\n\nWe recommend that, if your production environment consists entirely of users centered on v2 Pages, you consider starting to use the\n\n`/v/`\n\nbranch, so that upcoming new feature iterations can be used directly.If you are centered on v2 Pages but have a small number of v1 Pages, consider first migrating the v1 Pages to v2 Pages, and then consider using the\n\n`/v/`\n\nbranch.If you are centered on v1 Pages, we do not recommend switching directly to the\n\n`/v/`\n\nbranch. We suggest you first migrate your current v1 Pages to v2 Pages, and then switch to the`/v/`\n\nbranch.\n\nTypically, you only need to add the `/v/`\n\nprefix before the original path to enter the `/v/`\n\nbranch.\n\nFor example:\n\n```\n# Original path\nhttps://nocobase.example.com/admin/1xl0epqn6q3\n\n# v branch path\nhttps://nocobase.example.com/v/admin/1xl0epqn6q3\n```\n\n#### Setting the application’s default entry\n\nYou can control the application’s entry mode via the environment variable `APP_CLIENT_ENTRY_MODE`\n\n:\n\n`legacy-default`\n\n: both`/`\n\nand`/v/`\n\nare accessible, and the default entry is`/`\n\n`modern-default`\n\n: both`/`\n\nand`/v/`\n\nare accessible, and the default entry is`/v/`\n\n`modern-only`\n\n: only`/v/`\n\nis accessible\n\n#### Current status of the `/v/`\n\nbranch\n\nThe `/v/`\n\nbranch is a progressive-migration branch. After entering the `/v/`\n\nbranch, there will be a few noticeable changes:\n\n- Pages created via Page V1 will no longer be displayed in the\n`/v/`\n\nbranch. Pages created via Page V2 will still display normally in the`/v/`\n\nbranch. - Plugins that are only adapted for\n`client-v1`\n\nwill no longer be loaded in the`/v/`\n\nbranch. The`/v/`\n\nbranch only loads plugins adapted for`client-v2`\n\n. For details, refer to the[Client-side plugin development documentation](https://docs.nocobase.com/plugin-development/client/).\n\nAt present, most of the plugins built into NocoBase have been adapted and migrated to client-v2 in this release, so most features can be used directly (a small number of plugins have not yet been migrated, and we will keep migrating them). However, some capabilities provided by certain plugins will only be updated and iterated on the `/v/`\n\nbranch going forward. Specifically:\n\n- The plugin list no longer shows deprecated plugins or plugins that support only 1.x\n- Adding new Page V1 is no longer supported\n- Public forms distinguish between v1 and v2; the\n`/v/`\n\nbranch does not display v1 public forms - If you want to use approval workflows on the\n`/v/`\n\nbranch, you need to reconfigure the related UI - The new mobile client is only supported on the\n`/v/`\n\nbranch - Multi Portal is only supported on the\n`/v/`\n\nbranch - The Display configuration for sub-applications in the App supervisor has been removed; you can use Portals instead\n- The “AI Employees / Data Sources” tab has been removed\n- The comment table, calendar table, expression table, and external data table have been removed\n- The workflow manual node is not yet supported on the\n`/v/`\n\nbranch - Adding badge counts to menus is not yet supported\n\nYou can carry out the migration to the `/v/`\n\nbranch based on the actual situation of your production environment.\n\n### Multi Portal (only supported on the `/v/`\n\nbranch)\n\nPortals are used to provide multiple access entries within the same application. Each Portal can have its own independent pages, menus, navigation structure, layout, and permission configuration. (Supported in the Professional edition and above)\n\nIn real-world business scenarios, different roles usually need different operational interfaces. For example, a retail management system:\n\n```\nRetail management system\n\n├─ Headquarters Portal\n├─ Store Portal\n├─ Dealer Portal\n└─ Mobile Portal\n```\n\nHeadquarters staff care about:\n\n- Product management\n- Inventory management\n- Data analysis\n\nStore staff care about:\n\n- Checkout\n- Stock counting\n- Order processing\n\nDealers care about:\n\n- Procurement\n- Reconciliation\n- Shipping status\n\nEven though they use the same system, different roles don’t need to see the same menus and pages. Multi Portal is precisely what solves this problem.\n\nReference documentation:\n\n### New mobile client (only supported on the `/v/`\n\nbranch)\n\nThe new mobile client provides a brand-new `/v/mobile`\n\nentry, and at the same time, Portals also support adding Portals with a mobile layout.\n\nThe mobile layout and desktop layout use the same data source and business data, but menus, routing, and page content are configured separately. This allows you to reorganize pages according to how they are used on mobile, without being constrained by the desktop page structure. In addition, using the bottom tab bar as the primary navigation makes it better suited for data entry, querying, approval, and task handling on phones.\n\nReference documentation:\n\n### New comment block\n\nThe new comment block is no longer limited to the comment table of the main data source, and it can be used even outside of relationship blocks. The comment block is used to add commenting capabilities to business records. You can add a comment block on the detail page or popup of records such as tasks, articles, tickets, and customers, allowing users to view, reply to, and add comments around the current record.\n\nReference documentation:\n\n### AI knowledge base improvements\n\nIn this release, the AI knowledge base has also completed its migration to the `client-v2`\n\nversion. In addition, when a workflow creates knowledge base documents, it now supports overwriting by the knowledge base document’s key.\n\nReference documentation:\n\n### Workflow: Database transaction node\n\nThe workflow adds a database transaction node. It is used to execute a group of database operations within the same transaction. It is suited for scenarios that need to guarantee “all succeed or all roll back” across multi-step data processing—for example, deducting inventory, writing line items, and updating status after creating an order.\n\nReference documentation:\n\n## The following plugins are no longer supported in V2 (deprecated but not yet removed)\n\nSome plugins were actually deprecated much earlier. Some of them can still be used at present, but they will be completely removed in V3.\n\n| Plugin | Replacement | Notes |\n|---|---|---|\n`@nocobase/plugin-audit-logs` | `@nocobase/plugin-audit-logger` | Deprecated since 1.0 |\n`@nocobase/plugin-backup-restore` | `@nocobase/plugin-backups` | Deprecated since 1.0 |\n`@nocobase/plugin-block-multi-step-form` | JS Block | Deprecated since 2.0 |\n`@nocobase/plugin-charts` | `@nocobase/plugin-data-visualization` | Deprecated since 2.0 |\n`@nocobase/plugin-collection-fdw` | Sync from database | Deprecated since 2.2 |\n`@nocobase/plugin-comments` | `@nocobase/plugin-block-comment` | Deprecated since 2.2 |\n`@nocobase/plugin-custom-variables` | Event flow | Deprecated since 2.2 |\n`@nocobase/plugin-data-visualization-echarts` | `@nocobase/plugin-data-visualization` | Deprecated since 2.0 |\n`@nocobase/plugin-disable-pm-add` | None | Deprecated since 2.2 |\n`@nocobase/plugin-field-component-mask` | RunJS | Deprecated since 2.0 |\n`@nocobase/plugin-graph-collection-manager` | None | Deprecated since 2.2 |\n`@nocobase/plugin-mobile-client` | `@nocobase/plugin-ui-layout` | Deprecated since 2.0 |\n`@nocobase/plugin-mobile` | `@nocobase/plugin-ui-layout` | Deprecated since 2.0 |\n`@nocobase/plugin-mock-collections` | AI-assisted building | Deprecated since 2.0 |\n`@nocobase/plugin-multi-app-manager` | `@nocobase/plugin-app-supervisor` | Deprecated since 2.0 |\n`@nocobase/plugin-multi-app-share-collection` | None | Deprecated since 1.0 |\n`@nocobase/plugin-notifications` | `@nocobase/plugin-notification-manager` | Deprecated since 1.0 |\n`@nocobase/plugin-snapshot-field` | None | Deprecated since 1.0 |", "url": "https://wpnews.pro/news/announcing-nocobase-2-2-beta", "canonical_source": "https://www.nocobase.com/en/blog/2.2.0-beta", "published_at": "2026-07-17 01:54:57+00:00", "updated_at": "2026-07-17 03:04:12.527914+00:00", "lang": "en", "topics": ["artificial-intelligence", "developer-tools"], "entities": ["NocoBase"], "alternates": {"html": "https://wpnews.pro/news/announcing-nocobase-2-2-beta", "markdown": "https://wpnews.pro/news/announcing-nocobase-2-2-beta.md", "text": "https://wpnews.pro/news/announcing-nocobase-2-2-beta.txt", "jsonld": "https://wpnews.pro/news/announcing-nocobase-2-2-beta.jsonld"}}