Learn how the site theme is built, how to customize, and how to test using live AEM content.
In the previous document of the AEM Quick Site Creation journey, Retrieve Git Repository Access Information, you learned how the front-end developer users Cloud Manager to access git repository information, and you should now:
This part of the journey takes the next step and digs into the site theme and shows you how to customize it and then commit those customizations using the access credentials you retrieved.
This document explains how the AEM site theme is built, how to customize it, and how to test it using live AEM content. After reading you should:
This part of the journey applies to the front-end developer.
Extract the theme provided by the AEM administrator to where you would like to edit the theme and open it in your preferred editor.
You see that the theme is a typical front-end project. The most important parts of the structure are:
src/main.ts: The main entry point of your JS & CSS theme
src/site: JS & CSS files that apply to the entire site
src/components: JS & CSS files specific to AEM components
src/resources: Static files like icons, logos, and fonts
If you would like to know more about the standard AEM site theme, see the GitHub link in the Additional Resources section at the end of this document.
Once you are comfortable with the structure of the theme project, start the local proxy so you can see any theme customizations in real time based on actual AEM content.
From the command line, navigate to the root of the theme on your local machine.
npm install and npm retrieves dependencies and installs the project.
npm run live and the proxy server starts.
When the proxy server starts, it automatically opens a browser to
http://localhost:7001/. Select SIGN IN LOCALLY (ADMIN TASKS ONLY) and sign on with the proxy user credentials provided to you by the AEM administrator.
If you do not have these credentials, speak with your administrator referencing the Set Up Proxy User section of the Create Site from Template article in this journey.
Once signed in, change the URL in the browser to point to the path to the sample content that the AEM administrator provided to you.
You can navigate the site to explore the content. The site is pulled live from the live AEM instance so you can make your theme customizations against real content.
Now you can start customizing the theme. The following is a simple example to illustrate how you can see your changes live via the proxy.
In your editor, open the file
Edit the variable
$color-background and set it to a value other than white. In this example,
orange is used.
When you save the file, you see that the proxy server recognizes the change via the line
[Browsersync] File event [change].
Switching back to your browser of the proxy server, the change is immediately visible.
You can continue customizing the theme based on the requirements provided to you by the AEM administrator.
Once your customizations are complete, you can commit them to the AEM git repository. First you must clone the repository to your local machine.
From the command line, navigate to where you would like to clone the repo.
Execute the command you previously retrieved from Cloud Manager. It should be similar to
git clone https://git.cloudmanager.adobe.com/<my-org>/<my-program>/. Use the git user name and password that you retrieved in the previous part of this journey.
Move the theme project that you were editing into the cloned repo with a command similar to
mv <site-theme-sources> <cloned-repo>
In the directory of the cloned repo, commit the theme files that you just moved into with the following commands.
git add . git commit -m "Adding theme sources" git push
The customizations are pushed to the AEM git repository.
Your customizations are now safely stored in the AEM git repository.
Now that you have completed this part of the AEM Quick Site Creation journey you should:
Build on this knowledge and continue your AEM Quick Site Creation journey by next reviewing the document Deploy Your Customized Theme, where you learn how to deploy the theme using the front-end pipeline.
While it is recommended that you move on to the next part of the Quick Site Creation journey by reviewing the document Deploy Your Customized Theme, the following are some additional, optional resources that do a deeper dive on some concepts mentioned in this document, but they are not required to continue on the journey.