OdooWiki OCA HUB

Shopfloor mobile

shopfloor_mobile_base folder_open OCA/shopfloor-app open_in_new
Warehouse Management License: LGPL-3

Base frontend for Shopfloor applications.

The work is organized in scenario. A scenario represents a process in the workplace (eg: for WMS -\> receive, deliver). The app allows to start each process through the main menu.

Each scenario is linked to a specific menu item which can be configured in the backend. Each scenario drives you through the work to do.

Tech details

  • This frontend is built on top of VueJS and VuetifyJS and relies on shopfloor module that exposes REST API in Odoo (based in turn on base_rest).
  • The whole business logic comes from shopfloor_base module, this module takes care of providing a nice and reactive UI to work with.
  • No Odoo JS is used, no assets machinery used. Static assets are loaded straight, served by a specific controller. This app is a Single Page App, hence resources are loaded only once. The version of the module appended to the URL of each resources makes sure it's not cached when the version changes.
  • When developing you can use a demo mode which allows to define interactive scenario with pure JS demo data, without interacting with Odoo. Nothing to deal with Odoo demo data.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Provides the mobile web frontend for the Shopfloor warehouse app, letting warehouse workers open and use Shopfloor scenarios (such as receiving or delivering) from a phone or tablet. It also adds an app version field on the Shopfloor app configuration form.

This module is the mobile user interface layer for the Shopfloor warehouse application. It does not contain business logic itself; it serves a single-page mobile app that talks to the Shopfloor backend and displays the different work scenarios configured there.

  • Users open the app through a web address per Shopfloor app; the app is loaded once and then reacts to actions without full page reloads.
  • The app exposes a manifest file so it can be installed on a mobile device home screen, with icons for Apple, Android and browser favicons.
  • A "report an issue" action can be shown in the app; when enabled and an email address is configured, it opens the user's mail client with a pre-filled message including app version, user ID and browser details.
  • Reusable mobile screens are provided: lists, detail cards, manual selection lists with checkboxes and a confirm button, a number spinner with plus/minus buttons and minimum/maximum limits, a date picker that accepts typed dates in the user's local format and validates them, plus reset and cancel buttons and an information banner.
  • On the Shopfloor app configuration form, an app version field is added after the short name.

The module depends on shopfloor_base and works with the shopfloor.app model.

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 4 confirmed, 5 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 18.0

Usage

Source · Odoo 18.0

Pre-requisites

  • Your Odoo instance is accessible via mobile device
  • You have an API Key configured

Start the app

  • Go to "Inventory -\> Configuration -\> Shopfloor -\> Shopfloor App"
  • In the login screen fill in your API key
  • Hit "Login"

Select a profile

Several profiles can be configured in the backend, you must choose one before starting.

  • Tap on "Configure profile"
  • Select a profile

This will load all available menu items for the selected profile.

Change language

  • Go to "Settings -\> Language"
  • Select a language

Customization

Please refer to shopfloor_mobile_custom_example.

Working environment

You can control which running env is considerd by Odoo config or env vars.

For Odoo config: running_env or shopfloor_running_env.

For env var: RUNNING_ENV or SHOPFLOOR_RUNNING_ENV.

Expected key RUNNING_ENV is compliant w/ server_environment naming but is not depending on it.

Additionally, as specific key for Shopfloor is supported.

You don't need server_environment module to use this feature.

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.