{{#freestyle-usage "gutter-nav" title="Gutter Menu"}}
{{/freestyle-usage}} {{#freestyle-usage "gutter-nav-rich-components" title="Gutter Navigation with Rich Components"}}
{{/freestyle-usage}} {{#freestyle-annotation}} In order to keep the gutter navigation streamlined and easy to navigation, rich components should be avoided when possible. When not possible, they should be kept near the top. {{/freestyle-annotation}} {{#freestyle-usage "gutter-nav-many-items" title="Hypothetical Gutter Navigation with Many Items"}}
{{/freestyle-usage}} {{#freestyle-annotation}} There will only ever be one gutter menu in the Nomad UI, but it helps to imagine a situation where there are many navigation items in the gutter. {{/freestyle-annotation}} {{#freestyle-usage "gutter-nav-icon-items" title="Hypothetical Gutter Navigation with Icon Items"}}
{{/freestyle-usage}} {{#freestyle-annotation}} In the future, the gutter menu may have icons. {{/freestyle-annotation}} {{#freestyle-usage "gutter-nav-global" title="Global Gutter Navigation"}}
{{#gutter-menu}} {{!-- Page content here --}} {{/gutter-menu}}
{{/freestyle-usage}} {{#freestyle-annotation}}

Since there will only ever be one gutter menu in the UI, it makes sense to express the menu as a singleton component. This is what that singleton component looks like.

Note: Normally the gutter menu is rendered within a page layout and is fixed position. The columns shown in this example are only to imitate the actual width without applying fixed positioning.

{{/freestyle-annotation}}