Ask or search…

Bundle Structure

An Element is a bundled folder
Elements require a specific directory structure in order to work correctly, these are called Bundles in macOS.
Element bundles are directory hierarchies, with the top-level directory having a name that ends with a .rwdevpack or .rwelementpack extension.

Distributing Element Packs

RapidWeaver Element Packs (.rwelementpack) are highly optimised encrypted bundles compiled from an RapidWeaver Dev Pack (.rwdevpack) and ready for distribution. Use the dev tools inside of RapidWeaver to convert from a DevPack into a compiled Element Pack.
RapidWeaver Dev Packs are only for development and should not be distributed.
Elements should only be distributed as compiled RapidWeaver Element Packs (.rwelementpack).

Dev Pack Bundle Structure

The following outlines the folder structure supported by elements — Only bold items are required for a basic Element to function inside of RapidWeaver.
An Element pack can contain multiple Elements, each Element should be placed in the "elements" folder inside the main bundle.
  • HelloWorld.rwdevpack (bundle)
    • elements (folder)
      • com.realmac.elementpack.helloworld (folder)
        • hooks.js
        • icon.icns
        • icon-dark.icns
        • info.json
        • paletteIcon.png
        • paletteIcon-dark.png
        • properties.json
        • assets (folder)
        • templates (folder)
          • each (folder)
            • index.html
            • styles.css
          • include (folder)
            • extra.html
          • page (folder)
            • page.html
Here's a Finder window showing the above Element layout on macOS Ventura.
Finder window showing the layout of a typical Element.
And the same Element being edited in Visual Studio Code.
Editing an Element in Visual Studio Code

Dev Pack with Multiple Elements

An Element pack can have multiple addons inside of it, here's an example of that structure:
WebWorld.rwdevpack (bundle)
  • elements (folder)
    • info.json
    • com.realmac.elementpack.helloworld (folder)
    • com.realmac.elementpack.goodbyeworld (folder)
We are Realmac Software. We make nice things.