From 64609c75443b8295405aaad9ee6ead2a6c0a51ea Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 30 Mar 2026 15:57:03 +0000 Subject: [PATCH 1/2] Initial plan From a88a162bde9bfa088372a4dfa9ced9baff81159b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 30 Mar 2026 16:03:56 +0000 Subject: [PATCH 2/2] chore: replace all placeholder tokens and convert starter to LightSpeed Theme repo Agent-Logs-Url: https://github.com/lightspeedwp/ls-theme/sessions/b9659a62-d94f-4758-ad41-af76ca989bca Co-authored-by: ashleyshaw <1805352+ashleyshaw@users.noreply.github.com> --- .agents/agents/theme-architect.md | 2 +- .github/copilot-instructions.md | 18 +++--- .github/instructions/patterns.instructions.md | 6 +- .github/instructions/php.instructions.md | 6 +- .github/prompts/new-pattern.prompt.md | 2 +- .github/tasks/task-list.md | 10 +-- AGENTS.md | 37 +++++------ CHANGELOG.md | 9 ++- CODEOWNERS | 2 +- README.md | 63 ++++++------------- composer.json | 8 +-- docs/README.md | 2 +- functions.php | 18 +++--- package-lock.json | 4 +- package.json | 4 +- readme.txt | 8 +-- style.css | 12 ++-- 17 files changed, 95 insertions(+), 116 deletions(-) diff --git a/.agents/agents/theme-architect.md b/.agents/agents/theme-architect.md index 0eefd5f..15350fa 100644 --- a/.agents/agents/theme-architect.md +++ b/.agents/agents/theme-architect.md @@ -1,7 +1,7 @@ # Agent Persona: Theme Architect **Role:** Senior WordPress Block Theme Architect -**Repository:** `{{GITHUB_ORG}}/{{REPO_NAME}}` +**Repository:** `lightspeedwp/ls-theme` --- diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index b432082..6699ad1 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -8,7 +8,7 @@ For full AI and developer guidance, read [`AGENTS.md`](../AGENTS.md) at the root ## Repo Overview -This is a **LightSpeed WordPress block theme starter repository**. +This is the **LightSpeed Theme** WordPress block theme repository (`lightspeedwp/ls-theme`). One theme, one repo. Not a monorepo. The theme uses the WordPress Full Site Editing (FSE) / block theme approach: @@ -96,11 +96,15 @@ composer run lint:php # Lint PHP syntax --- -## Placeholder Tokens +## Theme Identity -If placeholder tokens like `{{THEME_NAME}}` or `{{TEXT_DOMAIN}}` appear in any file, they must be replaced before the theme is used in production. +| Key | Value | +|--------------|----------------------------------| +| Theme name | `LightSpeed Theme` | +| Theme slug | `ls-theme` | +| Text domain | `ls-theme` | +| Repo | `lightspeedwp/ls-theme` | +| Author | `LightSpeed` | +| Author URI | `https://lightspeedwp.agency/` | -Search for unreplaced placeholders: -```bash -grep -r "{{" . --include="*.php" --include="*.json" --include="*.css" --include="*.html" --include="*.md" --include="*.txt" --include="*.mjs" -``` +Keep the text domain (`ls-theme`) consistent in all PHP files and theme metadata. diff --git a/.github/instructions/patterns.instructions.md b/.github/instructions/patterns.instructions.md index 3c26a13..515433b 100644 --- a/.github/instructions/patterns.instructions.md +++ b/.github/instructions/patterns.instructions.md @@ -19,7 +19,7 @@ Every pattern file must start with a valid registration header: -

+

**Note:** This starter is not specifically packaged for WordPress.org submission. It is designed for client and commercial block theme development. +> **Note:** This theme is not specifically packaged for WordPress.org submission. It is designed for client and commercial block theme development. --- ## Who It Is For - WordPress theme developers at LightSpeed -- Developers creating custom block themes for clients +- Developers maintaining or extending this theme - AI agents building or maintaining block themes in this repo --- @@ -60,22 +60,18 @@ It provides: ## Quick Start ```bash -# 1. Clone or use this repo as a template on GitHub +# 1. Clone the repo -# 2. Replace all placeholder tokens -# Search for {{ to find all placeholders -grep -r "{{" . --include="*.php" --include="*.json" --include="*.css" --include="*.html" --include="*.md" --include="*.txt" --include="*.mjs" --include="*.yml" - -# 3. Install Node dependencies +# 2. Install Node dependencies npm install -# 4. Install Composer dependencies +# 3. Install Composer dependencies composer install -# 5. Validate the theme +# 4. Validate the theme npm run theme:validate -# 6. Validate JSON schema +# 5. Validate JSON schema npm run schema:validate ``` @@ -161,34 +157,15 @@ npm run schema:validate --- -## How to Customise Placeholders - -Search for `{{` across the repository and replace all placeholder tokens: - -| Placeholder | Replace with | -|--------------------------|-------------------------------------| -| `{{THEME_NAME}}` | Human-readable theme name | -| `{{THEME_SLUG}}` | Kebab-case slug | -| `{{TEXT_DOMAIN}}` | Text domain (same as slug) | -| `{{THEME_URI}}` | Theme URI | -| `{{AUTHOR_NAME}}` | Author or agency name | -| `{{AUTHOR_URI}}` | Author or agency URI | -| `{{THEME_DESCRIPTION}}` | Short theme description | -| `{{REPO_NAME}}` | GitHub repository name | -| `{{GITHUB_ORG}}` | GitHub organisation name | - ---- - -## What to Edit First +## What to Edit -1. `style.css` — replace all header placeholders -2. `theme.json` — set your colour palette and typography -3. `functions.php` — add any theme supports you need -4. `parts/header.html` — build your header -5. `parts/footer.html` — build your footer -6. `templates/index.html` — build your main template -7. `CHANGELOG.md` — start tracking your changes -8. `CODEOWNERS` — set your team as owners +1. `theme.json` — set your colour palette and typography +2. `functions.php` — add any theme supports you need +3. `parts/header.html` — build your header +4. `parts/footer.html` — build your footer +5. `templates/index.html` — build your main template +6. `CHANGELOG.md` — track your changes +7. `CODEOWNERS` — set your team as owners --- diff --git a/composer.json b/composer.json index e736527..1c20f4a 100644 --- a/composer.json +++ b/composer.json @@ -1,12 +1,12 @@ { - "name": "{{GITHUB_ORG}}/{{REPO_NAME}}", - "description": "{{THEME_DESCRIPTION}}", + "name": "lightspeedwp/ls-theme", + "description": "LightSpeed Theme is a custom WordPress block theme built by LightSpeed for fast, accessible, maintainable websites using the WordPress Site Editor and block editor.", "type": "wordpress-theme", "license": "GPL-2.0-or-later", "authors": [ { - "name": "{{AUTHOR_NAME}}", - "homepage": "{{AUTHOR_URI}}" + "name": "LightSpeed", + "homepage": "https://lightspeedwp.agency/" } ], "require-dev": { diff --git a/docs/README.md b/docs/README.md index 1efc312..8183d57 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,6 +1,6 @@ # docs/ -This folder is for **end-user documentation** for the `{{THEME_NAME}}` theme. +This folder is for **end-user documentation** for the `LightSpeed Theme` theme. It is intended for: diff --git a/functions.php b/functions.php index 56266d5..a72faa3 100644 --- a/functions.php +++ b/functions.php @@ -1,8 +1,8 @@ get( 'Version' ) @@ -45,11 +45,11 @@ function {{TEXT_DOMAIN}}_enqueue_assets() { // Main JavaScript. Uncomment when assets/js/main.js exists: // wp_enqueue_script( - // '{{TEXT_DOMAIN}}-main', + // 'ls-theme-main', // get_template_directory_uri() . '/assets/js/main.js', // array(), // wp_get_theme()->get( 'Version' ), // true // ); } -add_action( 'wp_enqueue_scripts', '{{TEXT_DOMAIN}}_enqueue_assets' ); +add_action( 'wp_enqueue_scripts', 'ls_theme_enqueue_assets' ); diff --git a/package-lock.json b/package-lock.json index 12fb3b4..9296305 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,11 +1,11 @@ { - "name": "{{THEME_SLUG}}", + "name": "ls-theme", "version": "0.1.0", "lockfileVersion": 3, "requires": true, "packages": { "": { - "name": "{{THEME_SLUG}}", + "name": "ls-theme", "version": "0.1.0", "devDependencies": { "ajv": "^8.17.1", diff --git a/package.json b/package.json index 39fbc0a..2826157 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { - "name": "{{THEME_SLUG}}", + "name": "ls-theme", "version": "0.1.0", - "description": "{{THEME_DESCRIPTION}}", + "description": "LightSpeed Theme is a custom WordPress block theme built by LightSpeed for fast, accessible, maintainable websites using the WordPress Site Editor and block editor.", "type": "module", "scripts": { "schema:validate": "node theme-utils.mjs validate-schema", diff --git a/readme.txt b/readme.txt index 406d148..1f7d974 100644 --- a/readme.txt +++ b/readme.txt @@ -1,5 +1,5 @@ -=== {{THEME_NAME}} === -Contributors: {{AUTHOR_NAME}} +=== LightSpeed Theme === +Contributors: LightSpeed Requires at least: 6.4 Tested up to: 6.7 Requires PHP: 8.1 @@ -7,11 +7,11 @@ Stable tag: 0.1.0 License: GPL-2.0-or-later License URI: https://www.gnu.org/licenses/gpl-2.0.html -{{THEME_DESCRIPTION}} +LightSpeed Theme is a custom WordPress block theme built by LightSpeed for fast, accessible, maintainable websites using the WordPress Site Editor and block editor. == Description == -{{THEME_NAME}} is a custom WordPress block theme built by {{AUTHOR_NAME}}. +LightSpeed Theme is a custom WordPress block theme built by LightSpeed. This file is a light distribution placeholder. See README.md for full developer documentation. diff --git a/style.css b/style.css index f0db734..4b4a824 100644 --- a/style.css +++ b/style.css @@ -1,15 +1,15 @@ /* -Theme Name: {{THEME_NAME}} -Theme URI: {{THEME_URI}} -Author: {{AUTHOR_NAME}} -Author URI: {{AUTHOR_URI}} -Description: {{THEME_DESCRIPTION}} +Theme Name: LightSpeed Theme +Theme URI: https://lightspeedwp.agency/ +Author: LightSpeed +Author URI: https://lightspeedwp.agency/ +Description: LightSpeed Theme is a custom WordPress block theme built by LightSpeed for fast, accessible, maintainable websites using the WordPress Site Editor and block editor. Version: 0.1.0 Requires at least: 6.4 Tested up to: 6.7 Requires PHP: 8.1 License: GPL-2.0-or-later License URI: https://www.gnu.org/licenses/gpl-2.0.html -Text Domain: {{TEXT_DOMAIN}} +Text Domain: ls-theme Tags: block-theme, full-site-editing, custom-colors, custom-typography */