Logicommerce Studio

Work with LogiCommerce headless front-office projects in a local Dev Container environment, reusing the same structure and workflows as the official LogiCommerce front-office template.

This extension automates the common workflow for LogiCommerce front-office development:

Initialize a local Dev Container environment.
Add and manage multiple commerces.
Switch the active commerce easily.
Use helper commands both inside and outside the Dev Container.

Requirements

Docker installed and running.
VS Code with:
- Dev Containers extension (formerly Remote - Containers).

There is no mandatory project structure required to start using this extension.
You can start from an empty folder and let the extension create what it needs.

Compatibility with `frontoffice-dev`

This extension is fully compatible with the public frontoffice-dev template if you follow that model:

Repository: logicommerce/frontoffice-dev

If your project has been created following the frontoffice-dev structure, Logicommerce Studio will detect and reuse it and will keep the www symlink and core assets pointing to the correct locations.

If you reuse the workspace, you must add the extension to your devcontainer.json.

"customizations": {
  "vscode": {
    "extensions": [
      ...
      "logicommerce.logicommerce-studio-extension"
    ]
  }
}

Main commands

Host only

LogiCommerce Studio: Create environment
Initialize a local Dev Container setup and prepare the folder to host LogiCommerce frontoffice code.
LogiCommerce Studio: Add Commerce
Add a new commerce under commerces/, clone its repository and generate local-only PHP config files needed for development.
LogiCommerce Studio: Switch Commerce
Switch the active commerce by updating www and core symlinks.
After switching, the extension can prompt you to rebuild and enter the Dev Container.
LogiCommerce Studio: Rebuild and enter Dev Container
Trigger “Rebuild and Reopen in Container” for the current workspace.

Inside the Dev Container

LogiCommerce Studio: Switch Commerce
Switch the active commerce while working inside the Dev Container.
LogiCommerce Studio: Exit Dev Container to Host
Reopen the current folder on the host, leaving the Dev Container session.

Notes

VS Code may show a standard Dev Containers notification such as:

Folder contains a Dev Container configuration file. Reopen folder to develop in a container.

You can ignore that notification and instead use:

LogiCommerce Studio: Rebuild and enter Dev Container (from the host)
LogiCommerce Studio: Exit Dev Container to Host (from inside the Dev Container)

LogiCommerce Studio

LogiCommerce