The AEM Brackets Extension provides a smooth workflow to edit AEM components and client libraries, and leverages the power of the Brackets code editor, which gives access from within the code editor to Photoshop files and layers. The easy synchronization provided by the extension (no Maven or File Vault required) increases developer efficiency and also helps front-end developers with limited AEM knowledge to participate on projects. This extension also provides some support for the HTML Template Language (HTL), which takes away the complexity of JSP to make component development easier and more secure.
The main features of the AEM Brackets Extension are:
- Automated synchronization of changed files to the AEM development instance.
- Manual bidirectional synchronization of files and folders.
- Full content-package synchronization of the project.
- HTL code completion for expressions and data-sly-* block statements.
Additionally, Brackets comes with many useful features for AEM font-end developers:
- Photoshop file support to extract information from a PSD file, like layers, measurements, colors, fonts, texts, etc.
- Code hints from the PSD, to easily reuse this extracted information in the code.
- CSS preprocessor support, like LESS and SCSS.
- And hundreds of additional extensions that cover more specific needs.
The AEM Brackets Extension supports Brackets version 1.0 or greater.
Download the latest Brackets version from brackets.io.
After the extension has been installed, you can start developing AEM components by opening a content-package folder from your file system with Brackets.
The project has to contain at least:
- a jcr_root folder (e.g. myproject/jcr_root)
- a filter.xml file (e.g. myproject/META-INF/vault/filter.xml); for more details about the structure of the filter.xml file please see the Workspace Filter definition.
In Brackets' File menu, choose Open Folder… and pick either the jcr_root folder, or the parent project folder.
If you don't have of your own a project with a content-package, you can try the HTL TodoMVC Example. On GitHub, click Download ZIP, extract the files locally, and as instructed above, open the jcr_root folder in Brackets. Then follow the steps below to setup the Project Settings, and finally upload the whole package to your AEM development instance by doing an Export Content Package as instructed further down in the Full Content-Package Synchronization section.
After these steps, you should be able to access the /content/todo.html URL on your AEM development instance and you can start doing modifications to the code in Brackets and see how, after doing a refresh in the web browser, the changes were immediately synchronized to the AEM server.
In order to synchronize your content to and from an AEM development instance, you need to define your Project Settings. This can be done by going to the AEM menu and choosing Project Settings…
The Project Settings allow to define:
- The server URL (e.g. http://localhost:4502)
- Wether to tolerate servers that don't have a valid HTTPS certificate (keep unchecked, unless required)
- The username used for synchronizing content (e.g. admin)
- The user's password (e.g. admin)
The AEM Brackets Extension provides following types of content synchronization for files and folders that are allowed by the filtering rules defined in filter.xml:
This will only synchronize changes from Brackets to the AEM instance, but never the other way around.
In the Project Explorer, open the contextual menu by right-clicking on any file or folder, and the Export to Server or Import from Server options can be accessed.
If the selected entry is outside of the jcr_root folder, the Export to Server and Import from Server contextual menu entries are disabled.
In the AEM menu, the Export Content Package or Import Content Package options allow to synchronize the whole project with the server.
The AEM Brackets Extension features a notification icon in the toolbar on the right of the Brackets window, which indicates the status of the last synchronization:
- green - all files have been synchronized successfully
- blue - a sync operation is in progress
- yellow - some of the files were not synchronized
- red - none of the files were synchronized
Clicking on the notification icon will open the Synchronization Status report dialog that lists of all the status for each synchronized file.
Only content that's marked as included by the filtering rules from filter.xml will be synchronized, regardless of the synchronization method used.
Additionally, .vltignore files are supported for excluding content from synchronizing to and from the repository.
The AEM Brackets Extension also features some auto-completion to ease the writing of HTL attributes and expressions.
The AEM Brackets Extension is an open-source project, hosted on GitHub by the Adobe Marketing Cloud organization, under the Apache License, version 2.0:
- Code repository: https://github.com/Adobe-Marketing-Cloud/aem-sightly-brackets-extension
- Apache License, version 2.0: http://www.apache.org/licenses/LICENSE-2.0.html
The Brackets code editor is also an open-source project, hosted on GitHub by the Adobe Systems Incorporated organization:
- Code repository: https://github.com/adobe/brackets
Feel free to contribute!