Page builder

Load site-dna first. Every page follows its §4 anatomy unless there is a stated reason not to.

Where things live

WordPress resolves page-<slug>.php automatically by page slug. A new page in wp-admin with slug pricing picks up theme/page-pricing.php with no routing.

Adding a page

1. Copy the closest existing page-*.php — they share a header/hero pattern.
2. Compose it from existing template parts before writing new markup.
3. Any business fact comes from a SB_* constant. If the constant does not exist, add it to site.config.example.php and site.config.php.
4. Wrap every user-facing string in esc_html_e() / esc_html__() with the site-builder-theme text domain.
5. Escape on output, always: esc_html(), esc_url(), esc_attr().

Adding a section

<?php
/**
 * <What this section is for.>
 *
 * @package site-builder-theme
 */
declare( strict_types=1 );
if ( ! defined( 'ABSPATH' ) ) { exit; }
?>
<section class="my-section" aria-labelledby="my-section-title">
  <h2 id="my-section-title"><?php esc_html_e( 'Heading', 'site-builder-theme' ); ?></h2>
</section>

Include it with get_template_part( 'template-parts/my-section' );

Rules

• No page builders, no CSS frameworks, no jQuery. The theme is hand-written and mobile-first. Adding Bootstrap or Elementor to "save time" here costs more than it saves, because everything else assumes plain CSS.
• Mobile first. Base styles are the phone; responsive.css adds the larger breakpoints upward.
• Every section must render with no images present. Backgrounds degrade to a colour. A site that only looks right once photography arrives cannot be reviewed before photography arrives.
• One primary action per page (site-dna §6).

Checks before you call it done

find theme -name "*.php" -exec php -l {} \; | grep -v "No syntax errors"
grep -rn "\[[A-Z][A-Za-z ]*\]" theme/          # leftover placeholder copy
grep -rnE "[0-9]{3}-[0-9]{3}-[0-9]{4}|@[a-z]+\.(com|net)" theme/   # hardcoded contact details

All three should be silent.