apps/components folder structure | Community
Skip to main content
W
webdev91
Level 3
August 15, 2022
Solved

apps/components folder structure

  • August 15, 2022
  • 4 replies
  • 2223 views

Hello,

I just wanted to check if there is any guide on the folder structure for the components. I have researched a bit and found out about the /content and /structure folder. I am not sure if it's old school or still applies nowadays.

Additionally, when we create a project using the maven archetype, by default it puts all the core proxy components directly under the components folder. Now, if you're working on a project from the scratch and expecting to add many custom components, is it a good idea to move those core proxy components to their own folder (any suggestion for the folder name would be appreciated)? Also, any example of categorizing custom components would help too.

In short, just wanted to get an idea/suggestion on what kind of folder structure other projects are following when they have a mix of core and a lot of custom components.

Any sample/example folder structure would be appreciated.

Thank you!

This post is no longer active and is closed to new replies. Need help? Start a new post to ask your question.
Best answer by arunpatidar

Hi,

Hi, this is ok if you separte the core component from custom, the Author never realised the differenc. It is mostly the developer who has to deal with it.

 

One idea cloud be

/apps/<group>/<tenant>/component/content/core
/apps/<group>/<tenant>/component/content
/apps/<group>/<tenant>/component/structure
/apps/<group>/<tenant>/clientlibs

/conf/<group>/<tenant>
/content/<group>/<tenant>

4 replies

Jagadeesh_Prakash
Community Advisor
Jagadeesh_PrakashCommunity Advisor
Community Advisor
August 15, 2022

Hi @webdev91 

 

The project structure and the guidelines depends on the type of project architype that you have created. If you can try creating the new project from below link reference it would be easy for you 

 

AEM cloud project can be created from new project wizard, please refer to link below 

https://experienceleague.adobe.com/docs/experience-manager-cloud-manager/content/getting-started/project-creation/using-the-wizard.html?lang=en

 

 

Sample project for on-prem

https://github.com/adobe/aem-project-archetype/tree/develop/src/main/archetype

Create using latest architype version below:

https://experienceleague.adobe.com/docs/experience-manager-core-components/using/developing/archetype/overview.html?lang=en

 

 

 

Link for best practise:

http://www.aemcq5tutorials.com/tutorials/adobe-aem-and-cq5-best-practices/

https://experienceleague.adobe.com/docs/experience-manager-65/forms/use-aem-forms-workspace/folder-structure.html?lang=en

 

    W
    webdev91Author
    Level 3
    August 15, 2022

    Hi @jagadeesh_prakash,

    Sorry for the confusion but I am not looking for the overall folder structure. I am only looking for the folder structure under the components folder especially when you have a lot of components (both core and custom) then how do you manage the folder structure for the components?

      B_Sravan
      Community Advisor
      B_SravanCommunity Advisor
      Community Advisor
      August 15, 2022

      Hi @webdev91,

       

      The folder structure is always a good practice to follow and there ain't any mandatory folder structure to follow.

       

      The best way to follow would be using the archetype-generated folder structure. As you said, yes the proxy components are kept under components, that's where we can organize our component folders. I am currently following this structure for one of the projects, where we hold multiple sub-projects under a parent. See if this aligns to your liking.

       

      apps/
        my-project/
                         clientlibs
                         components/
                                             sub-project
                                             content
                                             structure
                                             custom
                         config
                         i18
                         templates
                         install

      Under content, I have all my proxy components + common components that could be used in all sub projects, named my content components group name as my-project-common

       

      I hope this helps.
      Thank you,

      Sravan

       

        arunpatidar
        Community Advisor
        arunpatidarCommunity AdvisorAccepted solution
        Community Advisor
        August 15, 2022

        Hi,

        Hi, this is ok if you separte the core component from custom, the Author never realised the differenc. It is mostly the developer who has to deal with it.

         

        One idea cloud be

        /apps/<group>/<tenant>/component/content/core
/apps/<group>/<tenant>/component/content
/apps/<group>/<tenant>/component/structure
/apps/<group>/<tenant>/clientlibs

/conf/<group>/<tenant>
/content/<group>/<tenant>
        Arun Patidar
          W
          webdev91Author
          Level 3
          August 15, 2022

          Hi @arunpatidar

          I also thought of putting core components inside the core folder but I created the below folder structure. I hope that's ok.

          /apps/<tenant>/components/content
/apps/<tenant>/components/core
/apps/<tenant>/components/structure

          I will further categorize components inside the content folder based on their nature.

          Thank you!

            arunpatidar
            Community Advisor
            arunpatidarCommunity Advisor
            Community Advisor
            August 15, 2022

            This also fine unless the developer are not confused with folder structures.

            Arun Patidar
              DEBAL_DAS
              DEBAL_DAS
              New Member
              August 15, 2022

              In our project also we are following below folder structure to organize the components -

               

              • /apps/<project/site>/components/structure —> project or site specific page components goes here
              • /apps/<project/site>/components/content –> project or site specific custom authorable components goes here
              Debal Das, Senior AEM Consultant
                Terms & ConditionsAccessibility statement

                Loading footer...