Skip to content

Getting Started

Start building with Precursor.

Precursor gives WordPress a clean, flexible foundation for semantic HTML, reusable components, child themes, and builder-optional workflows.

Step One

Install the framework.

Install Precursor like any standard WordPress theme. Upload the theme, activate it, and then begin configuring the framework through the WordPress Customizer.

  1. Download the latest Precursor theme package.
  2. Go to Appearance → Themes.
  3. Click Add New, then Upload Theme.
  4. Choose the Precursor ZIP file and activate the theme.
Tip: Precursor works on its own. The BLOKS Code Editor is optional.

Step Two

Configure the basics.

Site Identity

Add your logo, site title, tagline, and site icon using the WordPress Customizer.

Header Options

Choose your header layout, header width, logo size, sticky header behavior, and accent bar visibility.

Design Options

Select color presets, typography, style presets, and content width settings.

Step Three

Understand the structure.

Precursor separates structure from presentation. The parent framework provides templates, navigation, layout rules, design tokens, and reusable components. Child themes provide branding, colors, typography, and visual personality. 

WordPress
  ↓
Precursor
  ↓
Child Theme
  ↓
Content

Framework First

Use Precursor as the foundation, not the finished design.

Precursor is intentionally neutral. It gives you the structure needed to build clean WordPress sites while leaving visual decisions to your child theme or custom CSS.

Core principle: Structure belongs in the framework. Personality belongs in the child theme.