This tutorial will run you through the very basics of using RapidWeaver. There is also a quick-start video that will show you how to build a website in under 5 minutes.


On the first launch of RapidWeaver, the Projects will appear.

When the Projects window is shown for the first time, RapidWeaver takes you to the Examples tab. This area shows the five included example projects, built by some of the best third-party add-on developers. Each project highlights one of the modern, responsive themes included with RapidWeaver and includes a selection of different pages, meaning you can use these examples as a starting point for your own projects. Any projects you create in RapidWeaver will appear in the Recent tab - and for ease of use, RapidWeaver will remember your selection of either Recent or Examples.

Note: The number of Recent sites that RapidWeaver lists will depend on the setting in System Preferences’ General tab, and the list of files is derived from the OS X “Recent Files” list.

In this tutorial, you’ll build a project from scratch so that you can understand how the example sites are made, so select New Project in the Projects window. You can also usethe File menu’s New Project option, or the keyboard shortcut Cmd Shift N.

Create A New Project

The new project is empty right now, so let’s add a page to the project by choosing Add on the main toolbar, and selecting a Markdown page.

The Add menu shows all the available page types (sometimes referred to as “plugins”) that you can add to a RapidWeaver project. The Add menu will adapt as you use RapidWeaver, by choosing to suggest your most recently used plugins, and you can view all the plugins by choosing all Plugins. Get started by adding a Styled Text page to your website.

With a page added to your site, let’s add some content to this page!

We’ll start by adding an image to the page - you may have an image already exported to the Finder, or have an image from your library in mind.

To insert an image into a Styled Text page, drag the image from the Finder onto the desired line on the page. You can open the iMedia Browser with Cmd 4 to browse, iPhoto & Aperture (if you’ve not yet upgraded to Photos), and Lightroom.

Designing Your Website

RapidWeaver includes over fifty varying templates known as “themes”, including a number of modern responsive designs that you can use. With a page now added to your project, choose preview on the main toolbar to get your bearings (you can also toggle preview mode with the keyboard shortcut Cmd R). By default, RapidWeaver will apply the “Offroad” theme to your site to preview your content. We’re going to browse the available themes by toggling the themes option on the main toolbar.

The Theme Browser allows you to apply any theme with a single click - you can customise each theme further once it’s selected. The Theme Browser allows you to search, select a specific folder (for example, to only show the more modern themes), and duplicate the themes to make modifications.

Once you’ve selected a theme, choose Master Styles in the Page List. The Master Styles area contains the variations available as part of your selected theme, and allows you to customise the theme across your entire site. Master Styles is the best way to lay your entire site out, but if you need to customise the layout of a single page don’t worry - you can override your site-wide Master Styles on a per-page basis if you need to!

That's it, you now have a basic website. Watch the quick-start guide to learn more. You can also browse the online help files to learn how to add more content, organise pages and upload your website.

Did this answer your question?