pimcore/studio-ui-bundle

Pimcore Studio Ui Bundle

Maintainers

Details

github.com/pimcore/studio-ui-bundle

Source

Issues

Installs: 103

Dependents: 0

Suggesters: 0

Security: 0

Stars: 10

Watchers: 10

Forks: 2

Open Issues: 160

Language:TypeScript

Type:pimcore-bundle

1.x-dev 2024-06-25 09:38 UTC

Requires

Requires (Dev)

proprietary 416aeab49ec5b05e43378565288c25fe8c10228a

This package is auto-updated.

Last update: 2024-06-25 19:39:42 UTC

README

Studio Ui

The Studio UI Bundle provides a Backend UI for Pimcore. It is based on the React framework.

How to install

How to open

  • Login via the classic backend UI
  • Access it under {your-domain}/admin/studio

Development

How to install

  1. Navigate to the plugin directory.
  2. Change to the assets directory cd ./assets
  3. Install dependencies npm install

How to build

Create a new build by running:

npm run build

How to run the dev-server (HMR/Live reloading)

Pimcore config

Enable your local domains in terms of CSP (Content-Security-Policy) in the Pimcore config file (./config/config.yml)

pimcore_admin:
    admin_csp_header:
        enabled: true
        additional_urls:
            connect-src:
                - 'ws://localhost:3030'
                - 'ws://localhost:3031'
                - 'http://localhost:3030'
                - 'http://localhost:3031'
            script-src: 
                - 'http://localhost:3030'
                - 'http://localhost:3031'
            font-src:
                - 'http://localhost:3030'
                - 'http://localhost:3031'
            style-src:
                - 'http://localhost:3030'
                - 'http://localhost:3031'

How to run and access the dev-server

Use the following command to run the dev-server:

npm run dev-server

Now your dev-server should be running. You can access it under your normal project domain:

{your-domain}/admin/studio

Storybook

Pimcore studio is using Storybook for documentation of react components.

Commands

npm run storybook // run storybook with live reloading
npm run build-storybook // for building storybook for a static hosting

Docker environment

To use storybook in your local environment ensure that you open up port 6006

node:
  ports: 
    - "6006:6006"
  ...

Nginx configuration

You should take care of the following configuration:

server {
  location ^~ /storybook/ {
      proxy_pass http://node:6006/;
  }

  location ^~ /__webpack_hmr {
      proxy_pass http://node:6006/__webpack_hmr;
  }
}

Now ensure that storybook is running via npm run storybook. Finally you can access it under {your-domain/storybook}

Documentation Overview