@codigodoleo/wp-kit 3.2.0 → 3.4.0

package/README.md

@@ -1,240 +1,119 @@
-# @codigodoleo/wp-kit (CLI: leo-wp)
+# @codigodoleo/wp-kit
 
-Simplifique e padronize seus projetos WordPress em minutos. Este CLI cria um esqueleto moderno, opinativo e pronto para CI/CD, com integração a temas (Sage), qualidade de código e fluxos de deploy — tudo com escolhas inteligentes e mínima fricção.
+[![npm version](https://img.shields.io/npm/v/@codigodoleo/wp-kit)](https://www.npmjs.com/package/@codigodoleo/wp-kit)
+[![license](https://img.shields.io/npm/l/@codigodoleo/wp-kit)](LICENSE)
 
-## Por que usar
+wp-kit monta a estrutura que você sempre recria do zero — lint, CI, deploy, scaffolds WordPress — em menos de um minuto.
 
-- Padronização entre projetos e equipes
-- Onboarding rápido (menos passos manuais, menos erros)
-- CI/CD dinâmico que se adapta às suas escolhas (GitLab, GitHub ou Bitbucket)
-- Convenções modernas (Conventional Commits, linters, hooks)
+## O que você quer fazer hoje?
 
-## Requisitos
-
-- Node.js 18+ (recomendado 22+)
-- npm
-- Git
-- PHP 8.2+ e Composer (necessário para tema Sage e ferramentas PHP)
+| Cenário                       | Módulos ativos            | Quickstart                    |
+| ----------------------------- | ------------------------- | ----------------------------- |
+| Só lint, git e deploy         | `lint` + `git` + `deploy` | [→ Quickstart](#quickstart)   |
+| Tema WordPress moderno (Sage) | + `sage`                  | [→ Sage](#sage)               |
+| MU Plugin customizado         | + `mu-plugin`             | [→ MU Plugin](#mu-plugin)     |
+| Plugin WordPress              | + `plugin`                | [→ Plugin](#plugin)           |
+| Tema do zero com Vite         | + `blank-theme`           | [→ Blank Theme](#blank-theme) |
 
-## Quickstart (1 minuto)
+> ⚡ Os módulos são combinantes — você pode ter Sage + mu-plugin + lint no mesmo projeto. E pode adicionar módulos rodando o `init` novamente.
 
-- Criar projeto interativo:
+## Quickstart
 
 ```bash
-npx @codigodoleo/wp-kit init --output meu-projeto
+npx @codigodoleo/wp-kit init --output meu-site
 ```
 
-- Projeto padrão (sem perguntas):
+Sem perguntas (defaults inteligentes):
 
 ```bash
-npx @codigodoleo/wp-kit init --output meu-projeto --defaults
+npx @codigodoleo/wp-kit init --output meu-site --defaults
 ```
 
-- Instalação global (opcional):
+Instalação global (opcional):
 
 ```bash
 npm install -g @codigodoleo/wp-kit
-leo-wp init --output meu-projeto
-```
-
-## O que é gerado
-
-- Estrutura WordPress com `content/` (temas, plugins, uploads)
-- Configurações úteis em `server/` e arquivos base (`.env`, `.editorconfig`, etc.)
-- Workspace do VSCode (opcional)
-- Pipelines de CI prontos, conforme o provedor escolhido:
-  - GitLab: `.gitlab-ci.yml`
-  - GitHub: `.github/workflows/ci.yml`
-  - Bitbucket: `bitbucket-pipelines.yml`
-- Convenções de Git e qualidade (husky, commitlint, lint-staged, ESLint, Prettier, Stylelint, Pint)
-- Integração opcional com tema Sage (v10/v11), com build automatizado
-
-## Como funciona (visão rápida)
-
-1. Você roda `init` e responde às perguntas (ou usa `--defaults`).
-2. O CLI infere capacidades (Composer, Node, Sage, Docker) e monta `context.ci`.
-3. O módulo `deploy` gera o pipeline certo para seu provedor (GitLab/GitHub/Bitbucket) com jobs somente do que faz sentido para o seu projeto.
-
-Exemplo: Se você ativar Sage 11, ajustamos versões automaticamente (PHP/Node/WP) e incluímos o job de build do tema no CI.
-
-## Fluxo recomendado
-
-1. Execute o comando (interativo):
-
-```bash
-npx @codigodoleo/wp-kit init --output meu-wp
+leo-wp init --output meu-site
 ```
 
-2. Escolha o provedor de Git (ex.: GitLab ou GitHub) no prompt do módulo "git".
-3. Ative o módulo "deploy" (gera a pipeline automática).
-4. Se desejar, habilite o tema Sage (o build entra na pipeline automaticamente).
-5. Faça o primeiro commit e suba o repositório. O CI já estará pronto para rodar.
+## Scaffolds disponíveis
 
-## Comandos disponíveis
+|               | Sage                      | MU Plugin                   | Plugin                   | Blank Theme               |
+| ------------- | ------------------------- | --------------------------- | ------------------------ | ------------------------- |
+| **Diretório** | `content/themes/{name}`   | `content/mu-plugins/{name}` | `content/plugins/{name}` | `content/themes/{name}`   |
+| **PHP**       | Acorn + Blade             | PSR-4                       | PSR-4                    | Mínimo                    |
+| **JS/CSS**    | Vite (Bud)                | —                           | —                        | Vite + SCSS               |
+| **ACF**       | ACF Composer              | —                           | —                        | —                         |
+| **Lint**      | ESLint + Stylelint + Pint | Pint                        | Pint                     | ESLint + Stylelint + Pint |
 
-- `init [options]` — Inicializa um novo projeto WordPress com DevOps
-- `--help` — Ajuda
-- `--version` — Versão
-
-### Opções do `init`
-
-- `--output <path>` — Diretório de saída do projeto
-- `--defaults` — Usa configurações padrão sem interação
-
-## Exemplos práticos
-
-- Interativo, escolhendo tudo pelo prompt:
-
-```bash
-npx @codigodoleo/wp-kit init --output site-corporativo
-```
-
-- Projeto padrão, sem prompts (padrões inteligentes):
-
-```bash
-npx @codigodoleo/wp-kit init --output blog-interno --defaults
-```
-
-## Estrutura essencial de pastas
-
-```
-meu-projeto/
-  content/
-    themes/
-    plugins/
-    uploads/
-  server/
-  .gitlab-ci.yml | .github/workflows/ci.yml | bitbucket-pipelines.yml
-  .env, .editorconfig, README.md, etc.
-```
+## Requisitos
 
-## CI Dinâmico (como decidimos o que rodar)
+- Node.js 18+ (recomendado 22+)
+- npm
+- Git
+- PHP 8.2+ e Composer — necessário para Sage, mu-plugin e plugin
 
-Detectamos automaticamente:
+## Módulos
 
-- `composer.json` (root/tema) → job de Composer
-- `package.json` (root/tema) → job de Node
-- Tema Sage ativo → job de build do tema
-- Deploy Docker escolhido → job de deploy Docker
+| Módulo        | O que faz                                                           |
+| ------------- | ------------------------------------------------------------------- |
+| `git`         | Inicializa repositório, Husky, commitlint, lint-staged              |
+| `deploy`      | Gera pipeline de CI (GitLab, GitHub Actions ou Bitbucket Pipelines) |
+| `lint`        | Configura ESLint, Prettier, Stylelint, Pint, commitlint e hooks     |
+| `sage`        | Scaffold do tema Roots Sage v11 em `content/themes/`                |
+| `mu-plugin`   | Scaffold de MU Plugin em `content/mu-plugins/`                      |
+| `plugin`      | Scaffold de Plugin em `content/plugins/`                            |
+| `blank-theme` | Scaffold de tema Vite+SCSS em `content/themes/`                     |
+| `php`         | Scripts e configs auxiliares para PHP                               |
+| `docs`        | Gera README do projeto gerado                                       |
 
-Provedores suportados:
+Documentação completa: [docs/04-Módulos.md](docs/04-Módulos.md)
 
-- GitLab CI, GitHub Actions, Bitbucket Pipelines
+## Lint modular
 
-## Convenções e qualidade
+O sistema de lint é modular: cada scaffold tem suas próprias configs instaladas de forma independente.
 
-- Commits: Conventional Commits (ex.: `feat:`, `fix:`, `docs:`)
-- Hooks: Husky + lint-staged (validação automática ao fazer commit)
-- Linters: ESLint (flat config), Prettier, Stylelint, Pint
-- Commitlint: Validação de mensagens de commit convencionais
-- Interactive commits: Use `npm run commit` para commits interativos
+> ⚠️ `enable_lint` controla apenas Husky + commitlint + `.lintstagedrc.json` dinâmico. Os arquivos de config (`pint.json`, `.prettierrc.json`, `eslint.config.mjs`) são sempre instalados em cada scaffold, independentemente dessa flag.
 
-## Script de desenvolvimento
+O `.lintstagedrc.json` na raiz é gerado dinamicamente com base nos módulos ativos — apenas os linters relevantes para o que você habilitou.
 
-Comandos disponíveis para desenvolvimento:
+## CI Dinâmico
 
-- `npm run lint` — Validar código com ESLint
-- `npm run lint:fix` — Corrigir automaticamente problemas de linting
-- `npm run format` — Formatar código com Prettier
-- `npm run commit` — Criar commit interativo (cz)
-- `npm run test:setup` — Gerar sandbox de teste
-- `npm run test:scaffold` — Criar novo projeto de teste
+O pipeline é gerado com base nos módulos que você ativou:
 
-## Git Workflows
+- `ci.build.composer` — composer.json detectado ou Sage ativo
+- `ci.build.node` — package.json detectado ou Sage ativo
+- `ci.lint.sage` — Sage ativo + `enable_lint`
+- `ci.lint.mu_plugin` — mu-plugin ativo + `enable_lint`
+- `ci.lint.plugin` — plugin ativo + `enable_lint`
+- `ci.lint.blank_theme` — blank-theme ativo + `enable_lint`
+- `ci.deploy.docker` — estratégia Docker selecionada
 
-O projeto usa Husky para automatizar validações:
+> 💡 Você não precisa editar o pipeline manualmente — se ativar um módulo, o job correspondente já aparece no CI.
 
-- **pre-commit**: Executa lint-staged em arquivos modificados
-- **commit-msg**: Valida mensagem com commitlint
+Documentação completa: [docs/05-CI-Dinâmico.md](docs/05-CI-Dinâmico.md)
 
-Se precisar pular hooks (situação de emergência apenas):
+## Scripts de desenvolvimento
 
 ```bash
-git commit --no-verify
+npm run lint          # ESLint
+npm run lint:fix      # ESLint com correção automática
+npm run format        # Prettier
+npm run commit        # Commit interativo (commitizen)
 ```
 
-## ESLint Flat Config (moderne)
-
-O projeto agora usa o novo formato ESLint flat config (`eslint.config.mjs`):
-
-- Melhor inicialização de projeto
-- Sem `eslintrc.json` legado
-- Ignores integradas na configuração principal
-- Melhor performance
-
-Projetos gerados também usarão este novo formato.
-
-## Dicas e solução de problemas
-
-- Pipeline não foi gerado? Verifique se habilitou o módulo `deploy` e qual provedor selecionou no módulo `git`.
-- Tema Sage não compilou? Garanta Composer/Node instalados e que o tema existe em `content/themes/<projectName>`.
-
-## AI Co-Pilot Support 🤖
-
-wp-kit agora inclui suporte integrado para assistência de IA via **Claude Code** (e futuramente Cursor e VSCode).
-
-### Funcionalidades
-
-Três skills prontos para ajudar no desenvolvimento:
-
-1. **Building Sage Themes** — Master Sage 11 & Acorn
-   - Service providers e injeção de dependência
-   - Componentes Blade e view composers
-   - theme.json e configuração WordPress
-   - Padrões de desenvolvimento
-
-2. **Optimizing Vite Builds** — Performance de assets
-   - Configuração Vite e bundling
-   - Code splitting e análise de bundle
-   - Cache busting e asset versioning
-   - Monitoramento de performance
+## Convenções
 
-3. **Developing ACF Blocks** — Criação de blocos Gutenberg
-   - Anatomia de blocos ACF
-   - Todos os 20+ tipos de campos ACF
-   - Templates com Blade
-   - Padrões avançados
+- **Commits:** Conventional Commits (`feat:`, `fix:`, `docs:`, `refactor:`, `chore:`)
+- **Hooks:** Husky + lint-staged validam no pré-commit
+- **Commitlint:** Valida mensagem no commit-msg
 
-### Como usar
-
-#### Com Claude Code
-
-1. Abra seu projeto wp-kit no Claude Code
-2. Use `/` para ver os skills disponíveis
-3. Procure por "sage", "vite" ou "acf"
-4. Clique para acessar o skill
-
-#### Busca Direta
-
-```
-/building-sage-themes      → Desenvolvimento de temas
-/optimizing-vite-builds    → Otimização de assets
-/developing-acf-blocks     → Blocos Gutenberg
-```
-
-### Estrutura de Skills
-
-Cada skill segue um padrão progressivo:
-
-- **SKILL.md** — Quick start em 2-3 minutos
-- **Decision Trees** — Guias "qual ferramenta usar?"
-- **Reference Files** — Documentação completa com exemplos
-- **150+ Exemplos** — Código pronto para copiar/colar
-
-### Futuro
+## Contribuição
 
-Suporte planejado para:
+Pull Requests são bem-vindos. Use commits convencionais, mudanças pequenas e atualize a documentação quando alterar comportamentos.
 
-- ✅ Claude Code (atual, disponível)
-- ⏳ Cursor (em desenvolvimento)
-- ⏳ VSCode AI Assistant (em desenvolvimento)
-- ⏳ Plugin customizado (roadmap futuro)
+→ Guia completo: [docs/06-Contribuicao.md](docs/06-Contribuicao.md)
 
 ---
 
-## Contribuição
-
-Pull Requests são muito bem-vindos! Use commits convencionais, escreva mudanças pequenas e inclua atualizações na documentação quando necessário.
-
-—
-Se quiser entender a fundo (arquitetura, módulos e CI dinâmico), veja a wiki em `docs/` deste repositório.
+Para entender a fundo a arquitetura, módulos e CI dinâmico: [docs/](docs/)

package/lib/core/infer-ci-capabilities.js

@@ -84,6 +84,23 @@ export function inferCiCapabilities(context) {
       node: hasNode,
       sage: hasSage,
     },
+    lint: {
+      sage:
+        hasSage &&
+        Boolean(context.enable_lint) &&
+        (context.sage_lint_eslint !== false ||
+          context.sage_lint_pint !== false ||
+          context.sage_lint_stylelint !== false),
+      mu_plugin: Boolean(context.enable_mu_plugin && context.enable_lint),
+      plugin: Boolean(context.enable_plugin && context.enable_lint),
+      blank_theme: Boolean(context.enable_blank_theme && context.enable_lint),
+      any:
+        Boolean(context.enable_lint) &&
+        (hasSage ||
+          Boolean(context.enable_mu_plugin) ||
+          Boolean(context.enable_plugin) ||
+          Boolean(context.enable_blank_theme)),
+    },
     deploy: {
       docker: context.deploy_strategy === 'docker',
     },

package/lib/prompts/index.js

@@ -74,6 +74,18 @@ export async function runPrompts({ defaults = false } = {}) {
       message: 'Enable debug mode?',
       default: false,
     },
+    {
+      type: 'checkbox',
+      name: 'selectedContentModules',
+      message: 'Selecione os módulos de conteúdo do projeto:',
+      choices: [
+        { name: 'Sage theme        (Roots + Acorn + Vite)', value: 'sage' },
+        { name: 'Blank theme       (Vite + SCSS, sem Sage)', value: 'blank-theme' },
+        { name: 'MU Plugin scaffold', value: 'mu-plugin' },
+        { name: 'Plugin scaffold', value: 'plugin' },
+      ],
+      default: ['sage'],
+    },
   ];
 
   const modulePromptDefs = await loadModulePrompts();
@@ -85,12 +97,53 @@ export async function runPrompts({ defaults = false } = {}) {
     for (const prompt of allPrompts) {
       if (prompt.when && !prompt.when(defaultAnswers)) continue;
       const def = prompt.default;
-      defaultAnswers[prompt.name] = typeof def === 'function' ? def() : def;
+      defaultAnswers[prompt.name] = typeof def === 'function' ? def(defaultAnswers) : def;
     }
 
+    const sel = defaultAnswers.selectedContentModules || [];
+    defaultAnswers.enable_sage = sel.includes('sage');
+    defaultAnswers.enable_blank_theme = sel.includes('blank-theme');
+    defaultAnswers.enable_mu_plugin = sel.includes('mu-plugin');
+    defaultAnswers.enable_plugin = sel.includes('plugin');
+
+    // WP_KIT_ENABLE_SAGE: legacy single-module override. Use WP_KIT_CONTENT_MODULES for full control.
     const envEnableSage = parseBooleanEnv(process.env.WP_KIT_ENABLE_SAGE);
-    if (envEnableSage !== null) {
+    if (envEnableSage !== null && process.env.WP_KIT_CONTENT_MODULES === undefined) {
       defaultAnswers.enable_sage = envEnableSage;
+      // Sync selectedContentModules with env override
+      if (envEnableSage) {
+        defaultAnswers.selectedContentModules = [
+          ...new Set([...(defaultAnswers.selectedContentModules || []), 'sage']),
+        ];
+      } else {
+        defaultAnswers.selectedContentModules = (
+          defaultAnswers.selectedContentModules || []
+        ).filter((m) => m !== 'sage');
+      }
+    }
+
+    // WP_KIT_CONTENT_MODULES: comma-separated list that fully overrides selectedContentModules.
+    // Use empty string to select no content modules. Takes precedence over WP_KIT_ENABLE_SAGE.
+    // Example: WP_KIT_CONTENT_MODULES="sage,blank-theme"
+    const envContentModules = process.env.WP_KIT_CONTENT_MODULES;
+    if (envContentModules !== undefined) {
+      const modules = envContentModules
+        ? envContentModules
+            .split(',')
+            .map((m) => m.trim())
+            .filter(Boolean)
+        : [];
+      defaultAnswers.selectedContentModules = modules;
+      defaultAnswers.enable_sage = modules.includes('sage');
+      defaultAnswers.enable_blank_theme = modules.includes('blank-theme');
+      defaultAnswers.enable_mu_plugin = modules.includes('mu-plugin');
+      defaultAnswers.enable_plugin = modules.includes('plugin');
+    }
+
+    // WP_KIT_PROJECT_NAME: overrides the default project name (used for E2E tests).
+    const envProjectName = process.env.WP_KIT_PROJECT_NAME;
+    if (envProjectName) {
+      defaultAnswers.projectName = envProjectName;
     }
 
     const envGitProvider = process.env.WP_KIT_GIT_PROVIDER;
@@ -99,7 +152,7 @@ export async function runPrompts({ defaults = false } = {}) {
     }
 
     const enabledModules = Object.keys(modulePromptDefs).filter(
-      (mod) => defaultAnswers[`enable_${mod}`] === true
+      (mod) => defaultAnswers[`enable_${mod.replace(/-/g, '_')}`] === true
     );
     return {
       ...defaultAnswers,
@@ -113,8 +166,15 @@ export async function runPrompts({ defaults = false } = {}) {
 
   const answers = await inquirer.prompt(allPrompts);
 
+  // Derive enable_* flags from the checkbox selection
+  const sel = answers.selectedContentModules || [];
+  answers.enable_sage = sel.includes('sage');
+  answers.enable_blank_theme = sel.includes('blank-theme');
+  answers.enable_mu_plugin = sel.includes('mu-plugin');
+  answers.enable_plugin = sel.includes('plugin');
+
   const enabledModules = Object.keys(modulePromptDefs).filter(
-    (mod) => answers[`enable_${mod}`] === true
+    (mod) => answers[`enable_${mod.replace(/-/g, '_')}`] === true
   );
   return {
     ...answers,

package/modules/blank-theme/index.js

@@ -0,0 +1,71 @@
+import path from 'path';
+
+import fs from 'fs-extra';
+
+import { log, color } from '../../lib/utils/logger.js';
+
+export async function setupModule(context, generator) {
+  const themeName = context.blank_theme_name || `${context.projectName}-theme`;
+  const themeDir = `content/themes/${themeName}`;
+  const absoluteThemeDir = path.join(generator.cwd, themeDir);
+
+  log(color.blue, `[blank-theme] 📂 Scaffolding blank theme: ${themeDir}`);
+
+  // 1. Ensure directories exist
+  await fs.ensureDir(path.join(absoluteThemeDir, 'src', 'js'));
+  await fs.ensureDir(path.join(absoluteThemeDir, 'src', 'scss'));
+  await fs.ensureDir(path.join(absoluteThemeDir, 'php'));
+
+  // 2. Generate static files
+  await generator.generateFile(
+    'style.css',
+    { ...context, blank_theme_name: themeName },
+    'blank-theme',
+    `${themeDir}/style.css`
+  );
+  await generator.generateFile(
+    'functions.php',
+    { ...context, blank_theme_name: themeName },
+    'blank-theme',
+    `${themeDir}/functions.php`
+  );
+  await generator.generateFile(
+    'vite.config.js',
+    { ...context, blank_theme_name: themeName },
+    'blank-theme',
+    `${themeDir}/vite.config.js`
+  );
+  await generator.generateFile(
+    'package.json',
+    { ...context, blank_theme_name: themeName },
+    'blank-theme',
+    `${themeDir}/package.json`
+  );
+
+  // 3. src/ scaffolds
+  await fs.ensureFile(path.join(absoluteThemeDir, 'src', 'js', 'app.js'));
+  await fs.ensureFile(path.join(absoluteThemeDir, 'src', 'scss', 'app.scss'));
+
+  // 4. Lint configs co-located in theme — always installed (IDE/editor support)
+  log(color.blue, '[blank-theme] 🔧 Installing lint configurations...');
+  await generator.copyFile('lint/.prettierrc.json', 'blank-theme', `${themeDir}/.prettierrc.json`);
+  if (context.blank_theme_lint_eslint !== false) {
+    await generator.copyFile(
+      'lint/eslint.config.mjs',
+      'blank-theme',
+      `${themeDir}/eslint.config.mjs`
+    );
+  }
+  if (context.blank_theme_lint_pint !== false) {
+    await generator.copyFile('lint/pint.json', 'blank-theme', `${themeDir}/pint.json`);
+  }
+  if (context.blank_theme_lint_stylelint !== false) {
+    await generator.copyFile(
+      'lint/.stylelintrc.json',
+      'blank-theme',
+      `${themeDir}/.stylelintrc.json`
+    );
+  }
+
+  log(color.green, `[blank-theme] ✅ Blank theme scaffolded: ${themeDir}`);
+}

package/modules/blank-theme/lint/.prettierrc.json

@@ -0,0 +1,12 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "overrides": [
+    { "files": "*.blade.php", "options": { "parser": "html" } },
+    { "files": "*.vue", "options": { "parser": "vue" } },
+    { "files": "*.scss", "options": { "singleQuote": false } }
+  ]
+}

package/modules/blank-theme/lint/.stylelintrc.json

@@ -0,0 +1,7 @@
+{
+  "extends": ["stylelint-config-standard-scss"],
+  "rules": {
+    "color-hex-length": "short",
+    "string-quotes": "double"
+  }
+}

package/modules/{lint → blank-theme/lint}/eslint.config.mjs

@@ -5,17 +5,11 @@ import globals from 'globals';
 
 export default [
   {
-    ignores: [
-      '**/node_modules/**',
-      '**/vendor/**',
-      '**/wp/**',
-      '**/public/build/**',
-      '**/dist/**',
-      'eslint.config.mjs',
-    ],
+    ignores: ['node_modules/**', 'vendor/**', 'dist/**'],
   },
   js.configs.recommended,
   {
+    files: ['src/js/**/*.{js,mjs,ts}'],
     languageOptions: {
       ecmaVersion: 2022,
       sourceType: 'module',

package/modules/blank-theme/lint/pint.json

@@ -0,0 +1,11 @@
+{
+  "preset": "psr12",
+  "rules": {
+    "array_syntax": {
+      "syntax": "short"
+    },
+    "binary_operator_spaces": {
+      "default": "single_space"
+    }
+  }
+}

package/modules/blank-theme/prompts.js

@@ -0,0 +1,33 @@
+export default [
+  {
+    type: 'input',
+    name: 'blank_theme_name',
+    message: 'Blank theme slug (used as directory name):',
+    default: (answers) => `${answers.projectName || 'wordpress'}-theme`,
+    when: (answers) => answers.selectedContentModules?.includes('blank-theme'),
+  },
+  {
+    type: 'confirm',
+    name: 'blank_theme_lint_eslint',
+    message: 'Blank Theme: enable ESLint for JS/TS?',
+    default: true,
+    when: (answers) =>
+      answers.selectedContentModules?.includes('blank-theme') && answers.enable_lint,
+  },
+  {
+    type: 'confirm',
+    name: 'blank_theme_lint_stylelint',
+    message: 'Blank Theme: enable Stylelint for CSS/SCSS?',
+    default: true,
+    when: (answers) =>
+      answers.selectedContentModules?.includes('blank-theme') && answers.enable_lint,
+  },
+  {
+    type: 'confirm',
+    name: 'blank_theme_lint_pint',
+    message: 'Blank Theme: enable Pint for PHP?',
+    default: true,
+    when: (answers) =>
+      answers.selectedContentModules?.includes('blank-theme') && answers.enable_lint,
+  },
+];

package/modules/blank-theme/templates/.lando.yml.hbs

@@ -0,0 +1,26 @@
+tooling:
+  bt-dev:
+    service: build
+    description: Run Vite dev server for blank theme
+    cmd: npm run dev --prefix /app/content/themes/{{blank_theme_name}}
+  bt-build:
+    service: build
+    description: Build blank theme assets
+    cmd: npm run build --prefix /app/content/themes/{{blank_theme_name}}
+{{#if enable_lint}}
+  bt-eslint:
+    service: build
+    description: Lint JS/TS in blank theme
+    cmd: npx eslint --fix src/js/ --config /app/content/themes/{{blank_theme_name}}/eslint.config.mjs
+    dir: /app/content/themes/{{blank_theme_name}}
+  bt-stylelint:
+    service: build
+    description: Lint CSS/SCSS in blank theme
+    cmd: npx stylelint --fix "src/scss/**/*.scss" --config /app/content/themes/{{blank_theme_name}}/.stylelintrc.json
+    dir: /app/content/themes/{{blank_theme_name}}
+  bt-pint:
+    service: appserver
+    description: Lint PHP in blank theme
+    dir: /app/content/themes/{{blank_theme_name}}
+    cmd: ./vendor/bin/pint
+{{/if}}