A central concept in Dust are namespaces, which is how it’s possible to reference components and other resources in one module from another one.

Namespaces take the form of an URI and follow the same rules as XML namespaces.

Modules register namespaces during their initialization, which causes the module to be scanned for any fragments, components and pages within the package of the module.

A simple module

public static class MyAppModule extends CrayonModule {
	protected void configure() {

	public void contributeNamespace(Namespaces namespaces) {

This module binds the namespace dust:example to the package of the class MyAppModule.

Referencing a namespace

It is now possible to reference any component discovered in the namespace by declaring the namespace in your template XML:

<div xmlns:app="dust:example">
	<app:myComponent /> <!-- references myComponent in dust:example -->

	${app:echo('hello')} <!-- calls the method echo in dust:example -->

Built-in namespaces

By default a few namespaces are registered, these are:

  • dust:common - common template components
  • dust:parameters - for passing blocks of markup into components
  • dust:fragments - define tiny reusable blocks of markup within a template
  • dust:messages - holds localized messages of the current template