Skip to content

Add modules and features

A module is one area of your business, and a feature groups related behavior inside it. In Acme Commerce, the Storefront has features such as Basket, Browse, Checkout and MyOrders. This page shows how to build that structure. For why the board is shaped this way, read Modules and features.

  1. Select Add Module (the sitemap icon) in the toolbar on the left edge of the board. A new, empty board points you to it.

  2. Studio places the module near the middle of your view. Double-click its name to rename it.

  3. To drag a whole collection of modules somewhere else, use its handle, labeled Drag to move collection.

To add another module next to an existing one, open the Add menu in the module header and choose Add Module.

  1. Open the Add menu in the header of a module.

  2. Choose Add Feature.

  3. Double-click the new feature’s name to rename it.

Features can nest. Open the Add menu in a feature’s header and choose Add Sub-feature to put a smaller group of behavior inside it.

The options menu of a module with Explain how this module works, Export module to Mermaid and Delete module
A module's options menu.

A feature’s options menu holds the actions for the whole group.

The options menu of a feature listing Generate, Assign feature, Preview code, Generation runs, Focus on this feature, Explain, Export, Context for an agent, Disable feature and Delete feature
A feature's options menu.
Choose To
Focus on this feature Draw only this feature. See Find your way around a board.
Assign feature Give the whole feature to a team member.
Generate Ask AI to fill the feature with slices. See Work with AI.
Preview code and Generation runs Look at generated code and earlier generation runs. See Build and deliver.
Explain how this feature works Ask an agent for an explanation. It appears only when AI is available.
Export feature to Mermaid Download the feature as a diagram.
Context for an agent Copy or download the feature’s description for an external AI tool.
Disable feature Turn the feature off without deleting it; Enable feature turns it back on.
Delete feature Remove the feature.

A module’s menu has Explain how this module works, Export module to Mermaid and Delete module.

A feature can be raised to Draft, Analysis or Ready for implementation. The working statuses, such as In progress and Done, are set on each slice. All statuses are listed in Statuses and colors.

Modules do not share a database. They only share facts. Draw the connection first, then name the fact.

  1. Find the connect dot on the edge of the module that produces the fact.

  2. Drag from the dot to the other module. A line follows the pointer. Drop it on the module that needs the fact, and the flow is drawn.

  3. On the slice in the receiving module, select the + on its row and search for the event. Pick it. The slice now refers to the other module’s event.

  4. Hover the reference. The rest of the board dims, leaving the event and the slice that produces it.

For facts that cross between applications, see Translations and public events.

Your module shows up on the board with its features beneath it, and a connection draws a line between the two modules. Open a feature’s header to see its Add menu, comments and status.

The Catalog board zoomed out: the Merchandising module with its Pricing, Products and Publication features, each holding slices
A finished structure: the Merchandising module of Acme Catalog, with the features Pricing, Products and Publication side by side.