Changes to the POS Apps SDK (@pancake-pos/ui-extensions, @pancake-pos/ui, @pancake-pos/app-cli, @pancake-pos/eslint-plugin, create-pos-app). The packages are released together under one version number.
- Deployed apps need nothing: POS serves the runtime, so fixes and new elements take effect right away. Everything in
api_version2026-01is additive and does not break existing code. - Projects in progress should update to get the new types, code rules, docs and MCP examples. The CLI tells you when a new version is out (Updating the SDK):
Terminal
npm i @pancake-pos/ui@latest @pancake-pos/ui-extensions@latest
npm i -D @pancake-pos/app-cli@latest @pancake-pos/eslint-plugin@latestIf you use the MCP server, restart it after updating.
2026.1.13
pos.apican call the Open API address catalog:/geo/provinces,/geo/districts,/geo/communes(they used to fail withinvalid_path). Iframe pages need a rebuild with this SDK.
2026.1.12
- Iframe pages: while a
PosModalorPosDraweris open, POS dims its title row, menu and top bar around the iframe like a POS modal; clicking the dimmed area or pressing Esc closes the top-most one. For antd'sModal,Draweror another library, useusePosBackdrop(open, onClose). See Modals and drawers over the whole POS. - Runtime API:
pos.page.setBackdrop(on)and thebackdrop-dismissevent for iframe pages. - New
page/rule (warning): antd'sModal,DrawerandModal.confirmonly cover the iframe; usePosModal/PosDrawer,pos.ui.modal/drawerorpos.ui.confirm. PosModalno longer focuses its close button andPosDrawerno longer draws a focus ring around the screen, like POS modals.- Deployed iframe pages need a rebuild with this SDK to get the dimming (
@pancake-pos/uiis bundled into the app).
2026.1.11
Iframe page UI
@pancake-pos/uihas React components for all 36pos-*elements (PosPage,PosSection,PosStat,PosTable…) with the Worker UI names, properties and{ detail }events. POS draws Worker UI with these components too, so iframe pages match Worker UI pages pixel for pixel. See Iframe page UI.PosProviderloads the bundled Inter font, removes the white card around the iframe so the page sits on the gray POS background, and puts thePosPageheading,descriptionand buttons on the POS title row. A page that paints its own full-page white background keeps the old look with<PosProvider frame="card">. Apps deployed with an older SDK do not change.- Color, type and spacing tokens:
tokens,@pancake-pos/ui/tokens.css,tailwind.css(Tailwind 4),tailwind-preset(Tailwind 3),fonts.css. antd strings in Lao.
Runtime API
pos.ui.modal,pos.ui.drawer: open an iframe page of the app in a modal/drawer over the whole POS from a block, an action or a page; the page inside getspos.data.presentationand closes with a result throughpos.close(result).pos.page.setHeader(heading, description, up to 5 buttons on the title row;header-actionevent) andpos.page.setFramefor iframe pages.connect({ optional: true }),isEmbedded(),PosProvider standalone,usePosOptional(): self-hosted pages that also open outside POS.
Checks and examples
- New
page/rules (warnings): other UI libraries, colors outside the POS palette, hand-formatted money, an entry file withoutPosProvider.pos-app checkreports<link>,@importand@font-facepointing outside the bundle (the CSP blocks them at run time). - The
create-pos-appiframe page usesPosPage,PosFilterBar,PosTable.get_exampleaddsiframe-reportandself-hosted.
2026.1.10
pos-app loginconnects through the browser: the POS Connect CLI page picks several shops at once, no token to copy.login --tokenstill works for CI. Existing projects need to update the SDK first: the older CLI has no browser login and ignoresdeploy --all.- One app, many shops:
deploy --allor repeated--shop,versionslists each shop, newshopsandusecommands,logout --shop. - The MCP server is not tied to one shop: new
list_shopstool;deploytakesshopsorall;get_errorsgathers errors from every shop;list_shop_metaandsample_contexttakeshop.
2026.1.9
- The CLI tells you about a newer SDK:
npm run check,build,deployanddevprint the update command;--jsonresults and the MCP tools (check_app,deploy,get_errors) carry anupdatefield so AI tools can offer the update. Turn it off withPOS_APP_NO_UPDATE_CHECK=1. - Rule
pos-app/valid-elements: an unknown element, property or event that looks like no known name now suggests updating the SDK (usually code written from newer docs). - This What's new page.
2026.1.8
Components
- New:
pos-switch,pos-radio-group,pos-time-picker,pos-file-input(POS reads CSV/Excel into a table for the app). pos-table:rowstake Open API records as they are and a columnkeyis a path (customer.name,items.0.sku); an "Actions" column withrowActionsandonRowAction;copyablecolumns.pos-select: search through the API withonSearchandloading.pos-date-picker:timeto pick a time as well.pos-modal:width(520, 720, 1000 px). The footer ofpos-modalandpos-draweralso takespos-menu-buttonandpos-link.
API (runtime-api)
pos.api.paginateloads many pages in parallel within the rate limit;pos.api.get(path, { cache })keeps catalogs in memory.pos.download({ sheet }): POS builds an.xlsxor.csvfile from columns and rows.pos.navigate({ resource: 'order', id })opens an order in a new tab.pos.formatformats numbers, money and dates like POS.pos.clipboard.copy.
Runtime and tools
- A value that breaks the schema (wrong type, misplaced element, text too long) no longer stops the extension: POS drops the bad part and writes it to the error log.
- Development mode writes "Standard screens" warnings (
standard_screen) to the error log, read withget_errors. - MCP tool
get_example: complete sample apps (report, list with a detail drawer, file import, order form block, print template, hook).
2026.1.7
- Elements for report and list screens:
pos-stat,pos-date-range,pos-menu-button,pos-description-list,pos-timeline,pos-progress,pos-empty,pos-drawer. pos-table: columnformatbadge, link, percent,tones,subtitle,sortable,fixed,ellipsis;sort,summary,selectable,selected; eventsonSortChange,onSelectionChange,onCellClick.pos-chart: combined bars and lines, horizontal bars, percent.pos-button:icon,tooltip.pos.downloadsaves a file the app made.- Rule
pos-app/standard-screen(warning) following Standard screens; thecreate-pos-apptemplate has a sample report page. - MCP tools
search_apiandget_apilook up Open API endpoints. - Fix: development mode could not load data when POS called the API through
pos.pancake.vn.
2026.1.6
- Docs and the template run the CLI through
npm run …ornpx @pancake-pos/app-cli …(thepos-apppackage on npm is not Pancake's).
2026.1.5
- Customer targets:
customer.details.action,customer.index.action,customer.index.selection-action,customer.index.column.
2026.1.4
- Worker UI pages (
app.pagewithrender: "worker") and page elements:pos-page,pos-tabs,pos-filter-bar,pos-chart. - List columns (
<resource>.index.column), app print templates (<resource>.print-action), the customer profile block (customer.details.block).
