Skip to main content

What the theme includes

The starter theme provides infrastructure you build on, examples you can adapt, and optional development tools you can turn on when you need them. This page is a map of all three — what each one is, where its source lives, and how to see it working. Initialization owns the commands that select and toggle them; Local development owns builds and checks.

Theme infrastructure​

These facilities are part of the starter and remain after an example is removed. The loaders and utilities are theme-owned adapters around the linked wp-primitives services.

FacilityOwnership and sourceDefault / lifecycleTry or verify
Block-theme layoutSkeleton: theme.json, templates/, parts/, patterns/, styles/Included; edit these files directly.Open Appearance → Editor and edit a template or style.
Bootstrap and registrationSkeleton: functions.php, inc/Main.php, inc/Core/; framework: Loader and Registrable (contracts)Included; add new classes to Main::CLASSES.Add a class and run composer dump-autoload.
Asset loadingSkeleton: inc/Core/Assets.php, src/css/, src/js/; framework: AssetLoader (loaders)Included; source is editable and assets/build/ is generated.Run a development build and inspect the loaded frontend assets.
ComponentsSkeleton: inc/Core/Components.php, src/components/; framework: ComponentLoaderLoader included; button and card examples can be removed during init.Render a component with Util::component() as shown below.
Template helpersSkeleton: inc/Core/Templates.php, template-parts/; framework: TemplateLoaderLoader included; the supplied author template follows the shortcode example's lifecycle.Render a part with Util::get_template() and check the frontend.
Runtime feature flagsSkeleton: inc/Core/FeatureRegistry.php, inc/Abstracts/AbstractThemeFeature.php; framework: FeatureSelectorRegistry included; retained feature flags are toggled in Settings → Features.Toggle a retained example and check the next request.
LoggingSkeleton: inc/Core/Logger.php, Util::logger(); framework: LoggerIncluded; writes only when WP_DEBUG is enabled.Call Util::logger()->info( 'Theme loaded' ) and inspect the WordPress debug log.
Encryption serviceSkeleton: inc/Core/Encryption.php, Util::encryption(); framework: EncryptorIncluded; configure the theme encryption key before use.Encrypt and decrypt a value, then confirm the round trip.
Quality checksSkeleton: tests/, package.json, composer.jsonIncluded; run focused checks for each change.Run the development checks.

Supplied examples​

All example sets are kept by default. Removing a set during init deletes its configured files and consumes its registration markers; it is not an on/off switch you can later use to restore the example.

Init keyOwnership and sourceDefault / lifecycleHow to see it
block-extensionSkeleton: inc/Modules/BlockExtensions/MediaTextInteractive.php, patterns/media-text-interactive.php, src/js/frontend/modules/media-text.jsKept by default; remove during first init only. The media-text-interactive runtime flag can be toggled in Settings → Features.Insert the supplied media/text pattern, build the module, and check its frontend interaction.
settingsSkeleton: inc/Modules/Settings/ThemeOptions.phpKept by default; remove during first init only.Open the theme's settings page under Settings; save Example Text and reload.
shortcodeSkeleton: inc/Modules/Shortcodes/AuthorBio.php, template-parts/author-bio.phpKept by default; remove during first init only. The author-bio runtime flag can be toggled in Settings → Features.Populate a user's biography and add the renamed author-bio shortcode to a Shortcode block, using that user's ID.
componentsSkeleton: src/components/button/, src/components/card/Kept by default; remove during first init only.Call a component from a PHP template and build its assets.
patternsSkeleton: patterns/page-creation-pattern.phpKept by default; remove during first init only.Create a page and use the supplied page-creation pattern.

For an Acme Blog project that retained the button example, call this from a PHP template:

\rtCamp\Theme\Acme_Blog\Helpers\Util::component(
'button',
[ 'label' => __( 'Read more', 'acme-blog' ), 'url' => home_url( '/' ) ]
);

The development guide shows the manual extension pattern. To generate a new feature, follow Scaffolding. Original examples remain browsable in the starter theme source after you remove them from your project.

Optional development features​

Unlike the supplied examples, these aren't source you keep or remove once — they're features you can turn on or off at any time through init.

Init keyOwnership and sourceDefault / lifecycleTheme-visible resultVerify
hmrSkeleton: webpack.config.js, inc/Core/Assets.php, .env.localOn by default; toggle repeatedly with init or ENABLE_HMR. Dependencies remain installed.BrowserSync watches compiled assets and reloads or injects changes.Start the asset watcher in a local WordPress environment and edit CSS. See Live reload.
tailwindSkeleton: bin/features/tailwind/, webpack.config.js, functions.php, inc/Core/Assets.php; tooling package: @rtcamp/tailwind-configOff by default; enable or disable with init. The generated token file and build output are ignored.Adds the entry and PostCSS config, declares dependencies, and enables the Tailwind enqueue constant.Run npm install, build, and inspect a utility class. See Tailwind.

The Settings → Features runtime switches, such as author-bio and media-text-interactive, control whether retained PHP hooks register. They are separate from init's optional development features and never delete source files.