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
The live preview will proxy a site running on AEM as a Cloud Service (author) to localhost and replace requests made to the Site Theme with your locally compiled version of the Site Theme.
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.
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.