AEM Project Archetype

Maven template that creates a minimal, best-practices-based Adobe Experience Manager (AEM) project as a starting point for your website.

Welcome

• Contributions are welcome, read our contributing guide for more information.

Documentation

• Archetype Documentation: Overview of the archetype architecture and its different modules.
• Following tutorials are based off this archetype:
  • WKND Site: Learn how to start a fresh new website.
  • WKND SPA Learn how to build a React or Angular webapp that is fully authorable in AEM.

Features

• Best Practice: Bootstrap your site with all of Adobe's latest recommended practices.
• Low-Code: Edit your templates, create content, deploy your CSS, and your site is ready for go-live.
• Cloud-Ready: If desired, use AEM as a Cloud Service to go-live in few days and ease scalability and maintenance.
• Dispatcher: A project is complete only with a Dispatcher configuration that ensures speed and security.
• Multi-Site: If needed, the archetype generates the content structure for a multi-language and multi-region setup.
• Core Components: Authors can create nearly any layout with our versatile set of standardized components.
• Editable Templates: Assemble virtually any template without code, and define what the authors are allowed to edit.
• Responsive Layout: On templates or individual pages, define how the elements reflow for the defined breakpoints.
• Header and Footer: Assemble and localize them without code, using the localization features of the components.
• Style System: Avoid building custom components by allowing authors to apply different styles to them.
• Front-End Build: Front-end devs can mock AEM pages and build client libraries with Webpack, TypeScript, and SASS.
• Decoupled Front-End: When chosing the frontend module to be decoupled, the project is preconfigured to use the AEMaaCS Frontend Pipeline. See the AEM React SPA template for more details how to get started with a decoupled frontend module using React.
• WebApp-Ready: For sites using React or Angular, use the SPA SDK to retain in-context authoring of the app.
• Commerce Enabled: For projects that want to use Commerce Integration Framework (CIF) to integrate with commerce solutions like Magento.
• Forms Enabled: For projects that want to use (Forms).
• Testing: ready-to-use Functional and UI testing modules, start adding your own tests
• Example Code: Checkout the HelloWorld component, and the sample models, servelets, filters, and schedulers.
• Open Sourced: If something is not as it should, contribute your improvements!

Usage

To generate a project, adjust the following command line to your needs:

• Set aemVersion=cloud for AEM as a Cloud Service;
  Set aemVersion=6.5.7 for Adobe Managed Services, or on-premise. The Core Components dependency is only added for non cloud aem versions as the Core Components are provided OOTB for AEM as a Cloud Service.
• Adjust appTitle="My Site" to define the website title and components groups.
• Adjust appId="mysite" to define the Maven artifactId, the component, config and content folder names, as well as client library names.
• Adjust groupId="com.mysite" to define the Maven groupId and the Java Source Package.
• Lookup the list of available properties to see if there's more you want to adjust.

mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=43\
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite"

Note: Make sure you use at least 3.1.0+ of maven-archetype-plugin (#400)

Note: To run above command with older versions, you have to use the old archetypeGroupId: -D archetypeGroupId=com.adobe.granite.archetype

Available Properties

System Requirements

Setup your local development environment for AEM as a Cloud Service SDK or for older versions of AEM.

Known Issues

• When running on Windows and generating the dispatcher configuration, you should be running in an elevated command prompt or the Windows Subsystem for Linux (see #329).

• When executing the archetype in interactive mode (without the -B parameter), the properties with default values cannot be changed, unless the final confirmation gets dismissed, which then repeats the questions by including the properties with default values in the questions (see ARCHETYPE-308 for details).

• You can't use this archetype in Eclipse when starting a new project with File -> New -> Maven Project since the post generation script archetype-post-generate.groovy will not be executed due to an Eclipse issue. Workaround is to use the above command line and then in Eclipse use File -> Import -> Existing Maven Project.