One coherent model
Direct links, submenu-only groups, or linked parents with a separate caret—one child level, intentionally.
Discourse theme component
Give your community
a coherent surface.
Brand Navigation combines brand identity, primary links, one-level submenus, and compact header destinations in one responsive component.
Independently maintained by CodeWorksLabs. Not an official Discourse product.
What it solves
More than custom links.
Less than a page builder.
Responsive by design
Compact mobile menu, wrapping mobile bar, or no mobile surface, plus per-item device visibility.
Audience-aware
Show destinations to everyone, anonymous visitors, or authenticated members.
Administrator-friendly
Structured object settings, validated input, palette-inheriting colors, and useful sample navigation.
Portable setup
Versioned JSON configuration bundles for backup and repeatable multi-site preparation.
Embed-safe boundaries
Site-global surfaces do not mount in supported Discourse embed contexts.
Install with Git
Prepare on staging.
Publish when ready.
https://github.com/CodeWorksLabs/brand-navigation.gitUse Discourse’s native component Enabled? control as the single activation switch. Attach it to a non-default staging theme first.
Installation guide →Known-working builds are evidence points, not a minimum-version declaration. Complete human screen-reader and RTL acceptance remain open, and the full release-tag pin-and-return rollback workflow remains provisional.