Nested Site Mounts

Stacklane sites may be organized into smaller sub-sites and mounted at a path.

To nest a site at a sub-path of another site, create a configuration file such as: /๐Ÿ”Œpath-name.yaml where "path-name" will become the directory where the site is nested at. For example, if your main site is hosted at, a configured nested site /๐Ÿ”Œstore.yaml would host the nested site at


The only required field for a site mount is the location to obtain the nested site's source code.



If the nested site is data driven, then it must be assigned a data namespace. This ensures the data remains relevant if you later change its path. Minimum length is 4 characters, maximum length is 25 characters.

namespace: my-namespace

Shared Data

A nested site may share data with its parent by specifying:

namespace: shared

However this should only be used in special scenarios, especially when the parent and nested site are sharing the same data model.


If the nested site contains a style configuration, then the values in the style configuration may be overridden, where the values beneath "๐ŸŽจ" correspond to values in the nested site's ๐ŸŽจ.scss file.

  some-option: true
  the-color: aliceblue


Since secure keys and credentials are scoped to the parent, there may be certain keys that the parent needs to expose to a nested site. The parent must explicitly specify individual keys, and any other keys will be non-existent for the nested site.