2. Create Folder Structure

a module can contain any code that will run on siteglide, but that code does need to be split into the relevant folders (notifications, views, etc ) and folder structures below, we'll take a look at how to do just that along with all the various options available to you, depending on what you would like to build quick start you can also use our boilerplate template on github https //github com/siteglide/siteglide module boilerplate https //github com/siteglide/siteglide module boilerplate \<module name> the module name is written in the following format module \<vanity id> replace vanity id with the vanity id generated in your module listing in portal for example, with our siteglide theme demo module this would generate a name of module 76 your module name (based on your generated vanity id) should be used anywhere the tag \<module name> is referenced in this documentation create your staging site create a new staging site within your agency to build your module on ideally you'll want to use a blank site, so pick the "build a custom site" option on creation only you will see what your site is called, so you can call it anything you like once you have successfully created your staging site, create a project folder on your machine to work within, connect to your site via cli and then pull the site down onto your local machine so that you are ready to begin building your module top level folders when you begin building a module, there are two top level folders that should be created alongside the marketplace builder folder of your staging site the top level module folders are modules/\<module name>/private modules/\<module name>/public any information that is stored in the private folder will not be accessible to users within the siteglide site admin, cli and graphql here you should store any logic that you don’t want anyone to be able to see or edit if you are following our example siteglide theme demo module, as it is a theme we do not have any private files and so this folder can be ignored any information stored in the public folder will be accessible to users within the siteglide site admin, cli, and graphql this folder should be used for any content that you would like to be visible and editable to the user sub level folders under each top level folder you have the option to create any relevant folders for the information you are wanting to create and use, such as assets , views , notifications etc full folder structure /my project folder /modules /\<module name> /assets /css /documents /js /scripts /authorization policies /custom module types /forms /modules /webapps /form configurations /forms /modules /webapps /graph queries /notifications /api call notifications /email notifications /pages /redirects /translations /user profile types /views /layouts /templates /pages /system pages /partials /layouts you can view and download this full folder structure from the example directory structure git repo alternatively, run the init command in cli to automatically create the structure within the marketplace builder folder and then move them into your module https //documentation platformos com/developer guide/platformos workflow/codebase directory/file explanation learn more assets used to store any assets (images, files, css etc) that you would like to ensure are accessible when your module is installed views contains all layouts/partials/pages/templates visible from admin & front end of a site the module is installed on notifications email and api notifications graphql graphql queries and other data handling module setup files beyond the standard site files that will be in your module (graphql, liquid, partials etc), the module installation process will look for 3 other files in the root folder of your module project (alongside /modules/ ) folder structure example /my project folder /modules /\<module name> /views setup json ignore on update json install process json setup json the setup json file contains information about your module, including any tables (data) you want to create when installing your module to a site you can view an example of this file here https //github com/siteglide/module siteglide example/blob/master/setup json files generated from this json file model \<module name> yml stored at modules/\<module name>/public/custom model types/modules/\<module name> yml form configuration \<module name> liquid stored at modules/\<module name>/public/form configurations/modules/\<module name> liquid detail page (if applicable) \<module name> liquid stored at modules/\<module name>/public/views/pages/modules/\<module name> liquid you can find details on field types in this document https //developers siteglide com/field types ignore on update json this file should contain a list of files you don’t want to be overwritten on sites when updating to a new version of your module typically these would be any layout or asset files in your module that a user will have edited in the last version each array’s key should be the version they are created at for example, if you want a file to be ignored when updating to any version above 1 0 0, set the key as 1 0 0 you can see an example structure here https //github com/siteglide/module siteglide example/blob/master/ignore on update json in this example, an update above 1 0 1 will ignore all 6 files in the list install process json the install process file will run a siteglide created process while the module is installed on the site a list of all of the scripts that are relevant for each module type can be found here create and link in this example we will need a page to be set as the homepage of the site after installing the module this is done using the set homepage process we will create a file with the version number of our module and set homepage as our process as seen here