AEM Site Theme Builder
This repository contains scripts for building a Site Theme, ensuring compatibility with the requirements of AEM Site Templates. The recommended way of integrating the Theme Builder is to install it as an npm dependency of the Site Template Theme. This way
aem-site-theme-builder commands can be used in NPM scripts. Example of such integration can be found in Basic Site Template.
cd <your-site-theme> npm install @adobe/aem-site-theme-builder --save-dev
Proxy your site running on AEM as a Cloud Service to localhost and replace requests made to the Site Theme with your locally compiled version of the Site Theme.
npx aem-site-theme-builder proxy
The live preview will run proxy server (desribed above) as well browser sync functionality. Browser sync will point to the proxied page and will be looking for changes in the
dist folder and will refresh the page each time you got a change.
npx aem-site-theme-builder live
- Compile your theme and make the artifact available on GitHub. AEM as a Cloud Service will try to access
https://api.github.com/repos/%GIT_ORG%/%GIT_REPO%/actions/artifacts/%GIT_ARTIFACT_ID%/zipin order to download the theme.
npx aem-site-theme-builder deployin order to update the reference on AEM as a Cloud Service.
Complete development workflow
In order to make best use of theme-builder you have to run the live preview which provides proxy and browser sync functionalities. On top of that you need to make sure that you have additional watcher for your source files that triggers your theme build process which produces changes in the
dist folder of your theme. This way after making change in your source file you will get your proxy page refreshed via browser sync.
Theme Builder scripts are based on the environment variables you provide. These variables are used to properly provide live preview and deploy functionality of the AEM Site Theme Builder. Here is the list of required variables:
AEM_URL=<URL of the AEM as a Cloud Service instance> AEM_SITE=<name of the AEM site> AEM_PROXY_PORT=<localhost proxy server port>
Recommended way to define site variables is to use / create
.env file within your theme project repository.
Expected Output of Compiled Site Theme
You're free to use any build tools of your choice. The only contract with the Site Theme Builder is that the compiled artifact shall be provided as follows:
dist/ css/ theme.css js/ theme.js resources/ a-font.font an-image.png
Release and publish
Run the "Release and publish" GitHub workflow and provide the semantic version you're about to release.
Contributions are welcomed! Read the Contributing Guide for more information.
This project is licensed under the MIT License. See LICENSE for more information.