superpowers-sage:sage-lando

Guide Sage theme scaffolding with Acorn and Lando generators.

13|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-sage-lando-hekivo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-sage:sage-lando
Source: https://github.com/hekivo/superpowers-sage/tree/main/skills/sage-lando
Command: npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-sage-lando-hekivo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates slow, error-prone setup and file-structure mistakes when building or modifying a Roots Sage (Acorn) WordPress theme in a Lando-based development environment.

Core Features & Use Cases

  • Environment & Lando workflow guidance: Start, inspect, and run the right Lando commands for Sage/Acorn projects, including cache and build steps.
  • Generator-first scaffolding across domains: Provides a decision guide for creating Acorn view composers, Blade components, ACF Composer blocks/fields/options/partials/widgets, and Acorn providers/commands using the correct generator commands.
  • Sage/Acorn structural correctness & troubleshooting: Helps troubleshoot common issues (Blade cache staleness, autoloading, ACF sync, Vite HMR, wrong Composer context, and provider boot/register lifecycle mistakes) using the referenced validation rules.

Quick Start

Ask the AI to set up the correct generator path for a new ACF block named "Hero" and to scaffold both the block class and its Blade view inside a Lando Roots Sage theme, assuming the theme follows the expected Bedrock/Sage directory layout.

Frequently Asked Questions about superpowers-sage:sage-lando

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a new ACF Composer block in a Roots Sage theme using Lando?

To scaffold an ACF Composer block in Roots Sage using Lando, run the correct Acorn generator command via Lando tooling to create both the block class and its Blade view, assuming a standard Bedrock/Sage directory layout.

Why does my Vite HMR not update Blade components in my Sage theme?

Vite HMR issues in Sage themes often stem from Blade cache staleness or wrong Composer context. Use Lando tooling to clear caches and verify your Acorn view composers are properly registered before rebuilding assets.

Can I use Acorn providers and commands with my existing Bedrock Sage setup?

Yes, Acorn providers and commands work with Bedrock Sage setups. Use the appropriate generator commands through Lando to scaffold them, ensuring your project follows the expected Bedrock/Sage structure for proper autoloading and boot lifecycle.

What is the best way to troubleshoot ACF sync and autoloading issues in Sage?

Troubleshooting ACF sync and autoloading in Sage involves checking Acorn provider boot/register lifecycle sequences and validating structural correctness. Read domain references and use Lando commands to clear caches and inspect Composer contexts.

Does Sage development with Lando require a specific directory structure?

Sage development with Lando requires the project and theme to follow the expected Bedrock/Sage structure. This structural correctness is necessary for generator-driven creation of providers, composers, components, and ACF Composer blocks to function properly.

How do I create Acorn view composers and Blade components for Sage without file structure errors?

To create Acorn view composers and Blade components without errors, use generator-first scaffolding via Lando tooling. This approach selects the correct scaffolding path for your domain, ensuring structural correctness and proper autoloading within your Bedrock/Sage theme.